Seven Specialized Agents

April 13, 2026 ยท View on GitHub

AgentRoleMin ModelKey Constraint
forge-speccerWrites R-numbered specs with testable criteriasonnetOne question at a time, capability-aware criteria
forge-plannerDecomposes specs into streaming DAGssonnetCoverage verification, no gold-plating
forge-executorImplements tasks with TDD + convention inferencehaikuWorktree + checkpoints, follow existing patterns
forge-researcherMulti-source research before implementationhaikuProduces reports only, never writes code
forge-reviewerTwo-pass review: spec compliance + blast radiussonnetCaveman for minor, verbose for security
forge-verifierFour-level goal-backward verificationsonnetCaveman for pass, verbose for gaps
forge-complexityScores task difficulty across 5 dimensionshaikuLightweight, runs on every command startup

The separation between agents is deliberate. The reviewer has fresh context and no implementation bias. The verifier never sees execution details, only checks outcomes against the spec.

Cross-Cutting Skills (v0.2.0)

Three skills are inlined into agent definitions and run automatically. No manual invocation required.

SkillUsed ByBehavior
karpathy-guardrailsexecutor, reviewer, plannerFour behavioral principles: Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution. Executor self-checks; reviewer flags violations as IMPORTANT.
graphify-integrationplanner, researcher, reviewer, executorAuto-detected via graphify-out/graph.json. Planner aligns tasks with community clusters. Researcher queries graph before external docs. Executor gets focused context.
design-systembrainstorming, planner, executor, reviewerAuto-detected via DESIGN.md. Planner tags UI tasks. Executor loads design tokens. Reviewer runs design compliance pass.

All three degrade gracefully. If no graph or DESIGN.md exists, agents behave exactly as before v0.2.0.