docs: remove stale memory-bank references and clarify the transient todo.md - #879
Merged
TomKaltofen merged 1 commit intoJul 28, 2026
Merged
Conversation
…odo.md 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 mloda-ai#878
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
All three references from the issue, each verified against
mainbefore touching it.1.
tests/README.md—test_memory_bank/The layout tree listed a
test_memory_bank/directory. There is no such directory undertests/. Removed the line.2.
test_link_on_methods.py— dead design-decision pathThe module docstring's See Also pointed at
/memory-bank/design-decisions/joinspec-convenience-function.md. Neither that file nor thememory-bank/design-decisions/directory exists onmain.Dropped that line and kept
GitHub Issue #133: JoinSpec Convenience Function, which still resolves — so the docstring keeps a working pointer to the rationale rather than losing the context entirely.3.
todo.mdin the Phase Completion ProtocolThe protocol read as though
memory-bank/todo.mdwere a standing file, which sits oddly next to the slimmed Memory Bank section.I clarified rather than dropped it: the protocol itself is still used, it's only the file's status that was unstated. Both files now say up front that
todo.mdis transient — created for the duration of a phased task, removed when the work lands, and therefore not one of the Memory Bank core files — before listing the steps.CLAUDE.mdandAGENTS.mdare kept in sync (I diffed the two sections to confirm they're identical).Note on overlap
This deliberately avoids the Memory Bank / core-files section that #877 is rewriting — the only shared files are
CLAUDE.md/AGENTS.md, and this change is confined to the Phase Completion Protocol section, which #877 doesn't touch. So the two should merge cleanly in either order.I did not touch #873's two catalog files, since #877 already removes them.
Checks
ruff format --check --line-length 120(597 files already formatted) andruff checkboth clean;tests/test_core/test_setup/test_link_on_methods.py— 18 passed. Docs/comments only, no behaviour change.Closes #878