Session Stop Skill

Graceful session close, pause, or verification. Three intents: Pause | Finish | Verify.

All session operations use

atlas-session

MCP tools directly (prefixed

session_*

and

contract_*

). Use

ToolSearch

to discover them.

Hard Invariants

1. User authority is absolute — AI NEVER closes without confirmation.
2. Human-visible memory only — All state lives in files.
3. Trust separation — for bounty verify, spawn a separate finality Task agent. Never the same agent that submits.
4. AtlasCoin is optional — if down, skip bounty steps and continue.
5. Idempotent — Running /stop on an already-closed session exits cleanly.
6. Archive after verification — Soul purpose is archived AFTER bounty settlement, not before.

UX Contract

• User sees ONE intent question, then results. Nothing else.
• No step announcements, no narration, no internal process descriptions.

---

Phase 0: Sync + State Detection

First, save the current session state so context files are up to date:

1. Invoke

   /sync

   — updates all session-context files and MEMORY.md with current progress. Silent, no output shown.

Then detect state:

2. Call

   session_read_context(project_dir)

   — get soul purpose, status hint, open tasks.
3. If

   status_hint

   is

   no_purpose

   or soul purpose is empty: tell user "No active soul purpose to close." EXIT.
4. Check bounty: if

   session-context/BOUNTY_ID.txt

   exists, call

   contract_get_status(project_dir)

   . Store

   HAS_BOUNTY

   .

Phase 1: Intent Question

Ask ONE question via AskUserQuestion:

Question: "Soul purpose: '[soul purpose text]'. What would you like to do?"

• "Pause for the day" — Save state, keep purpose active.
• "Finished — verify and close" — Full settlement + PR + archive.
• "Just verify" — Check status, show results, return to work.
• "Cancel" — Do nothing. EXIT.

Store the user's choice as

INTENT

.

Read

custom.md

if it exists, follow instructions under "During Settlement".

---

Intent A: Pause for the Day

Save progress. Soul purpose, bounty, and Ralph Loop all stay active.

Step 1: Harvest

1. Call

   session_harvest(project_dir)

   .
2. If promotable content exists, assess and present to user for approval.
3. After approval, append promoted content to target files via Edit tool.

Step 2: Write Checkpoint

Read

session-context/CLAUDE-activeContext.md

, then append a timestamped checkpoint:

## [CHECKPOINT] HH:MM DD/MM/YY
### Session Paused — Progress Saved

**Accomplished this session:**
- [AI fills in based on what was done]

**In progress:**
- [AI fills in based on current state]

**Next steps:**
- [AI fills in based on remaining work]

**Blockers/Decisions pending:**
- [AI fills in, or "None"]

Fill each section with real, specific content — not placeholders.

Step 3: Optional Save-Point Commit

Ask: "Create a save-point commit?" (Yes / No)

If Yes and project is git:

git add -A && git commit -m "checkpoint: [brief summary]"

. If commit fails, inform user and continue.

Step 4: Done

• Do NOT archive the soul purpose — it stays active.
• Do NOT settle the bounty — it stays active.
• Do NOT remove Ralph Loop indicator.
• Tell user: "Progress saved. Soul purpose '[text]' remains active. Run

  /start

  to pick up where you left off."

---

Intent B: Finished — Verify and Close

Full settlement: harvest, verify, review, PR, bounty, archive.

Step 1: Harvest + Promote

1. Call

   session_harvest(project_dir)

   .
2. If promotable content exists, assess and present to user. Append approved content.

Step 2: Feature Verification

1. Call

   session_features_read(project_dir)

   .
2. If pending features exist, run their proofs. Update status in

   CLAUDE-features.md

   .

Step 3: Verification Gate

1. Invoke

   superpowers:verification-before-completion

   — run doubt review on recent changes.
2. If critical issues: present to user — "Fix first" / "Close anyway" / "Continue working".
3. If "Continue working": EXIT (return to active work).

Step 4: Deactivate Hook

Call

session_hook_deactivate(project_dir)

.

Step 5: PR Creation

1. Push current branch:

   git push -u origin HEAD

2. Invoke

   superpowers:requesting-code-review

   for review body.
3. Create PR:

   gh pr create --title "..." --body "..."

   with review summary.
4. Return PR URL to user.

Step 6: Bounty Settlement (if bounty exists)

1. Call

   contract_run_tests(project_dir)

   — execute all criteria.
2. If tests pass: call

   contract_submit(project_dir)

   .
3. Spawn a single finality Task agent:

   Task(subagent_type: "general-purpose", prompt: "You are finality-agent. Verify bounty [ID] independently. Call contract_verify(project_dir). Report pass/fail.")

4. Wait for finality result.
5. If verified: call

   contract_settle(project_dir)

   . Tell user tokens earned.
6. If failed: "Fix and re-verify" / "Close anyway (forfeit)" / "Continue working".

Step 7: Archive + Cleanup

1. If user chose to set a new purpose, ask for it now. Store as

   NEW_PURPOSE

   .
2. Call

   session_archive(project_dir, OLD_PURPOSE, NEW_PURPOSE)

   .
3. Remove Ralph Loop indicator:

   rm -f ~/.claude/ralph-loop.local.md

4. Tell user: "Session closed. Soul purpose '[text]' archived." (Include token/PR info.)

---

Intent C: Just Verify

Check status without closing. Return to work after.

1. Invoke

   superpowers:verification-before-completion

   — doubt review.
2. Call

   session_features_read(project_dir)

   — show feature status.
3. If bounty exists: call

   contract_run_tests(project_dir)

   — show results.
4. Present all findings to user. No close, no archive.
5. Tell user: "Verification complete. Returning to work."