version: 1 agents: order: - architect - auditor - debugger - documenter - researcher - reviewer - worker items: architect: id: architect name: architect description: Research-first planning agent. Handles triage, research coordination, architecture design, and wave decomposition. Use before any non-trivial implementation task. Produces the implementation blueprint the entire team follows. model: opus effort: max permission_mode: plan tools: - Read - Glob - Grep - WebFetch - WebSearch - Bash - Write disallowed_tools: [] max_turns: 35 skills: - conventions - message-schema instruction_file: agents/architect.md auditor: id: auditor name: auditor description: Use after implementation — audits for security vulnerabilities and validates runtime behavior. Builds, tests, and probes acceptance criteria. Never modifies code. model: sonnet effort: "" permission_mode: "" tools: - Read - Glob - Grep - Bash - WebFetch - WebSearch disallowed_tools: - Write - Edit max_turns: 25 skills: - conventions - message-schema - qa-checklist background: true instruction_file: agents/auditor.md debugger: id: debugger name: debugger description: Use immediately when encountering a bug, error, or unexpected behavior. Diagnoses root cause and applies a minimal targeted fix. Does not refactor or improve surrounding code. model: sonnet effort: "" permission_mode: acceptEdits tools: - Read - Write - Edit - Glob - Grep - Bash disallowed_tools: [] max_turns: 20 skills: - conventions - worker-protocol - message-schema - qa-checklist instruction_file: agents/debugger.md documenter: id: documenter name: documenter description: Use when asked to write or update documentation — READMEs, API references, architecture overviews, inline doc comments, or changelogs. Reads code first, writes accurate docs. Never modifies source code. model: sonnet effort: high permission_mode: "" tools: - Read - Write - Edit - Glob - Grep - Bash disallowed_tools: [] max_turns: 20 skills: - conventions - worker-protocol - message-schema - qa-checklist memory: project instruction_file: agents/documenter.md researcher: id: researcher name: researcher description: Use to answer a specific research question with verified facts. Spawned in parallel — one instance per topic. Stateless. Returns verified facts, source URLs, and gotchas. model: sonnet effort: "" permission_mode: plan tools: - Read - Glob - Grep - Bash - WebFetch - WebSearch disallowed_tools: - Write - Edit max_turns: 10 skills: - message-schema instruction_file: agents/researcher.md reviewer: id: reviewer name: reviewer description: Use after implementation — reviews code quality and verifies claims against source, docs, and acceptance criteria. Never modifies code. model: sonnet effort: "" permission_mode: plan tools: - Read - Glob - Grep - Bash - WebFetch - WebSearch disallowed_tools: - Write - Edit max_turns: 20 skills: - conventions - message-schema - qa-checklist instruction_file: agents/reviewer.md worker: id: worker name: worker description: Universal implementer. Handles all task tiers — trivial to architectural. Model is scaled by the orchestrator based on task complexity (haiku for trivial, sonnet for standard, opus for architectural/ambiguous). Default implementer for all implementation work. model: sonnet effort: "" permission_mode: acceptEdits tools: - Read - Write - Edit - Glob - Grep - Bash disallowed_tools: [] max_turns: 25 skills: - conventions - worker-protocol - message-schema - qa-checklist isolation: worktree instruction_file: agents/worker.md skills: order: - conventions - message-schema - orchestrate - qa-checklist - worker-protocol items: conventions: id: conventions name: conventions description: Core coding conventions and quality priorities for all projects. instruction_file: skills/conventions/SKILL.md applies_to: - claude - codex install_mode: shared message-schema: id: message-schema name: message-schema description: Typed envelope schema for all inter-agent communication. Defines message types, required fields, and signal routing contracts. instruction_file: skills/message-schema/SKILL.md applies_to: - claude - codex install_mode: shared orchestrate: id: orchestrate name: orchestrate description: Orchestration framework for decomposing and delegating complex tasks to the agent team. Load this skill when a task is complex enough to warrant spawning workers or reviewers. Covers task tiers, planning pipeline, wave dispatch, review, and git flow. instruction_file: skills/orchestrate/SKILL.md applies_to: - claude - codex install_mode: shared qa-checklist: id: qa-checklist name: qa-checklist description: Self-validation checklist. All workers run this against their own output before returning results. instruction_file: skills/qa-checklist/SKILL.md applies_to: - claude - codex install_mode: shared worker-protocol: id: worker-protocol name: worker-protocol description: Standard output format, feedback handling, and operational procedures for all worker agents. instruction_file: skills/worker-protocol/SKILL.md applies_to: - claude - codex install_mode: shared rules: order: - 01-session - 02-responses - 03-git - 04-tools - 05-verification - 06-nix - 07-research items: 01-session: id: 01-session source_file: rules/01-session.md applies_to: - claude - codex 02-responses: id: 02-responses source_file: rules/02-responses.md applies_to: - claude - codex 03-git: id: 03-git source_file: rules/03-git.md applies_to: - claude - codex 04-tools: id: 04-tools source_file: rules/04-tools.md applies_to: - claude - codex 05-verification: id: 05-verification source_file: rules/05-verification.md applies_to: - claude - codex 06-nix: id: 06-nix source_file: rules/06-nix.md applies_to: - claude - codex 07-research: id: 07-research source_file: rules/07-research.md applies_to: - claude - codex