tdd-spike

Facilitate time-boxed spike conversations and generate design.md files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Time-boxed spike conversations to explore design questions before committing to an implementation approach.

Core Features & Use Cases

  • Structured spike workflow that captures hypothesis, success criteria, experiments, and demos.
  • Optional parent linkage and alignment with the project vision to ensure context continuity.
  • Generated artifacts stored under docs/tdd-designs/<spike-name>/design.md and linked to the design inventory when applicable.

Quick Start

Kick off this spike by running /tdd-spike-plan tdd-spike to begin a design experiment.

Frequently Asked Questions about tdd-spike

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

FAQPage Schema
What is a time-boxed spike for validating design decisions?

A time-boxed spike explores specific design questions before committing to an implementation approach. It captures hypothesis, success criteria, experiments, and demos in a structured design.md artifact to validate decisions within a fixed duration.

How do I document a design spike with hypothesis and success criteria?

Generate a structured design.md file under docs/tdd-designs/<spike-name>/ containing hypothesis, success criteria, experiments, and demos. The workflow enforces collaboration preflight, parent linkage checks, and vision alignment to ensure proper context continuity.

Can I link a design spike to a parent design and align it with project vision?

Yes, design spikes support optional parent linkage and project vision alignment. The workflow enforces parent linkage checks and vision alignment during preflight to ensure context continuity and automatically links generated artifacts to the design inventory.

Does a design spike workflow require collaboration preflight before starting?

Yes, the design spike workflow enforces collaboration preflight before starting. This preflight validates parent design linkage and project vision alignment to ensure all stakeholders share context before producing the structured design.md output.

What's the best way to explore design questions before committing to an implementation approach?

Run a time-boxed spike workflow that captures hypothesis, success criteria, experiments, and demos in a structured design.md. It enforces collaboration preflight, parent linkage checks, and vision alignment to validate design decisions before committing to an implementation approach.

When should I not use a time-boxed spike for design exploration?

Avoid time-boxed spikes when design questions are already resolved or lack parent design context for linkage. Spikes require collaboration preflight and vision alignment, making them unsuitable for isolated decisions lacking project-level design continuity or structured hypothesis validation.