Specs Driven Development Spring Angular

Spec-Driven Development for Spring Boot 4 + Angular

A tri-platform toolkit (Claude Code · GitHub Copilot · Windsurf) that drives Spring Framework 7 / Spring Boot 4 and Angular full-stack development through a documented, self-validating workflow:
specify → review → plan → implement (TDD) → test → validate → review → commit

The agent validates its own work via a layered harness (build, static analysis, architecture, tests, coverage, mutation, contract, security) instead of relying on a human to inspect every line.

Why

- No invention. During specify/review/plan/tasks, the agent never guesses; every uncertainty becomes a tracked open question that you answer before progress continues.
- TDD by construction. Production code can only be written *after* a failing test exists. Hooks enforce it.
- Traceable. Every acceptance criterion (AC-NNN) maps to tests, code, and the harness gates that exercised it.
- Self-validating. A single .github/scripts/harness.sh runs locally and in CI; the agent reads its reports and writes a structured validation report.
- Pre-commit code review by an agent that uses a Spring-specific rubric.
- Tri-platform with a platform-neutral core; thin wrappers for each tool.

Install

This toolkit is a set of files you drop into your repo, not a package you npm install or mvn install. Pick the path that matches your situation.

Prerequisites

- Backend: Java 25 + Maven 3.9+ (for the Spring harness to run).
- Frontend: Node.js 22+ and Angular CLI 20+ (for the Angular harness — lint, typecheck, unit tests, build, e2e).
- At least one supported agent surface installed:
  - Claude Code (uses .claude/)
  - GitHub Copilot in VS Code with chat enabled (uses .github/)
  - Windsurf (uses .windsurf/)
- bash, git, jq on your PATH (the harness scripts use…