1 line
77 KiB
JSON
1 line
77 KiB
JSON
{"repo": "burburton/amazingteam", "files": {"docs/config-reference.md": {"353bc7a663dc74367c47f732db3f44ae3459fbfa": {"t": 1785746481.520071, "n": 13956, "h": "bc67acbda83df28f", "c": "# Configuration Reference\n\nThis document describes all configuration options for `amazingteam.config.yaml`.\n\n---\n\n## Configuration File Location\n\nDefault: `amazingteam.config.yaml` in project root.\n\nCustom location: Specify via CLI `--config` flag or Action input.\n\n---\n\n## Full Configuration Example\n\n```yaml\nversion: \"1.0\"\n\npreset: \"typescript\"\n\nproject:\n name: \"my-awesome-app\"\n description: \"My awesome application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/repo\"\n\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\nrules:\n test_coverage_threshold: 80\n max_function_lines: 30\n max_file_lines: 500\n commit_convention: \"conventional\"\n\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\nworkflows:\n feature:\n sequence:\n - triage\n - architect\n - developer\n - qa\n - reviewer\n auto_merge: false\n bugfix:\n sequence:\n - triage\n - developer\n - qa\n auto_merge: false\n\nmemory:\n retention_days: 90\n max_entries_per_role: 100\n\nfoundation:\n version: \"3.0.0\"\n registry: \"https://registry.npmjs.org\"\n\noverlay:\n name: \"web-fullstack\"\n content: |\n ## Custom Rules\n - Use functional components\n - Prefer hooks over class components\n```\n\n---\n\n## Configuration Fields\n\n### Top-Level Fields\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"1.0\"` | Config file schema version |\n| `preset` | string | No | `\"default\"` | Preset name (default, typescript, python, go) |\n| `project` | object | **Yes** | - | Project information |\n| `llm` | object | No | Default | LLM provider configuration |\n| `workflow` | object | No | PR mode | Commit and PR workflow settings |\n| `build` | object | No | Preset default | Build commands |\n| `rules` | object | No | Preset default | Coding rules |\n| `agents` | object | No | All enabled | Agent configuration |\n| `workflows` | object | No | Built-in defaults | Custom workflows |\n| `memory` | object | No | Built-in defaults | Memory settings |\n| `foundation` | object | No | Latest | Foundation version settings |\n| `overlay` | object | No | None | Overlay configuration |\n\n---\n\n### project\n\n**Required**. Project information.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `name` | string | **Yes** | - | Project name |\n| `description` | string | No | `\"\"` | Project description |\n| `language` | string | **Yes** | - | Primary language (typescript, python, go, etc.) |\n| `framework` | string | No | `\"\"` | Framework name (react, vue, django, etc.) |\n| `repository` | string | No | Git origin | Repository URL |\n\n**Examples:**\n\n```yaml\n# Minimal\nproject:\n name: \"my-api\"\n language: \"python\"\n\n# Full\nproject:\n name: \"my-fullstack-app\"\n description: \"Full-stack web application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/my-fullstack-app\"\n```\n\n---\n\n### llm\n\nLLM provider configuration for custom AI backends.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `provider` | string | No | `\"default\"` | Provider name (default, openai, anthropic, bailian, deepseek, etc.) |\n| `model` | string | No | `\"default\"` | Model name for main tasks |\n| `small_model` | string | No | Same as model | Model for simple tasks |\n| `base_url` | string | No | Provider default | Custom API endpoint |\n| `api_key_env` | string | No | - | Environment variable name for API key |\n\n**Supported Providers:**\n\n| Provider | base_url | Notes |\n|----------|----------|-------|\n| `default` | - | Uses OpenCode's default configuration |\n| `openai` | `https://api.openai.com/v1` | OpenAI GPT models |\n| `anthropic` | `https://api.anthropic.com` | Claude models |\n| `bailian` | `https://bailian.aliyuncs.com/v1` | Alibaba Bailian (百炼) |\n| `deepseek` | `https://api.deepseek.com` | DeepSeek models |\n| `moonshot` | `https://api.moonshot.cn/v1` | Moonshot (月之暗面) |\n| `zhipu` | `https://open.bigmodel.cn/api/paas/v4` | Zhipu AI (智谱) |\n\n**Examples:**\n\n```yaml\n# Use default (OpenCode handles configuration)\nllm:\n provider: \"default\"\n\n# Use Alibaba Bailian (百炼)\nllm:\n model: \"bailian-coding-plan/glm-5\"\n small_model: \"bailian-coding-plan/glm-5\"\n\n# Use OpenAI\nllm:\n model: \"openai/gpt-4\"\n small_model: \"openai/gpt-3.5-turbo\"\n\n# Use DeepSeek\nllm:\n model: \"deepseek/deepseek-chat\"\n small_model: \"deepseek/deepseek-chat\"\n\n# Custom endpoint\nllm:\n model: \"custom/my-model\"\n base_url: \"https://my-api.example.com/v1\"\n api_key_env: \"CUSTOM_API_KEY\"\n```\n\n**Environment Variables:**\n\nSet your API key in environment:\n```bash\nexport AMAZINGTEAM_API_KEY=\"your-api-key\"\n```\n\nIn GitHub Actions, add to your workflow:\n```yaml\nenv:\n AMAZINGTEAM_API_KEY: ${{ secrets.AMAZINGTEAM_API_KEY }}\n```\n\n---\n\n### workflow\n\nCommit and PR workflow configuration.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `commit_mode` | string | No | `\"pr\"` | Commit mode: `\"pr\"` or `\"direct\"` |\n| `pr` | object | No | See below | PR mode settings |\n| `direct` | object | No | See below | Direct commit mode settings |\n\n#### commit_mode\n\n| Value | Description |\n|-------|-------------|\n| `\"pr\"` | Create Pull Request, wait for human review (recommended, safer) |\n| `\"direct\"` | Commit directly to branch (faster, less oversight) |\n\n#### pr settings\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `auto_merge` | boolean | No | `false` | Auto-merge PR after CI passes |\n| `require_review` | boolean | No | `true` | Require human review before merge |\n| `reviewers` | string[] | No | `[]` | Default reviewers for PRs |\n\n#### direct settings\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `require_ci_pass` | boolean | No | `true` | Require CI to pass before committing |\n\n**Examples:**\n\n```yaml\n# PR mode with human review (recommended for teams)\nworkflow:\n commit_mode: \"pr\"\n pr:\n auto_merge: false\n require_review: true\n reviewers:\n - \"team-lead\"\n - \"senior-dev\"\n\n# PR mode with auto-merge (trusted environments)\nworkflow:\n commit_mode: \"pr\"\n pr:\n auto_merge: true\n require_review: false\n\n# Direct commits (solo projects, faster iteration)\nworkflow:\n commit_mode: \"direct\"\n direct:\n require_ci_pass: true\n```\n\n**When to use each mode:**\n\n| Scenario | Recommended Mode |\n|----------|------------------|\n| Team project | `pr` with `require_review: true` |\n| Solo project | `direct` or `pr` with `auto_merge: true` |\n| Production codebase | `pr` with `require_review: true` |\n| Prototype/POC | `direct` |\n| Regulated industry | `pr` with multiple `reviewers` |\n\n---\n\n### build\n\nBuild and test commands.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `command` | string | No | Preset default | Build command |\n| `test` | string | No | Preset default | Test command |\n| `lint` | string | No | Preset default | Lint command |\n| `typecheck` | string | No | Preset default | Type check command |\n\n**Examples:**\n\n```yaml\n# TypeScript project\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\n# Python project\nbuild:\n command: \"python -m build\"\n test: \"pytest\"\n lint: \"ruff check .\"\n typecheck: \"mypy .\"\n\n# Go project\nbuild:\n command: \"go build ./...\"\n test: \"go test ./...\"\n lint: \"golangci-lint run\"\n typecheck: \"\" # Go doesn't need separate typecheck\n```\n\n---\n\n### rules\n\nCoding rules and thresholds.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `test_coverage_threshold` | number | No | `80` | Minimum test coverage % |\n| `max_function_lines` | number | No | `30` | Max lines per function |\n| `max_file_lines` | number | No | `500` | Max lines per file |\n| `commit_convention` | string | No | `\"conventional\"` | Commit message format |\n\n**Examples:**\n\n```yaml\nrules:\n test_coverage_threshold: 90\n max_function_lines: 25\n max_file_lines: 300\n commit_convention: \"conventional\" # or \"angular\", \"gitmoji\", \"none\"\n```\n\n---\n\n### agents\n\nEnable/disable agents.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `planner` | boolean | No | `true` | Enable planner agent |\n| `architect` | boolean | No | `true` | Enable architect agent |\n| `developer` | boolean | No | `true` | Enable developer agent |\n| `qa` | boolean | No | `true` | Enable QA agent |\n| `reviewer` | boolean | No | `true` | Enable reviewer agent |\n| `triage` | boolean | No | `true` | Enable triage agent |\n| `ci_analyst` | boolean | No | `true` | Enable CI analyst agent |\n\n**Examples:**\n\n```yaml\n# All enabled (default)\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\n# Minimal team\nagents:\n planner: false\n architect: true\n developer: true\n qa: true\n reviewer: false\n triage: false\n ci_analyst: false\n```\n\n---\n\n### workflows\n\nCustom workflow definitions.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `{workflow_name}` | object | No | Workflow definition |\n| `{workflow_name}.sequence` | string[] | **Yes** | Ordered list of roles |\n| `{workflow_name}.auto_merge` | boolean | No | Auto-merge PRs after completion |\n\n**Built-in Workflows:**\n\n| Name | Sequence | Description |\n|------|----------|-------------|\n| `feature` | triage → architect → developer → qa → reviewer | New feature development |\n| `bugfix` | triage → developer → qa | Bug fixes |\n| `tech-task` | triage → architect → developer → qa | Technical tasks |\n\n**Examples:**\n\n```yaml\nworkflows:\n # Override default feature workflow\n feature:\n sequence:\n - triage\n - architect\n - developer\n - developer # Second pass\n - qa\n - reviewer\n auto_merge: false\n\n # Custom quick-fix workflow\n quickfix:\n sequence:\n - developer\n - qa\n auto_merge: true\n\n # Documentation workflow\n docs:\n sequence:\n - developer\n auto_merge: true\n```\n\n---\n\n### memory\n\nMemory system settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `retention_days` | number | No | `90` | Days to keep memory entries |\n| `max_entries_per_role` | number | No | `100` | Max entries per role |\n\n**Examples:**\n\n```yaml\nmemory:\n retention_days: 30 # Shorter retention for small projects\n max_entries_per_role: 50\n```\n\n---\n\n### foundation\n\nFoundation version and source settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"latest\"` | Foundation version |\n| `registry` | string | No | `\"https://registry.npmjs.org\"` | NPM registry URL |\n| `github_repo` | string | No | Official repo | GitHub repo for fallback |\n\n**Examples:**\n\n```yaml\n# Use specific version\nfoundation:\n version: \"3.1.0\"\n\n# Use private registry\nfoundation:\n version: \"3.0.0\"\n registry: \"https://my-private-registry.com\"\n\n# Use GitHub releases\nfoundation:\n version: \"3.0.0\"\n github_repo: \"my-org/amazingteam\"\n```\n\n---\n\n### overlay\n\nOverlay configuration for custom rules and content.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `name` | string | No | Built-in overlay name |\n| `path` | string | No | Custom overlay path |\n| `content` | string | No | Inline overlay content |\n\n**Built-in Overlays:**\n\n| Name | Description |\n|------|-------------|\n| `web-fullstack` | React/Vue/Node fullstack conventions |\n| `python-backend` | Python/Django/FastAPI conventions |\n| `cpp-qt-desktop` | C++/Qt desktop application conventions |\n\n**Examples:**\n\n```yaml\n# Use built-in overlay\noverlay:\n name: \"web-fullstack\"\n\n# Use custom overlay from path\noverlay:\n path: \"./my-custom-overlay\"\n\n# Inline overlay content\noverlay:\n content: |\n ## Project-Specific Rules\n - Use functional components only\n - All API calls must have error handling\n - Use CSS modules for styling\n```\n\n---\n\n### preset\n\nQuick configuration presets.\n\n| Preset | Language | Framework | Build | Test |\n|--------|----------|-----------|-------|------|\n| `default` | Any | Any | `npm run build` | `npm test` |\n| `typescript` | TypeScript | Any | `npm run build` | `npm test` |\n| `python` | Python | Any | `python -m build` | `pytest` |\n| `go` | Go | Any | `go build ./...` | `go test ./...` |\n\n**Example:**\n\n```yaml\n# Using preset (recommended for quick setup)\npreset: \"typescript\"\n\nproject:\n name: \"my-api\"\n\n# Preset provides defaults for build, rules, etc.\n# Override as needed:\n\nbuild:\n test: \"npm run test:coverage\"\n```\n\n---\n\n## Minimal Configuration\n\nThe minimum required configuration:\n\n```yaml\nproject:\n name: \"my-project\"\n language: \"typescript\"\n```\n\nAll other fields use preset or built-in defaults.\n\n---\n\n## Configuration Merge Order\n\nConfiguration is merged in this order (later overrides earlier):\n\n1. Foundation defaults\n2. Preset defaults\n3. User configuration (`amazingteam.config.yaml`)\n4. Local overlay\n\n---\n\n## Validation\n\nValidate your configuration:\n\n```bash\nnpx amazingteam validate\n```\n\nThis checks:\n- Required fields present\n- Valid values for enums\n- Correct types for all fields\n- Valid workflow sequences\n\n---\n\n## Environment Variables\n\nOverride configuration with environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `AI_TEAM_CONFIG` | Path to config file |\n| `AI_TEAM_VERSION` | Override foundation version |\n| `AI_TEAM_REGISTRY` | Override NPM registry |\n| `AI_TEAM_DEBUG` | Enable debug logging |\n\n**Example:**\n\n```bash\nAI_TEAM_CONFIG=./custom-config.yaml npx amazingteam validate\n```"}, "c5d2ecf10c7585c75218f6b83233bd8477742223": {"t": 1785764792.489054, "n": 13956, "h": "bc67acbda83df28f", "c": "# Configuration Reference\n\nThis document describes all configuration options for `amazingteam.config.yaml`.\n\n---\n\n## Configuration File Location\n\nDefault: `amazingteam.config.yaml` in project root.\n\nCustom location: Specify via CLI `--config` flag or Action input.\n\n---\n\n## Full Configuration Example\n\n```yaml\nversion: \"1.0\"\n\npreset: \"typescript\"\n\nproject:\n name: \"my-awesome-app\"\n description: \"My awesome application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/repo\"\n\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\nrules:\n test_coverage_threshold: 80\n max_function_lines: 30\n max_file_lines: 500\n commit_convention: \"conventional\"\n\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\nworkflows:\n feature:\n sequence:\n - triage\n - architect\n - developer\n - qa\n - reviewer\n auto_merge: false\n bugfix:\n sequence:\n - triage\n - developer\n - qa\n auto_merge: false\n\nmemory:\n retention_days: 90\n max_entries_per_role: 100\n\nfoundation:\n version: \"3.0.0\"\n registry: \"https://registry.npmjs.org\"\n\noverlay:\n name: \"web-fullstack\"\n content: |\n ## Custom Rules\n - Use functional components\n - Prefer hooks over class components\n```\n\n---\n\n## Configuration Fields\n\n### Top-Level Fields\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"1.0\"` | Config file schema version |\n| `preset` | string | No | `\"default\"` | Preset name (default, typescript, python, go) |\n| `project` | object | **Yes** | - | Project information |\n| `llm` | object | No | Default | LLM provider configuration |\n| `workflow` | object | No | PR mode | Commit and PR workflow settings |\n| `build` | object | No | Preset default | Build commands |\n| `rules` | object | No | Preset default | Coding rules |\n| `agents` | object | No | All enabled | Agent configuration |\n| `workflows` | object | No | Built-in defaults | Custom workflows |\n| `memory` | object | No | Built-in defaults | Memory settings |\n| `foundation` | object | No | Latest | Foundation version settings |\n| `overlay` | object | No | None | Overlay configuration |\n\n---\n\n### project\n\n**Required**. Project information.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `name` | string | **Yes** | - | Project name |\n| `description` | string | No | `\"\"` | Project description |\n| `language` | string | **Yes** | - | Primary language (typescript, python, go, etc.) |\n| `framework` | string | No | `\"\"` | Framework name (react, vue, django, etc.) |\n| `repository` | string | No | Git origin | Repository URL |\n\n**Examples:**\n\n```yaml\n# Minimal\nproject:\n name: \"my-api\"\n language: \"python\"\n\n# Full\nproject:\n name: \"my-fullstack-app\"\n description: \"Full-stack web application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/my-fullstack-app\"\n```\n\n---\n\n### llm\n\nLLM provider configuration for custom AI backends.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `provider` | string | No | `\"default\"` | Provider name (default, openai, anthropic, bailian, deepseek, etc.) |\n| `model` | string | No | `\"default\"` | Model name for main tasks |\n| `small_model` | string | No | Same as model | Model for simple tasks |\n| `base_url` | string | No | Provider default | Custom API endpoint |\n| `api_key_env` | string | No | - | Environment variable name for API key |\n\n**Supported Providers:**\n\n| Provider | base_url | Notes |\n|----------|----------|-------|\n| `default` | - | Uses OpenCode's default configuration |\n| `openai` | `https://api.openai.com/v1` | OpenAI GPT models |\n| `anthropic` | `https://api.anthropic.com` | Claude models |\n| `bailian` | `https://bailian.aliyuncs.com/v1` | Alibaba Bailian (百炼) |\n| `deepseek` | `https://api.deepseek.com` | DeepSeek models |\n| `moonshot` | `https://api.moonshot.cn/v1` | Moonshot (月之暗面) |\n| `zhipu` | `https://open.bigmodel.cn/api/paas/v4` | Zhipu AI (智谱) |\n\n**Examples:**\n\n```yaml\n# Use default (OpenCode handles configuration)\nllm:\n provider: \"default\"\n\n# Use Alibaba Bailian (百炼)\nllm:\n model: \"bailian-coding-plan/glm-5\"\n small_model: \"bailian-coding-plan/glm-5\"\n\n# Use OpenAI\nllm:\n model: \"openai/gpt-4\"\n small_model: \"openai/gpt-3.5-turbo\"\n\n# Use DeepSeek\nllm:\n model: \"deepseek/deepseek-chat\"\n small_model: \"deepseek/deepseek-chat\"\n\n# Custom endpoint\nllm:\n model: \"custom/my-model\"\n base_url: \"https://my-api.example.com/v1\"\n api_key_env: \"CUSTOM_API_KEY\"\n```\n\n**Environment Variables:**\n\nSet your API key in environment:\n```bash\nexport AMAZINGTEAM_API_KEY=\"your-api-key\"\n```\n\nIn GitHub Actions, add to your workflow:\n```yaml\nenv:\n AMAZINGTEAM_API_KEY: ${{ secrets.AMAZINGTEAM_API_KEY }}\n```\n\n---\n\n### workflow\n\nCommit and PR workflow configuration.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `commit_mode` | string | No | `\"pr\"` | Commit mode: `\"pr\"` or `\"direct\"` |\n| `pr` | object | No | See below | PR mode settings |\n| `direct` | object | No | See below | Direct commit mode settings |\n\n#### commit_mode\n\n| Value | Description |\n|-------|-------------|\n| `\"pr\"` | Create Pull Request, wait for human review (recommended, safer) |\n| `\"direct\"` | Commit directly to branch (faster, less oversight) |\n\n#### pr settings\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `auto_merge` | boolean | No | `false` | Auto-merge PR after CI passes |\n| `require_review` | boolean | No | `true` | Require human review before merge |\n| `reviewers` | string[] | No | `[]` | Default reviewers for PRs |\n\n#### direct settings\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `require_ci_pass` | boolean | No | `true` | Require CI to pass before committing |\n\n**Examples:**\n\n```yaml\n# PR mode with human review (recommended for teams)\nworkflow:\n commit_mode: \"pr\"\n pr:\n auto_merge: false\n require_review: true\n reviewers:\n - \"team-lead\"\n - \"senior-dev\"\n\n# PR mode with auto-merge (trusted environments)\nworkflow:\n commit_mode: \"pr\"\n pr:\n auto_merge: true\n require_review: false\n\n# Direct commits (solo projects, faster iteration)\nworkflow:\n commit_mode: \"direct\"\n direct:\n require_ci_pass: true\n```\n\n**When to use each mode:**\n\n| Scenario | Recommended Mode |\n|----------|------------------|\n| Team project | `pr` with `require_review: true` |\n| Solo project | `direct` or `pr` with `auto_merge: true` |\n| Production codebase | `pr` with `require_review: true` |\n| Prototype/POC | `direct` |\n| Regulated industry | `pr` with multiple `reviewers` |\n\n---\n\n### build\n\nBuild and test commands.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `command` | string | No | Preset default | Build command |\n| `test` | string | No | Preset default | Test command |\n| `lint` | string | No | Preset default | Lint command |\n| `typecheck` | string | No | Preset default | Type check command |\n\n**Examples:**\n\n```yaml\n# TypeScript project\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\n# Python project\nbuild:\n command: \"python -m build\"\n test: \"pytest\"\n lint: \"ruff check .\"\n typecheck: \"mypy .\"\n\n# Go project\nbuild:\n command: \"go build ./...\"\n test: \"go test ./...\"\n lint: \"golangci-lint run\"\n typecheck: \"\" # Go doesn't need separate typecheck\n```\n\n---\n\n### rules\n\nCoding rules and thresholds.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `test_coverage_threshold` | number | No | `80` | Minimum test coverage % |\n| `max_function_lines` | number | No | `30` | Max lines per function |\n| `max_file_lines` | number | No | `500` | Max lines per file |\n| `commit_convention` | string | No | `\"conventional\"` | Commit message format |\n\n**Examples:**\n\n```yaml\nrules:\n test_coverage_threshold: 90\n max_function_lines: 25\n max_file_lines: 300\n commit_convention: \"conventional\" # or \"angular\", \"gitmoji\", \"none\"\n```\n\n---\n\n### agents\n\nEnable/disable agents.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `planner` | boolean | No | `true` | Enable planner agent |\n| `architect` | boolean | No | `true` | Enable architect agent |\n| `developer` | boolean | No | `true` | Enable developer agent |\n| `qa` | boolean | No | `true` | Enable QA agent |\n| `reviewer` | boolean | No | `true` | Enable reviewer agent |\n| `triage` | boolean | No | `true` | Enable triage agent |\n| `ci_analyst` | boolean | No | `true` | Enable CI analyst agent |\n\n**Examples:**\n\n```yaml\n# All enabled (default)\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\n# Minimal team\nagents:\n planner: false\n architect: true\n developer: true\n qa: true\n reviewer: false\n triage: false\n ci_analyst: false\n```\n\n---\n\n### workflows\n\nCustom workflow definitions.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `{workflow_name}` | object | No | Workflow definition |\n| `{workflow_name}.sequence` | string[] | **Yes** | Ordered list of roles |\n| `{workflow_name}.auto_merge` | boolean | No | Auto-merge PRs after completion |\n\n**Built-in Workflows:**\n\n| Name | Sequence | Description |\n|------|----------|-------------|\n| `feature` | triage → architect → developer → qa → reviewer | New feature development |\n| `bugfix` | triage → developer → qa | Bug fixes |\n| `tech-task` | triage → architect → developer → qa | Technical tasks |\n\n**Examples:**\n\n```yaml\nworkflows:\n # Override default feature workflow\n feature:\n sequence:\n - triage\n - architect\n - developer\n - developer # Second pass\n - qa\n - reviewer\n auto_merge: false\n\n # Custom quick-fix workflow\n quickfix:\n sequence:\n - developer\n - qa\n auto_merge: true\n\n # Documentation workflow\n docs:\n sequence:\n - developer\n auto_merge: true\n```\n\n---\n\n### memory\n\nMemory system settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `retention_days` | number | No | `90` | Days to keep memory entries |\n| `max_entries_per_role` | number | No | `100` | Max entries per role |\n\n**Examples:**\n\n```yaml\nmemory:\n retention_days: 30 # Shorter retention for small projects\n max_entries_per_role: 50\n```\n\n---\n\n### foundation\n\nFoundation version and source settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"latest\"` | Foundation version |\n| `registry` | string | No | `\"https://registry.npmjs.org\"` | NPM registry URL |\n| `github_repo` | string | No | Official repo | GitHub repo for fallback |\n\n**Examples:**\n\n```yaml\n# Use specific version\nfoundation:\n version: \"3.1.0\"\n\n# Use private registry\nfoundation:\n version: \"3.0.0\"\n registry: \"https://my-private-registry.com\"\n\n# Use GitHub releases\nfoundation:\n version: \"3.0.0\"\n github_repo: \"my-org/amazingteam\"\n```\n\n---\n\n### overlay\n\nOverlay configuration for custom rules and content.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `name` | string | No | Built-in overlay name |\n| `path` | string | No | Custom overlay path |\n| `content` | string | No | Inline overlay content |\n\n**Built-in Overlays:**\n\n| Name | Description |\n|------|-------------|\n| `web-fullstack` | React/Vue/Node fullstack conventions |\n| `python-backend` | Python/Django/FastAPI conventions |\n| `cpp-qt-desktop` | C++/Qt desktop application conventions |\n\n**Examples:**\n\n```yaml\n# Use built-in overlay\noverlay:\n name: \"web-fullstack\"\n\n# Use custom overlay from path\noverlay:\n path: \"./my-custom-overlay\"\n\n# Inline overlay content\noverlay:\n content: |\n ## Project-Specific Rules\n - Use functional components only\n - All API calls must have error handling\n - Use CSS modules for styling\n```\n\n---\n\n### preset\n\nQuick configuration presets.\n\n| Preset | Language | Framework | Build | Test |\n|--------|----------|-----------|-------|------|\n| `default` | Any | Any | `npm run build` | `npm test` |\n| `typescript` | TypeScript | Any | `npm run build` | `npm test` |\n| `python` | Python | Any | `python -m build` | `pytest` |\n| `go` | Go | Any | `go build ./...` | `go test ./...` |\n\n**Example:**\n\n```yaml\n# Using preset (recommended for quick setup)\npreset: \"typescript\"\n\nproject:\n name: \"my-api\"\n\n# Preset provides defaults for build, rules, etc.\n# Override as needed:\n\nbuild:\n test: \"npm run test:coverage\"\n```\n\n---\n\n## Minimal Configuration\n\nThe minimum required configuration:\n\n```yaml\nproject:\n name: \"my-project\"\n language: \"typescript\"\n```\n\nAll other fields use preset or built-in defaults.\n\n---\n\n## Configuration Merge Order\n\nConfiguration is merged in this order (later overrides earlier):\n\n1. Foundation defaults\n2. Preset defaults\n3. User configuration (`amazingteam.config.yaml`)\n4. Local overlay\n\n---\n\n## Validation\n\nValidate your configuration:\n\n```bash\nnpx amazingteam validate\n```\n\nThis checks:\n- Required fields present\n- Valid values for enums\n- Correct types for all fields\n- Valid workflow sequences\n\n---\n\n## Environment Variables\n\nOverride configuration with environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `AI_TEAM_CONFIG` | Path to config file |\n| `AI_TEAM_VERSION` | Override foundation version |\n| `AI_TEAM_REGISTRY` | Override NPM registry |\n| `AI_TEAM_DEBUG` | Enable debug logging |\n\n**Example:**\n\n```bash\nAI_TEAM_CONFIG=./custom-config.yaml npx amazingteam validate\n```"}, "85586f87060a0c10b80126e9d86e51f68142c276": {"t": 1785764793.968745, "n": 14159, "h": "f8cbba511d1ca74f", "c": "# Configuration Reference\n\nThis document describes all configuration options for `amazingteam.config.yaml`.\n\n---\n\n## Configuration File Location\n\nDefault: `amazingteam.config.yaml` in project root.\n\nCustom location: Specify via CLI `--config` flag or Action input.\n\n---\n\n## Full Configuration Example\n\n```yaml\nversion: \"1.0\"\n\npreset: \"typescript\"\n\nproject:\n name: \"my-awesome-app\"\n description: \"My awesome application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/repo\"\n\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\nrules:\n test_coverage_threshold: 80\n max_function_lines: 30\n max_file_lines: 500\n commit_convention: \"conventional\"\n\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\nworkflows:\n feature:\n sequence:\n - triage\n - architect\n - developer\n - qa\n - reviewer\n auto_merge: false\n bugfix:\n sequence:\n - triage\n - developer\n - qa\n auto_merge: false\n\nmemory:\n retention_days: 90\n max_entries_per_role: 100\n\nfoundation:\n version: \"3.0.0\"\n registry: \"https://registry.npmjs.org\"\n\noverlay:\n name: \"web-fullstack\"\n content: |\n ## Custom Rules\n - Use functional components\n - Prefer hooks over class components\n```\n\n---\n\n## Configuration Fields\n\n### Top-Level Fields\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"1.0\"` | Config file schema version |\n| `preset` | string | No | `\"default\"` | Preset name (default, typescript, python, go) |\n| `project` | object | **Yes** | - | Project information |\n| `llm` | object | No | Default | LLM provider configuration |\n| `workflow` | object | No | PR mode | Commit and PR workflow settings |\n| `build` | object | No | Preset default | Build commands |\n| `rules` | object | No | Preset default | Coding rules |\n| `agents` | object | No | All enabled | Agent configuration |\n| `workflows` | object | No | Built-in defaults | Custom workflows |\n| `memory` | object | No | Built-in defaults | Memory settings |\n| `foundation` | object | No | Latest | Foundation version settings |\n| `overlay` | object | No | None | Overlay configuration |\n\n---\n\n### project\n\n**Required**. Project information.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `name` | string | **Yes** | - | Project name |\n| `description` | string | No | `\"\"` | Project description |\n| `language` | string | **Yes** | - | Primary language (typescript, python, go, etc.) |\n| `framework` | string | No | `\"\"` | Framework name (react, vue, django, etc.) |\n| `repository` | string | No | Git origin | Repository URL |\n\n**Examples:**\n\n```yaml\n# Minimal\nproject:\n name: \"my-api\"\n language: \"python\"\n\n# Full\nproject:\n name: \"my-fullstack-app\"\n description: \"Full-stack web application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/my-fullstack-app\"\n```\n\n---\n\n### llm\n\nLLM provider configuration for custom AI backends.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `provider` | string | No | `\"default\"` | Provider name (default, openai, anthropic, bailian, deepseek, etc.) |\n| `model` | string | No | `\"default\"` | Model name for main tasks |\n| `small_model` | string | No | Same as model | Model for simple tasks |\n| `base_url` | string | No | Provider default | Custom API endpoint |\n| `api_key_env` | string | No | - | Environment variable name for API key |\n\n**Supported Providers:**\n\n| Provider | base_url | Notes |\n|----------|----------|-------|\n| `default` | - | Uses OpenCode's default configuration |\n| `openai` | `https://api.openai.com/v1` | OpenAI GPT models |\n| `anthropic` | `https://api.anthropic.com` | Claude models |\n| `bailian` | `https://bailian.aliyuncs.com/v1` | Alibaba Bailian (百炼) |\n| `deepseek` | `https://api.deepseek.com` | DeepSeek models |\n| `moonshot` | `https://api.moonshot.cn/v1` | Moonshot (月之暗面) |\n| `zhipu` | `https://open.bigmodel.cn/api/paas/v4` | Zhipu AI (智谱) |\n\n**Examples:**\n\n```yaml\n# Use default (OpenCode handles configuration)\nllm:\n provider: \"default\"\n\n# Use Alibaba Bailian (百炼)\nllm:\n provider: \"bailian\"\n model: \"qwen-max\"\n small_model: \"qwen-turbo\"\n base_url: \"https://bailian.aliyuncs.com/v1\"\n api_key_env: \"BAILIAN_API_KEY\"\n\n# Use OpenAI\nllm:\n provider: \"openai\"\n model: \"gpt-4\"\n small_model: \"gpt-3.5-turbo\"\n\n# Use DeepSeek\nllm:\n provider: \"deepseek\"\n model: \"deepseek-chat\"\n small_model: \"deepseek-chat\"\n\n# Custom endpoint\nllm:\n provider: \"custom\"\n model: \"my-model\"\n base_url: \"https://my-api.example.com/v1\"\n api_key_env: \"CUSTOM_API_KEY\"\n```\n\n**Environment Variables:**\n\nSet your API key in environment:\n```bash\n# For Bailian\nexport BAILIAN_API_KEY=\"your-api-key\"\n\n# For OpenAI\nexport OPENAI_API_KEY=\"your-api-key\"\n\n# For DeepSeek\nexport DEEPSEEK_API_KEY=\"your-api-key\"\n```\n\nIn GitHub Actions, add to your workflow:\n```yaml\nenv:\n BAILIAN_API_KEY: ${{ secrets.BAILIAN_API_KEY }}\n```\n\n---\n\n### workflow\n\nCommit and PR workflow configuration.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `commit_mode` | string | No | `\"pr\"` | Commit mode: `\"pr\"` or `\"direct\"` |\n| `pr` | object | No | See below | PR mode settings |\n| `direct` | object | No | See below | Direct commit mode settings |\n\n#### commit_mode\n\n| Value | Description |\n|-------|-------------|\n| `\"pr\"` | Create Pull Request, wait for human review (recommended, safer) |\n| `\"direct\"` | Commit directly to branch (faster, less oversight) |\n\n#### pr settings\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `auto_merge` | boolean | No | `false` | Auto-merge PR after CI passes |\n| `require_review` | boolean | No | `true` | Require human review before merge |\n| `reviewers` | string[] | No | `[]` | Default reviewers for PRs |\n\n#### direct settings\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `require_ci_pass` | boolean | No | `true` | Require CI to pass before committing |\n\n**Examples:**\n\n```yaml\n# PR mode with human review (recommended for teams)\nworkflow:\n commit_mode: \"pr\"\n pr:\n auto_merge: false\n require_review: true\n reviewers:\n - \"team-lead\"\n - \"senior-dev\"\n\n# PR mode with auto-merge (trusted environments)\nworkflow:\n commit_mode: \"pr\"\n pr:\n auto_merge: true\n require_review: false\n\n# Direct commits (solo projects, faster iteration)\nworkflow:\n commit_mode: \"direct\"\n direct:\n require_ci_pass: true\n```\n\n**When to use each mode:**\n\n| Scenario | Recommended Mode |\n|----------|------------------|\n| Team project | `pr` with `require_review: true` |\n| Solo project | `direct` or `pr` with `auto_merge: true` |\n| Production codebase | `pr` with `require_review: true` |\n| Prototype/POC | `direct` |\n| Regulated industry | `pr` with multiple `reviewers` |\n\n---\n\n### build\n\nBuild and test commands.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `command` | string | No | Preset default | Build command |\n| `test` | string | No | Preset default | Test command |\n| `lint` | string | No | Preset default | Lint command |\n| `typecheck` | string | No | Preset default | Type check command |\n\n**Examples:**\n\n```yaml\n# TypeScript project\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\n# Python project\nbuild:\n command: \"python -m build\"\n test: \"pytest\"\n lint: \"ruff check .\"\n typecheck: \"mypy .\"\n\n# Go project\nbuild:\n command: \"go build ./...\"\n test: \"go test ./...\"\n lint: \"golangci-lint run\"\n typecheck: \"\" # Go doesn't need separate typecheck\n```\n\n---\n\n### rules\n\nCoding rules and thresholds.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `test_coverage_threshold` | number | No | `80` | Minimum test coverage % |\n| `max_function_lines` | number | No | `30` | Max lines per function |\n| `max_file_lines` | number | No | `500` | Max lines per file |\n| `commit_convention` | string | No | `\"conventional\"` | Commit message format |\n\n**Examples:**\n\n```yaml\nrules:\n test_coverage_threshold: 90\n max_function_lines: 25\n max_file_lines: 300\n commit_convention: \"conventional\" # or \"angular\", \"gitmoji\", \"none\"\n```\n\n---\n\n### agents\n\nEnable/disable agents.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `planner` | boolean | No | `true` | Enable planner agent |\n| `architect` | boolean | No | `true` | Enable architect agent |\n| `developer` | boolean | No | `true` | Enable developer agent |\n| `qa` | boolean | No | `true` | Enable QA agent |\n| `reviewer` | boolean | No | `true` | Enable reviewer agent |\n| `triage` | boolean | No | `true` | Enable triage agent |\n| `ci_analyst` | boolean | No | `true` | Enable CI analyst agent |\n\n**Examples:**\n\n```yaml\n# All enabled (default)\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\n# Minimal team\nagents:\n planner: false\n architect: true\n developer: true\n qa: true\n reviewer: false\n triage: false\n ci_analyst: false\n```\n\n---\n\n### workflows\n\nCustom workflow definitions.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `{workflow_name}` | object | No | Workflow definition |\n| `{workflow_name}.sequence` | string[] | **Yes** | Ordered list of roles |\n| `{workflow_name}.auto_merge` | boolean | No | Auto-merge PRs after completion |\n\n**Built-in Workflows:**\n\n| Name | Sequence | Description |\n|------|----------|-------------|\n| `feature` | triage → architect → developer → qa → reviewer | New feature development |\n| `bugfix` | triage → developer → qa | Bug fixes |\n| `tech-task` | triage → architect → developer → qa | Technical tasks |\n\n**Examples:**\n\n```yaml\nworkflows:\n # Override default feature workflow\n feature:\n sequence:\n - triage\n - architect\n - developer\n - developer # Second pass\n - qa\n - reviewer\n auto_merge: false\n\n # Custom quick-fix workflow\n quickfix:\n sequence:\n - developer\n - qa\n auto_merge: true\n\n # Documentation workflow\n docs:\n sequence:\n - developer\n auto_merge: true\n```\n\n---\n\n### memory\n\nMemory system settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `retention_days` | number | No | `90` | Days to keep memory entries |\n| `max_entries_per_role` | number | No | `100` | Max entries per role |\n\n**Examples:**\n\n```yaml\nmemory:\n retention_days: 30 # Shorter retention for small projects\n max_entries_per_role: 50\n```\n\n---\n\n### foundation\n\nFoundation version and source settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"latest\"` | Foundation version |\n| `registry` | string | No | `\"https://registry.npmjs.org\"` | NPM registry URL |\n| `github_repo` | string | No | Official repo | GitHub repo for fallback |\n\n**Examples:**\n\n```yaml\n# Use specific version\nfoundation:\n version: \"3.1.0\"\n\n# Use private registry\nfoundation:\n version: \"3.0.0\"\n registry: \"https://my-private-registry.com\"\n\n# Use GitHub releases\nfoundation:\n version: \"3.0.0\"\n github_repo: \"my-org/amazingteam\"\n```\n\n---\n\n### overlay\n\nOverlay configuration for custom rules and content.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `name` | string | No | Built-in overlay name |\n| `path` | string | No | Custom overlay path |\n| `content` | string | No | Inline overlay content |\n\n**Built-in Overlays:**\n\n| Name | Description |\n|------|-------------|\n| `web-fullstack` | React/Vue/Node fullstack conventions |\n| `python-backend` | Python/Django/FastAPI conventions |\n| `cpp-qt-desktop` | C++/Qt desktop application conventions |\n\n**Examples:**\n\n```yaml\n# Use built-in overlay\noverlay:\n name: \"web-fullstack\"\n\n# Use custom overlay from path\noverlay:\n path: \"./my-custom-overlay\"\n\n# Inline overlay content\noverlay:\n content: |\n ## Project-Specific Rules\n - Use functional components only\n - All API calls must have error handling\n - Use CSS modules for styling\n```\n\n---\n\n### preset\n\nQuick configuration presets.\n\n| Preset | Language | Framework | Build | Test |\n|--------|----------|-----------|-------|------|\n| `default` | Any | Any | `npm run build` | `npm test` |\n| `typescript` | TypeScript | Any | `npm run build` | `npm test` |\n| `python` | Python | Any | `python -m build` | `pytest` |\n| `go` | Go | Any | `go build ./...` | `go test ./...` |\n\n**Example:**\n\n```yaml\n# Using preset (recommended for quick setup)\npreset: \"typescript\"\n\nproject:\n name: \"my-api\"\n\n# Preset provides defaults for build, rules, etc.\n# Override as needed:\n\nbuild:\n test: \"npm run test:coverage\"\n```\n\n---\n\n## Minimal Configuration\n\nThe minimum required configuration:\n\n```yaml\nproject:\n name: \"my-project\"\n language: \"typescript\"\n```\n\nAll other fields use preset or built-in defaults.\n\n---\n\n## Configuration Merge Order\n\nConfiguration is merged in this order (later overrides earlier):\n\n1. Foundation defaults\n2. Preset defaults\n3. User configuration (`amazingteam.config.yaml`)\n4. Local overlay\n\n---\n\n## Validation\n\nValidate your configuration:\n\n```bash\nnpx amazingteam validate\n```\n\nThis checks:\n- Required fields present\n- Valid values for enums\n- Correct types for all fields\n- Valid workflow sequences\n\n---\n\n## Environment Variables\n\nOverride configuration with environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `AI_TEAM_CONFIG` | Path to config file |\n| `AI_TEAM_VERSION` | Override foundation version |\n| `AI_TEAM_REGISTRY` | Override NPM registry |\n| `AI_TEAM_DEBUG` | Enable debug logging |\n\n**Example:**\n\n```bash\nAI_TEAM_CONFIG=./custom-config.yaml npx amazingteam validate\n```"}, "e0b8810a31ef8686ae47958df2087c9f2e8853aa": {"t": 1785764795.2167377, "n": 12131, "h": "704b9ea16f389b35", "c": "# Configuration Reference\n\nThis document describes all configuration options for `amazingteam.config.yaml`.\n\n---\n\n## Configuration File Location\n\nDefault: `amazingteam.config.yaml` in project root.\n\nCustom location: Specify via CLI `--config` flag or Action input.\n\n---\n\n## Full Configuration Example\n\n```yaml\nversion: \"1.0\"\n\npreset: \"typescript\"\n\nproject:\n name: \"my-awesome-app\"\n description: \"My awesome application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/repo\"\n\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\nrules:\n test_coverage_threshold: 80\n max_function_lines: 30\n max_file_lines: 500\n commit_convention: \"conventional\"\n\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\nworkflows:\n feature:\n sequence:\n - triage\n - architect\n - developer\n - qa\n - reviewer\n auto_merge: false\n bugfix:\n sequence:\n - triage\n - developer\n - qa\n auto_merge: false\n\nmemory:\n retention_days: 90\n max_entries_per_role: 100\n\nfoundation:\n version: \"3.0.0\"\n registry: \"https://registry.npmjs.org\"\n\noverlay:\n name: \"web-fullstack\"\n content: |\n ## Custom Rules\n - Use functional components\n - Prefer hooks over class components\n```\n\n---\n\n## Configuration Fields\n\n### Top-Level Fields\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"1.0\"` | Config file schema version |\n| `preset` | string | No | `\"default\"` | Preset name (default, typescript, python, go) |\n| `project` | object | **Yes** | - | Project information |\n| `llm` | object | No | Default | LLM provider configuration |\n| `build` | object | No | Preset default | Build commands |\n| `rules` | object | No | Preset default | Coding rules |\n| `agents` | object | No | All enabled | Agent configuration |\n| `workflows` | object | No | Built-in defaults | Custom workflows |\n| `memory` | object | No | Built-in defaults | Memory settings |\n| `foundation` | object | No | Latest | Foundation version settings |\n| `overlay` | object | No | None | Overlay configuration |\n\n---\n\n### project\n\n**Required**. Project information.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `name` | string | **Yes** | - | Project name |\n| `description` | string | No | `\"\"` | Project description |\n| `language` | string | **Yes** | - | Primary language (typescript, python, go, etc.) |\n| `framework` | string | No | `\"\"` | Framework name (react, vue, django, etc.) |\n| `repository` | string | No | Git origin | Repository URL |\n\n**Examples:**\n\n```yaml\n# Minimal\nproject:\n name: \"my-api\"\n language: \"python\"\n\n# Full\nproject:\n name: \"my-fullstack-app\"\n description: \"Full-stack web application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/my-fullstack-app\"\n```\n\n---\n\n### llm\n\nLLM provider configuration for custom AI backends.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `provider` | string | No | `\"default\"` | Provider name (default, openai, anthropic, bailian, deepseek, etc.) |\n| `model` | string | No | `\"default\"` | Model name for main tasks |\n| `small_model` | string | No | Same as model | Model for simple tasks |\n| `base_url` | string | No | Provider default | Custom API endpoint |\n| `api_key_env` | string | No | - | Environment variable name for API key |\n\n**Supported Providers:**\n\n| Provider | base_url | Notes |\n|----------|----------|-------|\n| `default` | - | Uses OpenCode's default configuration |\n| `openai` | `https://api.openai.com/v1` | OpenAI GPT models |\n| `anthropic` | `https://api.anthropic.com` | Claude models |\n| `bailian` | `https://bailian.aliyuncs.com/v1` | Alibaba Bailian (百炼) |\n| `deepseek` | `https://api.deepseek.com` | DeepSeek models |\n| `moonshot` | `https://api.moonshot.cn/v1` | Moonshot (月之暗面) |\n| `zhipu` | `https://open.bigmodel.cn/api/paas/v4` | Zhipu AI (智谱) |\n\n**Examples:**\n\n```yaml\n# Use default (OpenCode handles configuration)\nllm:\n provider: \"default\"\n\n# Use Alibaba Bailian (百炼)\nllm:\n provider: \"bailian\"\n model: \"qwen-max\"\n small_model: \"qwen-turbo\"\n base_url: \"https://bailian.aliyuncs.com/v1\"\n api_key_env: \"BAILIAN_API_KEY\"\n\n# Use OpenAI\nllm:\n provider: \"openai\"\n model: \"gpt-4\"\n small_model: \"gpt-3.5-turbo\"\n\n# Use DeepSeek\nllm:\n provider: \"deepseek\"\n model: \"deepseek-chat\"\n small_model: \"deepseek-chat\"\n\n# Custom endpoint\nllm:\n provider: \"custom\"\n model: \"my-model\"\n base_url: \"https://my-api.example.com/v1\"\n api_key_env: \"CUSTOM_API_KEY\"\n```\n\n**Environment Variables:**\n\nSet your API key in environment:\n```bash\n# For Bailian\nexport BAILIAN_API_KEY=\"your-api-key\"\n\n# For OpenAI\nexport OPENAI_API_KEY=\"your-api-key\"\n\n# For DeepSeek\nexport DEEPSEEK_API_KEY=\"your-api-key\"\n```\n\nIn GitHub Actions, add to your workflow:\n```yaml\nenv:\n BAILIAN_API_KEY: ${{ secrets.BAILIAN_API_KEY }}\n```\n\n---\n\n### build\n\nBuild and test commands.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `command` | string | No | Preset default | Build command |\n| `test` | string | No | Preset default | Test command |\n| `lint` | string | No | Preset default | Lint command |\n| `typecheck` | string | No | Preset default | Type check command |\n\n**Examples:**\n\n```yaml\n# TypeScript project\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\n# Python project\nbuild:\n command: \"python -m build\"\n test: \"pytest\"\n lint: \"ruff check .\"\n typecheck: \"mypy .\"\n\n# Go project\nbuild:\n command: \"go build ./...\"\n test: \"go test ./...\"\n lint: \"golangci-lint run\"\n typecheck: \"\" # Go doesn't need separate typecheck\n```\n\n---\n\n### rules\n\nCoding rules and thresholds.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `test_coverage_threshold` | number | No | `80` | Minimum test coverage % |\n| `max_function_lines` | number | No | `30` | Max lines per function |\n| `max_file_lines` | number | No | `500` | Max lines per file |\n| `commit_convention` | string | No | `\"conventional\"` | Commit message format |\n\n**Examples:**\n\n```yaml\nrules:\n test_coverage_threshold: 90\n max_function_lines: 25\n max_file_lines: 300\n commit_convention: \"conventional\" # or \"angular\", \"gitmoji\", \"none\"\n```\n\n---\n\n### agents\n\nEnable/disable agents.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `planner` | boolean | No | `true` | Enable planner agent |\n| `architect` | boolean | No | `true` | Enable architect agent |\n| `developer` | boolean | No | `true` | Enable developer agent |\n| `qa` | boolean | No | `true` | Enable QA agent |\n| `reviewer` | boolean | No | `true` | Enable reviewer agent |\n| `triage` | boolean | No | `true` | Enable triage agent |\n| `ci_analyst` | boolean | No | `true` | Enable CI analyst agent |\n\n**Examples:**\n\n```yaml\n# All enabled (default)\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\n# Minimal team\nagents:\n planner: false\n architect: true\n developer: true\n qa: true\n reviewer: false\n triage: false\n ci_analyst: false\n```\n\n---\n\n### workflows\n\nCustom workflow definitions.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `{workflow_name}` | object | No | Workflow definition |\n| `{workflow_name}.sequence` | string[] | **Yes** | Ordered list of roles |\n| `{workflow_name}.auto_merge` | boolean | No | Auto-merge PRs after completion |\n\n**Built-in Workflows:**\n\n| Name | Sequence | Description |\n|------|----------|-------------|\n| `feature` | triage → architect → developer → qa → reviewer | New feature development |\n| `bugfix` | triage → developer → qa | Bug fixes |\n| `tech-task` | triage → architect → developer → qa | Technical tasks |\n\n**Examples:**\n\n```yaml\nworkflows:\n # Override default feature workflow\n feature:\n sequence:\n - triage\n - architect\n - developer\n - developer # Second pass\n - qa\n - reviewer\n auto_merge: false\n\n # Custom quick-fix workflow\n quickfix:\n sequence:\n - developer\n - qa\n auto_merge: true\n\n # Documentation workflow\n docs:\n sequence:\n - developer\n auto_merge: true\n```\n\n---\n\n### memory\n\nMemory system settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `retention_days` | number | No | `90` | Days to keep memory entries |\n| `max_entries_per_role` | number | No | `100` | Max entries per role |\n\n**Examples:**\n\n```yaml\nmemory:\n retention_days: 30 # Shorter retention for small projects\n max_entries_per_role: 50\n```\n\n---\n\n### foundation\n\nFoundation version and source settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"latest\"` | Foundation version |\n| `registry` | string | No | `\"https://registry.npmjs.org\"` | NPM registry URL |\n| `github_repo` | string | No | Official repo | GitHub repo for fallback |\n\n**Examples:**\n\n```yaml\n# Use specific version\nfoundation:\n version: \"3.1.0\"\n\n# Use private registry\nfoundation:\n version: \"3.0.0\"\n registry: \"https://my-private-registry.com\"\n\n# Use GitHub releases\nfoundation:\n version: \"3.0.0\"\n github_repo: \"my-org/amazingteam\"\n```\n\n---\n\n### overlay\n\nOverlay configuration for custom rules and content.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `name` | string | No | Built-in overlay name |\n| `path` | string | No | Custom overlay path |\n| `content` | string | No | Inline overlay content |\n\n**Built-in Overlays:**\n\n| Name | Description |\n|------|-------------|\n| `web-fullstack` | React/Vue/Node fullstack conventions |\n| `python-backend` | Python/Django/FastAPI conventions |\n| `cpp-qt-desktop` | C++/Qt desktop application conventions |\n\n**Examples:**\n\n```yaml\n# Use built-in overlay\noverlay:\n name: \"web-fullstack\"\n\n# Use custom overlay from path\noverlay:\n path: \"./my-custom-overlay\"\n\n# Inline overlay content\noverlay:\n content: |\n ## Project-Specific Rules\n - Use functional components only\n - All API calls must have error handling\n - Use CSS modules for styling\n```\n\n---\n\n### preset\n\nQuick configuration presets.\n\n| Preset | Language | Framework | Build | Test |\n|--------|----------|-----------|-------|------|\n| `default` | Any | Any | `npm run build` | `npm test` |\n| `typescript` | TypeScript | Any | `npm run build` | `npm test` |\n| `python` | Python | Any | `python -m build` | `pytest` |\n| `go` | Go | Any | `go build ./...` | `go test ./...` |\n\n**Example:**\n\n```yaml\n# Using preset (recommended for quick setup)\npreset: \"typescript\"\n\nproject:\n name: \"my-api\"\n\n# Preset provides defaults for build, rules, etc.\n# Override as needed:\n\nbuild:\n test: \"npm run test:coverage\"\n```\n\n---\n\n## Minimal Configuration\n\nThe minimum required configuration:\n\n```yaml\nproject:\n name: \"my-project\"\n language: \"typescript\"\n```\n\nAll other fields use preset or built-in defaults.\n\n---\n\n## Configuration Merge Order\n\nConfiguration is merged in this order (later overrides earlier):\n\n1. Foundation defaults\n2. Preset defaults\n3. User configuration (`amazingteam.config.yaml`)\n4. Local overlay\n\n---\n\n## Validation\n\nValidate your configuration:\n\n```bash\nnpx amazingteam validate\n```\n\nThis checks:\n- Required fields present\n- Valid values for enums\n- Correct types for all fields\n- Valid workflow sequences\n\n---\n\n## Environment Variables\n\nOverride configuration with environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `AI_TEAM_CONFIG` | Path to config file |\n| `AI_TEAM_VERSION` | Override foundation version |\n| `AI_TEAM_REGISTRY` | Override NPM registry |\n| `AI_TEAM_DEBUG` | Enable debug logging |\n\n**Example:**\n\n```bash\nAI_TEAM_CONFIG=./custom-config.yaml npx amazingteam validate\n```"}, "837c2376ccb5ae7d2eaefbecf38413c7c2388f6d": {"t": 1785764796.853102, "n": 10001, "h": "76486c7bd59f0cf5", "c": "# Configuration Reference\n\nThis document describes all configuration options for `amazingteam.config.yaml`.\n\n---\n\n## Configuration File Location\n\nDefault: `amazingteam.config.yaml` in project root.\n\nCustom location: Specify via CLI `--config` flag or Action input.\n\n---\n\n## Full Configuration Example\n\n```yaml\nversion: \"1.0\"\n\npreset: \"typescript\"\n\nproject:\n name: \"my-awesome-app\"\n description: \"My awesome application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/repo\"\n\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\nrules:\n test_coverage_threshold: 80\n max_function_lines: 30\n max_file_lines: 500\n commit_convention: \"conventional\"\n\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\nworkflows:\n feature:\n sequence:\n - triage\n - architect\n - developer\n - qa\n - reviewer\n auto_merge: false\n bugfix:\n sequence:\n - triage\n - developer\n - qa\n auto_merge: false\n\nmemory:\n retention_days: 90\n max_entries_per_role: 100\n\nfoundation:\n version: \"3.0.0\"\n registry: \"https://registry.npmjs.org\"\n\noverlay:\n name: \"web-fullstack\"\n content: |\n ## Custom Rules\n - Use functional components\n - Prefer hooks over class components\n```\n\n---\n\n## Configuration Fields\n\n### Top-Level Fields\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"1.0\"` | Config file schema version |\n| `preset` | string | No | `\"default\"` | Preset name (default, typescript, python, go) |\n| `project` | object | **Yes** | - | Project information |\n| `build` | object | No | Preset default | Build commands |\n| `rules` | object | No | Preset default | Coding rules |\n| `agents` | object | No | All enabled | Agent configuration |\n| `workflows` | object | No | Built-in defaults | Custom workflows |\n| `memory` | object | No | Built-in defaults | Memory settings |\n| `foundation` | object | No | Latest | Foundation version settings |\n| `overlay` | object | No | None | Overlay configuration |\n\n---\n\n### project\n\n**Required**. Project information.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `name` | string | **Yes** | - | Project name |\n| `description` | string | No | `\"\"` | Project description |\n| `language` | string | **Yes** | - | Primary language (typescript, python, go, etc.) |\n| `framework` | string | No | `\"\"` | Framework name (react, vue, django, etc.) |\n| `repository` | string | No | Git origin | Repository URL |\n\n**Examples:**\n\n```yaml\n# Minimal\nproject:\n name: \"my-api\"\n language: \"python\"\n\n# Full\nproject:\n name: \"my-fullstack-app\"\n description: \"Full-stack web application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/my-fullstack-app\"\n```\n\n---\n\n### build\n\nBuild and test commands.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `command` | string | No | Preset default | Build command |\n| `test` | string | No | Preset default | Test command |\n| `lint` | string | No | Preset default | Lint command |\n| `typecheck` | string | No | Preset default | Type check command |\n\n**Examples:**\n\n```yaml\n# TypeScript project\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\n# Python project\nbuild:\n command: \"python -m build\"\n test: \"pytest\"\n lint: \"ruff check .\"\n typecheck: \"mypy .\"\n\n# Go project\nbuild:\n command: \"go build ./...\"\n test: \"go test ./...\"\n lint: \"golangci-lint run\"\n typecheck: \"\" # Go doesn't need separate typecheck\n```\n\n---\n\n### rules\n\nCoding rules and thresholds.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `test_coverage_threshold` | number | No | `80` | Minimum test coverage % |\n| `max_function_lines` | number | No | `30` | Max lines per function |\n| `max_file_lines` | number | No | `500` | Max lines per file |\n| `commit_convention` | string | No | `\"conventional\"` | Commit message format |\n\n**Examples:**\n\n```yaml\nrules:\n test_coverage_threshold: 90\n max_function_lines: 25\n max_file_lines: 300\n commit_convention: \"conventional\" # or \"angular\", \"gitmoji\", \"none\"\n```\n\n---\n\n### agents\n\nEnable/disable agents.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `planner` | boolean | No | `true` | Enable planner agent |\n| `architect` | boolean | No | `true` | Enable architect agent |\n| `developer` | boolean | No | `true` | Enable developer agent |\n| `qa` | boolean | No | `true` | Enable QA agent |\n| `reviewer` | boolean | No | `true` | Enable reviewer agent |\n| `triage` | boolean | No | `true` | Enable triage agent |\n| `ci_analyst` | boolean | No | `true` | Enable CI analyst agent |\n\n**Examples:**\n\n```yaml\n# All enabled (default)\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\n# Minimal team\nagents:\n planner: false\n architect: true\n developer: true\n qa: true\n reviewer: false\n triage: false\n ci_analyst: false\n```\n\n---\n\n### workflows\n\nCustom workflow definitions.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `{workflow_name}` | object | No | Workflow definition |\n| `{workflow_name}.sequence` | string[] | **Yes** | Ordered list of roles |\n| `{workflow_name}.auto_merge` | boolean | No | Auto-merge PRs after completion |\n\n**Built-in Workflows:**\n\n| Name | Sequence | Description |\n|------|----------|-------------|\n| `feature` | triage → architect → developer → qa → reviewer | New feature development |\n| `bugfix` | triage → developer → qa | Bug fixes |\n| `tech-task` | triage → architect → developer → qa | Technical tasks |\n\n**Examples:**\n\n```yaml\nworkflows:\n # Override default feature workflow\n feature:\n sequence:\n - triage\n - architect\n - developer\n - developer # Second pass\n - qa\n - reviewer\n auto_merge: false\n\n # Custom quick-fix workflow\n quickfix:\n sequence:\n - developer\n - qa\n auto_merge: true\n\n # Documentation workflow\n docs:\n sequence:\n - developer\n auto_merge: true\n```\n\n---\n\n### memory\n\nMemory system settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `retention_days` | number | No | `90` | Days to keep memory entries |\n| `max_entries_per_role` | number | No | `100` | Max entries per role |\n\n**Examples:**\n\n```yaml\nmemory:\n retention_days: 30 # Shorter retention for small projects\n max_entries_per_role: 50\n```\n\n---\n\n### foundation\n\nFoundation version and source settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"latest\"` | Foundation version |\n| `registry` | string | No | `\"https://registry.npmjs.org\"` | NPM registry URL |\n| `github_repo` | string | No | Official repo | GitHub repo for fallback |\n\n**Examples:**\n\n```yaml\n# Use specific version\nfoundation:\n version: \"3.1.0\"\n\n# Use private registry\nfoundation:\n version: \"3.0.0\"\n registry: \"https://my-private-registry.com\"\n\n# Use GitHub releases\nfoundation:\n version: \"3.0.0\"\n github_repo: \"my-org/amazingteam\"\n```\n\n---\n\n### overlay\n\nOverlay configuration for custom rules and content.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `name` | string | No | Built-in overlay name |\n| `path` | string | No | Custom overlay path |\n| `content` | string | No | Inline overlay content |\n\n**Built-in Overlays:**\n\n| Name | Description |\n|------|-------------|\n| `web-fullstack` | React/Vue/Node fullstack conventions |\n| `python-backend` | Python/Django/FastAPI conventions |\n| `cpp-qt-desktop` | C++/Qt desktop application conventions |\n\n**Examples:**\n\n```yaml\n# Use built-in overlay\noverlay:\n name: \"web-fullstack\"\n\n# Use custom overlay from path\noverlay:\n path: \"./my-custom-overlay\"\n\n# Inline overlay content\noverlay:\n content: |\n ## Project-Specific Rules\n - Use functional components only\n - All API calls must have error handling\n - Use CSS modules for styling\n```\n\n---\n\n### preset\n\nQuick configuration presets.\n\n| Preset | Language | Framework | Build | Test |\n|--------|----------|-----------|-------|------|\n| `default` | Any | Any | `npm run build` | `npm test` |\n| `typescript` | TypeScript | Any | `npm run build` | `npm test` |\n| `python` | Python | Any | `python -m build` | `pytest` |\n| `go` | Go | Any | `go build ./...` | `go test ./...` |\n\n**Example:**\n\n```yaml\n# Using preset (recommended for quick setup)\npreset: \"typescript\"\n\nproject:\n name: \"my-api\"\n\n# Preset provides defaults for build, rules, etc.\n# Override as needed:\n\nbuild:\n test: \"npm run test:coverage\"\n```\n\n---\n\n## Minimal Configuration\n\nThe minimum required configuration:\n\n```yaml\nproject:\n name: \"my-project\"\n language: \"typescript\"\n```\n\nAll other fields use preset or built-in defaults.\n\n---\n\n## Configuration Merge Order\n\nConfiguration is merged in this order (later overrides earlier):\n\n1. Foundation defaults\n2. Preset defaults\n3. User configuration (`amazingteam.config.yaml`)\n4. Local overlay\n\n---\n\n## Validation\n\nValidate your configuration:\n\n```bash\nnpx amazingteam validate\n```\n\nThis checks:\n- Required fields present\n- Valid values for enums\n- Correct types for all fields\n- Valid workflow sequences\n\n---\n\n## Environment Variables\n\nOverride configuration with environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `AI_TEAM_CONFIG` | Path to config file |\n| `AI_TEAM_VERSION` | Override foundation version |\n| `AI_TEAM_REGISTRY` | Override NPM registry |\n| `AI_TEAM_DEBUG` | Enable debug logging |\n\n**Example:**\n\n```bash\nAI_TEAM_CONFIG=./custom-config.yaml npx amazingteam validate\n```"}, "79d474b4fe567a76dac7ae831ab61feb1d44e8a8": {"t": 1785764798.7191978, "n": 10010, "h": "bb8326dbdca51b42", "c": "# Configuration Reference\n\nThis document describes all configuration options for `ai-team.config.yaml`.\n\n---\n\n## Configuration File Location\n\nDefault: `ai-team.config.yaml` in project root.\n\nCustom location: Specify via CLI `--config` flag or Action input.\n\n---\n\n## Full Configuration Example\n\n```yaml\nversion: \"1.0\"\n\npreset: \"typescript\"\n\nproject:\n name: \"my-awesome-app\"\n description: \"My awesome application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/repo\"\n\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\nrules:\n test_coverage_threshold: 80\n max_function_lines: 30\n max_file_lines: 500\n commit_convention: \"conventional\"\n\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\nworkflows:\n feature:\n sequence:\n - triage\n - architect\n - developer\n - qa\n - reviewer\n auto_merge: false\n bugfix:\n sequence:\n - triage\n - developer\n - qa\n auto_merge: false\n\nmemory:\n retention_days: 90\n max_entries_per_role: 100\n\nfoundation:\n version: \"3.0.0\"\n registry: \"https://registry.npmjs.org\"\n\noverlay:\n name: \"web-fullstack\"\n content: |\n ## Custom Rules\n - Use functional components\n - Prefer hooks over class components\n```\n\n---\n\n## Configuration Fields\n\n### Top-Level Fields\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"1.0\"` | Config file schema version |\n| `preset` | string | No | `\"default\"` | Preset name (default, typescript, python, go) |\n| `project` | object | **Yes** | - | Project information |\n| `build` | object | No | Preset default | Build commands |\n| `rules` | object | No | Preset default | Coding rules |\n| `agents` | object | No | All enabled | Agent configuration |\n| `workflows` | object | No | Built-in defaults | Custom workflows |\n| `memory` | object | No | Built-in defaults | Memory settings |\n| `foundation` | object | No | Latest | Foundation version settings |\n| `overlay` | object | No | None | Overlay configuration |\n\n---\n\n### project\n\n**Required**. Project information.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `name` | string | **Yes** | - | Project name |\n| `description` | string | No | `\"\"` | Project description |\n| `language` | string | **Yes** | - | Primary language (typescript, python, go, etc.) |\n| `framework` | string | No | `\"\"` | Framework name (react, vue, django, etc.) |\n| `repository` | string | No | Git origin | Repository URL |\n\n**Examples:**\n\n```yaml\n# Minimal\nproject:\n name: \"my-api\"\n language: \"python\"\n\n# Full\nproject:\n name: \"my-fullstack-app\"\n description: \"Full-stack web application\"\n language: \"typescript\"\n framework: \"react\"\n repository: \"https://github.com/org/my-fullstack-app\"\n```\n\n---\n\n### build\n\nBuild and test commands.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `command` | string | No | Preset default | Build command |\n| `test` | string | No | Preset default | Test command |\n| `lint` | string | No | Preset default | Lint command |\n| `typecheck` | string | No | Preset default | Type check command |\n\n**Examples:**\n\n```yaml\n# TypeScript project\nbuild:\n command: \"npm run build\"\n test: \"npm test\"\n lint: \"npm run lint\"\n typecheck: \"npm run typecheck\"\n\n# Python project\nbuild:\n command: \"python -m build\"\n test: \"pytest\"\n lint: \"ruff check .\"\n typecheck: \"mypy .\"\n\n# Go project\nbuild:\n command: \"go build ./...\"\n test: \"go test ./...\"\n lint: \"golangci-lint run\"\n typecheck: \"\" # Go doesn't need separate typecheck\n```\n\n---\n\n### rules\n\nCoding rules and thresholds.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `test_coverage_threshold` | number | No | `80` | Minimum test coverage % |\n| `max_function_lines` | number | No | `30` | Max lines per function |\n| `max_file_lines` | number | No | `500` | Max lines per file |\n| `commit_convention` | string | No | `\"conventional\"` | Commit message format |\n\n**Examples:**\n\n```yaml\nrules:\n test_coverage_threshold: 90\n max_function_lines: 25\n max_file_lines: 300\n commit_convention: \"conventional\" # or \"angular\", \"gitmoji\", \"none\"\n```\n\n---\n\n### agents\n\nEnable/disable agents.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `planner` | boolean | No | `true` | Enable planner agent |\n| `architect` | boolean | No | `true` | Enable architect agent |\n| `developer` | boolean | No | `true` | Enable developer agent |\n| `qa` | boolean | No | `true` | Enable QA agent |\n| `reviewer` | boolean | No | `true` | Enable reviewer agent |\n| `triage` | boolean | No | `true` | Enable triage agent |\n| `ci_analyst` | boolean | No | `true` | Enable CI analyst agent |\n\n**Examples:**\n\n```yaml\n# All enabled (default)\nagents:\n planner: true\n architect: true\n developer: true\n qa: true\n reviewer: true\n triage: true\n ci_analyst: true\n\n# Minimal team\nagents:\n planner: false\n architect: true\n developer: true\n qa: true\n reviewer: false\n triage: false\n ci_analyst: false\n```\n\n---\n\n### workflows\n\nCustom workflow definitions.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `{workflow_name}` | object | No | Workflow definition |\n| `{workflow_name}.sequence` | string[] | **Yes** | Ordered list of roles |\n| `{workflow_name}.auto_merge` | boolean | No | Auto-merge PRs after completion |\n\n**Built-in Workflows:**\n\n| Name | Sequence | Description |\n|------|----------|-------------|\n| `feature` | triage → architect → developer → qa → reviewer | New feature development |\n| `bugfix` | triage → developer → qa | Bug fixes |\n| `tech-task` | triage → architect → developer → qa | Technical tasks |\n\n**Examples:**\n\n```yaml\nworkflows:\n # Override default feature workflow\n feature:\n sequence:\n - triage\n - architect\n - developer\n - developer # Second pass\n - qa\n - reviewer\n auto_merge: false\n\n # Custom quick-fix workflow\n quickfix:\n sequence:\n - developer\n - qa\n auto_merge: true\n\n # Documentation workflow\n docs:\n sequence:\n - developer\n auto_merge: true\n```\n\n---\n\n### memory\n\nMemory system settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `retention_days` | number | No | `90` | Days to keep memory entries |\n| `max_entries_per_role` | number | No | `100` | Max entries per role |\n\n**Examples:**\n\n```yaml\nmemory:\n retention_days: 30 # Shorter retention for small projects\n max_entries_per_role: 50\n```\n\n---\n\n### foundation\n\nFoundation version and source settings.\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `version` | string | No | `\"latest\"` | Foundation version |\n| `registry` | string | No | `\"https://registry.npmjs.org\"` | NPM registry URL |\n| `github_repo` | string | No | Official repo | GitHub repo for fallback |\n\n**Examples:**\n\n```yaml\n# Use specific version\nfoundation:\n version: \"3.1.0\"\n\n# Use private registry\nfoundation:\n version: \"3.0.0\"\n registry: \"https://my-private-registry.com\"\n\n# Use GitHub releases\nfoundation:\n version: \"3.0.0\"\n github_repo: \"my-org/ai-team-foundation\"\n```\n\n---\n\n### overlay\n\nOverlay configuration for custom rules and content.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `name` | string | No | Built-in overlay name |\n| `path` | string | No | Custom overlay path |\n| `content` | string | No | Inline overlay content |\n\n**Built-in Overlays:**\n\n| Name | Description |\n|------|-------------|\n| `web-fullstack` | React/Vue/Node fullstack conventions |\n| `python-backend` | Python/Django/FastAPI conventions |\n| `cpp-qt-desktop` | C++/Qt desktop application conventions |\n\n**Examples:**\n\n```yaml\n# Use built-in overlay\noverlay:\n name: \"web-fullstack\"\n\n# Use custom overlay from path\noverlay:\n path: \"./my-custom-overlay\"\n\n# Inline overlay content\noverlay:\n content: |\n ## Project-Specific Rules\n - Use functional components only\n - All API calls must have error handling\n - Use CSS modules for styling\n```\n\n---\n\n### preset\n\nQuick configuration presets.\n\n| Preset | Language | Framework | Build | Test |\n|--------|----------|-----------|-------|------|\n| `default` | Any | Any | `npm run build` | `npm test` |\n| `typescript` | TypeScript | Any | `npm run build` | `npm test` |\n| `python` | Python | Any | `python -m build` | `pytest` |\n| `go` | Go | Any | `go build ./...` | `go test ./...` |\n\n**Example:**\n\n```yaml\n# Using preset (recommended for quick setup)\npreset: \"typescript\"\n\nproject:\n name: \"my-api\"\n\n# Preset provides defaults for build, rules, etc.\n# Override as needed:\n\nbuild:\n test: \"npm run test:coverage\"\n```\n\n---\n\n## Minimal Configuration\n\nThe minimum required configuration:\n\n```yaml\nproject:\n name: \"my-project\"\n language: \"typescript\"\n```\n\nAll other fields use preset or built-in defaults.\n\n---\n\n## Configuration Merge Order\n\nConfiguration is merged in this order (later overrides earlier):\n\n1. Foundation defaults\n2. Preset defaults\n3. User configuration (`ai-team.config.yaml`)\n4. Local overlay\n\n---\n\n## Validation\n\nValidate your configuration:\n\n```bash\nnpx ai-team-foundation validate\n```\n\nThis checks:\n- Required fields present\n- Valid values for enums\n- Correct types for all fields\n- Valid workflow sequences\n\n---\n\n## Environment Variables\n\nOverride configuration with environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `AI_TEAM_CONFIG` | Path to config file |\n| `AI_TEAM_VERSION` | Override foundation version |\n| `AI_TEAM_REGISTRY` | Override NPM registry |\n| `AI_TEAM_DEBUG` | Enable debug logging |\n\n**Example:**\n\n```bash\nAI_TEAM_CONFIG=./custom-config.yaml npx ai-team-foundation validate\n```"}}}} |