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.