claude-dev-team

A Claude Code plugin that installs a full dev-team of AI agents and skills into any project in one command.

What's Included

Advisory Agents (global, work in every project)

Agent	Model	Purpose
code-reviewer	Sonnet	Code quality, anti-patterns, bug detection
qa-expert	Haiku	Testing strategy, edge cases, coverage gaps
performance-engineer	Haiku	N+1 queries, caching, latency bottlenecks
tech-writer	Haiku	API docs, ADRs, response schema proposals
product-manager	Haiku	Feature scoping, user stories, prioritization
tech-lead	Sonnet	Architectural decisions, multi-agent synthesis

All advisory agents return: ASSESSMENT → RECOMMENDATION → EXAMPLE → RED FLAGS ⚠️ → CONFIDENCE

Skills (global, work in every project)

Skill	Invocation	Purpose
brainstorm-feature	/brainstorm-feature <idea>	Structured feature proposal with cost, tier, priority
consult-team	Claude-only	Dispatch 2–4 specialists in parallel + tech-lead synthesis
setup-team	/setup-team	Bootstrap project-specific agents from templates

Action Agent Templates (project-specific, filled by /setup-team)

Template	Purpose
backend-expert	Implements routes, services, models
frontend-expert	Builds pages, components, forms
dba-expert	Schema, migrations, query optimization
devops-expert	Docker, CI/CD, infrastructure config
security-reviewer	Data isolation, auth, injection audits

---

Installation

Step 1 — Add this repo as a marketplace source

Add to ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "my-plugins": {
      "source": {
        "source": "github",
        "repo": "sofien-chaouch/claude-dev-team"
      }
    }
  }
}

Step 2 — Install the plugin

claude plugin install dev-team@my-plugins

That's it. All 6 advisory agents and 3 skills are now available in every project on this device.

---

Usage

In any project — use advisory agents directly

Just mention the agent in your request:

Ask code-reviewer to check this new endpoint for anti-patterns.
Ask performance-engineer if this query has N+1 issues.
Ask product-manager to write a user story for the notification feature.

Brainstorm a new feature

/brainstorm-feature add CSV export to the leads dashboard

Bootstrap a new project with project-specific agents

/setup-team

This asks about your stack and generates customized action agents in .claude/agents/ for the current project.

Multi-agent consultation (triggered by Claude automatically)

Claude invokes consult-team when a question spans multiple domains. The flow:

1. Dispatches 2–4 relevant specialists in parallel
2. Passes all responses to tech-lead
3. tech-lead produces a TECHNICAL DECISION + IMPLEMENTATION PLAN

---

Cost Model

Agent	Model	When used
qa-expert, performance-engineer, tech-writer, product-manager, devops-expert	Haiku	Advisory — lightweight analysis
code-reviewer, tech-lead, action agents	Sonnet	Code writing and synthesis

---

Adding to a New Device

1. Add extraKnownMarketplaces to ~/.claude/settings.json (see Step 1 above)
2. Run claude plugin install dev-team@my-plugins
3. In a new project, run /setup-team to generate project-specific action agents

---

Repository Structure

claude-dev-team/
  .claude-plugin/
    plugin.json               ← plugin manifest
  agents/
    code-reviewer.md          ← global advisory agents
    qa-expert.md
    performance-engineer.md
    tech-writer.md
    product-manager.md
    tech-lead.md
  skills/
    brainstorm-feature/
      SKILL.md
    consult-team/
      SKILL.md
    setup-team/
      SKILL.md
  templates/
    agents/
      backend-expert.md       ← project-specific action agent templates
      frontend-expert.md
      dba-expert.md
      devops-expert.md
      security-reviewer.md
  README.md