02-project-memory

name	02-project-memory
description	Build the project's memory of its architecture, conventions, and decisions, and wire it into your AI tools. Use when the user wants to set up or refresh project memory, or rewire it into a tool. Not for editing one existing memory file.
argument-hint	setup | refresh | rewire

Project Memory

flowchart LR
  new([no argument, or setup]) --> scan --> write --> sync --> wired([memory wired])
  update([refresh]) --> scan --> check --> write
  rewire([rewire]) --> sync
  scan -.-> empty([nothing to remember])

Actions

Run the flow above, reading only the next action file.

Action	Does
scan	read the project
write	write the memory
check	show what drifted, change nothing
sync	pick the tools, wire it in

Transversal rules

• If a referenced file cannot be read, stop and say so. Never invent its content.
• Ask before anything ambiguous. Never default silently.
• A bank that already exists changes only through what the user approved, file by file and line by line.
• End with a short report of what changed.