deepseek-harness/docs/cookbook
Tianyi Cui c0808d5126 docs: the governing principle — every LLM request is reconstructable from the session log
The reconstructability RFC is the principle's home: model-visible ⟺
logged in both forms, the mechanism (boundary derivation + header
fold), the enforcement (write-time round-trip guard, the dev
invariant), the corollaries ranked (prefix-cache stability first), the
MiniCode lineage with the provenance arrow inverted, and the
alternatives it beat — including the stateful transmission client
whose three-design archaeology lives in PR #162.

Placements per the one-home-per-fact taxonomy: a standing-order line in
root AGENTS.md (with displacement trims to stay inside the 1,575-word
ceiling), the principle statement in architecture.md § Session Log and
its Turn Flow lines (condensed to the ratcheted 1,630 ceiling), the
request-envelope section in core-data-structures/core.md with the
LlmCallConfig paste, both review-requested FIXMEs
(FIXME(call-config-shape) beside the type, FIXME(catalog-verbs) at the
catalog's drift-gate note), cookbook rows redirected off agent/request
(tool filtering → system-prompt/assemble, plan-mode prompt → sections/
inject()), and the llm/stream JSDoc stating the frozen-request
contract. RFC index and all generated catalogs regenerated.
2026-07-06 03:49:35 +08:00
..
adding-a-package.md fix(docs): address Codex review round 2 — repoint every remaining moved-policy citation 2026-07-04 15:43:51 +08:00
adding-a-tool.md Merge branch 'worktree-hooks-b-bash-seam' into worktree-hooks-c-interception 2026-07-04 02:44:26 +08:00
adding-a-vendored-package.md Use explicit ts specifiers for declarations 2026-06-22 06:11:00 +08:00
adding-an-llm-adapter.md refactor(llm): drop the inert request knobs — prefill and strict 2026-07-04 18:38:39 +08:00
extension-cookbook.md docs: the governing principle — every LLM request is reconstructable from the session log 2026-07-06 03:49:35 +08:00
responding-to-pr-review-on-a-stack.md docs: check dependents per-branch with --base, not a capped sweep 2026-07-06 01:15:32 +08:00