om-gap-analysis

Verifies client requirements against a platform codebase and produces a gated Epic/Story coverage report.

1.7k|382|Updated Sep 10, 2025
One-click install
npx skills add https://github.com/open-mercato/open-mercato --skill om-gap-analysis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: om-gap-analysis
Source: https://github.com/open-mercato/open-mercato/tree/main/.ai/skills/om-gap-analysis
Command: npx skills add https://github.com/open-mercato/open-mercato --skill om-gap-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Scoping a client engagement against an existing platform usually means weeks of manual code reading and guesswork about what the platform already covers. This Skill turns a folder of client documents (transcripts, requirement dumps, spec docs) into an evidence-backed Epic/Story tree where every coverage verdict is re-verified by executable gates against a validated checkout of the platform's code, so no claim enters the report unverified.

Core Features & Use Cases

  • Three-phase pipeline: Scoping (docs → structured Epic/Story tree), Verification (parallel read-only subagents investigate the platform codebase, every finding gated before writing), and Synthesis (client-facing summary plus prioritized backlog).
  • Executable trust gates: five deterministic scripts enforce completeness of the tree, freshness of the platform checkout, re-run of every grounding query, pipeline citation cross-checks, and surfacing of significant open PRs.
  • License-tier tagging and effort scoring: verdicts are split by core vs licensed tiers and gaps are scored in atomic commits (0–5), never T-shirt sizes.
  • Use Case: A consultancy receives 40 requirement documents for a B2B portal. The Skill produces a coverage report showing which stories the platform already implements, which are partial, and a sequenced backlog of the remaining work with effort estimates.

Quick Start

Run the om-gap-analysis skill on my folder of client requirement documents to produce a verified coverage report and implementation backlog against the platform repository.

Frequently Asked Questions about om-gap-analysis

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

FAQPage Schema
How do I run a gap analysis of client requirements against an existing platform?▼

Point the skill at a directory of client documents with a project slug; Phase 1 builds an Epic/Story tree, then after clearing context, re-invoke it on the generated markdown file to run verification and synthesis. The output is a coverage summary and a sequenced backlog.

How are coverage verdicts verified against the platform code?▼

Each story is investigated by a read-only subagent that names a decisive search term, and the gap-validate-finding gate re-runs that search against a validated, freshly fetched checkout of the platform before the verdict is written. Subagent claims are never trusted without the gate passing.

Can it analyze a single capability question instead of a full document set?▼

Yes. For one question like whether the platform supports a feature, it answers directly with the same evidence discipline using a validated checkout search, without starting the batch pipeline designed for directories of documents.

What happens if the analysis run is interrupted mid-verification?▼

Each story carries a status field (pending, done, needs-review) in the source markdown file, so re-invoking the skill on that file resumes the run and skips stories already marked done.

What are the limitations of the automated verdict gates?▼

The gates are falsifiers, not proof oracles: a search hit confirms a string match, not that the code satisfies the acceptance criteria, and verdicts grounded on an integration branch may include code not yet in a tagged release. Semantic judgment remains with the investigating subagent.