ai-development-framework

# 🤖 AI Development Framework v5.2

> A Claude Code plugin for **spec-driven development**: write the spec, then the plan, then the
> code — with quality gates that are enforced by hooks rather than by good intentions.

---

## 🎯 What it is

Claude Code will happily write code from a one-line prompt. That works until the change is big
enough that "what were we building?" stops having an obvious answer — and then it fails quietly,
by building the wrong thing well.

This framework adds the missing middle. A feature goes **idea → spec → plan → tasks → code**, with
a human gate at each seam, and the pipeline refuses to skip ahead. Around that sit six specialist
agents, nine hooks, and a set of rules that load into every session.

The parts that matter are the ones you cannot talk your way past:

- ✅ **A `TaskCompleted` hook blocks a task from being marked done while the tests fail.** Not a
  reminder — a hook that exits non-zero and refuses.
- 🔐 **A pre-commit hook runs secrets detection and linting**, and blocks the commit if they fail.
- 🚧 **A plan-phase hook blocks edits outside `.specify/`** while a plan is being written, so the
  agent cannot start coding "just to check somethi…