claude-corps

# claude-corps

> Parallel agentic development framework for Claude Code

claude-corps provides skills, agents, hooks, and scripts that extend Claude Code (Anthropic's agentic coding CLI) into an autonomous multi-session development team. Multiple Claude agents work simultaneously on isolated branches, coordinated by an orchestrator that dispatches tasks, reconciles results, and compounds learnings across sessions.

## Key Capabilities

- /dispatch: Spawn parallel agent workers in isolated git worktrees
- /auto-run: Autonomous multi-hour orchestration loop (dispatch, reconcile, repeat)
- /spec: Research-driven planning with parallel agents — interactive refinement, plan writing, optional task decomposition into Linear issues
- /orient: Survey a project and identify parallel work streams
- /start-task: Claim a task, create a task branch, gather context, define acceptance criteria
- /finish-task: Tests, commit, PR, code review, session summary, close
- /multi-review: Parallel specialized code review with 14+ agent types (including framework-specific reviewers for Next.js, Tailwind/shadcn, Python backend, and more)
- Review configuration: Per-project .claude/review.json for review depth, reviewer overrides, and smart model selection (Opus for critical/high, Sonnet for medium/low)

## Architecture

Orchestrator + Workers pattern. One Claude session orients and dispatches work.
Worker sessions execute tasks in isolated git worktrees and report back with session summaries.
The orchestrator reconciles results, updates the task board, and dispatches newly unblocked work.

Task tracking is optional. With Linear MCP connected, skills create/manage issues automatically.
Without Linear, skills write plan files and execute directly from them.

## Dependencies

- Claude Code (Anthropic's CLI): https://docs.anthropic.com/en/docs/claude-code
- Linear MCP (optional task tracking): https://mcp.linear.app/mcp
- git with worktree support

## Links

- Repository: https://github.com/josephneumann/claude-corps
- README: https://github.com/josephneumann/claude-corps/blob/main/README.md
- Install: https://github.com/josephneumann/claude-corps#installation