AD-SDLC: Agent-Driven Software Development Lifecycle

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

Quick Start

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.

What is AD-SDLC?

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:

Greenfield Pipeline (New Projects)

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

Enhancement Pipeline (Existing Projects)

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)

Import Pipeline (Existing GitHub Issues)

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

Agent Pipeline (25 Agents)

Phase	Agent	Role
Orchestration	AD-SDLC Orchestrator	Coordinates the full pipeline lifecycle
	Analysis Orchestrator	Coordinates the analysis sub-pipeline
Setup	Mode Detector	Detects Greenfield vs Enhancement vs Import mode
	Project Initializer	Creates `.ad-sdlc` directory structure and config
	Repo Detector	Determines if existing repo or new setup needed
	GitHub Repo Setup	Creates and initializes GitHub repository
Collection	Collector	Gathers requirements from text, files, and URLs
	Issue Reader	Imports existing GitHub Issues for Import pipeline
Documentation	PRD Writer	Generates Product Requirements Document
	SRS Writer	Generates Software Requirements Specification
	SDS Writer	Generates Software Design Specification
Planning	Issue Generator	Creates GitHub Issues from SDS components
Execution	Controller	Orchestrates work distribution and monitors progress
	Worker	Implements code based on assigned issues
Quality	PR Reviewer	Creates PRs and performs automated code review
	CI Fixer	Automatically diagnoses and fixes CI failures
	Regression Tester	Validates existing functionality after changes
Enhancement	Document Reader	Parses existing PRD/SRS/SDS documents
	Code Reader	Extracts source code structure and dependencies
	Codebase Analyzer	Analyzes current architecture and code structure
	Doc-Code Comparator	Detects gaps between documentation and code
	Impact Analyzer	Assesses change implications and risks
	PRD Updater	Incremental PRD updates (delta changes)
	SRS Updater	Incremental SRS updates (delta changes)
	SDS Updater	Incremental SDS updates (delta changes)

Features

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

Installation

Prerequisites

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

Install

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

# Or use directly with npx
npx ad-sdlc init

Configure

# 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.

Usage

Initialize a New Project

# 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

Template Options

Template	Workers	Coverage	Features
minimal	2	50%	Basic structure
standard	3	70%	Token tracking, dashboard
enterprise	5	80%	Audit logging, security scanning

Run the Pipeline

# 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"

CLI Commands

# 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>

Full Pipeline Script

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

Shell Autocompletion

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.

Use Cases

New Feature Implementation

claude "Implement user dashboard with usage statistics and charts"

Bug Fix Workflow

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

Refactoring Project

claude "Refactor auth module to use dependency injection"

From Requirements File

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

See Use Cases Guide for more examples.

Project Structure

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

Documentation

Getting Started

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

Reference

Guides

Korean Documentation

Agent Definitions

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.

Contributing

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

Quick Start for Contributors

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

Related Projects

claude-config

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

License

BSD 3-Clause License - see LICENSE for details.

Need help? Check the FAQ or open an issue.

Claude Code Agent

AI-Agent Assisted

README