mmolloy/Hayden-Project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Split memory and task tracking docs

Browse Source
This commit is contained in:
deamonkai
2026-03-28 11:52:59 -05:00
parent 941476150c
commit 2166b8ebb5
3 changed files with 39 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
MEMORY.md
View File

@@ -2,14 +2,11 @@
This file is the durable handoff for AI agents working in this repository. Keep it short, factual, and current. If it ever drifts from the source docs or code, update this file to match the real source of truth.
## Working With the Operator
## File Roles
The operator has ADHD. This means:
They may squirrel down tangential paths — if the conversation drifts far from the task at hand, gently reframe by summarizing where we started, what we've done, and what's still open.
Periodic big-picture reviews help — when a session gets deep into details, proactively offer a summary of the larger context (current priorities, what's in-flight, what's blocked).
Keep TODO.md and this file updated — these are the external memory that bridges sessions. If something important is discussed but not captured, it's lost.
Be direct about scope creep — if a "quick fix" is turning into a multi-file refactor, flag it. Help them decide: do it now, or capture it and come back.
- `MEMORY.md` stores durable project context: guardrails, sourced facts, assumptions, decisions, code status, and verification notes.
- `TODO.md` stores the active execution queue and the current critical path.
- Do not turn `TODO.md` into a second memory file or turn `MEMORY.md` into a running checklist.
## Guardrails
@@ -20,6 +17,7 @@ Be direct about scope creep — if a "quick fix" is turning into a multi-file re
- When implementing the atmosphere helper, include the stratosphere branch for altitude `> 11 km`.
- Do not describe the model as runnable until all `XX` placeholders are replaced and `getRho.m` exists.
- Record every meaningful assumption, extracted constant, unresolved issue, and verification result here.
- Keep `TODO.md` aligned with the current critical path, but keep durable context and decisions in this file.
- Use exact dates in status notes.
- Do not store secrets, tokens, or personal data in this file.
@@ -73,10 +71,12 @@ After any meaningful change, update:
- `Current Snapshot` if assumptions, sourced values, or operating context changed.
- `Code Status` if files were added, edited, or made runnable.
- `Next Actions` so the current critical path stays accurate.
- `Next Actions` only if the durable sequencing changed in a meaningful way.
- `TODO.md` if the active work queue or current critical path changed.
- `Change Log` with a short dated note.
## Change Log
- `2026-03-28`: Created `README.md` and `MEMORY.md` from the `/docs` PDFs and current MATLAB code. Confirmed the repo is still an incomplete assignment skeleton with unresolved placeholders and a missing `getRho.m`.
- `2026-03-28`: Documented professor guidance that the atmosphere model must be integrated into the simulation, must include the stratosphere branch for altitude `> 11 km`, and will not run until the `XX` placeholders are replaced.
- `2026-03-28`: Clarified file roles so `MEMORY.md` is the durable handoff and `TODO.md` is the active execution tracker.