TDD Issues Workflow

Enforce a strict Test-Driven Development workflow for docs/ISSUES.md issues.

Updated Aug 16, 2022
One-click install
npx skills add https://github.com/katylava/name-carousel --skill tdd-issues-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TDD Issues Workflow
Source: https://github.com/katylava/name-carousel/tree/main/.claude/skills/tdd-issues
Command: npx skills add https://github.com/katylava/name-carousel --skill tdd-issues-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves? This Skill automates the rigorous process of Test-Driven Development (TDD) for issue resolution, ensuring every bug fix or feature implementation adheres to strict quality standards. It eliminates the manual overhead of process enforcement, allowing developers to focus on creative problem-solving while the AI handles systematic execution, testing, and documentation.

Core Features & Use Cases

  • Strict TDD Enforcement: Automatically guides the development process to write failing tests before implementing code for non-CSS changes, guaranteeing robust and verifiable solutions.
  • Automated Issue Management: Systematically processes issues from docs/ISSUES.md, handling pre-flight checks, status updates (DONE, REJECTED, RE-REVIEW), and cleanup of approved issues.
  • Comprehensive Quality Assurance: Ensures 100% code coverage, runs full test suites, and performs visual verification for CSS-only changes, maintaining high code quality and preventing regressions.
  • Use Case: When a project has a backlog of issues, this Skill can be activated to systematically work through them. It will identify the next task, write necessary tests, implement the solution, verify success, commit changes, and update the issue tracker, all while strictly adhering to TDD principles and ensuring full test coverage.

Quick Start

To activate this Skill and begin working on project issues:

"Claude, please start working through the issues in docs/ISSUES.md using the TDD workflow."

Frequently Asked Questions about TDD Issues Workflow

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

FAQPage Schema
How do I implement test-driven development for bug fixes and feature development?

Test-driven development (TDD) for bug fixes and features involves writing failing tests first, then implementing code to pass those tests. This Skill automates the TDD workflow by enforcing test creation before implementation, running end-to-end tests, verifying 100% code coverage, and committing changes with proper documentation, ensuring robust and verifiable solutions.

Can I automate issue management and track resolution status across my project?

Yes. This Skill systematically processes issues from docs/ISSUES.md, handling pre-flight checks, updating status (DONE, REJECTED, RE-REVIEW), and cleaning up approved issues. It manages the complete issue lifecycle while enforcing TDD principles, eliminating manual overhead of process tracking and allowing focus on problem-solving.

What's the best way to ensure code quality and prevent regressions when fixing issues?

Comprehensive quality assurance combines strict TDD enforcement, full test suite execution, 100% code coverage validation, and visual verification for CSS-only changes. This Skill enforces all these checks automatically, guaranteeing high code quality and preventing regressions across bug fixes and feature implementations.

How do I work through a backlog of issues systematically with automation?

Activate this Skill to process your docs/ISSUES.md backlog: it identifies the next task, writes necessary tests, implements solutions, verifies success with end-to-end tests and coverage checks, commits changes with proper formatting, and updates the issue tracker—all while adhering strictly to TDD principles.

Does this workflow apply to both code changes and CSS-only modifications?

Yes. This Skill handles CSS-only changes through visual verification and non-CSS changes through strict TDD with failing tests first. It adapts the workflow to the type of change while maintaining consistent quality standards and comprehensive test coverage across all issue types.