TDD-Driven Spec Management for AI Coding Workflows

TDD-Driven Spec Management for AI Coding Workflows

This AI agent skill provides a test-driven development (TDD) approach to spec management, designed for AI coding workflows using tools such as Claude Code, Cursor, and Codex. It creates structured, persistent specification documents from ephemeral plans, ensuring disciplined and iterative software development. The skill activates when specific commands or pre-defined directory structures indicate a focus on specs.

What this skill does

• Initiates spec management workflow when users mention keywords related to specs or an existing `.specs/` directory is detected.
• Transforms initial objectives and plans into structured specifications using deep research and iterative interviews.
• Enforces a strict TDD protocol, starting all tasks with a failing test, leading through green refactoring cycles.
• Generates professional HTML spec documents featuring Mermaid diagrams, syntax-highlighted code diffs, and UI mockups.
• Integrates testcontainers for testing real services with mocking restricted to service boundaries.
• Ensures tests do not execute external network calls.

Who it is for

This skill is intended for developers and teams utilizing AI coding agents, particularly those who prioritize structured planning and documentation in their software development processes. It supports professionals seeking consistent specification management within TDD workflows.

Use cases

• Turning conceptual user stories into formal specifications within AI-driven coding projects.
• Maintaining well-documented progress through different phases of software development.
• Implementing a rigorous test-driven development cycle for consistent, high-quality code.

Technical details

• Works with AI coding agents such as Claude Code, Cursor, and Codex.
• Uses the Spec Mint TDD HTML tool to convert plans into specifications.
• Adheres to repository policies regarding the inclusion of the `.specs/` directory.
• Supports integration with any tool capable of reading and editing HTML documents.

Source & Licence

This package is built on open-source work published by ngvoicu (ngvoicu/kluris) and distributed under MIT. The original licence text and copyright notice are included in your download.

Personal and commercial use, modification and redistribution are permitted, provided the original copyright and licence notice are retained.

Your purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.

Delivery & Support

• Delivery: instant — a secure download link is emailed to you as soon as payment is confirmed.
• Format: ZIP archive containing the skill files, documentation and the original licence.
• Support: support@mcpcart.com — we aim to reply within 2 business days.
• Updates: updates are included only where stated on this page.

Refunds

This is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.

Claude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.