| name | manage-okf-memory |
| description | Manage this repository's OKF project memory bundle. Use at the start and end of work in flutter-agentic-starter, when maintaining okf-memory daily logs, rolling daily logs into base knowledge, or recording durable agent knowledge such as coding patterns, human style, requirements, decisions, major changes, and roadmap changes. |
Manage OKF Memory
Use okf-memory/ as the source of truth. Keep it OKF v0.1 compatible: markdown files, YAML frontmatter on concept files, index.md and log.md reserved.
Start Of Work
- Run
date +%F.
- Read
okf-memory/index.md, relevant okf-memory/base/*.md, and today's okf-memory/daily/YYYY-MM-DD.md if it exists.
- Create today's daily file if no daily file exists.
- If the latest
okf-memory/daily/*.md file is not today, roll over before other edits.
Rollover
For each prior daily file with merged: false:
- Move durable entries into the matching base file:
coding-patterns, human-style, project-requirements, decision-changes, major-changes, roadmap.
- Deduplicate against existing base facts. Do not preserve transient debugging notes.
- Set the daily file to
merged: true.
- Update changed base files with
timestamp and merged_through.
- Append a dated entry to
okf-memory/log.md.
- Create today's daily file with the same sections and
merged: false if it does not exist.
End Of Work
Update today's daily file only when there are new durable facts:
- Coding patterns agents should repeat.
- Human communication or report style preferences.
- Stable project requirements or verification rules.
- Accepted, rejected, or superseded decisions.
- Major repository changes.
- Roadmap changes.
Skip repeated facts, speculative ideas, temporary build logs, local paths with private values, secrets, tokens, credentials, and environment values. Put unresolved questions last.
