Skip to content

feat(framework): repo files as persistent AI memory (#260)#261

Merged
suleimansh merged 1 commit into
mainfrom
feat/repo-memory-files
Jul 5, 2026
Merged

feat(framework): repo files as persistent AI memory (#260)#261
suleimansh merged 1 commit into
mainfrom
feat/repo-memory-files

Conversation

@suleimansh

Copy link
Copy Markdown
Member

Closes #260. Part of #204 (Open Loop). Rom: systematically use special repo files as persistence + AI memory.

We already write DECISIONS.md. This adds the read side: the agent reads the repo memory files at the start of a run for context, and is told to keep the ones it owns current.

  • loadRepoMemory(cwd) reads the canonical files present (CODE-OVERVIEW.md, KNOWLEDGE-BASE.md, BRAINSTORMING.md, DECISIONS.md).
  • runFramework gains a memory option; the files are framed into the system prompt alongside personas + skills: current contents (context) + a maintain instruction (persistence). The agent has file access, so it does the writing.
  • CLI reads the files from the workspace and passes them in, same pattern as signals + the-framework.yml.

Correctness: DECISIONS.md is framework-owned (we write it from the decisions ledger at run end), so it is framed read-only. Otherwise the agent could edit it and our end-of-run write would clobber that.

Verified e2e with --fake --cwd <dir with memory files>:

◆ project memory: CODE-OVERVIEW.md, KNOWLEDGE-BASE.md
# no files -> no line

New exports: loadRepoMemory / memoryFraming / MEMORY_FILES / MemoryFile / LoadedMemory. Typecheck + 113 framework tests green. Changeset minor.

Follow-ups (separate): a summarize/update step on the ledger, and truncation for large files.

@suleimansh suleimansh added enhancement New feature or request priority: medium Worth doing, not urgent labels Jul 5, 2026
@suleimansh suleimansh self-assigned this Jul 5, 2026
@suleimansh suleimansh force-pushed the feat/repo-memory-files branch from 6e5569c to ea1903a Compare July 5, 2026 16:25
@suleimansh suleimansh merged commit edd242b into main Jul 5, 2026
2 checks passed
@suleimansh suleimansh deleted the feat/repo-memory-files branch July 5, 2026 16:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request priority: medium Worth doing, not urgent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Repo files as persistent AI memory (CODE-OVERVIEW / KNOWLEDGE-BASE / ...)

1 participant