foundry-review

Identify implementation deviations from specifications using LSP and MCP fidelity analysis.

4|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/foundry-works/claude-foundry --skill foundry-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foundry-review
Source: https://github.com/foundry-works/claude-foundry/tree/main/skills/foundry-review
Command: npx skills add https://github.com/foundry-works/claude-foundry --skill foundry-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to confirm that implemented code conforms to a given specification, using deterministic LSP pre-checks and MCP-powered fidelity analysis to surface deviations and generate auditable reports.

Core Features & Use Cases

  • Deterministic structural checks: Validate the presence of required symbols (e.g., classes and methods) against the spec using LSP.
  • AI-driven fidelity analysis: Compare implementation with the specification, classify deviations (exact, minor, major, missing), and assess impact.
  • Auditable reporting: Produce a detailed fidelity report and persist it for traceability across reviews, phases, and tasks.

Quick Start

Run a phase-level fidelity review for phase-1 in spec user-auth-001: Skill(foundry:foundry-review) "Review phase phase-1 in spec user-auth-001"

Frequently Asked Questions about foundry-review

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

FAQPage Schema
How do I verify code fidelity against a specification?

To verify code fidelity against a specification, run a phase-level or task-level review using LSP documentSymbol pre-checks and MCP-driven deviation analysis to classify exact, minor, major, or missing discrepancies. This validates required symbols and generates auditable reports.

What is AI-driven fidelity analysis for spec-driven development?

AI-driven fidelity analysis compares implementation code against a given specification to classify deviations and assess impact. It uses MCP to evaluate structural discrepancies and generates a detailed fidelity report for traceability across reviews.

Can I use LSP to validate required symbols before a full code review?

Yes, you can use LSP documentSymbol pre-checks to validate the presence of required classes and methods against the specification. This deterministic structural check ensures implementation completeness before conducting deeper AI-driven fidelity analysis.

How do I generate auditable reports for phase-level code reviews?

Generate auditable reports for phase-level code reviews by executing a fidelity review for a specific spec phase. The process compares implementation to specification and persists detailed JSON artifacts, ensuring traceability across tasks and phases.

Does code fidelity analysis classify minor and major deviations differently?

Yes, code fidelity analysis classifies deviations into exact, minor, major, and missing categories to assess their impact accurately. This classification helps measure implementation conformance to the specification during the review.

What are the limitations of deterministic pre-checks in spec review?

Deterministic pre-checks using LSP are limited to validating structural presence of required symbols like classes and methods. They do not assess semantic logic or complex deviations, which require subsequent AI-driven MCP fidelity analysis to fully evaluate.