agentic-sdlc

agentic-sdlc

A multi-agent orchestration framework for Claude Code that brings structured software development lifecycle (SDLC) workflows to AI-assisted development. Choose your own frontend, backend, and database stack during installation — the CLI generates tailored agent configurations for any supported combination.

---

Why This Exists

Claude Code is powerful, but without structure it tends toward single-agent, ad-hoc development. This framework introduces:

• Role-based agents that mirror a real development team (architect, devs, testers, PO, UX)
• Orchestrated workflows that coordinate agents through design → implement → test → deploy phases
• Composable templates that generate stack-specific agent configurations for any project
• Quality gates with feedback loops and escalation to prevent runaway iteration

The result: Claude Code operates more like a coordinated development team than a single assistant.

---

Prerequisites

• Claude Code CLI installed and configured
• Node.js 18+ (for the scaffolding CLI)
• Git

---

Installation

Step 1: Install the Plugin

Option A: Install from GitHub (recommended — works for anyone):

From within a Claude Code session:

/plugin marketplace add syanix/agentic-sdlc
/plugin install agentic-sdlc --scope user

This installs globally — all projects get the 5 orchestration agents and 5 workflow commands.

Option B: Development mode (for plugin contributors):

claude --plugin-dir /path/to/agentic-sdlc

Loads the plugin from a local clone for the current session. Changes take effect on next session (or use /reload-plugins).

Option C: Clone to plugins directory:

git clone https://github.com/syanix/agentic-sdlc.git ~/.claude/plugins/agentic-sdlc

Step 2: Scaffold Your Project

Navigate to your project directory and run the CLI. You choose your own stack combination — there are no fixed presets to be locked into.

Interactive Mode (recommended for first-time use)

cd ~/my-project
npx create-agentic-project

The wizard walks you through each choice:

🏗  Create Agentic Project
Configure your Claude Code agent stack.

? Backend framework:    › NestJS / Go (Gin/Echo) / Python (FastAPI) / .NET 10 / Cloudflare Workers
? Frontend framework:   › Next.js (App Router) / Astro / React (Vite)
? Database hosting:     › Neon Postgres / Supabase Postgres / Fly.io Postgres (unmanaged) / Cloudflare D1
? E2E testing framework:› Playwright / Cypress
? Agent preset:         › Full SDLC / Minimal / Prototype / Backend Only / Frontend Only

Non-Interactive Mode (CI/scripting)

Pass your choices as flags to skip the wizard entirely:

npx create-agentic-project \
  --frontend nextjs \
  --backend dotnet \
  --database flyio \
  --testing-e2e playwright \
  --preset full-sdlc

Only --frontend and --backend are required. Other flags have sensible defaults:

• --database defaults to Neon Postgres (or the only valid option for your backend)
• --testing-e2e defaults to Playwright
• --preset is inferred from your stack (full-sdlc for full-stack, backend-only/frontend-only when appropriate)

Step 3: Start Working

Use the workflow commands in any Claude Code session:

/feature Add user authentication with OAuth2 and email/password
/review security src/auth/
/improve performance src/api/
/analyze architecture
/deploy staging

---

Stack Combinations

You can mix and match any frontend, backend, and database from the supported options below. The CLI validates compatibility and generates the correct agent configuration for your combination.

Available Choices

Category	Options
Frontend	Next.js (App Router), Astro, React (Vite), None
Backend API	NestJS (Prisma), Go (Gin/Echo), Python (FastAPI), .NET 10, Cloudflare Workers (Hono + Drizzle), None
Database	Neon Postgres, Supabase Postgres, Fly.io Postgres (unmanaged), Cloudflare D1 (SQLite edge), None
E2E Testing	Playwright, Cypress, None

Example Combinations

Here are some common stack combinations you can create:

# Full-stack TypeScript: Next.js + NestJS + Neon
npx create-agentic-project \
  --frontend nextjs --backend nestjs --database neon

# .NET API with React frontend on Fly.io
npx create-agentic-project \
  --frontend react-vite --backend dotnet --database flyio

# Python FastAPI with Astro frontend on Supabase
npx create-agentic-project \
  --frontend astro --backend python --database supabase-db

# Go microservice with Next.js frontend
npx create-agentic-project \
  --frontend nextjs --backend go --database neon

# Lightweight Astro content site on Cloudflare Workers + D1
npx create-agentic-project \
  --frontend astro --backend cloudflare --database cloudflare-d1