Ship like a team of 10, working solo with AI agents.
A comprehensive template repository for Claude Code solo development workflow. Transform yourself from a lone developer into a CTO with an infinite AI-powered team.
Imagine you're a CTO of a startup with unlimited developers. Each git worktree is a separate developer working on their feature. Each subagent is a specialist with deep expertise. GitHub Issues is your project board. Memory is your corporate wiki.
This isn't about AI autocomplete—it's about AI-driven development where you:
- Architect the system
- Manage the work
- Review the output
- Let AI agents handle the implementation
- Spec First, Code Second — Every line traces back to a specification
- Isolated Contexts — Subagents work in their scope, main thread stays strategic
- Parallel by Default — One issue spawns 3-5 parallel work streams
- Evidence-Based Completion — "Done" requires proof: tests pass, build succeeds
# Option A: Use GitHub template feature (recommended)
# Click "Use this template" on GitHub
# Option B: Clone and reinitialize
git clone https://github.com/merllinsbeard/cc-solo-dev-template.git my-project
cd my-project
rm -rf .git && git init./scripts/init.shThis will:
- Copy template files to appropriate locations
- Set up CLAUDE.md hierarchy
- Configure hooks and MCP servers
claudeYou're ready to ship!
| Component | Description |
|---|---|
| CLAUDE.md Templates | 3-level hierarchy (global → project → local) |
| Subagents | 3 ready-to-use agents (python-backend, code-reviewer, researcher) |
| GitHub Actions | Automated PR review with Claude |
| CCPM Integration | GitHub Issues + Worktrees automation |
| 11 Doc Files | Complete workflow documentation |
| Helper Scripts | Project init, worktree management |
| Doc | Description |
|---|---|
| Philosophy | Mental model, the "CTO with infinite team" metaphor |
| Tool Stack | Tools by tier (Must Have → Recommended → Optional) |
| Setup Guide | Step-by-step environment setup |
| Workflow | 5-phase development cycle (Ideation → Ship) |
| Git Worktrees | Parallel development deep dive |
| Subagents | Agent patterns and examples |
| Memory | CLAUDE.md hierarchy + persistent memory |
| Automation | Hooks and GitHub Actions |
| Prompting | Effective prompt patterns |
| CCPM Guide | GitHub Issues + Worktrees PM |
| Checklists | Setup, pre-merge, post-merge checklists |
| Tool | Purpose |
|---|---|
| Claude Code | Main development agent |
| Git Worktrees | Parallel feature isolation |
| CLAUDE.md | Persistent project context |
| GitHub Issues | Task tracking, audit trail |
| Tool | Purpose |
|---|---|
| CCPM | GitHub Issues + Worktrees automation |
| superpowers | Skills for structured workflow |
| claude-mem | Persistent memory between sessions |
| sequentialthinking MCP | Multi-step reasoning |
| Tool | Purpose |
|---|---|
| SuperClaude | 30 slash commands, 16 agents |
| claude-flow | Enterprise orchestration |
| Codex CLI | Deep background tasks |
See Tool Stack for details.
your-project/
├── CLAUDE.md # Project context (git tracked)
├── CLAUDE.local.md # Local notes (gitignored)
│
├── .claude/
│ ├── settings.json # Project hooks and config
│ └── agents/ # Project-specific subagents
│ ├── python-backend.md
│ ├── code-reviewer.md
│ └── researcher.md
│
├── .github/
│ └── workflows/
│ └── claude-review.yml # PR review automation
│
└── src/ # Your code
Plus global config at ~/.claude/:
~/.claude/
├── CLAUDE.md # Global preferences
├── settings.json # MCP servers, permissions
└── agents/ # Global subagents
┌─────────────────┐
│ 0. IDEATION │ PRD / User Story
└────────┬────────┘
▼
┌─────────────────┐
│ 1. PLANNING │ Epic → Bite-sized tasks (2-5 min each)
└────────┬────────┘
▼
┌─────────────────┐
│ 2. DEVELOPMENT │ Worktree + TDD + Subagents
└────────┬────────┘
▼
┌─────────────────┐
│ 3. REVIEW │ Code review + Evidence verification
└────────┬────────┘
▼
┌─────────────────┐
│ 4. SHIP │ Merge + Cleanup + Release
└─────────────────┘
See Workflow for the full guide.
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a PR
Inspired by:
- CCPM — GitHub-native project management
- obra/superpowers — Skills-based workflow
- claude-mem — Persistent memory
- Anthropic's Best Practices
MIT License — see LICENSE for details.
Built for solo developers who want to ship like a team.