tdd-workflow

Enforce a seven-step test-driven development workflow with scenario documents and regression tests.

103|21|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/archibate/dotfiles-opencode --skill tdd-workflow-archibate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-workflow
Source: https://github.com/archibate/dotfiles-opencode/tree/main/skills/tdd-workflow
Command: npx skills add https://github.com/archibate/dotfiles-opencode --skill tdd-workflow-archibate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents hallucinated or unverified implementations by enforcing a strict, step-by-step TDD cycle where every transition is confirmed by real test behavior.

Core Features & Use Cases

  • Verified 7-step TDD loop: Drives the workflow from intent discovery to regression-safe final review using RED->GREEN->REFACTOR principles.
  • Scenario-driven requirements: Converts functional requirements into explicit scenario documents with acceptance criteria and test status gates.
  • Failure-first development: Requires writing failing tests before implementing minimal production code, then verifies passing and refactoring without breaking behavior.
  • Use Case: When implementing a new feature (e.g., an API endpoint or a domain rule), it helps ensure you define scenarios clearly, prove correctness with tests, and avoid merging code that only “seems” correct.

Quick Start

Ask the AI to apply the tdd-workflow to your next feature by creating the step reports, scenario docs, failing tests, minimal implementation, refactoring, and final regression verification.

Frequently Asked Questions about tdd-workflow

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

FAQPage Schema
How do I enforce test-driven development to prevent hallucinated or unverified implementations?

Enforce test-driven development by applying a strict seven-step workflow that requires real test execution results before transitioning between phases, ensuring verified progress. This prevents unchecked assumptions by synchronizing scenario documents, test files, and checkbox updates.

How do I turn functional requirements into scenario documents for unit tests?

Turn functional requirements into scenario documents by defining explicit acceptance criteria and test status gates before writing code. This scenario-driven approach ensures requirements are clearly established and proven correct through failing tests prior to minimal implementation.

What is the Red Green Refactor workflow for reliable software development?

The Red Green Refactor workflow is a failure-first development process that requires writing failing tests, producing minimal code to make tests pass, then refactoring while preserving behavior. It drives the workflow from intent discovery to regression-safe final review.

How do I run regression tests after refactoring code without breaking behavior?

Run regression tests after refactoring by executing the full test suite to verify that existing behavior is preserved. The workflow requires running these tests to confirm that refactoring did not introduce regressions before final review.

Can I use this TDD workflow for implementing new API endpoints and domain rules?

You can use this TDD workflow for implementing new API endpoints or domain rules because it handles new feature implementation by defining scenarios clearly and proving correctness with tests. It ensures you avoid merging code that only seems correct.

Why do scenario doc counts and test file counts need to be synchronized?

Scenario doc counts and test file counts need synchronization to maintain invariants that prevent hallucinated progress. This strict requirement ensures that every scenario document has a corresponding verified test file reflecting real test execution results.