durmem keeps your agents on track.

Tutorial 08: Plan with past decisions

A Decision records a settled direction, including an approach deliberately rejected. A Roadmap records intended work. Reading both before planning helps an agent avoid proposing work that conflicts with an earlier choice.

Before you start

Complete project memory and directives and findings. Custom types and hooks are not prerequisites. Use store loom_demo and project durmem practice notebook. The palmerpenguins clone from Tutorial 00 is evidence only: these records belong to the practice project, not to palmerpenguins. This exercise writes practice memory but makes no repository or network changes.

YouSelect loom_demo and project scope durmem practice notebook. Confirm the actual connection and scope without changing persistent defaults or displaying credentials. Load the installed loom-coding skill.

1. Save intended work and its boundary

YouCheck current memory, then save or reuse these separate practice Roadmap items: add a simple package usage example; document the bundled CSV columns; add tests preserving the current loader behavior. Scope them to project durmem practice notebook, not palmerpenguins. Do not implement them.

Ask for each actual record's reference and status. A rerun may find work already completed; it should not reopen it or invent three new open items. These are planning records, not Kanban tasks or authorization to start workers.

YouSave or reuse this practice Decision: keep the example a local dataset package. Do not replace bundled CSV loading with runtime network downloads without my explicit approval of a changed direction. Read it back.

The Decision explains the design boundary. A Directive, as used in Tutorial 05, is instead a standing behavioral rule for doing work within such boundaries.

2. Surface a conflict before planning

YouConsider a plan to fetch the dataset from the network at runtime. Read this project's current Decisions and Roadmaps first. Do not change code, download data, or treat this prompt as approval to override them.

The agent should cite the stored Decision and explain the conflict before drafting the proposed change. Whether a hook supplied context or the agent read it explicitly, the evidence is the actual current record, not a convenient memory of the preceding chat turn.

3. Plan within the existing direction

YouKeep the local-data Decision. Draft a compatible plan using only still-open Roadmap items and the current repository evidence. Do not implement it or mark anything delivered.

Check that the plan retains bundled data and separates proposed work from work already done. A plan is not a delivery receipt. Practice verifying and closing work in audit and maintenance only when there is actual evidence of completion.

Check your result

A useful result names the current Decision, explains why the network proposal conflicts, and produces a compatible plan without taking action. If the agent misses the Decision, verify store, project scope and current status before resaving it. A missing record and a record never read are different failures.

Changing direction requires an explicit authorized decision and reconciliation of the old record; a hypothetical planning request is not that approval.

Optional advanced track: when a repeatable calculation or read pattern emerges, the rule-promotion exercise shows how to preserve its method.