tdd-spike-results

Record spike findings into a structured spike-results.md document.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture spike findings and verdicts into a standardized spike-results document to enable durable records of what was learned, what happened, and what decisions emerged.

Core Features & Use Cases

  • Write a structured spike-results.md for completed or partial spikes.
  • Integrate with design and decisions artifacts (design.md, plan.md, decisions.md) to reflect outcomes and rationale.
  • Supports collaboration with lock rules, validation, and automatic logging of verdicts and next steps.

Quick Start

Run the /tdd-spike-results <spike-name> command after finishing your spike to generate spike-results.md.

Frequently Asked Questions about tdd-spike-results

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

FAQPage Schema
How do I document spike findings in a structured TDD workflow?

Use the `/tdd-spike-results <spike-name>` command to generate a spike-results.md file. It records findings, verdicts, and next steps into a standardized document located at `docs/tdd-designs/<spike-name>/spike-results.md`.

What is a spike-results document and when do I need it?

A spike-results document captures what was learned, what happened, and what decisions emerged during a spike. You generate it when a spike is completed or partially completed to create a durable, standardized record of the investigation.

Can I use spike-results with existing design and decisions artifacts?

Yes, the spike-results document integrates with design.md, plan.md, and decisions.md. It reflects outcomes and rationale from the spike while enforcing spike-name validation and respecting collaboration locks.

What is the best way to record partial spike outcomes in TDD?

Run the `/tdd-spike-results` command to write a structured spike-results.md file. It supports both completed and partial spikes, automatically logging verdicts and guiding you to run `/tdd-spike-learn <spike-name>` after generating results.

Why does my spike name validation fail when generating spike-results?

Spike name validation fails if the provided name does not match expected conventions. The command enforces strict spike-name validation and respects existing collaboration locks before generating the results artifact.