Session Close

Purpose

Close a session cleanly: overwrite each touched project's FOCUS.md, update BRAIN.md, and append one line per project to CHANGELOG.md.

Base path for all files below: {{BRAIN_ROOT}} (set by install.sh).

Steps

Step 1: Summarize the session

Derive from the conversation:

• Which projects were touched?
• What was built, changed, or decided?
• What is the current state per project?
• What is the concrete next step per project?

Step 2: Overwrite FOCUS.md per project

For each touched active project, fully rewrite {{BRAIN_ROOT}}/projects/<category>/<project>/FOCUS.md.

Do not hardcode a project list. Resolve the path dynamically:

• List directories under {{BRAIN_ROOT}}/projects/*/ and match the project name (and obvious aliases) against folder names.
• If the match is ambiguous or missing, ask the user which project is meant.

FOCUS.md format (max ~150 tokens — this is the hot state, kept deliberately small):

# FOCUS — [Project name]

State: YYYY-MM-DD

---

## What's running
[2-3 sentences]

## Next step (concrete)
[exactly one action]

## Then
- [next step]

## Open decisions
[only if actively blocking — omit if none]

## Recent sessions (max 3, non-code projects only)
- DD.MM. — what happened

Step 3: Update BRAIN.md

File: {{BRAIN_ROOT}}/BRAIN.md

For each touched project:

• Bring the one-line status (after the project name) up to date
• Set the Last updated: line at the top

If a project was completed:

• Remove it from "Active"
• Move it to "Archive" with a short closing note
• Move the folder via Bash to {{BRAIN_ROOT}}/_archive/<category>/<name>/

Step 4: CHANGELOG.md — one line per project

File: {{BRAIN_ROOT}}/CHANGELOG.md

Current timestamp via Bash: date "+%Y-%m-%d — %H:%M"

Insert a new section at the top:

## YYYY-MM-DD — HH:MM

**[Project name]**
- [What was done / decided — max 3-5 points]

**[Project name 2]**
- [What was done / decided]

Rules:

• Each /done call = its own section with a timestamp — never merge into existing entries
• Max 5 points per project — condense
• Only completed work + decisions, no open items, no discussion

Step 5: Confirm

Short summary of what was done, then sign off.

Known pitfalls

• No entry if nothing relevant happened in the session
• Discussion and conversation context belong in FOCUS.md ("What's running"), not CHANGELOG
• FOCUS.md is always overwritten — never appended
• Actually update the BRAIN.md one-line status — not just the date
• Always get the date via Bash, never infer it from the conversation