Product Coherence

Audits documentation and marketing claims against code to identify misalignments.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill product-coherence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Product Coherence
Source: https://github.com/nsalvacao/nsalvacao-claude-code-plugins/tree/main/plugins/solution-audit/skills/product-coherence
Command: npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill product-coherence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation and marketing promises often diverge from the actual code, leading to user confusion and trust erosion. This skill helps detect and surface those gaps so teams can align what they say with what they ship.

Core Features & Use Cases

  • Detect mismatches between README/docs and implemented features across a codebase.
  • Identify ghost features, undocumented capabilities, and naming drift across touchpoints.
  • Provide remediation guidance and traceable mappings between claims and actual code exports or entry points.

Quick Start

Run an audit to compare documentation with the codebase and surface misalignments.

Frequently Asked Questions about Product Coherence

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

FAQPage Schema
How do I audit README documentation against my codebase to find ghost features?

To audit README documentation against a codebase, compare documented claims with actual code exports and entry points to detect ghost features, naming drift, and undocumented capabilities. The audit generates source references and remediation guidance.

What causes documentation drift in public APIs?

Documentation drift in public APIs occurs when implemented features diverge from documented claims over time. Auditing README.md, docs/, and CHANGELOG.md files against the actual codebase surfaces these undocumented capabilities and naming inconsistencies.

How can I check if my CHANGELOG matches the implemented features?

You can check CHANGELOG accuracy by running an audit that maps claims to actual code exports and entry points. This process identifies misalignment between marketing promises and shipped features, providing traceable mappings for remediation.

Can I use this audit for undocumented capabilities in my docs folder?

Yes, this audit applies to the docs/ folder, README.md, and CHANGELOG.md to identify undocumented capabilities. It compares documentation against the codebase to surface gaps and provides recommended fixes with source references.

What is the best way to fix naming drift across touchpoints?

The best way to fix naming drift is to audit documentation against the codebase to identify inconsistencies. The audit maps claims to actual code exports and entry points, providing organized findings with recommended fixes.

Does this documentation audit work without external dependencies?

Yes, this documentation audit works without external dependencies. It analyzes your codebase and documentation files directly to detect misalignment, ghost features, and naming drift, generating traceable mappings and remediation guidance.