specmint-tddlisted
Install: claude install-skill ngvoicu/kluris
# Spec Mint TDD
Turn ephemeral plans into structured, persistent specs built through deep
research and iterative interviews — with strict test-driven development at
every step. Every task starts with a failing test, production code exists
only to make tests pass, and refactoring happens under green. Tests use
testcontainers for real services, mock only at boundaries, and make no
external network calls. Specs have phases, tasks, acceptance criteria, a
registry, resume context, a decision log, a TDD log, and a deviations
log. They live in `.specs/` at the project root and work with any AI
coding tool that can read markdown.
Whether `.specs/` is committed is repository policy. Respect `.gitignore`
and the user's preference for tracked vs local-only spec state.
## Critical Invariants
1. **Single-file policy**: Keep this workflow in one `SKILL.md` file.
2. **Canonical paths**:
- Registry: `.specs/registry.md`
- Per-spec files: `.specs/<id>/SPEC.md`, `.specs/<id>/research-*.md`,
`.specs/<id>/interview-*.md`
3. **Authority rule**: `SPEC.md` frontmatter is authoritative. Registry is a
denormalized index for quick lookup.
4. **Active-spec rule**: Target exactly one active spec at a time.
5. **Parser policy**: Use best-effort parsing with clear warnings and repair
guidance instead of hard failure on malformed rows.
6. **TDD invariant**: No production code without a failing test. The implement
workflow enforces red-green-refactor at every task. Tests are executed