Hard role separation
Reading, writing, testing, diagnosis, and judgment each belong to a defined specialist.
A software engineering company inside Claude Code — one manager and twelve specialist agents.
The manager plans, dispatches, and verifies. Specialists read, write, test, research, diagnose, and judge—with a hard boundary around every role.
Each capability has one owner, and the amount of process scales with the risk of the change.
Reading, writing, testing, diagnosis, and judgment each belong to a defined specialist.
Four role aliases put orchestration, file work, analysis, and trivial edits on the right model tier.
A stack-neutral rulebook, agent definitions, and one profile—with no fork, plugin, or build step.
The manager scopes, plans, delegates, and verifies while specialists execute within clear boundaries.
This is the crew’s sole customization surface. Edit it to adapt Claude Crew to any project.
skills/stack-profile/SKILL.md
Keep the core stack-neutral. CLAUDE.md and the agent definitions must not be edited to change stacks.
The manager sizes each task, runs the matching chain, and assigns work through four cost-aware role aliases.
[explorer if location unknown] → fixer → reviewer → doneexplorer → English plan → implementer → reviewer ∥ tester → doneexplorer → guardian PRE → English plan → implementer → tester → reviewer → security* → guardian POST → doneresearcher is inserted before the English plan whenever external facts are required| Alias | Used for |
|---|---|
leadclaude-lead | Management, review, security, and regression gates |
engineerclaude-engineer | Reconnaissance, implementation, tests, and prose |
analystclaude-analyst | External research, root-cause analysis, and bug hunting |
assistantclaude-assistant | Low-risk, single-file TRIVIAL edits |
Each agent stays inside a hard boundary, keeping execution focused and verification independent.
explorerengineerMaps the codebase and returns a structured, read-only reconnaissance report.
backendengineerImplements APIs, business logic, data access, authentication, and integrations.
frontendengineerImplements UI, components, styling, state, forms, and accessibility.
testerengineerWrites and runs focused automated tests.
writerengineerWrites documentation, prose, and copy in the profile language.
researcheranalystResearches external documentation, APIs, errors, and version differences.
debuggeranalystPerforms deep root-cause analysis when the cause is not apparent.
qaanalystHunts for unreported edge cases, race conditions, and broken failure paths.
reviewerleadReviews completed changes adversarially and reports defects.
securityleadAudits trust boundaries, authorization, input, data exposure, and integrations.
guardianleadRecords and checks regression baselines around HIGH-risk changes.
fixerassistantApplies a few obvious, low-risk lines in one file for TRIVIAL work.
Choose your operating system. Each installation copies the manager rules, all twelve agents, the stack profile, and the gateway settings template.
git clone https://github.com/miladjs/claude-crew.git
cd claude-crew
mkdir -p ~/.claude
cp CLAUDE.md ~/.claude/CLAUDE.md
cp -r agents ~/.claude/
cp -r skills ~/.claude/
cp settings.example.json ~/.claude/settings.json
git clone https://github.com/miladjs/claude-crew.git
cd claude-crew
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
Copy-Item CLAUDE.md "$env:USERPROFILE\.claude\CLAUDE.md"
Copy-Item -Recurse -Force agents "$env:USERPROFILE\.claude\agents"
Copy-Item -Recurse -Force skills "$env:USERPROFILE\.claude\skills"
Copy-Item settings.example.json "$env:USERPROFILE\.claude\settings.json"
git clone https://github.com/miladjs/claude-crew.git
cd claude-crew
mkdir -p ~/.claude
cp CLAUDE.md ~/.claude/CLAUDE.md
cp -r agents ~/.claude/
cp -r skills ~/.claude/
cp settings.example.json ~/.claude/settings.json
ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN, then restart Claude Code.skills/stack-profile/SKILL.md.