Agent skill · software engineering · aiskillstore

flow-tdd

Enforces TDD Iron Law in flow-dev. NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST.

Why this skill is useful

Provides a structured TDD workflow with specific phases and requirements that the AI wouldn't reliably generate on its own.

What it needs

About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

Flow TDD - Test-Driven Development Enforcement The Iron Law This is NON-NEGOTIABLE. No exceptions. No "just this once." The TDD Cycle Enforcement in flow-dev Phase 2: Tests First Phase 3: Implementation What If Code Already Exists? If you've written code before tests: Rationalization Prevention Excuse Reality -------- --------- "Too simple to test" Simple code breaks. Test takes 30 seconds. "I'll test after" Tests passing immediately prove nothing. "Tests after achieve same goals" Tests-after = "what does this do?" Tests-first = "what should this do?" "Already manually tested" Ad-hoc ≠ systematic. No record, can't re-run. "Deleting X hours is wasteful" Sunk cost fallacy. Keeping unverified code is technical debt. "Keep as reference, write tests first" You'll adapt it. That's testing after. Delete means delete. "Need to explore first" Fine. Throw away exploration, start with TDD. "Test hard = design unclear" Listen to test. Hard to test = hard to use. "TDD slows me down" TDD faster than debugging. Pragmatic = test-first. "This is different because..." No. This is rationalization. Follow the law. "Spirit not letter" Violating letter IS violating spirit. No loopholes. "I'm being pragmatic, not dogmatic" TDD IS pragmatic. Shortcuts = debugging in production = slower. "Just this once" No exceptions. Rules exist for this exact moment. Red Flags - STOP If you find yourself: Writing code before tests Tests passing immediately Saying "just this once" Keeping "exploration" code Writing tests that describe existing code STOP. Delete the code. Write the test first. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/flow-tdd

View the source on GitHub

Browse the @skills marketplace