coherence-reviewer

Review planning documents for internal inconsistencies and terminology drift.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ybbms777/compound-engineering --skill coherence-reviewer-ybbms777
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coherence-reviewer
Source: https://github.com/ybbms777/compound-engineering/tree/main/skills/agent-coherence-reviewer
Command: npx skills add https://github.com/ybbms777/compound-engineering --skill coherence-reviewer-ybbms777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning documents often contain hidden internal contradictions, inconsistent terminology, structural gaps, or ambiguous language that leads to misaligned execution, rework, and team divergence during development.

Core Features & Use Cases

  • Contradiction Detection: Identifies conflicting statements between sections, such as scope exclusions that are later included in requirements, or stated constraints violated by proposed approaches.
  • Terminology Drift Checking: Catches instances where the same concept is referred to by different names or the same term has different meanings across sections, preventing reader confusion.
  • Structural & Ambiguity Analysis: Flags forward references to undefined sections, ungrouped multi-topic requirement lists, unresolved dependency contradictions, and ambiguous statements that would lead to divergent interpretations.
  • Use Case: For example, before finalizing a technical plan for a new feature, use this skill to review the document to catch conflicting scope statements, inconsistent naming for core system components, or ambiguous requirement language that would cause engineering teams to implement different solutions.

Quick Start

Use the coherence-reviewer skill to review the attached technical planning document for internal inconsistencies, terminology drift, and structural issues.

Frequently Asked Questions about coherence-reviewer

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

FAQPage Schema
How do I check a technical plan for internal contradictions?

To check a technical plan for internal contradictions, review the document for conflicting statements between sections, such as scope exclusions included later in requirements, or stated constraints violated by proposed approaches. Contradiction detection prevents execution misalignment and rework.

What causes terminology drift in requirement documents?

Terminology drift in requirement documents happens when the same concept is referred to by different names or the same term has different meanings across sections. Catching these inconsistencies during pre-development review prevents reader confusion and divergent interpretations.

How do I find structural gaps and ambiguous statements in project specifications?

Finding structural gaps and ambiguous statements in project specifications involves flagging forward references to undefined sections, ungrouped multi-topic requirement lists, and unresolved dependency conflicts. Analyzing these structural issues ensures overall document coherence.

Can I use consistency checking for pre-development requirement reviews?

Yes, you can use consistency checking for pre-development requirement reviews. Applying this process to technical plans and project specifications catches hidden internal contradictions, ambiguous language, and unresolved dependency conflicts before execution begins.

What is the best way to prevent execution misalignment from planning documents?

The best way to prevent execution misalignment from planning documents is performing a pre-development review that detects contradictions, terminology drift, and structural issues. Document coherence ensures engineering teams implement unified solutions rather than divergent ones.