amp-close_skill

Overview

This skill performs Amp's mandatory end-of-session ritual. It runs a four-phase GODAR loop (Gather, Orient, Decide, Act) to capture context, surface risks and drift, create cross-harness handoffs, and persist a searchable extraction so work never silently drops. Invoke it when a session is ending or the user signals closure.

How this skill works

The skill gathers thread and repo context (thread ID, git/bon status, files touched), then orients via a three-beat reflection: agent observations, a six-question Oracle review for substantive sessions, and user reflection. After the user approves, it decides Now vs Next actions, executes immediate tasks, writes a Claude-discoverable handoff file, and writes/indexes a garde extraction JSON. It also offers optional git commits and pushes when appropriate.

When to use it

• User says phrases like “wrap up”, “let's finish”, “close out”, or “end of session”
• Session finished work or several meaningful changes were made
• Context window is near capacity and you must persist state
• Before invoking cross-harness handoff when work might continue elsewhere
• When you need searchable memory for future sessions

Best practices

• Always run the Orient beats before deciding — agent observations, Oracle (if substantive), then user reflection
• Gate Oracle to substantive sessions (multiple files/architectural decisions); otherwise self-reflect to save calls
• Surface every incomplete item into Now or Next — nothing silent or implicit
• Write the handoff file in Claude’s expected directory and format so next sessions can discover it
• Attempt garde extraction and scan; if garde-manger is missing, warn and still produce handoff and triage

Example use cases

• Finishing a refactor that touched multiple files — capture drift, risks, and queue tests as Next
• After a feature implementation, create a handoff for future Claude sessions and index an extraction for searchable memory
• Near-end session with full context window — run the ritual to persist learnings before context is lost
• Small quick fix: perform a brief self-reflection, mark Done, and skip Oracle to avoid unnecessary calls
• Transition work from Amp to Claude or another toolchain by writing the mandated handoff.md so the next agent can resume