Agents & Skills
This is the deep dive into Agents and Skills. For basic setup, see Claude Code Integration.
Agents
The .claude/agents/ directory contains agent definitions that Claude Code loads automatically. These aren’t generic instructions — they’re specialized roles designed around the SpecForge workflow:
- Planning agents guide you through specification refinement, asking the right questions about goals, constraints, edge cases, and acceptance criteria
- Implementation agents know how to pick up tickets, follow implementation steps, report progress, and complete work sessions
- Support agents resolve cross-ticket blockers and discoveries raised during implementation, and research packages when a ticket needs it
ℹ️ Checking completed work against acceptance criteria isn’t a scaffolded agent — it ships as the validator skill under
.claude/skills/.
Skills
The .claude/skills/ directory contains operational skills — step-by-step protocols for using SpecForge MCP tools correctly. Skills encode the workflow so Claude Code doesn’t need to figure out tool sequencing from scratch:
- How to start a planning session and iterate through decomposition
- How to claim a ticket, implement it, and close the work session
- How the validator skill checks completed work against acceptance criteria and reports findings
- How to handle blocks and discoveries during implementation