AI Development Team

A reusable repository of specialized Claude Code skills that work together like a real software development team. Each "agent" has deep expertise, follows best practices, and can be invoked for specific tasks.

Team Overview

                              MANAGEMENT LAYER
           ┌─────────────────────┬─────────────────────┐
           │                     │                     │
    ┌──────▼──────┐      ┌───────▼───────┐     ┌──────▼──────┐
    │   PRODUCT   │      │    SCRUM      │     │  BUSINESS   │
    │    OWNER    │      │   MASTER      │     │  ANALYST    │
    │     /po     │      │     /sm       │     │    /ba      │
    └──────┬──────┘      └───────┬───────┘     └──────┬──────┘
           └─────────────────────┼─────────────────────┘
                                 │
                        ARCHITECTURE LAYER
                      ┌──────────▼──────────┐
                      │     SOLUTION        │
                      │    ARCHITECT        │
                      │       /arch         │
                      └──────────┬──────────┘
                                 │
         ┌───────────────────────┼───────────────────────┐
         │                       │                       │
┌────────▼───────┐    ┌─────────▼────────┐    ┌─────────▼────────┐
│    BACKEND     │    │    FRONTEND      │    │     DEVOPS       │
│   DEVELOPER    │    │   DEVELOPER      │    │    ENGINEER      │
│      /be       │    │      /fe         │    │                  │
└───────┬────────┘    └────────┬─────────┘    └────────┬─────────┘
        │                      │                       │
        │   QUALITY LAYER      │                       │
        ▼                      ▼                       ▼
┌───────────────┐      ┌───────────────┐       ┌───────────────┐
│     CODE      │      │   UI/UX       │       │    SECOPS     │
│   REVIEWER    │      │   DESIGNER    │       │   ENGINEER    │
│     /rev      │      │     /ui       │       │               │
└───────┬───────┘      └───────┬───────┘       └───────────────┘
        ▼                      ▼
┌───────────────┐      ┌───────────────┐
│  QA / TEST    │      │     E2E       │
│   DESIGNER    │      │    TESTER     │
│     /qa       │      │     /e2e      │
└───────────────┘      └───────────────┘

                         COMPLIANCE LAYER
      ┌──────────────┬──────────────┬──────────────┐
      │              │              │              │
┌─────▼─────┐  ┌─────▼─────┐  ┌─────▼─────┐  ┌─────▼─────┐
│ACCOUNTANT │  │   LEGAL   │  │ MARKETING │  │ TECHNICAL │
│   /fin    │  │  /legal   │  │   /mkt    │  │  WRITER   │
└───────────┘  └───────────┘  └───────────┘  └───────────┘

---

Quick Start

Installation (One Command)

# Clone and install
git clone https://github.com/your-org/ai-dev-team.git
cd ai-dev-team
./install.sh

The installer will:

• Detect existing ~/.claude directory
• Offer merge or replace options
• Backup existing configuration if replacing
• Install all skills, commands, and templates

Manual Installation

# Clone the repository
git clone https://github.com/your-org/ai-dev-team.git
cd ai-dev-team

