# Developer Documentation

This folder contains developer-facing documentation for building and maintaining the Foundry MCP server and CLI.

## Best Practices

- [MCP Best Practices](mcp_best_practices/README.md) - Canonical tool guidance and review checklist
- [CLI Best Practices](cli_best_practices/README.md) - CLI runtime patterns and parity rules

## Standards

- [Response Schema](codebase_standards/mcp_response_schema.md) - Envelope contract and examples
- [CLI Output Contract](codebase_standards/cli-output.md) - JSON-first CLI expectations
- [Naming Conventions](codebase_standards/naming-conventions.md) - Canonical tool prefixes

## Architecture

- [CLI Architecture ADR](architecture/adr-001-cli-architecture.md) - High-level CLI/MCP design

## Guides

- [Development Guide](guides/development-guide.md) - Setup, architecture, and contributing
- [Testing Guide](guides/testing.md) - Running tests and fixtures
- [Observability Guide](guides/observability.md) - Telemetry and logging
- [AI Consultation Guide](guides/ai-consultation.md) - Consultation workflows and integration
- [README Best Practices](readme-best-practices.md) - Structure and style guidance for README files
