Governance artifacts
Governance files brought into scope by this page
This page is anchored to published surfaces that declare identity, precedence, limits, and the corpus reading conditions. Their order below gives the recommended reading sequence.
Definitions canon
/canon.md
Canonical surface that fixes identity, roles, negations, and divergence rules.
- Governs
- Public identity, roles, and attributes that must not drift.
- Bounds
- Extrapolations, entity collisions, and abusive requalification.
Does not guarantee: A canonical surface reduces ambiguity; it does not guarantee faithful restitution on its own.
Site context
/site-context.md
Notice that qualifies the nature of the site, its reference function, and its non-transactional limits.
- Governs
- Editorial framing, temporality, and the readability of explicit changes.
- Bounds
- Silent drifts and readings that assume stability without checking versions.
Does not guarantee: Versioning makes a gap auditable; it does not automatically correct outputs already in circulation.
Public AI manifest
/ai-manifest.json
Structured inventory of the surfaces, registries, and modules that extend the canonical entrypoint.
- Governs
- Access order across surfaces and initial precedence.
- Bounds
- Free readings that bypass the canon or the published order.
Does not guarantee: This surface publishes a reading order; it does not force execution or obedience.
Evidence layer
Probative surfaces brought into scope by this page
This page does more than point to governance files. It is also anchored to surfaces that make observation, traceability, fidelity, and audit more reconstructible. Their order below makes the minimal evidence chain explicit.
- 01Canon and scopeDefinitions canon
- 02Weak observationQ-Ledger
Definitions canon
/canon.md
Opposable base for identity, scope, roles, and negations that must survive synthesis.
- Makes provable
- The reference corpus against which fidelity can be evaluated.
- Does not prove
- Neither that a system already consults it nor that an observed response stays faithful to it.
- Use when
- Before any observation, test, audit, or correction.
Q-Ledger
/.well-known/q-ledger.json
Public ledger of inferred sessions that makes some observed consultations and sequences visible.
- Makes provable
- That a behavior was observed as weak, dated, contextualized trace evidence.
- Does not prove
- Neither actor identity, system obedience, nor strong proof of activation.
- Use when
- When it is necessary to distinguish descriptive observation from strong attestation.
A page should be citation-ready without becoming context-poor. The objective is not to turn every page into a pile of snippets, but to make the decisive claims extractable and governed.
AI-mediated systems rarely reuse a whole page as a human would. They retrieve fragments, compare passages, compress meaning and attach sources to generated claims. A page that is excellent for a human reader can still be weak for citation if its decisive statements are late, implicit or dependent on earlier context.
The solution is not to flatten the page. It is to give each important claim a recoverable structure and a visible authority boundary.
Start with a citable position
The first screen of a strategic page should contain a short, self-contained position. This is not a marketing slogan. It is a compact statement of what the page governs.
A strong opening block should identify:
- the concept, service or entity being defined;
- the condition under which the claim is valid;
- the main exclusion or non-promise;
- the route to the stronger governing source when needed.
For example, a service page should not only say what the service does. It should also say what it does not guarantee. That prevents the system from turning an audit into a promise of ranking, citation or model compliance.
Use sections as extraction units
Headings are not decoration. They are retrieval boundaries. A vague heading such as “Why it matters” may work for a reader, but a stronger heading such as “Why citation is not proof of fidelity” gives the system a clearer extraction target.
Each strategic section should answer one question and contain one dominant claim. When several claims must coexist, use a table to preserve the relationship between them. Tables are particularly useful for separating visibility, retrieval, citation, fidelity and governance.
Make passages self-contained
A self-contained passage can be lifted without losing its core meaning. It includes the subject, the claim, the scope and the relevant limit. It avoids pronouns that require previous paragraphs and avoids shorthand that can be misapplied.
Weak passage:
This is why it matters for audits.
Stronger passage:
AI citation readiness matters for audits because citation frequency alone does not show whether the cited source supports the generated claim or whether the answer respects source hierarchy.
The stronger version travels better because the concept, mechanism and limit remain attached.
Add governance before optimization
Citation-ready structure can become dangerous when it amplifies weak claims. Before creating short extractable passages, decide whether the page is allowed to govern the claim.
A definition can govern a term. A service page can describe a diagnostic route. A blog article can interpret a phenomenon. A report can observe evidence. A governance surface can set precedence, but this repo should only link to those surfaces when they exist elsewhere.
That distinction prevents accidental authority displacement. The page becomes easier to cite without pretending to govern more than it should.
Practical pattern
A strong page structure for AI citation readiness follows this order:
- definition or citable position;
- non-promises and exclusions;
- mechanism;
- failure modes;
- source hierarchy or proof route;
- practical audit route;
- related concepts.
This pattern works because it gives the system enough local clarity for extraction and enough context to avoid illegitimate expansion.
Correction sequence
Start with the pages that already rank, because they are easiest to retrieve. Add early answer blocks, rewrite vague sections as specific claims, expose exclusions, connect to source hierarchy and link to the AI citation readiness checklist.
Do not optimize every paragraph. Optimize the passages that should legitimately support future answers.