⚡ Enterprise SDLC Multi-Agent Framework

The definitive, production-grade Multi-Agent System designed specifically for the software engineering lifecycle (SDLC).
Built for Low-Input $\rightarrow$ High-Output engineering: supply a 1-sentence prompt and let 12 specialized agents autonomously architect, design, test, secure, and document your software in a zero-clutter Living System Brain (.agents/brain.md).
100% compatible with Claude, Google Antigravity, Cursor, Windsurf, GitHub Copilot, and Cline.

💡 The "Low-Input, High-Output" Protocol

You do not need to write long prompts or manage dozens of files. The framework is engineered so you provide 1 sentence of intent, and the agents deliver enterprise-grade architecture:

[Developer: 1 Sentence Intent]
        │
        ▼
[Living Brain: .agents/brain.md] ◄──► [12 Specialist Agents]
        │
        ▼
[Production Architecture, Schemas, APIs, Tests & Deployment Gates]

🎯 3 Golden Low-Input Prompts (Copy & Paste)

1. The Autonomous Full-Stack Build

"@agents System Intent: 'Build a multi-tenant B2B SaaS billing portal with Stripe, PostgreSQL, and Next.js.' Update .agents/brain.md and execute Phase 1 & 2."

2. The Architecture & Database Engine

"@agents Act as Agent 03 (Architect) and Agent 08 (Database). Intent: 'High-throughput real-time auction bidding platform.' Output C4 diagrams, PostgreSQL DDL with row-level locks, and update .agents/brain.md."

3. The Shift-Left Security & QA Audit

"@agents Act as Agent 10 (Security) and Agent 11 (QA). Intent: 'Audit our auth and checkout endpoints.' Produce STRIDE threat model, OWASP Top 10 remediation, and Playwright E2E tests."

🧠 Zero-Clutter Architecture: The Living Brain (.agents/brain.md)

Running npx @sahin11/sdlc-agents init will NOT pollute your repository with dozens of files.
Instead, it creates a single, elegant Living Brain File (.agents/brain.md) containing:

• 🗺️ Visual System Architecture Map: Dynamic Mermaid graph mapping clients, APIs, queues, and databases.
• 📁 Directory & Module Registry: Clear structural index of the codebase.
• 🛡️ Tech Stack & Invariants: Enforced engineering rules and boundaries.
• 📋 Active Pipeline Progress Tracker: Real-time checklist tracking which agent is currently executing.
• 📜 ADR Decision Log: Living index of all architectural decisions.

graph TD
    Client["Client Tier (Web / Mobile SPA)"] -->|HTTPS / TLS 1.3| Ingress["Ingress / API Gateway"]
    Ingress --> AppServices["Backend Core Application Services"]
    AppServices --> PrimaryDB[("Primary Database (PostgreSQL / Relational)")]
    AppServices --> Cache[("In-Memory Cache (Redis)")]
    AppServices --> AsyncQueue["Background Job / Queue Worker"]
    AppServices --> ExtServices["External Third-Party APIs (Auth, Payments)"]

    classDef primary fill:#2563eb,stroke:#1d4ed8,stroke-width:2px,color:#ffffff;
    classDef storage fill:#059669,stroke:#047857,stroke-width:2px,color:#ffffff;
    class Client,AppServices primary;
    class PrimaryDB,Cache storage;

🚀 Quick Start in 30 Seconds

# 1. Initialize the Living Brain in your repository (Zero File Clutter!)
npx @sahin11/sdlc-agents init

# 2. View the Low-Input High-Output Guide in your terminal
npx @sahin11/sdlc-agents guide

# 3. Export IDE rules tailored to your environment
npx @sahin11/sdlc-agents export --target cursor     # Generates .cursorrules
npx @sahin11/sdlc-agents export --target copilot    # Generates .github/copilot-instructions.md
npx @sahin11/sdlc-agents export --target windsurf   # Generates .windsurfrules
npx @sahin11/sdlc-agents export --target antigravity # Generates GEMINI.md