# Copy to ~/.claude
cp -r claude/* ~/.claude/

Verify Installation

# List installed skills
ls ~/.claude/skills/

# List commands
ls ~/.claude/commands/

# In Claude Code, try:
/agents

---

What Gets Installed

~/.claude/
├── CLAUDE.md                    # Global instructions (TDD, workflow)
├── TEAM_WORKFLOW.md             # Complete team workflow documentation
│
├── skills/                      # 33 AI agent skills
│   ├── management/              # Product Owner, Scrum Master, Business Analyst
│   ├── architecture/            # Solution Architect, GraphQL Developer
│   ├── development/
│   │   ├── backend/             # Java, Kotlin, Python specialists
│   │   └── frontend/            # React, Angular, Vue, Flutter
│   ├── quality/
│   │   ├── review/              # Code reviewers
│   │   └── testing/             # QA, E2E, BDD testers
│   ├── operations/              # DevOps, SecOps, MLOps
│   ├── design/                  # UI/UX Designer
│   ├── compliance/              # Accountant, Legal (generic + UK)
│   ├── marketing/               # Product Marketing
│   └── specialized/             # Technical Writer
│
├── commands/                    # 16 slash commands
│   ├── agents.md                # /agents - list all agents
│   ├── po.md                    # /po - Product Owner
│   ├── sm.md                    # /sm - Scrum Master
│   ├── arch.md                  # /arch - Solution Architect
│   ├── fe.md                    # /fe - Frontend Developer
│   ├── be.md                    # /be - Backend Developer
│   ├── rev.md                   # /rev - Code Reviewer
│   ├── qa.md                    # /qa - QA/Test Designer
│   ├── e2e.md                   # /e2e - E2E Tester
│   ├── ui.md                    # /ui - UI Designer
│   ├── ba.md                    # /ba - Business Analyst
│   ├── fin.md                   # /fin - UK Accountant
│   ├── legal.md                 # /legal - UK Legal
│   ├── mkt.md                   # /mkt - Marketing
│   ├── bug.md                   # /bug - Report bugs
│   └── issue.md                 # /issue - Report issues
│
└── templates/                   # Document templates
    ├── adr-template.md
    ├── user-story-template.md
    ├── sprint-template.md
    ├── code-review-template.md
    └── investigation-report-template.md

---

Agent Reference

Core Agents (18)

| Command | Role | Expertise | |---------|------|-----------| | /po | Product Owner | Vision, backlog, user stories | | /sm | Scrum Master | Sprints, AC, status tracking | | /ba | Business Analyst | Research, requirements | | /arch | Solution Architect | System design, patterns, ADRs | | /fe | Frontend Developer | React, TypeScript, Next.js | | /be | Backend Developer | Java, Spring Boot, APIs | | /rev | Code Reviewer | Quality, security, style | | /qa | QA Engineer | Test design, bug investigation | | /e2e | E2E Tester | Playwright, Detox, performance | | /ui | UI Designer | Design systems, prototypes | | /fin | UK Accountant | Tax, VAT, R&D credits | | /legal | UK Legal | GDPR, contracts, compliance | | /mkt | Marketing | GTM, positioning, content | | - | DevOps Engineer | Terraform, K8s, CI/CD | | - | Security Engineer | OWASP, auth, security | | - | ML Engineer | AI/ML, LLM integration | | - | Technical Writer | Docs, diagrams, guides | | - | Generic Accountant | Multi-jurisdiction finance | | - | Generic Legal | Multi-jurisdiction legal |

Extended Skills (14)

Technology-specific extensions that activate alongside core agents:

| Skill | Extends | Technology | |-------|---------|------------| | angular-developer | frontend-developer | Angular 21 | | vue-developer | frontend-developer | Vue 3 | | flutter-developer | frontend-developer | Flutter/Dart | | kotlin-developer | backend-developer | Kotlin 2.1 | | quarkus-developer | backend-developer | Quarkus | | fastapi-developer | backend-developer | Python FastAPI | | spring-kafka | backend-developer | Kafka integration | | graphql-developer | solution-architect | GraphQL APIs | | terraform-specialist | devops-engineer | Terraform/OpenTofu | | cucumber-bdd | e2e-tester | BDD/Cucumber | | backend-reviewer | reviewer | Java/Kotlin focus | | frontend-reviewer | reviewer | TypeScript focus | | backend-tester | tester | JUnit, Testcontainers | | frontend-tester | tester | Jest, RTL |

---

Workflow

Development Sequence

/po → /sm → /arch → [/fin] → [/legal] → [/ui] → /fe|/be → /rev → /qa + /e2e
Vision  AC   Arch.   Finance  Legal    Design   TDD Dev   Review  Testing

Approval Gates

| Gate | Agent | When Required | |------|-------|---------------| | Architecture | /arch | ALWAYS | | Finance | /fin | Payments, billing, tax | | Legal | /legal | GDPR, privacy, contracts | | UI Design | /ui | Frontend features |

Bug Workflow

/bug Login button doesn't work on mobile Safari

Creates structured bug report → Investigation → Reproduction test → TDD fix → Review → Tests

---

Key Principles

TDD (Mandatory)

All development follows Test-Driven Development:

1. Write tests first (RED)
2. Implement minimum code (GREEN)
3. Refactor (REFACTOR)

Architecture First

ALL features require /arch approval before implementation.

Developers Own Tests

• /fe and /be write unit and integration tests
• /qa designs test cases from acceptance criteria
• /e2e implements automated E2E and performance tests

---

Installation Options

Interactive Installation

./install.sh

Command-Line Options

./install.sh --merge    # Merge with existing ~/.claude
./install.sh --replace  # Backup and replace ~/.claude
./install.sh --link     # Create symlink (for development)
./install.sh --help     # Show help

Development Mode

For contributing to this repository:

./install.sh --link

This creates a symlink so changes in the repo are immediately reflected.

---

Contributing

1. Fork the repository
2. Create a feature branch
3. Make changes to skills in claude/skills/
4. Test with ./install.sh --link
5. Submit a pull request

See docs/skill-extension-guide.md for adding new technologies.

---

Version History

| Version | Date | Changes | |---------|------|---------| | 4.0.0 | 2025-01-02 | Restructured for easy ~/.claude deployment | | 3.1.0 | 2024-12-27 | Added approval gates and Aura design verification | | 3.0.0 | 2024-12-26 | TDD workflow, unified QA agents | | 2.0.0 | 2024-12-25 | Performance testing modules | | 1.0.0 | 2024-12-23 | Initial release with 15 agents |

---

License

MIT License - See LICENSE file for details.