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.

3
README.md
View File

@@ -56,7 +56,8 @@ At the moment, the repository is a partially completed assignment skeleton rathe
- Keep units in SI unless a source document explicitly states otherwise.
- Treat `/docs` and direct instructor clarifications as authoritative for assignment requirements and parameter values.
- Record assumptions, extracted tables, unresolved issues, and verification status in [`MEMORY.md`](./MEMORY.md).
- Track the active execution queue in [`TODO.md`](./TODO.md).
## For AI Agents
Read [`MEMORY.md`](./MEMORY.md) before making changes. Use it as the project's durable handoff for assumptions, sourced values, open work, and guardrails, and update it after any meaningful change so the next agent can continue without re-discovering context.
Read [`MEMORY.md`](./MEMORY.md) before making changes. Use [`MEMORY.md`](./MEMORY.md) for durable handoff context and [`TODO.md`](./TODO.md) for the live task queue, and update the one that changed so the next agent can continue without re-discovering context.

29
TODO.md Normal file
View File

@@ -0,0 +1,29 @@
# TODO
This file tracks the active execution queue. Use [`MEMORY.md`](./MEMORY.md) for durable context, sourced facts, guardrails, and decisions.
Last updated: `2026-03-28`
## Now
- [ ] Implement `getRho.m` and include the required stratosphere branch for altitude `> 11 km`.
- [ ] Fill the known assignment constants in [`code/Interceptor_3DOF.m`](./code/Interceptor_3DOF.m) and [`code/getGuidance.m`](./code/getGuidance.m).
- [ ] Replace the current syntax-breaking `XX` placeholders that prevent the model from starting in Octave.
## Blocked
- [ ] Transcribe missile and target reference areas, thrust curves, mass curves, and drag tables from [`docs/Missile and Target Data for 3DOF Spring 26.pdf`](./docs/Missile%20and%20Target%20Data%20for%203DOF%20Spring%2026.pdf).
## Next
- [ ] Replace the remaining `XX` arrays in [`code/T3dxdt.m`](./code/T3dxdt.m) and [`code/M3dxdt.m`](./code/M3dxdt.m) with sourced data.
- [ ] Run [`code/Interceptor_3DOF.m`](./code/Interceptor_3DOF.m) in Octave and fix the next runtime errors.
- [ ] Verify the required plots and inspect `Ttrajectory.csv` and `Mtrajectory.csv`.
## Done Criteria
- [ ] No remaining `XX` placeholders in executable code.
- [ ] `getRho.m` exists and is used by both vehicle dynamics models.
- [ ] The atmosphere model includes the required stratosphere handling for altitude `> 11 km`.
- [ ] The full script runs in Octave without syntax or runtime errors.
- [ ] The required plots and CSV outputs are generated.