# 4. (Optional) Inspect all agents or workflows
npx @sahin11/sdlc-agents list
npx @sahin11/sdlc-agents workflows

🤖 The 12 Specialist Agents

| # | Agent Name | Tier | Primary Technologies & Competencies | Deliverable Contract | |---|------------|------|-------------------------------------|----------------------| | 01 | Business Analyst | Discovery | User Stories, Gherkin BDD, INVEST, Domain Glossary | Business Requirements Document (BRD) | | 02 | Product Manager | Governance | WBS, RICE scoring, MoSCoW, RAID Register | Product Delivery Plan & Sprint Backlog | | 03 | Solution Architect | Core Arch | C4 Diagrams, ADRs, Hexagonal Arch, OpenAPI 3.1 | System Architecture Document (SAD) | | 04 | UI/UX Designer | Experience | Design Tokens, Spacing Grid, WCAG 2.1 AA | UX Journeys & Design Token Catalog | | 05 | Component Designer | Markup | HTML5, XML, SCSS/BEM, Tailwind CSS, PrimeNG | Production Component Styles & Markup | | 06 | Frontend Engineer | Client App | React 19, Angular 19, Next.js 15, Vue 3, TanStack Query | Type-Safe Responsive Web Client | | 07 | Backend Engineer | Services | Node.js (NestJS), Python (FastAPI/Django), .NET 9 Web API | Clean Architecture Microservices & REST | | 08 | Database Architect | Data Tier | PostgreSQL 16+, MongoDB 7+, Indexing (ESR), Migrations | DDL Schemas, Aggregations & Query Plans | | 09 | DevOps & Cloud | Infrastructure | Docker (Distroless), Kubernetes, AWS/GCP/Azure, Terraform | Multi-Stage Containers & CI/CD Pipelines | | 10 | Security Architect | Governance | OWASP Top 10, STRIDE Threat Modeling, Zero-Trust | Threat Model & Security Policy Matrix | | 11 | QA Automation | Verification | Playwright (E2E), Cypress, Jest, Vitest, PyTest | Automated Test Suites & Coverage Gates | | 12 | Production Gatekeeper | Release | Canary Deployments, Blue-Green, Health Probes, Rollback | PRR Sign-off & Automated Rollback Plan |

🔄 End-to-End Orchestration Workflows

1. 01-full-sdlc-pipeline.md: Autonomous sequential progression from raw business requirements to production canary deployment.
2. 02-api-first-development.md: Enables parallel frontend and backend engineering by establishing an immutable OpenAPI 3.1 contract.
3. 03-security-compliance-audit.md: Automated shift-left security enforcement (SAST/SCA, Gitleaks, OWASP ZAP).
4. 04-production-release-gate.md: Zero-downtime deployment protocol with progressive canary traffic shifting (5% $\rightarrow$ 25% $\rightarrow$ 100%) and instant rollback triggers.

🔌 Universal Code Agent Adapters

🟣 Claude.ai & Anthropic API

Upload agents/ or reference .agents/brain.md directly. See adapters/claude.md.

🔵 Cursor AI

Run npx @sahin11/sdlc-agents export --target cursor to generate .cursorrules.

🟢 Google Antigravity (AGY)

Run npx @sahin11/sdlc-agents export --target antigravity to generate GEMINI.md.

⚪ GitHub Copilot

Run npx @sahin11/sdlc-agents export --target copilot to generate .github/copilot-instructions.md.

🌊 Windsurf & Cline

Run npx @sahin11/sdlc-agents export --target windsurf to generate .windsurfrules.

🛠️ CLI Reference

# Initialize living system brain in current repository
sdlc-agents init

# Display Low-Input High-Output guide
sdlc-agents guide

# View all agents & workflows
sdlc-agents list
sdlc-agents workflows

# Inspect specific agent prompt
sdlc-agents show 03-solution-architect

# Export IDE rules
sdlc-agents export --target [cursor|copilot|windsurf|antigravity]

📄 License

Distributed under the MIT License. See LICENSE for more information.

Developed and maintained by sahin11 ([email protected]).