🦀 Claude Dev Team

A plug-and-play AI software development team built for Claude Code.
Drop it into any project and get a full team of specialized agents — orchestrated by a Project Manager — ready to design, build, review, and test your software.

---

✨ What's Included

Agent	Role
🧭 Project Manager	Reads plan.md, breaks it into tasks, delegates to the team, tracks progress in PROGRESS.md
🎨 Design Expert	UX/UI design, component specs, design system guidance
⚡ Frontend Dev	Angular components, pages, services, state, routing
🔧 Backend Dev	APIs, services, database, auth, server logic
🔍 Code Reviewer	Reviews all code changes, enforces standards, flags blockers
🧪 Tester	Unit, integration, and e2e tests

---

🚀 Quick Install

Option A — Setup Script (recommended)

# Clone this repo
git clone https://github.com/YOUR_USERNAME/claude-dev-team.git

# Install into your project
cd claude-dev-team
./setup-dev-team.sh /path/to/your-project

Option B — Manual

# Copy agents into your project
cp -r .claude/agents/ /path/to/your-project/.claude/agents/
cp CLAUDE.md /path/to/your-project/CLAUDE.md
cp plan.md.template /path/to/your-project/plan.md

---

📋 How to Use

1. Fill in plan.md

After installing, edit plan.md in your project root.
Describe your project, tech stack, features, and acceptance criteria.
A full template is provided — just fill in the blanks.

2. Start Claude Code

cd your-project
claude

3. Kick it off

"Start the project using plan.md"

The Project Manager agent will:

1. Read plan.md
2. Create PROGRESS.md with a full task breakdown
3. Coordinate the team — design → backend → frontend → review → test

4. Resume anytime

"Resume the project"

The Project Manager reads PROGRESS.md and picks up exactly where it left off.

---

🗂 File Structure

After install, your project will look like this:

your-project/
├── plan.md                    ← Your project plan (you write this)
├── PROGRESS.md                ← Auto-generated by Project Manager
├── CLAUDE.md                  ← Claude project instructions
├── docs/
│   ├── design/                ← Design specs from Design Expert
│   ├── api/                   ← API docs from Backend Dev
│   └── reviews/               ← Code reviews from Code Reviewer
└── .claude/
    └── agents/
        ├── project-manager.md
        ├── design-expert.md
        ├── frontend-dev.md
        ├── backend-dev.md
        ├── code-reviewer.md
        └── tester.md

---

🔄 How Agents Work Together

plan.md  →  Project Manager
               ├── delegates design specs  →  Design Expert
               ├── delegates UI tasks      →  Frontend Dev
               ├── delegates API tasks     →  Backend Dev
               ├── requests review         →  Code Reviewer
               └── requests tests          →  Tester

Each agent is a .md file in .claude/agents/. Claude Code automatically loads them and routes tasks based on context. No plugins, no config — it just works.

---

✅ Quality Gates

No feature is marked "done" until:

• Code reviewed by code-reviewer (no blockers)
• Tests written and passing by tester
• PROGRESS.md updated

---

🛠 Customizing

Change the tech stack: Edit plan.md — agents adapt to whatever stack you specify (React, FastAPI, Go, etc.).

Add an agent: Create a new .md file in .claude/agents/ following the same format as the existing ones.

Adjust conventions: Edit CLAUDE.md to change folder structure, iteration policy, or quality gates.

---

📦 Requirements

• Claude Code (claude CLI)
• Any project — frontend, backend, fullstack, whatever

---

License

MIT — use it, fork it, build something great.