End Session

Git root: !git rev-parse --show-toplevel

Step 1: Review Session Work

Review what was accomplished this session by examining:

• Recent git commits

• Files changed

• Conversation context

Step 2: Update Session Context

Update <git-root>/.bonfire/index.md :

Update the session entry with:

• Accomplished: List what was completed

• Decisions: Key decisions made and rationale

• Files Modified: Important files changed (if relevant)

• Blockers: Any issues encountered

Update "Next Session Priorities" based on remaining work

Update "Current State" to reflect new status

Step 3: Update Codemap

Update the "Codemap" section in index.md with files referenced this session:

Identify key files from this session:

• Files you read or edited

• Files mentioned in commits

• Files central to the work done

Update "This Session's Key Files":

• List up to 10 most relevant files

• Include brief description of what each does

• Format: -
  path/to/file.ts - Brief description

Preserve user-curated sections:

• Keep "Entry Points" as-is (user maintains these)

• Keep "Core Components" as-is (user maintains these)

Keep it concise:

• Only include files directly relevant to session work

• Remove stale entries from previous sessions

• Max 10 files in "This Session's Key Files"

Step 4: Sync to Tasks

Sync "Next Session Priorities" to the Tasks system for cross-session persistence:

Convert priorities to tasks:

• Each priority in index.md becomes a task

• Preserve task descriptions and context

• Mark completed items as done

Task list continuity:

• Tasks persist automatically across sessions

• New session will see these without needing to read index.md

• index.md provides the "why", Tasks provide the "what"

Keep in sync:

• If priority was completed this session, mark task done

• If new priority emerged, add as new task

• Don't duplicate existing tasks

Step 5: Commit Changes (if tracked)

Read <git-root>/.bonfire/config.json to check gitStrategy .

If gitStrategy is "ignore-all": Skip committing - nothing is tracked.

If gitStrategy is "hybrid" or "commit-all":

• Stage unignored files: git add .bonfire/

• Check if anything was staged: git diff --cached --quiet .bonfire/

• If changes staged, commit: git commit -m "docs: update session context"

Step 6: Context Health Check

Run garbage detection and offer actionable cleanup.

6.1 Detect Issues

Scan .bonfire/ for:

• Broken file references: Internal links to non-existent files

• Stale external links: PRs/issues closed > 30 days ago

• Orphaned specs: Unreferenced specs older than 7 days

• Archive integrity: Broken links to archived sessions

6.2 Build Smart Summaries

For each issue, extract context (title, age, related PR status).

6.3 Assign Confidence Levels

• HIGH: Spec mentions merged PR, file > 90 days unreferenced, broken link

• MEDIUM: 30-90 days unreferenced, stale link > 60 days

• LOW: < 30 days, no signals

6.4 Offer Cleanup

Prompt for each category with context. Delete/remove based on user choice.

Step 7: Smart Archive Detection

Detect if session work is ready for archiving.

7.1 Check PR Status

If session context references PRs (#[0-9]+ or github.com/.*/pull/[0-9]+ ):

gh pr view [NUMBER] --json state,mergedAt,title

Track which PRs are merged vs open.

7.2 Check Task Completion

Review task list:

• All tasks completed? → completion signal

• Some tasks pending? → note for summary

7.3 Check Conversation Signals

Scan conversation for completion language:

• "done", "shipped", "complete", "finished"

• "merged", "closed", "resolved"

• "ready to archive"

7.4 Determine Action

Auto-archive (proceed without asking) if ANY:

• All referenced PRs are merged

• User explicitly said completion words in this session

• All tasks marked complete

Prompt with summary if:

• Mixed state (some PRs merged, some open)

• No clear signals detected

• Session has substantial content but unclear if complete

Skip archive if:

• No session content to archive (empty Recent Sessions)

• Work explicitly ongoing ("WIP", "still working on", "not done yet")

7.5 Prompt Format (when needed)

Show what would be archived:

SESSION COMPLETE?

This session's work:

• PR #30: "Add garbage detection" (merged ✓)
• PR #31: "Actionable cleanup" (merged ✓)
• Spec: context-garbage-detection.md (implemented)

Archive this session? [Y/n]

For partial completion:

PARTIAL COMPLETION

Completed:

• PR #30: "Add garbage detection" (merged ✓)

Still open:

• PR #31: "Actionable cleanup" (open)

Archive completed work? The open PR will stay in session. [Y/n]

Step 8: Archive (if triggered)

If Step 7 determined archiving should happen:

8.1 Create Archive Entry

Create file: .bonfire/archive/YYYY-MM-DD-<topic>.md

Template:

[TOPIC]

Date: [DATE] Issue: [ISSUE-ID or N/A] PR: [PR links] Status: Completed

Summary

[Brief description of what was accomplished]

Accomplished

• [List of completed items]

Decisions Made

• [Key decisions and rationale]

Impact

• Files changed: [count]

Related

• [Links to specs, docs, or code]

8.2 Clean Up Index

Update .bonfire/index.md :

• Remove archived session from Recent Sessions

• Add link to Archived Sessions section

• Update Current State

• If partial archive, keep open work in Recent Sessions

8.3 Clean Up Specs

Check specsLocation for implemented specs:

• If spec was fully implemented and archived, delete it

• Archive has the record

8.4 Update Linear (if enabled)

Read linearEnabled from config. If true and session references Linear issue:

linear issue update ENG-123 --state "Done"

On failure, warn but continue.

8.5 Commit Archive (if tracked)

If gitStrategy is "hybrid" or "commit-all":

git add .bonfire/ && git commit -m "docs: archive completed session"

8.6 Archive Summary

ARCHIVED:

• Session: "Context Garbage Detection"
• PRs: #30, #31 (merged)
• Deleted spec: context-garbage-detection.md
• Added to: archive/2026-01-26-context-garbage-detection.md

Step 9: Confirm

Summarize:

• What was documented

• Tasks synced for next session

• Next priorities

• What was archived (if anything)

SESSION ENDED

✓ Context updated ✓ Tasks synced ✓ Health check passed ✓ Archived: "Context Garbage Detection"

Ready for next session. Run /bonfire-start to continue.