Maya Sandbox — CLAUDE.md

Maya Sandbox — CLAUDE.md

Purpose: Validate the Karpathy LLM Wiki pattern (RD-0017) on 3 factory TFDs before locking the M1 schema.

Purpose of this wiki

Synthesize factory architectural decisions (TFD-NNN) into an interlinked markdown knowledge base that answers cross-cutting questions like "how do toolkit-catalog distribution, EA catalog storage, and rendering layer ownership interact for a digital talent delivery?"

Folder structure

  • raw/ — read-only sources (TFD markdown copies). Never edit.
  • wiki/ — agent-maintained. Index + concept pages + entity pages + comparisons.
  • CLAUDE.md — this file. Rules.

Ingest workflow

When a new file lands in raw/:

  1. Read the full file.
  2. Extract: decision, context, actors, alternatives, consequences, references.
  3. For each named concept/entity/role mentioned → check if a page exists in wiki/concepts/ or wiki/entities/.
  4. Update existing pages with the new claim (add a bullet, cite source). Do not create duplicates.
  5. Create new pages for concepts/entities that don't have one yet.
  6. Link bidirectionally — every page that mentions a concept links to its page; every concept page links back to source TFDs.
  7. Flag contradictions — if a new claim contradicts an existing page, add a > ⚠ Contradicts: callout with both sources.
  8. Update wiki/INDEX.md.
  9. Log the change in wiki/_changelog.md.

Page formatting rules

  • One H1 per page = the concept/entity name.
  • First section = one-paragraph summary (the "what").
  • Subsequent sections cite source via [TFD-NNN](../raw/TFD-NNN-*.md) — clickable in widget.
  • Inter-page links: [Concept](./CONCEPT.md) relative within wiki/.
  • Bilingual: keep source language for direct quotes; synthesis can be in FR or EN, prefer FR if source is FR.
  • Every claim has a source citation. No floating assertions.

Question-answering behavior

  • Consult wiki/ first (not raw/).
  • If wiki doesn't contain the answer, say so explicitly and propose: (a) look in raw, or (b) create a ticket.
  • Cite every claim with the wiki page path; click-through to TFD source is the user's job (the wiki page has the link).
  • Flag uncertainty: "according to TFD-0019 (2026-05-15), but TFD-0022 (2026-05-26) refines this..."

Lint behavior (/lint-wiki)

When asked to lint, scan wiki/ and report:

  1. Contradictions — pages with ⚠ Contradicts: callouts not yet resolved.
  2. Orphan pages — no inbound links from any other wiki page.
  3. Dead refs — links to wiki pages that don't exist.
  4. Outdated claims — pages where a referenced TFD has been superseded by a newer one not yet ingested.
  5. Missing concept pages — terms appearing 3+ times across pages without a dedicated page.

Output: structured markdown report. No auto-fixes — propose, don't apply.