tdd-design

Orchestrate TDD design conversations and generate design.md artifacts.

4|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/CurtisThe/three-pillars-plugin --skill tdd-design-curtisthe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-design
Source: https://github.com/CurtisThe/three-pillars-plugin/tree/main/skills/tdd-design
Command: npx skills add https://github.com/CurtisThe/three-pillars-plugin --skill tdd-design-curtisthe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams through a structured, collaborative process to create and maintain high-level TDD designs, turning conversations into a concrete design artifact.

Core Features & Use Cases

  • Structured design conversations that surface problem statements, scope, dependencies, and constraints.
  • Automatic generation of docs/tdd-designs/<design-name>/design.md with a consistent template.
  • Collaboration-friendly workflow with preflight checks, vision alignment, and change logging.

Quick Start

Start a design session for a new feature by naming the design, for example "new-auth-workflow".

Frequently Asked Questions about tdd-design

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

FAQPage Schema
How do I document a high-level TDD design through a structured conversation?

To document a TDD design, this Skill guides stakeholders through structured context gathering and vision alignment, automatically generating a concrete design.md artifact for your project.

What is the best way to start a collaborative TDD design session?

Start a collaborative TDD design session by naming your design, such as "new-auth-workflow"; the Skill enforces a structured workflow with preflight checks and collaboration locks to manage stakeholder input.

How does the design pipeline handle revisions to existing TDD documentation?

The TDD design pipeline handles revisions by revising existing design.md artifacts, guiding stakeholders through updated context gathering, vision alignment, and logging changes in the design inventory.

Does this TDD workflow enforce any specific file structure for design documentation?

Yes, the TDD workflow enforces a specific file structure, automatically creating and maintaining your design documentation within the docs/tdd-designs/<design-name>/design.md directory path.

Can I use this for aligning team vision before writing tests in a design pipeline?

Yes, you can use this for aligning team vision before writing tests; it orchestrates high-level design conversations to surface problem statements, scope, dependencies, and constraints prior to implementation.

What limitations exist when managing collaboration locks during a TDD design workflow?

A key limitation is that collaboration locks are managed strictly via preflight checks within the design workflow, meaning concurrent stakeholder edits outside this structured session are not natively synchronized.