# Agents

This directory contains AI agent definitions generated by `@vpxa/kb init`.

## Agent Roster

| Agent | Purpose | Model | Category |
|-------|---------|-------|----------|
| **Orchestrator** | Master conductor that orchestrates the full development lifecycle: Planning → Implementation → Review → Recovery → Commit | Claude Opus 4.6 | orchestration |
| **Planner** | Autonomous planner that researches codebases and writes comprehensive TDD implementation plans | Claude Opus 4.6 | orchestration |
| **Implementer** | Persistent implementation agent that writes code following TDD practices until all tasks are complete | GPT-5.4 | implementation |
| **Frontend** | UI/UX specialist for React, styling, responsive design, and frontend implementation | Gemini 3.1 Pro (Preview) | implementation |
| **Refactor** | Code refactoring specialist that improves structure, readability, and maintainability | GPT-5.4 | implementation |
| **Debugger** | Expert debugger that diagnoses issues, traces errors, and provides solutions | Claude Opus 4.6 | diagnostics |
| **Security** | Security specialist that analyzes code for vulnerabilities and compliance | Claude Opus 4.6 | diagnostics |
| **Documenter** | Documentation specialist that creates and maintains comprehensive project documentation | GPT-5.4 | documentation |
| **Explorer** | Rapid codebase exploration to find files, usages, dependencies, and structural context | Gemini 3 Flash (Preview) | exploration |
| **Researcher-Alpha** | Primary deep research agent — also serves as default Researcher | Claude Opus 4.6 | research |
| **Researcher-Beta** | Research variant for multi-model decision protocol — different LLM perspective | Claude Sonnet 4.6 | research |
| **Researcher-Gamma** | Research variant for multi-model decision protocol — different LLM perspective | GPT-5.4 | research |
| **Researcher-Delta** | Research variant for multi-model decision protocol — different LLM perspective | Gemini 3.1 Pro (Preview) | research |
| **Code-Reviewer-Alpha** | Primary code reviewer | GPT-5.4 | review |
| **Code-Reviewer-Beta** | Code reviewer variant — different LLM perspective for dual review | Claude Opus 4.6 | review |
| **Architect-Reviewer-Alpha** | Primary architecture reviewer | GPT-5.4 | review |
| **Architect-Reviewer-Beta** | Architecture reviewer variant — different LLM perspective for dual review | Claude Opus 4.6 | review |

## Multi-Model Pattern

Variant agents (Researcher-Alpha/Beta/Gamma/Delta, Code-Reviewer-Alpha/Beta, Architect-Reviewer-Alpha/Beta) share the same methodology via files in `_shared/`. They differ only in which LLM model backs them — enabling multi-model decision analysis and dual-review workflows.

**Agent names are model-agnostic.** The model behind Alpha/Beta/Gamma/Delta can be changed in `scaffold/definitions/models.mjs` without renaming any agent files.

## Structure

```
agents/
  {Name}.agent.md          — Agent definition (YAML frontmatter + instructions)
  _shared/                  — Shared protocols referenced by multiple agents
    code-agent-base.md      — Base for all code-modifying agents
    researcher-base.md      — Base for all Researcher variants
    code-reviewer-base.md   — Base for all Code-Reviewer variants
    architect-reviewer-base.md — Base for all Architect-Reviewer variants
    decision-protocol.md    — Multi-model decision protocol rules
    forge-protocol.md       — FORGE quality gate protocol
  templates/
    execution-state.md      — Orchestrator state tracking template
    adr-template.md         — Architecture Decision Record template
```

## Regenerating

To regenerate after changing models or agent definitions:

```bash
cd knowledge-base
node scaffold/generate.mjs
```
