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.