tdd-workflow

What This Skill Does

The tdd-workflow skill serves as the primary gateway for Test-Driven Development (TDD) within the SpecWeave ecosystem. It is an intelligent discovery hub designed to identify when a user intends to employ the Red-Green-Refactor methodology. Rather than being a monolithic tool, it acts as a coordinator, ensuring developers follow a disciplined approach by offering three distinct paths: the strictly enforced Guided TDD Workflow via /sw:tdd:cycle, the flexible Expert TDD Agent (tdd-orchestrator) for complex tasks, or a Manual TDD mode for experienced practitioners who need occasional advice. By bridging the gap between intent and execution, this skill ensures that testing is never an afterthought, helping users maintain a clean, high-coverage codebase from the very first line of implementation.

Installation

To integrate this into your workflow, execute the following command in your terminal: clawhub install openclaw/skills/skills/anton-abyzov/sw-tdd-workflow This installs the discovery hub and links the necessary dependencies for the orchestrator and phase-specific command gates.

Use Cases

This skill is ideal for:

1. Beginners wanting to build a habit of TDD through rigid gatekeeping.
2. Experienced engineers needing to refactor legacy codebases with safety nets.
3. Teams requiring advanced testing strategies like property-based testing (via the Expert Agent).
4. Any project where code quality and maintainability are critical success metrics.

Example Prompts

1. "Implement authentication with TDD, I want to ensure my tests are as strong as my code."
2. "Use test-driven development for this payment module, I'm new to this and need the guided cycle."
3. "Let's do red-green-refactor for the data parser; can you use the expert agent to help with edge cases?"

Tips & Limitations

• Tip: If you are learning, always opt for the 'Guided TDD Workflow' to prevent skipping the RED phase, which is a common pitfall.
• Tip: For complex, multi-module systems, the 'Expert TDD Agent' is significantly more effective as it can perform mutation testing and coordinate across multiple files.
• Limitation: This skill is a router. It does not contain the core logic for running your specific language's test runner directly; ensure your environment is configured for your chosen language's test framework.