Priority: Medium
Description
If the purpose of llms-full.txt is to help models answer accurately, the current structure causes predictable failure modes:
- Repetition without hierarchy: Same concepts appear in multiple places; models blend them
- Conflicting definitions: Schema shapes differ; models hallucinate hybrids
- Too many
... placeholders: In code and UIDs; LLMs treat these as literal patterns
- Links as authority: References GitHub issues/specs, but models can't follow links
Fix Direction
Add an "Authoritative Canonical Summary" section (1-2 pages) at the top of llms-full.txt defining:
Then append the detailed reference dump. The dump is useful, but it needs an anchor.