consistency-check

Consistency Check

Compares what each PRD claims about shared entities, values, and formulas against the registry. Pure read — never writes a file. Produces a structured findings list the user can resolve with /design-system retrofit ... or /propagate-design-change.

---

Purpose / When to Run

Run when:

• Three or more PRDs exist
• A PRD has just been authored that overlaps with prior PRDs
• Before /review-all-prds (which is more expensive)

Distinct from /review-all-prds: this skill checks values for drift; the holistic review checks design intent for contradictions. Run consistency-check first — it is much cheaper.

Inputs

• design/registry/entities.yaml
• All design/prd/*.md
• Optional: design/systems-index.md

Outputs

• Printed findings. No file writes.

---

Phase 1: Load the Registry

Read design/registry/entities.yaml. The registry is the source of truth for cross-PRD facts. Each entry has:

• name
• type (entity / configurable / formula / constant / event / endpoint)
• value or attributes
• source (the PRD that owns the canonical definition)
• referenced_by (other PRDs that reference it)

If the registry does not exist, stop:

"No design/registry/entities.yaml found. The registry is built incrementally as /design-system runs. Cannot consistency-check without it. Either author more PRDs or run /design-system retrofit ... to populate the registry from existing PRDs."

If the registry has fewer than 5 entries, warn that meaningful checks need ≥5 entries — the skill will run but findings will be sparse.

---

Phase 2: Index Every PRD

For each design/prd/*.md:

1. Read the file.
2. Identify which registry entries it references — grep for each entry's name in the file body.
3. For each referenced entry, extract the value the PRD claims (from sections 3 Detailed Requirements, 6 Configurable Values, and any inline tables).

Build a per-entry table:

entry: rate_limit_login_attempts
  registry value: 5 (per minute)
  source: design/prd/auth.md
  referenced in:
    design/prd/auth.md → 5 per minute ✓
    design/prd/account-recovery.md → 3 per minute ✗ MISMATCH
    design/prd/security.md → "5 attempts" ✓