save

/save — Save the Session and Consolidate Memory

Saves the session to the vault and automatically consolidates durable decisions, insights and conventions. Use it when you finish or pause work.

Run both phases in order. Phase 2 only writes when there is durable knowledge. When in doubt, don't write: the session log already preserves the context, and the user can pin something later with /memorize.

Vault detection (same rule as /resume)

Run this block (one Bash call) and use the printed vault= as <vault>, project= as <project>, project_dir= as <vault>/<project> and logs= as the log folder:

setopt nullglob 2>/dev/null  # zsh aborts on unmatched globs; no-op in bash
vault=${VAULT_DIR:-$HOME/vault}
root=$(git rev-parse --show-toplevel 2>/dev/null); root=${root:-$PWD}
project=$(basename "$root")
if [ -d "$vault/$project" ]; then pdir="$vault/$project"; logs="$pdir/logs"; else pdir=""; logs="$vault/logs"; fi
echo "vault=$vault project=$project project_dir=${pdir:-NONE} logs=$logs"

• The vault is $VAULT_DIR (default ~/vault). The project is the basename of the git top-level folder, or of the current directory outside git.
• project_dir=NONE: logs go to <vault>/logs/ and decisions stay in the log only. Don't create a project folder in the vault.

Phase 1: Session log (always)

1. Read <vault>/CLAUDE.md before writing. Review the whole conversation of this session.
2. Create <logs>/YYYY-MM-DD-short-description.md (kebab-case, no accents). Never overwrite an existing log: if the name already exists, add HHMM after the date. Frontmatter:

---
title: "Descriptive session title"
tags: [session-log, <project>]
created: YYYY-MM-DD
updated: YYYY-MM-DD
status: completed
type: log
---

1. Sections:
   • ## What was done
   • ## Decisions made (if none, "No new decisions.")
   • ## Pending
   • ## State for resume: task (or none), branch, pending acceptance criteria, tests run and result, blockers, exact next action
   • ## Files modified (path — what changed)
   • ## Notes created or updated (filled at the end of Phase 2)
2. Follow the rules in <vault>/CLAUDE.md: at least 2 wikilinks, complete frontmatter.
3. Never include the raw log of the whole conversation. If an existing vault note became outdated and is not handled in Phase 2, tell the user.