cross-validation

Compare plan items line-by-line against codebase evidence to identify gaps.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill cross-validation-usetheodev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-validation
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/cross-validation
Command: npx skills add https://github.com/usetheodev/theo-ui --skill cross-validation-usetheodev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill verifies that each element of a plan is faithfully implemented in code by performing a line-by-line comparison between the plan and the actual repository, ensuring evidence supports every claim.

Core Features & Use Cases

  • Plan-to-code audits: Validate that ADRs, phases, tasks, TDD cycles, acceptance criteria, and DoD items are reflected in the codebase.
  • Evidence-driven checks: Require concrete evidence (tests, files, and artifacts) for every item the plan asserts.
  • Use Case: Teams perform rapid, repeatable validations after plan updates to prevent regressions before delivery.

Quick Start

Run cross-validation on the latest plan to verify implementation against the codebase and produce a report.

Frequently Asked Questions about cross-validation

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

FAQPage Schema
How do I verify codebase alignment with my project plan?

Plan-to-code alignment is verified by performing a line-by-line comparison between your latest plan and the actual repository to identify divergences. This strict audit enforces coverage of ADRs, phases, tasks, and TDD cycles by requiring concrete evidence from tests and files.

What is a plan-to-code audit and how does it work?

A plan-to-code audit validates that ADRs, acceptance criteria, and Definition of Done items are faithfully implemented in the codebase. It works by requiring concrete evidence, such as tests and artifacts, to support every claim made in the plan and surfacing any gaps.

How do I check if my TDD cycles and acceptance criteria are implemented?

To check TDD cycles and acceptance criteria implementation, run a cross-validation audit on your latest plan. It requires concrete evidence from the codebase and tests to determine conformity against the specified Definition of Done items and surfaces any implementation gaps.

How do I prevent regressions before delivery after updating a plan?

Prevent regressions before delivery by performing rapid, repeatable plan-to-code validations after plan updates. This ensures every phase, task, and Definition of Done item has concrete evidence in the codebase, surfacing any divergences or gaps before the final delivery.

Does the cross-validation audit require concrete evidence for every task?

Yes, the cross-validation audit requires concrete evidence from the codebase and tests to determine conformity for every task. It enforces evidence-driven checks to ensure ADRs, acceptance criteria, and Definition of Done items are faithfully reflected in the code.

What are the limitations of a line-by-line codebase audit?

A line-by-line codebase audit is limited to verifying conformity against the latest plan and existing ADRs. It cannot detect unimplemented features if they are absent from the plan, and it requires concrete evidence from tests and files to successfully determine conformity.