# Documentation Index
Quick entry points for common tasks and reference material.
- **Quick start / workflow**: README.md (root) → install, `mcp-bash new`, `config`, `validate`, `doctor`
- **Architecture**: [ARCHITECTURE.md](ARCHITECTURE.md) — lifecycle, concurrency, registries
- **Inspector**: [INSPECTOR.md](INSPECTOR.md) — MCP Inspector recipes and strict-client pitfalls
- **Environment knobs**: [ENV_REFERENCE.md](ENV_REFERENCE.md) — all env vars with defaults and caps
- **Registry & discovery**: [REGISTRY.md](REGISTRY.md), [PROJECT-STRUCTURE.md](PROJECT-STRUCTURE.md)
- **Resource templates**: [RESOURCE-TEMPLATES.md](RESOURCE-TEMPLATES.md) — templates, collisions, and client-side expansion
- **Elicitation**: [ELICITATION.md](ELICITATION.md) — form/URL modes, SDK helpers
- **Completion**: [COMPLETION.md](COMPLETION.md) — providers, capabilities, pagination
- **Roots**: [ROOTS.md](ROOTS.md) — discovery, fallbacks, client negotiation
- **Performance & limits**: [PERFORMANCE.md](PERFORMANCE.md), [LIMITS.md](LIMITS.md)
- **Security & remote**: [SECURITY.md](SECURITY.md), [REMOTE.md](REMOTE.md)
- **Debugging/tests**: [DEBUGGING.md](DEBUGGING.md), [TESTING.md](../TESTING.md)
- **Best practices**: [BEST-PRACTICES.md](BEST-PRACTICES.md), [LOGGING.md](LOGGING.md), [MINIMAL-MODE.md](MINIMAL-MODE.md)
- **LLM context patterns**: [LLM-CONTEXT.md](LLM-CONTEXT.md) — writing descriptions, examples, domain resources for LLM tool use
- **Response helpers**: [BEST-PRACTICES.md §4.8](BEST-PRACTICES.md#48-building-calltoolresult-responses) — `mcp_result_success`, `mcp_result_error`, `mcp_error`, `mcp_json_truncate`
- **Distribution**: [MCPB.md](MCPB.md) — MCPB bundle format for one-click installation
