How aws-samples/sample-claude-code-agent-team works
This repository is a Claude Code configuration sample, not an application runtime. Its main workflow has the lead agent research and specify work, delegate tasks to parallel coding and DevOps workers, then run scoped reviews and fixes through end-to-end review. Agent prompts, workflow skills and rules provide guidance; hooks enforce task-format, completion-verification and idle-work guardrails. The README documents the broader workflow, while source excerpts confirm hook behavior and helper calls; unsampled agent and skill internals are not assumed.
Main entry points: fullstack-agent.md Full-stack lead · coding-agent.md Coding agent · devops-agent.md DevOps agent · testing-standards.md Testing standards
Components 21
Agent roles
- Full-stack lead
agents/fullstack-agent.md - Coding agent
agents/coding-agent.md - DevOps agent
agents/devops-agent.md - Review agent
agents/review-agent.md - Review-lite agent
agents/review-lite-agent.md - Solutions architect
agents/sa-agent.md
Workflow guidance
- Spec workflow
skills/spec-workflow/SKILL.md - Team protocol
rules/agent-team-protocol.md - Testing standards
rules/testing-standards.md - Documentation skill
skills/documentation/SKILL.md - Git workflow
skills/git-workflow/SKILL.md
Hook enforcement
- Task format gate
hooks/task_created_format_check.py - Completion verify gate
hooks/task_completed_verify_gate.py - Idle work check
hooks/teammate_idle_workcheck.py - Hook common helpers
hooks/team_hook_common.py
Supporting capabilities
- Cached fetch skill
skills/concurrent-cached-fetch/SKILL.md - Brainstorm command
commands/brainstorm.md - Configuration optimizer
commands/optimize-my-claude.md - AWS security guidance
rules/AWS-security-guidelines.md - Claude settings
settings.json
Other components
- Project user
Connections 28
- Project user → Full-stack lead: requests work
README.md - Full-stack lead → Spec workflow: plans with
README.md - Full-stack lead → Coding agent: delegates build
README.md - Full-stack lead → DevOps agent: delegates build
README.md - Full-stack lead → Review agent: assigns review
README.md - Full-stack lead → Review-lite agent: assigns narrow review
README.md - Full-stack lead → Solutions architect: requests architecture review
README.md - Coding agent → Team protocol: follows team protocol
README.md - DevOps agent → Team protocol: follows team protocol
README.md - Review agent → Testing standards: checks test tiers
README.md - Coding agent → Testing standards: owns T1 T2
README.md - DevOps agent → Testing standards: owns T3 wiring
README.md - Full-stack lead → Testing standards: plans coverage
README.md - Review agent → Documentation skill: uses guidance
- Coding agent → Git workflow: uses guidance
- Task format gate → Hook common helpers: imports helpers
hooks/task_created_format_check.py - Completion verify gate → Hook common helpers: imports helpers
hooks/task_completed_verify_gate.py - Idle work check → Hook common helpers: imports helpers
hooks/teammate_idle_workcheck.py - Task format gate → Project user: blocks malformed task
- Completion verify gate → Project user: blocks unverified completion
- Idle work check → Project user: nudges claimable work
- Full-stack lead → Brainstorm command: can invoke
- Full-stack lead → Configuration optimizer: can invoke
- DevOps agent → AWS security guidance: uses security guidance
- Claude settings → Task format gate: configures hook
- Claude settings → Completion verify gate: configures hook
- Claude settings → Idle work check: configures hook
- Coding agent → Cached fetch skill: can use skill