AI Notes — Consolidate
Consolidate raw session observations from .ainotes/log.md into a curated .ainotes/memory.md.
Workflow
- •Check if
.ainotes/directory exists in the repo root. If not, create it with emptymemory.md,rules.md, andlog.md. - •Read
.ainotes/log.md— these are raw observations appended by the commit skill. - •Read
.ainotes/memory.md— this is the current curated memory. - •Read
.ainotes/rules.md— check for any rules that should be updated or deduplicated. - •Consolidate log entries into memory:
- •Merge new observations into the appropriate section
- •Deduplicate — if a fact is already in memory, skip it
- •Merge related observations into single concise entries
- •Prune stale info that contradicts newer observations
- •Keep memory under ~200 lines (hard limit)
- •If any log entries describe mistakes or operational lessons, ensure they're captured in
rules.mdas one-liners. - •Write updated
memory.md - •Truncate
log.md— keep only the last 10 entries as a buffer, remove everything else.
memory.md Format
Use structured sections. Only include sections that have content:
markdown
# AI Notes — <project name> ## Architecture - <observation> ## Gotchas - <observation> ## Workflows - <observation> ## Testing - <observation> ## Dependencies - <observation> ## Conventions - <observation>
Rules
- •Every bullet must be a terse one-liner — no paragraphs
- •Prefer specifics over generalities (file paths, command names, exact behavior)
- •If memory exceeds ~200 lines, aggressively prune least-useful entries
- •Never duplicate information already in README.md or AGENTS.md
- •When merging contradictory observations, keep the newer one
- •Mistakes and operational lessons go in
rules.md, notmemory.md