Save Session

Prerequisite check (run first): if ./memory/ does not exist OR ~/.claude/.memory-disabled marker file is present, this skill is a no-op. Output: "Memory persistence is disabled. Run ./setup.sh and choose to enable memory if you want this skill to work."

Save session state to memory:

1. Update session.md at ./memory/core/session.md:

• Current topic and what we're working on
• Recent progress (what was accomplished this session)
• Next steps (what should happen next session)
• Any blockers or open questions

1. Update reminders at ./memory/core/reminders.md:

• Ask the user if there are any pending tasks, deadlines, or reminders to carry forward
• Remove completed reminders (move to Completed section with date), keep active ones, add new ones

1. Update per-project context: If working on a registered project, update ./memory/projects/active/{project}.md → Session Context section:

• Last worked on (what specifically)
• In progress (current state)
• Next up (what should happen next on THIS project)

1. Check preferences.md: If new preferences or work patterns were observed during this session, update ./memory/core/preferences.md

1. Check MEMORY.md: If new technical learnings or gotchas were discovered, update {MEMORY_MD_PATH}. After any edit, count total lines — if over 170, warn that MEMORY.md is approaching the 200-line auto-truncation limit and suggest moving content to topic files.

1. Check decisions.md: If a non-obvious architectural or technical decision was made this session (something future-us would ask "why?"), append to ./memory/core/decisions.md using the existing format: ## YYYY-MM-DD — Title / **Context** / **Decision** / **Rationale**

1. Diary (if this was a significant session — e.g., feature shipped, major bug fixed, architecture decision made): Use the save-diary skill to create or append an entry to ./memory/diary/current/YYYY-MM-DD.md

1. Git commit + push memory: Stage all changed files in memory, commit with a descriptive message, and push to GitHub (git push origin main). This keeps the remote diary and session state up to date.

1. Confirm: Summarize what was saved and where

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: faizkhairi
• Source: faizkhairi/claude-code-blueprint
• License: MIT
• Homepage: https://github.com/faizkhairi/claude-code-blueprint#readme

Install and usage instructions live in the source repository linked above.