tdd-design-complete

Archive completed TDD designs with git mv and stamp completion dates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mark a finished TDD design as complete by stamping completion, removing transient handoff artifacts, and archiving the design directory in a way that preserves history and context.

Core Features & Use Cases

  • Stamp a completion date on the design's metadata (design.md) and remove handoff.md to clear session state.
  • Move the design from docs/tdd-designs to docs/completed-tdd-designs using git mv to preserve history, and update the product roadmap accordingly.
  • Optionally commit the archival changes on the current branch and offer to open a PR merging back to the base branch.

Quick Start

Run /tdd-design-complete <design-name> to archive the design and move it to the completed designs folder.

Frequently Asked Questions about tdd-design-complete

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

FAQPage Schema
How do I archive a completed TDD design and preserve its git history?

To archive a completed TDD design and preserve git history, this Skill moves the design directory from docs/tdd-designs to docs/completed-tdd-designs using git mv, ensuring full history retention.

What's the best way to mark a TDD design as complete and update the roadmap?

The best way to mark a TDD design as complete is to stamp a completion date on design.md, remove transient handoff artifacts, and automatically update the project roadmap to reflect the finished design status.

Can I automatically open a PR to merge archived TDD design changes back to the base branch?

Yes, you can automatically open a PR to merge archived TDD design changes. The Skill optionally commits archival changes on the current branch and offers to open a PR back to the base branch.

Does the TDD design archival process remove session state and handoff artifacts?

Yes, the TDD design archival process removes session state by deleting handoff.md. This clears transient handoff artifacts while preserving the core design.md metadata and directory history.

How do I move design directories with strict git operations during TDD archival?

To move design directories with strict git operations, the Skill uses explicit staging of archival paths and focused commit messages. It prompts for user confirmation before executing the git mv operations.