← Vault Index
Source: frameworks/kit-knowledge-transfer/01-context.md

01 — CONTEXT: Knowledge Transfer

Input definitions, validation rules, and what each mode requires.


Create — Inputs

InputRequiredExampleUsed For
Source recording/transcriptYesA screen-share of the expert running the monthly close, transcribed (Otter/Zoom)The spine — every captured line traces here
Subject + header factsYes"Northwind Trading Co." · operator · QBO/Bill.com/Gusto · monthly · ownerTitle + header line
Prior docNoAn old SOP, a partial blueprint, account listSupplementary detail; loses to the recording on conflict
TemplateYesengine/template.json (general, or domain-adapted)The structure the engine fills

Validation Rules — Create

  1. No source, no capture. A recording or transcript of the actual work is required. Don't build from memory or from the prior doc alone.
  2. One subject per capture. Multiple people/processes → multiple runs.
  3. The prior doc is supplementary. Where it conflicts with the recording, the recording wins (it's what the expert actually does).
  4. Confirm subject + source + template with the advisor before running.

Update — Inputs

InputRequiredSourceUsed For
Existing content fileYesengine/-content.jsonThe doc being updated
The changeYesA filled gap, a new rule, a changed watch-outWhat to edit

Validation Rules — Update

  1. Edit the content file, then regenerate — never hand-edit the .docx as the source of truth (the engine would overwrite it).
  2. Re-run Gate 1 after every update.

Gap Protocol

Missing inputs don't block the build — they get flagged, by design. But two things do block:

Everything else missing → a FILL:: flag. A capture with flagged gaps is valid, correct output — the flags ARE the deliverable's honesty.


Input Priority Hierarchy

When inputs conflict:

  1. The source recording — what the expert actually does, in their own narration.
  2. The advisor's confirmation — corrections stated in the run.
  3. The prior doc — only where the recording is silent.
  4. Never: assumption, plausibility, or "how it's usually done." That's a FILL::, not a fact.