# Docs Map

Use this page as a full index of the documentation.

## Quick Router

| I want to... | Go to |
| --- | --- |
| Understand the project value and positioning | [Why This Repo Matters](/start_here/why_this_repo_matters) |
| See the feature overview | [Feature Map](/start_here/feature_map) |
| Decide between terminal automation and MCP clients | [CLI vs MCP](/start_here/cli_vs_mcp) |
| Copy CLI commands quickly | [CLI Quick Recipes](/start_here/cli_quick_recipes) |
| Install manually as a developer | [Execution playbook](/ai_agents/execution_playbook) |
| Configure AI clients manually | [Execution playbook](/ai_agents/execution_playbook) |
| Run install through an AI assistant | [AI agent overview](/ai_agents/overview) |
| Install skills via `npx skills` / [skills.sh](https://skills.sh) | [AI agent overview](/ai_agents/overview) — § Install via `npx skills` |
| Install from Claude / Cursor / Codex marketplaces | [Marketplace distribution](/ai_agents/marketplace_distribution) |
| Publish plugin to official stores (maintainers) | [Marketplace submission runbook](/contributing/marketplace_submission_runbook) |
| Operate as an AI agent | [AI Agent Overview](/ai_agents/overview) |
| See all contributor information | [Contributors](/contributing/contributors) |

## Start Here

- [Overview](/)
- [Why This Repo Matters](/start_here/why_this_repo_matters)
- [Feature Map](/start_here/feature_map)
- [CLI vs MCP](/start_here/cli_vs_mcp)
- [CLI Quick Recipes](/start_here/cli_quick_recipes)
- [Video Walkthroughs](/start_here/video_walkthroughs)

## For Humans

- [Execution playbook](/ai_agents/execution_playbook)
- [Debugging Workflow](/guides/debugging_workflow)
- [Creating Dynamic Tools](/guides/creating_dynamic_tools)
- [Common Issues](/troubleshooting/common_issues)

## For AI Agents

- [AI Agent Overview](/ai_agents/overview)
- [Marketplace distribution](/ai_agents/marketplace_distribution)
- [Execution Playbook](/ai_agents/execution_playbook)
- [AI Troubleshooting](/ai_agents/troubleshooting)

_On Cursor/Codex/Claude wiring, use `flutter-mcp-toolkit init <agent>` (skills + MCP) or `npx skills add Arenukvern/mcp_flutter` (skills only) — see [AI agent overview](/ai_agents/overview)._

## Core Reference

- [Architecture](/core/project_architecture)
- [MCP Configuration](/core/mcp_configuration)
- [Dynamic Tool Registry](/core/dynamic_tools_registry)
- [CLI quick recipes](/start_here/cli_quick_recipes)
- [AI troubleshooting](/ai_agents/troubleshooting)

## Contributing

- [Contribution Guide](/contributing/contribution_guide)
- [Contributors](/contributing/contributors)
- [Docs Maintenance](/contributing/docs_maintenance)

## Root Entry Docs (GitHub)

These are concise entry files in repo root that point into MDX docs:

- [QUICK_START.md](https://github.com/Arenukvern/mcp_flutter/blob/main/QUICK_START.md)
- [llm_install.md](https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md)
- [CONFIGURATION.md](https://github.com/Arenukvern/mcp_flutter/blob/main/CONFIGURATION.md)
- [MCP_RPC_DESCRIPTION.md](https://github.com/Arenukvern/mcp_flutter/blob/main/MCP_RPC_DESCRIPTION.md)
