AI Team Workflow

A documentation-driven development workflow connecting PM/BA, Developers, and QC through Claude Code.

Quick Start

npx create-ai-team

How It Works

flowchart LR
    PM[PM/BA] -->|/write-spec| Docs[docs/feature/spec.md]
    Docs -->|triggers| GHA[GitHub Action]
    GHA -->|notifies| Dev[Developer]
    Dev -->|/develop-feature| Claude[Claude Code]
    Claude -->|reads| Docs
    Claude -->|builds| Code[Feature Code]

Loading

Commands

Command	For	Purpose
/write-spec	PM/BA	Create spec through conversation
/develop-feature	Dev	Build feature from spec
/fix-issue	Dev	Fix bugs with doc context
/trace-flow	Dev	Trace code flow

Folder Structure

your-project/
├── .claude/commands/      # Claude Code commands
├── docs/
│   └── <feature>/
│       ├── spec.md        # Required: What to build
│       └── examples/      # Optional: Sample data
└── .github/workflows/     # Optional: GitHub Actions

Documentation

• Full Documentation
• Installation Guide
• Example Project

Spec Format

See examples/docs/example-feature/spec.md for the full template.

Key sections:

• Overview
• Requirements (checklist)
• Data Model (Mermaid ERD)
• API endpoints
• Error format and codes
• Test cases
• Out of scope