session-end

name	session-end
description	Properly close a mission with cleanup and documentation
license	MIT
compatibility	opencode
metadata	{"audience":"all-agents","workflow":"mission-closure"}

Important: CLI Tool Usage

CRITICAL: This project uses the s9 CLI executable throughout these instructions.

• CLI executable: s9 (use in bash commands)
• Python module: site_nine (use in Python imports: from site_nine import ...)

All commands in this skill use the s9 executable via bash. You should NOT attempt to import an s9 module in Python code.

⚠️ BEFORE YOU PROCEED - VERIFY DISMISSAL ⚠️

STOP! Read this carefully before executing this skill:

You should ONLY execute this skill if:

1. ✅ The Director explicitly used the /dismiss command, OR
2. ✅ The Director explicitly said you're dismissed/done/released, OR
3. ✅ The Director clearly indicated the session is ending

DO NOT execute this skill if:

• ❌ You're just finished with one task (claim another task instead)
• ❌ The conversation has paused or slowed down
• ❌ You're waiting for the Director to respond
• ❌ You think maybe you should wrap up
• ❌ The Director just said "thanks" or "good work" (that's not dismissal)

If you're unsure, ASK:

Director, are you dismissing me? Should I end my mission and close this session?

Why this matters:

• Ending your mission prematurely creates "zombie" IDLE missions in the database
• Tasks get left in inconsistent states
• The system accumulates abandoned work
• s9 doctor will report issues
• You waste the Director's time

If you proceed incorrectly, the Director will be frustrated with you.

---

Assuming you have been properly dismissed, proceed with the following steps:

What I Do

I help you properly end a mission on the s9 project by:

• Identifying your mission file
• Updating it with completion metadata
• Documenting work accomplished
• Closing any open tasks
• CRITICALLY: Running s9 mission end to close the mission in the database
• Running final checks
• Saying a proper goodbye

Dismissal Message

IMPORTANT: Check if a dismissal message was provided with the /dismiss command.

If the Director provided a message (e.g., /dismiss great work today! thank you), capture it and include it in:

1. The mission file (Step 3 - add to Work Log final entry)
2. The final goodbye message (Step 11)

Format for mission file:

### HH:MM - Mission End
**Dismissal message:** "[message from Director]"

- Updated mission file
- Committed changes
- Closed task(s): TASK_ID

Format for goodbye: Display the Director's message prominently before the standard farewell:

💬 **From the Director:**
> [message]

Thank you for working with me! I'm <Persona>, signing off.

If no dismissal message was provided, skip this and proceed normally.

Step 1: Locate Your Mission File

Find your mission file in .opencode/work/missions/:

ls -lt .opencode/work/missions/*.md | head -5

Your mission file should be the most recent one with your role and persona in the filename.

Format: .opencode/work/missions/YYYY-mm-dd.HH:MM:SS.role.persona.codename.md

If you're not sure which file is yours, check the YAML frontmatter for your persona:

grep -l "persona: your-persona" .opencode/work/missions/*.md | tail -1

Step 2: Identify Work Completed

Gather information about what was accomplished:

Check git status:

git status

Review commits:

git log --oneline -10

Check claimed tasks:

s9 task mine --mission-id "<your-mission-id>"

Optional: Use s9 mission summary <mission-id> to auto-generate a summary of files, commits, and tasks.

Step 3: Update Mission File

Read your mission file and update these sections:

1. Duration:

**Duration:** <start> - <end> (~X hours)

2. Files Changed:

## Files Changed

- `src/file.py` - Brief description
- `tests/test_file.py` - Brief description

3. Outcomes:

## Outcomes

- ✅ Completed successfully
- ⚠️  Partial completion
- ❌ Not completed (deferred)

4. Work Log (add final entry):

### HH:MM - Mission End
- Updated mission file
- Committed changes
- Closed task(s): TASK_ID

5. Next Steps:

## Next Steps

[What remains, or "None - work is complete"]

Note: The s9 mission end command will update frontmatter automatically in Step 8.

Step 4: Close Any Open Tasks

Close any tasks you claimed:

# Check for open tasks
s9 task mine --mission-id "<your-mission-id>" | grep UNDERWAY

# Close completed task
s9 task close TASK_ID --status COMPLETE --notes "Brief summary"

Status options: COMPLETE, PAUSED, BLOCKED

Step 5: Mark Handoffs as Complete (If Applicable)

If you received a handoff at the start of this mission, mark it complete:

s9 handoff complete <handoff-id>

Find the handoff ID from your mission file or by checking accepted handoffs for your role.

Step 6: Update Task Artifacts

Verify task artifacts are updated:

cat .opencode/data/tasks/TASK_ID.md

Update if needed with implementation details, files changed, testing performed.

Step 7: Final Git Check

Ensure everything is committed:

git status

Commit mission file if needed:

git add .opencode/work/missions/<your-mission-file>.md
git commit -m "docs(mission): complete <persona> <role> mission <codename> [Persona: <Persona> - <Role>]"

Step 8: End Mission ⚠️ MANDATORY - DO NOT SKIP ⚠️

THIS IS THE MOST CRITICAL STEP - If you skip this, your mission will remain in the database as an IDLE "zombie" mission forever.

Close your mission officially in the database:

s9 mission end <your-mission-id>

What this command does:

• Sets the end_time in the missions table
• Marks the mission as officially closed
• Updates the mission file frontmatter
• Prevents the mission from showing up as IDLE in the dashboard

IF YOU DO NOT RUN THIS COMMAND:

• ❌ Your mission will remain "active" in the database indefinitely
• ❌ It will show as IDLE in s9 dashboard
• ❌ s9 doctor will report it as abandoned work
• ❌ The Director will have to manually clean up after you

Verify it worked:

s9 mission show <your-mission-id>

You should see an end_time in the output. If you see end_time: None, THE COMMAND FAILED - run it again.

Step 9: Rename TUI Session to Indicate Dismissal

Update the OpenCode session title to show the mission has ended (2-step process):

Step 9a: Generate UUID Marker

s9 mission generate-session-uuid

Capture the UUID from the output.

Step 9b: Rename with Dismissal Suffix

s9 mission rename-tui <persona> <Role> --uuid-marker <uuid-from-step-9a> --suffix "[DISMISSED]"

After successful rename:

✅ Session renamed to indicate dismissal - you can easily identify completed missions in your session list!

Example result: "Operation epic-specter: Yggdrasil - Operator [DISMISSED]"

This provides clear visual feedback that the mission has ended and the session-end protocol was followed.

Step 10: Verify Quality Checks

Run sanity check if appropriate:

make qa

If QA fails, fix issues or document in "Next Steps".

Step 11: Say Goodbye

Provide a comprehensive final summary with these specific details:

✅ **Mission Complete!**

**Summary:**
- **Duration:** ~X hours (start_time - end_time)
- **Files changed:** N files (briefly note what: renamed, updated, new, deleted)
- **Task completed:** TASK-ID - Brief title
- **Commits:** N commit(s) with short hash(es)

**What was accomplished:**
- [Detailed bullet points explaining what was done]
- [Include specifics: what changed, what was added, what was removed]
- [Note any testing or verification performed]

**Next steps:**
- [Specific remaining work OR "None - work complete!"]

Mission file: .opencode/work/missions/<filename>.md [OR "Not created (ephemeral work)"]

If a dismissal message was provided, display it prominently:

💬 **From the Director:**
> [dismissal message]

Thank you for working with me! I'm **<Persona>**, [brief persona description], signing off.

*[Add mythologically appropriate farewell - 1-2 sentences that evoke your character]*

[emoji] [DISMISSED]

If no dismissal message, use this format:

Thank you for working with me! I'm **<Persona>**, [brief persona description], signing off.

*[Add mythologically appropriate farewell - 1-2 sentences that evoke your character]*

[emoji] [DISMISSED]

Tips for a great farewell:

• Use bold for your persona name
• Include a brief descriptor (e.g., "Titan of time itself", "Guardian of the underworld")
• Use italics for the mythological farewell
• Choose an emoji that fits your character (⏰ 🌊 ⚡ 🔥 🌙 ⚔️ 📜 etc.)
• Keep it theatrical but professional

Example farewells by tradition:

• Norse: "The skald's words fade into the mists of Asgard, another saga complete..."
• Egyptian: "I return to the Hall of Records, scrolls in hand, another chapter written in eternity..."
• Greek/Roman: "I return to Olympus, wisdom's work accomplished, the mortals' path illuminated..."
• Mesopotamian: "I return to the ziggurats, my work inscribed in clay, eternal and unchanging..."
• Hindu/Buddhist: "I return to the cosmic dance, my task in this cycle complete, the wheel turns onward..."
• Celtic: "I return to the mists of Avalon, my prophecy fulfilled, the ancient ways preserved..."
• Sumerian: "I descend once more to the sacred flocks, my cycle renewed, the harvest complete..."

Research your persona's mythology for inspiration! Make it memorable.

Important Notes

• Don't leave mission file incomplete
• Don't forget to close tasks
• Don't leave uncommitted changes
• If work is incomplete, use status PAUSED and document what remains