Package Files for Retrieval, Not for Human Browsing
Prepare knowledge files so an assistant can retrieve and cite them reliably.
If the file is hard for retrieval to understand, the assistant will act like the evidence never existed. Retrieval wants clean signals Use descriptive filenames, searchable text, clear headings, and narrow topical scope. These cues help the assistant find the right source chunk instead of a noisy near-match. Layout matters less than text clarity A beautiful slide deck often performs worse than a plain markdown or document export because the important rules are scattered across visuals, callouts, and tiny text boxes. Versioning matters Multiple nearly identical files cause conflicts. If one version is canonical, make that obvious in the name…
Sign up free — one personalized lesson every day, matched to your role and goals.
Already have an account? Sign in