agent-team/TEAM.yaml

version: 1

agents:
  order:
    - architect
    - auditor
    - debugger
    - documenter
    - grunt
    - researcher
    - reviewer
    - senior
    - 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
        - Write
      disallowed_tools:
        - Edit
      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: acceptEdits
      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 and updates documentation artifacts only.
      model: sonnet
      effort: high
      permission_mode: acceptEdits
      tools:
        - Read
        - Write
        - Edit
        - Glob
        - Grep
      disallowed_tools: []
      max_turns: 20
      skills:
        - conventions
        - worker-protocol
        - message-schema
        - qa-checklist
      memory: project
      instruction_file: agents/documenter.md
    grunt:
      id: grunt
      name: grunt
      description: Fast, cheap implementer for trivial and tightly scoped work. Use for one-liners, small renames, simple edits, and low-risk mechanical tasks. Escalate when the work grows beyond that scope.
      model: haiku
      effort: ""
      permission_mode: acceptEdits
      tools:
        - Read
        - Write
        - Edit
        - Glob
        - Grep
        - Bash
      disallowed_tools: []
      max_turns: 15
      skills:
        - conventions
        - worker-protocol
        - message-schema
        - qa-checklist
      isolation: worktree
      instruction_file: agents/grunt.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
        - 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
        - WebFetch
        - WebSearch
      disallowed_tools:
        - Write
        - Edit
      max_turns: 20
      skills:
        - conventions
        - message-schema
        - qa-checklist
      instruction_file: agents/reviewer.md
    senior:
      id: senior
      name: senior
      description: Strong implementer for ambiguous, architectural, or high-risk work. Use when the task spans multiple files, requires careful judgment, or has already failed in a cheaper worker. Default escalation path for hard implementation work.
      model: opus
      effort: ""
      permission_mode: acceptEdits
      tools:
        - Read
        - Write
        - Edit
        - Glob
        - Grep
        - Bash
      disallowed_tools: []
      max_turns: 35
      skills:
        - conventions
        - worker-protocol
        - message-schema
        - qa-checklist
      isolation: worktree
      instruction_file: agents/senior.md
    worker:
      id: worker
      name: worker
      description: Balanced implementer for standard development work. Use when the task is well-defined but not trivial. Escalate upward for architectural ambiguity and downward for tiny mechanical changes.
      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
        - opencode
      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
        - opencode
      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
        - opencode
      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
        - opencode
      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
        - opencode
      install_mode: shared

rules:
  order:
    - 01-session
    - 02-responses
    - 03-git
    - 04-tools
    - 05-verification
    - 07-research
  items:
    01-session:
      id: 01-session
      source_file: rules/01-session.md
      applies_to:
        - claude
        - codex
        - opencode
    02-responses:
      id: 02-responses
      source_file: rules/02-responses.md
      applies_to:
        - claude
        - codex
        - opencode
    03-git:
      id: 03-git
      source_file: rules/03-git.md
      applies_to:
        - claude
        - codex
        - opencode
    04-tools:
      id: 04-tools
      source_file: rules/04-tools.md
      applies_to:
        - claude
        - codex
        - opencode
    05-verification:
      id: 05-verification
      source_file: rules/05-verification.md
      applies_to:
        - claude
        - codex
        - opencode
    07-research:
      id: 07-research
      source_file: rules/07-research.md
      applies_to:
        - claude
        - codex
        - opencode