Save

/neo:save — persist session memory

Brain: !ls .neo/brain 2>/dev/null || echo "MISSING — run /neo:init first" · Uncommitted: !git diff --stat HEAD 2>/dev/null | tail -1 || echo "not a git repo"

Steps

1. Guard: if .neo/brain/ is missing, stop and point to /neo:init.

2. Assemble the session delta (you, NEO, know the session — the shadow doesn't):

   • What was worked on and what state it reached (done / in-flight / blocked)
   • What changed on disk (summarize from the git stat above; include key file paths)
   • Decisions made this session, with the why and the rejected alternatives
   • Anything that bit us — mistakes, surprises, gotchas worth a lesson
   • What comes next + open questions

3. Spawn neo-shadow (Agent tool) with the 6-section contract. TASK: update the brain from this delta. EXPECTED OUTCOME: ACTIVE rewritten (cap 150 lines), PROGRESS appended under today's date, DECISIONS/LESSONS updated only if the delta earns it, ARCHITECTURE only if patterns changed, WORKFLOWS updated if the session repeated a known multi-step sequence. MUST NOT: touch anything outside .neo/. CONTEXT: the full delta from step 2.

4. Verify: confirm from the shadow's report which files changed. Relay one line to the user: "Brain saved — ACTIVE rewritten, PROGRESS +1 entry" (adjust to reality). If the report flags a workflow at 3+ sightings, offer /neo:train.