generated from mintlify/starter
-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
P3Low priority - post-MVPLow priority - post-MVPdocumentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Description
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:
- Entities: Location Attestation, Policy Attestation, InputRef, Delegated Attestation
- Canonical schemas: Or explicit per-chain variants
- Canonical SDK method signatures and return types
- Key terminology and precise definitions
Then append the detailed reference dump. The dump is useful, but it needs an anchor.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
P3Low priority - post-MVPLow priority - post-MVPdocumentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Type
Projects
Status
Todo