tdd-plan-audit

Audit plan.md against design documents with deterministic checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Plan audits help teams verify that a planned implementation aligns with its design documents by performing deterministic checks and surfacing issues before coding begins.

Core Features & Use Cases

  • Deterministic checks that validate plan completeness, module/interface coverage, phase alignment, and file existence.
  • Council-based review with three experts (Torvalds, Ada, and Feynman) to categorize findings and resolve design gaps.
  • Supports standard mode and spike/auto modes, with results consolidated into a final report.

Quick Start

Provide the path to the target design directory and optional flags to run a deterministic plan audit with council review.

Frequently Asked Questions about tdd-plan-audit

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

FAQPage Schema
How do I audit a TDD plan against design documents?

To audit a TDD plan against design documents, run deterministic checks on a target design directory to verify task coverage, interface alignment, phase sequencing, and file existence between plan.md and design.md files.

What is a deterministic plan audit for software design?

A deterministic plan audit for software design identifies inconsistencies between plan.md and its design documents by running automated checks and surfacing actionable findings before coding begins.

How do I verify task coverage and interface alignment in a plan.md file?

You verify task coverage and interface alignment by running a plan audit that applies deterministic checks to your design directory, automatically surfacing gaps between planned tasks and the detailed-design.md specifications.

Can I run a plan audit in spike or auto mode?

Yes, you can run a plan audit in spike or auto mode by passing optional flags to the target design directory, consolidating the deterministic checks and council review results into a final report.

What does the council-based review do during a plan audit?

The council-based review uses three expert personas to categorize deterministic audit findings and resolve design gaps between plan.md and design documents, producing a consolidated final report for review.

What design files do I need for a software design audit?

For a software design audit, you need a plan.md file and a design.md file in the target directory, with an optional detailed-design.md file to enable deeper interface alignment and phase sequencing verification.