.claude/skills/tdd-workflow/SKILL.md
Test-Driven Development workflow for autonomous coding. Use when implementing features with TDD, writing tests first, following red-green-refactor, or ensuring test coverage.
npx skillsauth add adaptationio/skrillz tdd-workflowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Implements Test-Driven Development workflow for feature implementation.
from scripts.tdd_workflow import TDDWorkflow
workflow = TDDWorkflow(project_dir)
result = await workflow.implement_feature(
feature_id="auth-001",
acceptance_criteria=criteria
)
if result.passed:
print("Feature implemented and verified!")
# Red: Write failing test
test_path = await workflow.write_test(feature_id)
# Green: Implement to pass
await workflow.implement_code(feature_id)
# Refactor: Clean up
await workflow.refactor(feature_id)
┌─────────────────────────────────────────────────────────────┐
│ TDD CYCLE │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 1. RED │ │
│ │ Write failing test │ │
│ │ Test must fail │ │
│ │ │ │
│ └───────────────────┬─────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 2. GREEN │ │
│ │ Write minimal code │ │
│ │ to pass test │ │
│ │ │ │
│ └───────────────────┬─────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 3. REFACTOR │ │
│ │ Improve code quality │ │
│ │ Keep tests passing │ │
│ │ │ │
│ └───────────────────┬─────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 4. VERIFY (E2E) │ │
│ │ Run acceptance tests │ │
│ │ Confirm feature works │ │
│ │ │ │
│ └─────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
| Principle | Description | |-----------|-------------| | Tests First | Always write tests before implementation | | Minimal Code | Write only enough code to pass tests | | Small Steps | Make incremental changes | | Fast Feedback | Run tests frequently | | Refactor Often | Keep code clean |
| Type | Purpose | When to Write | |------|---------|---------------| | Unit | Test individual functions | RED phase | | Integration | Test component interaction | After GREEN | | E2E | Test full feature flow | VERIFY phase |
references/TDD-BEST-PRACTICES.md - Best practicesreferences/TEST-PATTERNS.md - Common patternsscripts/tdd_workflow.py - Main workflowscripts/test_writer.py - Generate testsscripts/test_runner.py - Run testsscripts/refactor_helper.py - Refactoring toolsdevelopment
Setup secure web-based terminal access to WSL2 from mobile/tablet via ttyd + ngrok/Cloudflare/Tailscale. One-command install, start, stop, status. Use when you need remote terminal access, web terminal, browser-based shell, or mobile access to WSL2 environment.
development
Complete development workflows where Claude writes the code while Gemini and Codex provide research, planning, reviews, and different perspectives. Claude remains the main developer. Use for complex projects requiring expert planning and multi-perspective reviews.
development
Systematic progress tracking for skill development. Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum. Use when tracking skill development, coordinating work, or reporting progress.
testing
Comprehensive testing workflow orchestrating functional testing, example validation, integration testing, and usability assessment. Sequential workflow for complete skill testing from examples through scenarios to integration validation. Use when conducting thorough testing, pre-deployment validation, ensuring skill functionality, or comprehensive quality checks.