# /save — Save Progress for Later Sessions

> Persists all in-flight work to files so the next session can resume cleanly.

---

## Procedure

### Step 1: Load Current State

Read `.claude/project/STATE.md` to understand what is in progress.

### Step 2: Capture Unsaved Decisions

Review the current conversation for any architectural, design, or process decisions that were discussed but not yet persisted. If any are found, append them to `.claude/project/knowledge/DECISIONS.md` using the standard entry format:

```markdown
### DEC-XXXX — [Title]

- **Date:** [current date]
- **Status:** Accepted
- **Context:** [why this decision was needed]
- **Decision:** [what was decided]
- **Consequences:** [what this means going forward]
```

If no unsaved decisions exist, skip this step.

### Step 3: Verify Artifacts

Check that all substantial outputs from this session are written to files, not only present in chat. If any artifact is only in chat, write it to the appropriate location:

| Artifact Type | Location |
|---------------|----------|
| Documents, plans | `docs/` |
| Code | project source directories |
| Decisions | `.claude/project/knowledge/DECISIONS.md` |
| Research | `.claude/project/knowledge/RESEARCH.md` |

### Step 4: Update STATE.md

Set:
- `Last Run Status` = Checkpointed
- `Session Lock > Checkpointed` = Yes
- `Last Activity` = current timestamp

If there is an active task in progress, leave its status as-is (it will resume next session).

### Step 5: Log Checkpoint Event

Append to `.claude/project/EVENTS.md`:

```markdown
| EVT-XXXX | CHECKPOINT | Session saved. [brief summary of progress] | Processed |
```

Use the next available EVT number.

### Step 6: Print Save Summary

Print a compact summary:

```
== Session Saved ==

Files Updated:  [list of files modified this session]
Work Done:      [1-2 sentence summary]
Next Task:      [task ID — title, or "None"]
Resume With:    /run-project
```

---

## Rules

- Always update STATE.md before ending. This is the single source of truth for session continuity.
- Do not mark in-progress tasks as Done. They will resume next session.
- Keep the save summary under 10 lines.