devflow-tdd-enforcer

Block TASKS.md saves when implementation tasks precede test tasks.

111|21|Updated Sep 17, 2025
One-click install
npx skills add https://github.com/Dimon94/cc-devflow --skill devflow-tdd-enforcer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devflow-tdd-enforcer
Source: https://github.com/Dimon94/cc-devflow/tree/main/.claude/skills/devflow-tdd-enforcer
Command: npx skills add https://github.com/Dimon94/cc-devflow --skill devflow-tdd-enforcer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents developers from accidentally or intentionally bypassing Test-First Development (TDD) principles by blocking the completion of implementation tasks before their corresponding test tasks. This ensures strict adherence to project mandates and maintains high code quality.

Core Features & Use Cases

  • Real-time TDD Enforcement: Blocks file saves in TASKS.md if the TDD order (Tests before Implementation) is violated, providing immediate feedback.
  • Constitutional Mandate: Upholds Article VI of the project's Constitution, ensuring test coverage and quality standards are met.
  • Use Case: A developer attempts to mark an "Implement user login" task as complete before the "Test user login" task. The skill immediately blocks the save, prompting the developer to correct the TDD sequence and prioritize testing.

Quick Start

Mark the test task [x] as complete before marking the implementation task [x] in devflow/requirements/REQ-XXX/TASKS.md.

Frequently Asked Questions about devflow-tdd-enforcer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce Test-First Development to prevent implementation before tests?

Test-First Development (TDD) enforcement blocks marking implementation tasks complete until their corresponding test tasks are finished. This Skill automatically detects violations in devflow/requirements/TASKS.md files and prevents saves that break the test-before-code sequence, ensuring immediate compliance.

Can I use TDD enforcement with Claude workflow automation?

Yes. This Skill integrates into Claude workflows via PreToolUse hooks, monitoring TASKS.md edits in real-time. It applies specifically to US story tasks within devflow/requirements directories, catching TDD violations before file changes are saved.

What happens when I try to mark an implementation task complete before its test task?

The Skill blocks the file save and prompts you to correct the task sequence. You must mark the test task complete first, ensuring tests are written and passing before implementation work is considered done.

How does TDD enforcement maintain code quality and project standards?

By mandating test tasks precede implementation tasks, the Skill upholds constitutional project requirements for test coverage and quality gates. Real-time blocking prevents accidental or intentional bypasses of Test-First Development principles.

Does TDD enforcement work with configurable skip options?

Yes. The Skill provides configurable skip options, allowing selective override of enforcement rules when needed, while maintaining default strict adherence to Test-First Development order across all standard US story tasks.