tdd-design-audit

Analyze design documents against the codebase to surface interface mismatches and alignment issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design Audit performs a thorough, multi-angle comparison between a detailed design and the actual codebase to surface interface mismatches, feasibility concerns, and alignment gaps before implementation.

Core Features & Use Cases

  • Preflight checks against design and code
  • Artifact alignment across design-detailed and codebase
  • Risk signaling with actionable fixes

Quick Start

Run the audit against the target design directory to surface alignment issues.

Frequently Asked Questions about tdd-design-audit

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

FAQPage Schema
How do I check for interface mismatches between a design document and my codebase?

To check for interface mismatches, perform a design audit comparing detailed designs against the actual codebase. This process surfaces alignment issues, validates interface contracts, and identifies cross-boundary schema discrepancies before implementation begins.

What is a design audit and when do I need it?

A design audit is a multi-angle comparison between detailed designs and the codebase to surface feasibility gaps. You need it before implementation to validate data flows, verify vision alignment, and ensure cross-boundary schemas match the intended contracts.

How do I surface feasibility gaps before starting implementation?

Surface feasibility gaps by running a design audit against your target design directory. This analyzes detailed designs alongside the current codebase, detecting alignment issues and validating data flows to provide actionable findings categorized by severity.

Can I validate cross-boundary schema contracts against existing code?

Yes, you can validate cross-boundary schema contracts by running a design audit. It checks artifact alignment across design-detailed specifications and the codebase, verifying that interface boundaries and data flows conform to the intended schema validation rules.

What is the best way to perform a preflight code review for architecture alignment?

The best way to perform a preflight code review for architecture alignment is executing a design audit. It compares design artifacts against the codebase to surface risk signals, interface mismatches, and provides concrete fix recommendations categorized by severity.

Does a design audit work with designs stored in docs/tdd-designs?

Yes, design audit works directly with designs stored in docs/tdd-designs. It analyzes the detailed designs within that directory against the current codebase to surface alignment issues, feasibility concerns, and interface mismatches before you begin implementation.