From 8ac839c12aa868cff03244fa566b5548ac0ba722 Mon Sep 17 00:00:00 2001 From: welsberr Date: Wed, 13 May 2026 16:07:23 -0400 Subject: [PATCH] Document reasoning scaffold memory principles --- ...asoning-scaffold-operational-principles.md | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/reasoning-scaffold-operational-principles.md diff --git a/docs/reasoning-scaffold-operational-principles.md b/docs/reasoning-scaffold-operational-principles.md new file mode 100644 index 0000000..e15bd8a --- /dev/null +++ b/docs/reasoning-scaffold-operational-principles.md @@ -0,0 +1,30 @@ +# Reasoning Scaffold Operational Principles + +GroundRecall is the durable memory layer for reasoning-scaffold work. It should preserve why a scaffold exists, what review decisions were made, which source slots remain unresolved, and how later tools changed the artifact. + +## Principles + +- Store reviewed rationale, not raw hidden chain-of-thought. +- Keep decisions recoverable: source choices, rejected citations, audience assumptions, and revision reasons belong in durable notes. +- Link concrete artifacts by path so future sessions can find the HTML, JSON, app page, source note, or bibliography record without rediscovery. +- Treat pending source slots as first-class memory items. They should remain visible until CiteGeist or another reviewed workflow resolves them. +- Prefer compact operational notes that future agents can act on over broad summaries that lack file paths or next actions. + +## Current Pilot + +The first applied scaffold is the evo-edu Notebook concept page: + +- `/home/netuser/dev/evo-edu.org/notebook/concepts/allele-frequency-change.html` +- `/home/netuser/dev/evo-edu.org/notebook/concepts/allele-frequency-change.scaffold.json` + +Related local memory notes: + +- `/home/netuser/.groundrecall/source-notes/knowledgebase-lcot-sciencepedia-implications-20260513.md` +- `/home/netuser/.groundrecall/source-notes/evo-edu-notebook-allele-frequency-scaffold-20260513.md` + +## Downstream Responsibilities + +- Didactopus consumes prompt seeds for learner-facing prediction, evidence, and revision activities. +- doclift extracts or emits scaffold-shaped records from longer documents. +- CiteGeist resolves bibliography source slots. +- Notebook exposes the reviewed learner-facing summary.