Kb Render

KB Render

Turn approved knowledge into deterministic outward-facing artifacts.

Karpathy's LLM Wiki naturally produces slides, charts, and reports. kb-render is the dedicated lane for those deterministic derivatives after the grounding work is already done.

Minimal loop

1. confirm which approved pages ground the artifact
2. choose the render mode
3. generate the artifact in the expected format
4. save it under the correct output directory
5. record any durable follow-up as writeback metadata

Read before rendering

• local AGENTS.md
• local CLAUDE.md if present
• ../obsidian-notes-karpathy/scripts/skill-contract-registry.json
• ../obsidian-notes-karpathy/references/file-model.md
• ../obsidian-notes-karpathy/references/render-template.md
• ../obsidian-notes-karpathy/references/obsidian-safe-markdown.md

Treat skill-contract-registry.json as the canonical source for required references, baseline command, and expected write surfaces.

If onkb is available, run onkb --json render <vault-root> --mode <mode> --source <path> first to get the deterministic baseline before manual shaping.

If onkb is missing, follow the install fallback in ../obsidian-notes-karpathy/references/lifecycle-matrix.md, then rerun the same command.

Load on demand

Load these only when the trigger applies:

• ../obsidian-notes-karpathy/references/archive-model.md — when archive reuse, truth-status, or output-surface posture questions arise
• ../obsidian-notes-karpathy/references/lifecycle-matrix.md — when onkb is missing (install fallback) or a stage handoff is unclear
• ../obsidian-notes-karpathy/references/content-output-template.md — when producing publish-mode artifacts under outputs/content/
• ../obsidian-notes-karpathy/references/profile-contract.md — when account profiles or source_profile metadata is involved

Non-negotiable rules

• only ground artifacts in wiki/live/ pages and already-cited outputs/qa/ answers
• archived grounded answers are valid inputs, but they remain artifact archive rather than truth
• never read wiki/drafts/ or raw/ as render source material
• static web export belongs to kb-query, not here
• obey Obsidian-safe markdown rules, especially no alias-style wikilinks inside table cells

Render modes

• slides -> Marp-compatible markdown under outputs/slides/
• report -> deterministic markdown report under outputs/reports/
• charts -> markdown chart brief or chart spec under outputs/charts/
• canvas -> Obsidian .canvas JSON, usually under outputs/charts/

Use ../obsidian-notes-karpathy/references/render-template.md for the detailed skeletons, metadata, and per-mode formatting rules.

If the user says output/reports but clearly means a governance or lint report, route back to kb-review maintenance instead of rendering here.

Checkpoint

Before generating any artifact, confirm:

• which approved pages or archived grounded answers are the source
• which render mode fits the request
• whether any audience or format constraint changes the template

If the request is already explicit, locate the approved pages silently and proceed. Only pause when source selection or mode is genuinely ambiguous.

Output to the user

Report:

1. which approved pages grounded the artifact
2. which render mode was used
3. where the artifact was saved
4. whether writeback_candidates were discovered during rendering
5. whether a render log entry should be appended to wiki/log.md