llm-wiki-claim-anchors

LLM-Wiki Claim Anchors

Goal

Add stable, auditable claim and source anchors to important wiki pages.

When to use

• The user wants stable claim IDs or source anchor IDs added to a wiki page or folder.
• A high-impact recommendation or synthesis page needs auditable provenance before it is trusted or merged.
• The user asks to validate existing claim/source anchors or check anchor formatting.
• llm-wiki-provenance has flagged unsupported, ambiguous, or conflicting claims that need anchors or a gap report.

Inputs

• Target wiki pages or folders.
• Raw sources or source pages.
• Desired mode: report-only or patch.
• Existing provenance conventions if present.

Procedure

1. Read the convention

Use references/docs/provenance/claim-anchors.md when available.

Default format:

- Claim text. ^claim-YYYYMMDD-001
  - Support: extracted
  - Source: `raw/sources/example.md` ^src-YYYYMMDD-001

2. Select claims

Prioritize:

• high-impact recommendations;
• current-state claims;
• claims used in synthesis;
• claims marked verified/reviewed;
• claims found by llm-wiki-provenance.

Re-verify current-state claims (pricing, versions, release status, provider support) against fresh sources before anchoring them as extracted rather than inferred.

3. Classify support

Use:

extracted | inferred | ambiguous | synthesis | unsupported | conflicting

Do not upgrade unsupported claims to inferred just to make the page look complete.

4. Add anchors

In patch mode:

• preserve wording unless the user asks for edits;
• add claim anchors near the claim;
• add source anchors near supporting source references;
• avoid changing human-owned synthesis except to add explicit provenance notes when approved.

5. Validate

Run or recommend:

node scripts/validate-claim-anchors.mjs <wiki-or-file-path>

6. Report gaps

Create or update a provenance report for unsupported, ambiguous or conflicting claims.

Output