From 3ac42ad7d8cfcea82de08014ea985d70432e7643 Mon Sep 17 00:00:00 2001 From: Dipak Date: Thu, 23 Jul 2026 13:34:46 +0530 Subject: [PATCH] docs: remove stale memory-bank references and clarify the transient todo.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Three references pointed at memory-bank paths that do not exist: - tests/README.md listed a test_memory_bank/ directory that is not in the tests tree; removed from the layout. - tests/test_core/test_setup/test_link_on_methods.py pointed its See Also at /memory-bank/design-decisions/joinspec-convenience-function.md, which does not exist on main; dropped the line and kept the GitHub issue reference, which still resolves. - CLAUDE.md and AGENTS.md described the Phase Completion Protocol as if memory-bank/todo.md were a standing file. Clarified that it is transient — created for a phased task, removed when the work lands, and not one of the Memory Bank core files — rather than dropping a protocol that is still used. CLAUDE.md and AGENTS.md are kept in sync. Closes #878 --- AGENTS.md | 6 +++++- CLAUDE.md | 6 +++++- tests/README.md | 1 - tests/test_core/test_setup/test_link_on_methods.py | 1 - 4 files changed, 10 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8ef68d417..9f4b358d6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -31,7 +31,11 @@ ## Phase Completion Protocol -When working with `memory-bank/todo.md` that contains phases: +Phased work uses a `memory-bank/todo.md` checklist. This file is **transient**: it is +created for the duration of a phased task and removed when the work lands, so it is not +part of the Memory Bank core files below and is normally absent from the repository. + +When such a `todo.md` exists and contains phases: 1. **After completing each phase**: Run `tox` to validate all tests pass 2. **If tox passes**: diff --git a/CLAUDE.md b/CLAUDE.md index 50069e356..d119d7c32 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -32,7 +32,11 @@ ## Phase Completion Protocol -When working with `memory-bank/todo.md` that contains phases: +Phased work uses a `memory-bank/todo.md` checklist. This file is **transient**: it is +created for the duration of a phased task and removed when the work lands, so it is not +part of the Memory Bank core files below and is normally absent from the repository. + +When such a `todo.md` exists and contains phases: 1. **After completing each phase**: Run `tox` to validate all tests pass 2. **If tox passes**: diff --git a/tests/README.md b/tests/README.md index c8921bbcf..8ec85d110 100644 --- a/tests/README.md +++ b/tests/README.md @@ -27,7 +27,6 @@ tests/ ├── test_documentation/ # Tests for documentation examples ├── test_examples/ # Tests for example code │ └── mloda_basics/ # Tests for basic mloda examples -├── test_memory_bank/ # Tests for memory bank functionality └── test_plugins/ # Tests for plugin implementations ├── compute_framework/ # Tests for compute framework plugins ├── extender/ # Tests for extender plugins diff --git a/tests/test_core/test_setup/test_link_on_methods.py b/tests/test_core/test_setup/test_link_on_methods.py index d8c5f7f49..17ba9bb8f 100644 --- a/tests/test_core/test_setup/test_link_on_methods.py +++ b/tests/test_core/test_setup/test_link_on_methods.py @@ -22,7 +22,6 @@ See Also: - GitHub Issue #133: JoinSpec Convenience Function - - Design Decision: /memory-bank/design-decisions/joinspec-convenience-function.md """ from typing import Any, Optional