Automate your software development from requirements to deployment using Claude-powered agents.

Get started in under 5 minutes:

# 1. Install AD-SDLC
npm install -g ad-sdlc

# 2. Initialize your project
ad-sdlc init my-project
cd my-project

# 3. Start with your requirements
claude "Implement user authentication with OAuth2"

That's it! The agents will generate documents, create issues, implement code, and open PRs.

AD-SDLC is an automated software development pipeline that uses 25 specialized Claude agents to transform your requirements into production-ready code. It supports three modes:

User Input → Collector → PRD Writer → SRS Writer → SDS Writer
                                                       ↓
                           Worker ← Controller ← Issue Generator
                              ↓
                         PR Reviewer → Merge

Existing Docs + Code → Document Reader → Codebase Analyzer → Code Reader
                                                                  ↓
                                                      Doc-Code Comparator
                                                                  ↓
                                                        Impact Analyzer
                                                                  ↓
                                      PRD Updater → SRS Updater → SDS Updater
                                                                  ↓
                                         Issue Generator + Regression Tester
                                                                  ↓
                                            Controller → Worker → PR Reviewer
                                                                      ↓
                                                              CI Fix (on failure)

GitHub Issues → Issue Reader → Controller → Worker → PR Reviewer
                                                         ↓
                                                 CI Fix (on failure)

• Automatic Document Generation: PRD, SRS, SDS documents from natural language requirements
• Enhancement Pipeline: Incremental updates to existing projects without full rewrites
• Import Pipeline: Process existing GitHub Issues directly, skipping document generation
• Mode Detection: Automatically detects Greenfield, Enhancement, or Import pipeline
• Pipeline Resume: Resume interrupted pipelines from the last completed stage (--resume)
• Session Persistence: Automatic state persistence for pipeline recovery
• GitHub Integration: Automatic issue creation with dependencies and labels
• Parallel Implementation: Multiple workers implementing issues concurrently
• Automated PR Review: Code review and quality gate enforcement
• Progress Tracking: Real-time visibility into pipeline status
• Regression Testing: Identifies affected tests when modifying existing code
• Doc-Code Gap Analysis: Detects discrepancies between documentation and implementation
• Customizable Workflows: Configure agents, templates, and quality gates

• Node.js 18+ (Download)
• Git 2.30+
• GitHub CLI 2.0+ (optional, for issue/PR management)
• Claude API Key

# Global installation (recommended)
npm install -g ad-sdlc

# Or use directly with npx
npx ad-sdlc init

# Set your Claude API key
export CLAUDE_API_KEY="your-api-key"
# or
export ANTHROPIC_API_KEY="your-api-key"

# For GitHub integration
gh auth login

See Installation Guide for detailed setup instructions.

# Interactive mode - guides you through configuration
ad-sdlc init

# Quick setup with defaults
ad-sdlc init my-project --quick

# With specific options
ad-sdlc init my-project \
  --tech-stack typescript \
  --template standard \
  --github-repo https://github.com/user/my-project

# Start with requirements collection
claude "Collect requirements for [your project description]"

# Generate documents step by step
claude "Generate PRD from collected information"
claude "Generate SRS from PRD"
claude "Generate SDS from SRS"

# Create GitHub Issues
claude "Generate GitHub issues from SDS"

# Implement and review
claude "Start implementation with Controller"

# Initialize new project
ad-sdlc init [project-name]

# Validate configuration files
ad-sdlc validate [--file <path>] [--watch] [--format text|json]

# Check pipeline status
ad-sdlc status [--project <id>] [--format text|json] [--verbose]

# Analyze project for documentation-code gaps
ad-sdlc analyze [--project <path>] [--scope full|documents_only|code_only]

# Generate shell completion script
ad-sdlc completion --shell <bash|zsh|fish>

Run the complete AD-SDLC pipeline end-to-end:

# Auto-detect mode and run full pipeline
./ad-sdlc-full-pipeline.sh [project_path] [mode]

# Specify mode explicitly
./ad-sdlc-full-pipeline.sh . greenfield
./ad-sdlc-full-pipeline.sh . enhancement
./ad-sdlc-full-pipeline.sh . import

# Resume an interrupted pipeline
./ad-sdlc-full-pipeline.sh . auto --resume

# Resume a specific session
./ad-sdlc-full-pipeline.sh . auto --resume <session-id>

# Start from a specific stage
./ad-sdlc-full-pipeline.sh . greenfield --start-from sds_generation

# List available sessions for resume
./ad-sdlc-full-pipeline.sh . auto --list-sessions

Enable tab completion for AD-SDLC commands in your shell:

# Bash
ad-sdlc completion --shell bash >> ~/.bashrc
source ~/.bashrc

# Zsh
ad-sdlc completion --shell zsh > ~/.zsh/completions/_ad-sdlc
source ~/.zshrc

# Fish
ad-sdlc completion --shell fish > ~/.config/fish/completions/ad-sdlc.fish

See Quickstart Guide for a step-by-step tutorial.

claude "Implement user dashboard with usage statistics and charts"

claude "Fix #42: Login fails when email contains +"

claude "Refactor auth module to use dependency injection"

claude "Read requirements from docs/requirements.md and implement"

See Use Cases Guide for more examples.

your-project/
├── .claude/
│   └── agents/              # Agent definitions (25 agents)
│       ├── *.md             # English versions (used by Claude)
│       └── *.kr.md          # Korean versions (for reference)
├── .ad-sdlc/
│   ├── config/              # Configuration files
│   │   ├── agents.yaml      # Agent registry
│   │   └── workflow.yaml    # Pipeline configuration
│   ├── logs/                # Audit logs
│   ├── scripts/             # Pipeline shell scripts
│   │   └── ad-sdlc-full-pipeline.sh
│   ├── templates/           # Document templates
│   └── scratchpad/          # Inter-agent state (Scratchpad pattern)
│       └── pipeline/        # Pipeline session state (resume support)
├── docs/                    # Generated documentation
├── src/                     # Generated source code
└── README.md

• Installation Guide - Detailed setup instructions
• Quickstart Guide - 5-minute tutorial
• Use Cases - Common scenarios and examples
• FAQ - Frequently asked questions

• System Architecture
• Document Status Definitions
• PRD-001: Agent-Driven SDLC
• SRS-001: Agent-Driven SDLC
• SDS-001: Agent-Driven SDLC

• Agent Deployment
• Reference Documentation

• PRD-001 (한글)
• SRS-001 (한글)
• SDS-001 (한글)

Each agent is defined in .claude/agents/ with:

• YAML frontmatter (name, description, tools, model)
• Markdown body with role, responsibilities, schemas, and workflows

English versions (.md) are used by Claude during execution. Korean versions (.kr.md) are provided for developer reference.

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes using conventional commits
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

A Claude Code configuration management and development guidelines system. Agents in this project can reference claude-config's guidelines during code generation and review to improve code quality.

• Repository: kcenon/claude-config
• Reference Guide: docs/claude-config-reference.md

BSD 3-Clause License - see LICENSE for details.

Need help? Check the FAQ or open an issue.