audit-copywriter
Arc Contract Audit
Core Concept
cogni-narrative (upstream) defines story arcs — each with 4 named elements, section proportions, technique assignments, and localized headings. cogni-copywriting (downstream) has an arc-preservation mode that polishes narratives without breaking their arc structure. The preservation mode relies on three reference files that must stay in sync with upstream definitions:
- arc-preservation.md — detection table mapping arc_id to 4 element headings, localized heading variants (DE for all mirrored arcs; FR/IT/PL/NL/ES for the translation-supported arcs corporate-visions + jtbd-portfolio), and structural validation rules (H2 counts, heading hierarchy)
- arc-technique-map.md — per-arc sections with element-level technique assignments, Number Play variants, and word targets
- 00-index.md — mode detection logic that lists which arc patterns trigger arc-aware mode
When cogni-narrative adds arcs, renames headings, adjusts proportions, changes technique assignments, or introduces new structural conventions (like message-driven headings), these downstream references drift. This skill detects that drift and produces an actionable report. It never auto-fixes — the human decides what to change.
Upstream Sources (read from cogni-narrative)
Resolve paths relative to the monorepo root. The monorepo root is the nearest ancestor directory containing both cogni-narrative/ and cogni-copywriting/ as siblings.