comprehension-fulllisted
Install: claude install-skill jacob-balslev/skill-graph
# Comprehension-Full Fixture
This fixture exercises the full Understanding surface in the canonical
v8 post-sidecar shape: the five flat top-level fields (`mental_model`,
`purpose`, `boundary`, `analogy`, `misconception`) live in `SKILL.md`
frontmatter, and `comprehension_state: present` lives in the
`audit-state.json` sidecar. The cross-file lint check (per ADR-0019)
must accept this pairing — when the sidecar declares
`comprehension_state: present`, the five frontmatter fields are required.
## Coverage
The five flat Understanding fields in frontmatter plus
`comprehension_state: present` in the audit-state sidecar, proving the
cross-file comprehension contract. No grounding (deployment_target:
portable), no relations.
## Philosophy
Per [ADR-0019](../../../docs/adr/0019-audit-state-sidecar-separation.md),
agent-facing fields (including the flat Understanding prose) live in
frontmatter, while audit/eval bookkeeping (including `comprehension_state`)
lives in the sidecar. The legacy nested `concept` block was retired in the
clean cut. This fixture is the smallest configuration that proves the
cross-file lint binds the sidecar flag to the frontmatter Understanding
fields without re-introducing the nested block.
## Verification
```bash
node scripts/skill-lint.js --path examples/fixture-skills/comprehension-full
# expected: 0 errors
node scripts/skill-lint.js --path examples/fixture-skills
# expected: 0 errors across all four fixtures
```
The cross-file lint must accept the