Advanced Agents

Agents are AI specialists that combine multiple skills into coordinated workflows. Instead of invoking skills one at a time, an agent handles the full workflow — selecting the right skills, chaining them together, and producing a complete result.

Agents are currently supported in Claude Code only. Other AI tools (Cursor, Windsurf, Gemini CLI) use skills directly.

Why Use Agents

Skills are individual workflow steps (e.g., “create a PR”). Agents compose multiple skills into a specialist that understands the full picture:

Approach	Example	Best For
Single skill	"Use the pr-create skill"	One specific task
Agent	"Use the release-manager agent"	Multi-step workflow where skills coordinate

Use agents when your task spans multiple skills. Use skills directly for focused, single-step work.

All 10 Agents

Agent	Skills	When to Use
planner	specify, plan	Creating PRDs and implementation plans
code-reviewer	code-review, security-reviewer	Reviewing code for architecture and security
design-reviewer	design-review	Reviewing UI for accessibility and design system
test-writer	add-test	Adding tests for existing code
qa-tester	qa, manual-qa	Test quality analysis and browser smoke-testing
security-reviewer	security-reviewer	Security audit with OWASP checklist
readme-updater	readme-updater	Updating module READMEs
framework-manager	skill-builder, rule-builder	Creating new skills and rules
release-manager	deploy, changelog, pr-create	PRs, changelogs, deployments
db-manager	db-migrate	Safe database migrations

Agent files live in docs/ai-context/agents/.

How to Invoke

Reference the agent by name in your prompt:

"Use the release-manager agent to prepare a release for v1.2."
"Use the db-manager agent to add a projects table."
"Use the framework-manager agent to create a skill for invoice generation."

The agent loads its skills automatically and decides which to use based on your request.

Multi-Agent Workflows

Chain agents for end-to-end workflows. Each step is a separate prompt.

Feature to Release

1. "Use the planner agent to plan the feature."            (PLAN)
2. Build with implementation skills (new-feature, etc.)     (BUILD)
3. "Use the code-reviewer agent to review."                 (REVIEW)
4. "Use the release-manager agent to create a PR."          (RELEASE)

Database Change

1. "Use the db-manager agent to add the migration."         (MIGRATE)
2. Build the feature using the new schema                    (BUILD)
3. "Use the code-reviewer agent to review."                  (REVIEW)
4. "Use the release-manager agent to prepare the release."   (RELEASE)

Extending the Framework

1. "Use the framework-manager agent to create a new skill." (EXTEND)
2. Test the new skill by invoking it                         (VERIFY)
3. "Use the release-manager agent to create a PR."           (RELEASE)

See Extending the Framework for a detailed guide on creating custom skills and rules.

Next Steps

• Learn about skills: Prompt Library
• Extend the framework: Extending the Framework
• Understand the framework: AI Framework
• See the in-app agent features: Knowledge Base (RAG)