Metis Session End

---
name: metis-session-end
description: Update .metis/CURRENT.md with the session handoff.
---

# $metis-session-end

Close out the session: rewrite `.metis/CURRENT.md`.

## Preconditions

`.metis/` must exist. If it does not, stop and point at `$metis-init`.

## Load

- The current `.metis/CURRENT.md`.
- `.metis/BUILD.md`, when an item was completed this session — so the finished item can move to *Built* and the active-task pointer can advance. `Read` it before the `Edit`.
- The session's in-flight state from conversation context — what just happened, what was decided, what is queued, any plan or scope report mid-flow, and any review verdicts.

## Do not load

- Other `.metis/` artifacts (`SYNTHESIS.md`, `INDEX.md`, `CONTRADICTIONS.md`, `QUESTIONS.md`, `RESOLVED.md`). The handoff is about session state, not project state.
- `docs/`.

## Read first

This skill's `references/session-handoff.md` — read before writing the handoff.

## Write scope

- **`.metis/CURRENT.md`** — full rewrite. The handoff is the cumulative summary of session state, not an append log.
- **`.metis/BUILD.md`** — only when an *item* is fully complete (its last task review-approved) this session: a surgical `Edit` moving that item from *To build* to *Built*. An item still in progress stays put; its progress is recorded in `CURRENT.md` instead. Nothing else in the file changes.

### Do not write to

- Other `.metis/` files.
- `docs/`.
- `.claude/`.

## Invocation prompt

Trailing prompt: see this skill's `references/command-prompts.md`.

## Return

- **Handoff summary** — the blocks of the new `CURRENT.md`, rendered inline.
- **Backlog updates** — any item moved to *Built* and the new active item; for an item still in progress, the next step recorded in *Current state*. "No change" if nothing advanced.
- **Pending decisions** — any architectural choice made this session that should be remembered next time but wasn't captured (in the docs, in code, or in a commit message). Surfaced as a flag for the user.
- **Next step** — typically the session ends here.