tdd-validation

Validate Technical Design Documents for completeness and implementation readiness.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/BrunoSantanaDeveloper/flyeelab-agent-kit --skill tdd-validation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tdd-validation
Source: https://github.com/BrunoSantanaDeveloper/flyeelab-agent-kit/tree/main/skills/tdd-validation
Command: npx skills add https://github.com/BrunoSantanaDeveloper/flyeelab-agent-kit --skill tdd-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates Technical Design Documents to ensure they are complete and ready for implementation.

Core Features & Use Cases

  • Structured Validation ensures all mandatory sections exist and are properly populated
  • MVP & Risk Checks verifies MVP items are defined and risks have mitigations
  • Architecture Alignment cross-checks with ARCHITECTURE.md and CODEBASE for compatibility
  • Output & Integration generates a standardized TDD validation report and integrates with related skills

Quick Start

Run the TDD validator on docs/design/TDD-Name.md to produce a ready-to-review report

Frequently Asked Questions about tdd-validation

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

FAQPage Schema
How do I validate a Technical Design Document for completeness before implementation?▼

TDD validation checks for mandatory sections, verifies MVP definitions, and ensures risks have mitigations. This structured process confirms the Technical Design Document is populated and ready for implementation.

When do I need to run TDD validation in the software development lifecycle?▼

You need TDD validation during pre-implementation reviews, PRD-to-SDD handoffs, and code review pipelines. Running it at these milestones ensures architecture alignment and verifies readiness before committing development resources.

Can I use TDD validation to check architecture alignment with my existing codebase?▼

Yes, TDD validation cross-checks your document against ARCHITECTURE.md and the CODEBASE. This architecture alignment verifies compatibility, ensuring the proposed design integrates seamlessly with your existing technical structure.

What does a TDD validation report include for MVP and risk mitigation?▼

A TDD validation report includes structured checks verifying that MVP items are explicitly defined and that identified risks have corresponding mitigations. It outputs a standardized readiness assessment for code review pipelines.

How do I validate TDD structure for missing sections in a PRD-to-SDD handoff?▼

Validating TDD structure during a PRD-to-SDD handoff involves scanning the document to ensure all mandatory sections exist and are properly populated. This structured validation prevents incomplete designs from reaching implementation.

Do I need a completed PRD to validate a Technical Design Document?▼

A completed PRD is typically needed to validate a Technical Design Document because the validation process checks MVP status and architecture alignment. The PRD provides the foundational requirements needed to verify TDD readiness.