🤖 create-sdlc-agents

18 specialized AI agents for the entire Software Development Lifecycle.
Supports both Claude Code and GitHub Copilot — plug-and-play into any project.

🚀 Quick Install

# Interactive setup wizard (recommended)
npx create-sdlc-agents

# Non-interactive with flags
npx create-sdlc-agents --platform both --type fullstack --no-interactive

# Backend API project (Claude only)
npx create-sdlc-agents --platform claude --type backend-api --no-interactive

✨ Features

• 🧠 18 specialized agents — each with dedicated prompts, workflows, and guardrails
• 🔄 14 core protocols — Reflection, Debate, HITL (L1-L4), Guardrails, Error Recovery, and more
• 📚 27 skill libraries — reusable capability modules for testing, security, CI/CD, etc.
• 🔍 Auto-detect 11 languages — TypeScript, Python, Go, Java, PHP, Ruby, Rust, C#, Dart, Elixir, Swift
• 🏗️ Multi-service & monorepo support — auto-discovers sub-projects and generates services.yml
• 🔐 Dynamic MCP generation — database-aware server configs with credential placeholders
• 📋 Post-scaffold verify — built-in agent prompt to validate the entire config
• 🖥️ Cross-platform — Windows, macOS, Linux — works everywhere Node.js runs

⚡ Quick Start (5 minutes)

# 1. Scaffold agents into your project
cd my-existing-project
npx create-sdlc-agents

# 2. Configure your tech stack (auto-detected!)
# Edit: .claude/config/project.config.yml

# 3. Describe your project for AI context
# Edit: .claude/memory/project-context.md

# 4. Start using agents!
@setup-assistant Analyze my project and verify config
@implementer Create a CRUD service for the products module
@qa-tester Write unit tests for ProductService
@code-reviewer Review the products module

🏗️ Architecture

                  User Request
                       │
              ┌────────▼────────┐
              │    @router      │  Classify & orchestrate
              └────────┬────────┘
                       │
         ┌─────────────┼─────────────┐
         │ Simple      │ Complex     │
         ▼             ▼             │
   Single Agent    @planner          │
                   (Decompose)       │
                       │             │
              ┌────────▼────────┐    │
              │   PIPELINE      │    │
              │                 │    │
              │ Design: @architect, @db-designer, @api-designer     │
              │ Build:  @implementer, @frontend-dev                 │
              │ Test:   @qa-tester, @code-reviewer, @security-aud   │
              │ Ship:   @devops, @tech-writer                       │
              └─────────────────┘

🤖 18 Agents

📦 Supported Project Types

🔍 Auto-Detection (11 Languages)

The CLI automatically detects your project's tech stack:

Also detects: ORM (Prisma, Eloquent, ActiveRecord, Doctrine, EF Core), Auth (JWT, Passport, NextAuth), Database (from docker-compose.yml or .env).

🏢 Multi-Service & Monorepo

For microservice architectures with mixed languages:

my-platform/
├── api-laravel/        ← composer.json → PHP + Laravel
├── api-go-gateway/     ← go.mod → Go + Gin  
├── web-admin/          ← package.json → TypeScript + React
├── batch-etl/          ← requirements.txt → Python
├── api-rust-perf/      ← Cargo.toml → Rust + Actix
└── api-dotnet/         ← MyApi.csproj → C# + .NET

cd my-platform
npx create-sdlc-agents
# → Auto-detects all 6 services
# → Generates services.yml with per-service config
# → Creates cross-service dependency map

🗂️ What Gets Scaffolded

your-project/
├── .claude/                     ← Claude Code agent system
│   ├── .mcp.json                ← MCP servers (edit credentials here)
│   ├── CLAUDE.md                ← Global rules
│   ├── agents/ (18 files)       ← Agent definitions
│   ├── core/ (14 files)         ← Core protocols  
│   ├── skills/ (27 folders)     ← Skill library
│   ├── config/
│   │   ├── project.config.yml   ← Tech stack config (auto-filled)
│   │   └── services.yml         ← Service registry (multi-service only)
│   └── memory/
│       ├── project-context.md   ← Project description (YOU EDIT THIS)
│       ├── lessons-learned.md   ← Auto-updated bug patterns
│       └── inbox/               ← Drop docs here for ingestion
│
├── .github/                     ← GitHub Copilot agent system
│   ├── agents/ (18 .agent.md)   ← Same agents, Copilot format
│   ├── core/, skills/, config/  ← Full parity with Claude
│   └── ...
│
├── .vscode/
│   └── mcp.json                 ← MCP config for VS Code / Copilot
│
└── AGENTS_README.md             ← Quick start guide

🔄 Cross-Platform Parity

Both systems share the same 18 agents, 14 protocols, and 27 skills — only file format differs:

📖 Documentation

🔒 Security

• MCP files are generated with <YOUR_TOKEN> placeholders — no credentials leak
• Add to .gitignore: .claude/.mcp.json and .vscode/mcp.json
• Built-in guardrails block dangerous commands (DROP TABLE, rm -rf, etc.)

📊 Stats

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Run tests: npm test (195 assertions across 18 test suites)
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push and open a Pull Request

📄 License

MIT — see LICENSE for details.

Enterprise SDLC Agent System v5.0 — A+ Grade (9.55-9.58/10)

© 2026 Doan Hai Duy — Built with Claude Opus 4.6