pmatch

Validate alignment between source-of-truth documents and target artifacts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/madebymlai/feldspar --skill pmatch-madebymlai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pmatch
Source: https://github.com/madebymlai/feldspar/tree/main/.claude/skills/pmatch
Command: npx skills add https://github.com/madebymlai/feldspar --skill pmatch-madebymlai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It validates that a source-of-truth document (such as a design, plan, or specification) aligns with a target artifact (like a implementation directory, codebase, or document), helping teams catch gaps or mismatches early.

Core Features & Use Cases

  • Agent Orchestration: Automatically creates and manages matcher agents to scan source and target.
  • Consensus Scoring: Merges findings from multiple agents, deduplicates claims, and flags gaps or ambiguities.
  • Alignment Reporting: Produces a detailed markdown report showing matched items, gaps, extras, and an overall verdict.
  • Use Cases: Verify that a design spec matches the implemented code, ensure a project plan covers all required deliverables, or quickly sanity‑check documentation against a repository.

Quick Start

Run /pmatch design.md src/ to generate an alignment report between the design document and the source code directory.

Frequently Asked Questions about pmatch

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

FAQPage Schema
How do I verify that my codebase matches a design specification?▼

Verifying codebase alignment with a design specification involves comparing the source-of-truth document against implementation files. The tool orchestrates matcher agents to parse both inputs using Read, Glob, and Grep, generating a consensus report with matched items, gaps, and an overall verdict.

What is plan-implementation alignment validation?▼

Plan-implementation alignment validation checks a project plan against an actual codebase to catch gaps or mismatches early. It ensures required deliverables are covered by scanning source and target artifacts, deduplicating claims, and flagging ambiguities in a markdown report.

How do I generate an alignment report between a requirements document and source code?▼

Generating an alignment report between requirements and source code requires executing the validation command with the document path and target directory. Matcher agents scan inputs, merge findings, and produce a detailed markdown report showing matched items, gaps, and an overall verdict.

Can I validate an entire codebase directory against a specification document?▼

You can validate an entire codebase directory against a specification document. The validation leverages Glob and Grep tools to parse the full implementation directory, orchestrating matcher agents to scan and compare it comprehensively against the source-of-truth document.

Does alignment validation work for checking documentation against a repository?▼

Alignment validation works for sanity-checking documentation against a repository. It compares documentation as the source-of-truth against repository files, using matcher agents to identify mismatches, missing information, or extra implementation details not covered in the docs.

What is the best way to catch gaps between a design and its implementation?▼

The best way to catch gaps between a design and its implementation is automated consensus scoring. Multiple matcher agents scan the design specification and codebase, deduplicate findings, and flag mismatches or ambiguities, producing a detailed markdown report for early detection.