Agentic SDD (Spec-Driven + TDD)

Agentic Workflow — Spec-Driven Development + TDD

A reusable Claude Code workflow that enforces Spec-Driven Development (SDD) and Test-Driven Development (TDD) across a full-stack TypeScript/JavaScript, C#/.NET, and Python stack: React, React Native, Node.js (Express/Fastify), NestJS, Next.js, C# / ASP.NET Core Web APIs, Avalonia (XAML) desktop, Python (Django/DRF, FastAPI, Flask), PostgreSQL, MongoDB.

It ships as a Claude Code plugin (agentic-sdd) and as a copyable .claude/ folder, so you can install it in any repo and start shipping clean, tested, maintainable code. Cross-platform, including macOS (Tahoe) on Apple Silicon — .NET work targets modern cross-platform .NET 8/9 (arm64-native), not the Windows-only .NET Framework.

Read CLAUDE.md for the full source of truth on how the agents, skills, commands, hooks, and rules work together.

What's inside

• 19 agents — 8 lifecycle agents (architect, spec-writer, tdd-test-writer, implementer, e2e-tester, code-reviewer, refactorer, cicd-engineer) + 11 stack experts (React, React Native, Node/Express/Fastify, NestJS, Next.js, C#/ASP.NET Core, Avalonia/XAML, Django/DRF, FastAPI, Flask, PostgreSQL/MongoDB).
• 13 commands — /feature, /plan, /spec, /tdd, /implement, /e2e, /review, /refactor, /cicd, /update-pr, /triage-copilot, /triage-reviews, /ship.
• 7 skills — spec-driven-development, tdd-workflow, e2e-testing, clean-code, stack-testing-recipes, cicd-pipelines, pr-description.
• Enforcing, polyglot hooks — block focused tests/debugger/Debugger.Break()/breakpoint(), format/lint changed files (ESLint, dotnet format, or ruff), and gate git commit on the toolchains the repo has (JS: lint + types + tests; .NET: format + build -warnaserror + test; Python: ruff + mypy + pytest).
• 5 rule files — workflow, testing, clean code, security, git hygiene.
• CI templates — a build-and-test GitHub Actions workflow (Node + .NET on macOS Apple Silicon) you can drop into target repos with --with-ci. This repo's own CI just validates the plugin.

Quick start (this repo)

Open this folder with Claude and run:

/feature add a health-check endpoint that returns build version and DB status

It runs the whole loop — spec → failing tests → implementation → E2E → review → ship — stopping at the approval gates.

Install into another repo

Two ways to install. Option A (plugin) is recommended — it updates cleanly from this repo and copies nothing into your target's git history. Option B (copy) is fully self-contained — use it when you can't depend on a marketplace or want the workflow checked into the repo. After either, open the target repo with Claude and run /feature … to start.

Option A — install as a plugin (recommended, updatable)

One-time setup: push this template to a GitHub repo you control. It already has .claude-plugin/marketplace.json at the root, which is what makes the repo a plugin marketplace.

Then, in the target project:

/plugin marketplace add walmanarias/agentic-workflow
/plugin install agentic-sdd@agentic-workflow

• Replace walmanarias/agentic-workflow with your repo path. A full Git URL or a local path also work — handy during local development before you push: /plugin marketplace add ./path/to/agentic-workflow.
• The plugin installs at user scope by default (available in all your projects). Add --scope project to scope it to this repo only, or --scope local for a personal, uncommitted install: /plugin install agentic-sdd@agentic-workflow --scope project.
• Run /plugin anytime for the interactive menu (Discover / Installed / Marketplaces / Errors).

Make it automatic for a team. Commit these keys to the target repo's .claude/settings.json, and anyone who opens the repo with Claude gets the marketplace and plugin without manual steps:

{
  "extraKnownMarketplaces": {
    "agentic-workflow": {
      "source": { "source": "github", "repo": "walmanarias/agentic-workflow" }
    }
  },
  "enabledPlugins": {
    "agentic-sdd@agentic-workflow": true
  }
}

Updating an existing install — pull the latest after this template changes:

/plugin marketplace update agentic-workflow     # refresh the catalog from your repo
/plugin install agentic-sdd@agentic-workflow    # reinstall to pull the newest version

Or enable auto-update from /plugin → Marketplaces. To remove: /plugin uninstall agentic-sdd@agentic-workflow (and /plugin marketplace remove agentic-workflow to drop the source — note that also uninstalls its plugins).

Option B — copy the .claude/ folder (self-contained)

From your local checkout of this template:

bash scripts/install.sh /path/to/your/repo