fire-session-summary

/fire-session-summary

Compact forward-looking session summary — fills the gap between full WARRIOR handoffs and the memory system

---

Purpose

Generate a lightweight session summary capturing what the memory system doesn't: aggregate status, readiness assessment, forward planning, and concrete next steps. Saved as a searchable memory point (source type: session_summary), indexed automatically by the session-end consolidation hook.

Not a replacement for /fire-5-handoff. Use handoffs for milestones. Use this for every session — it's fast, compact, and auto-indexed.

---

Arguments

arguments: none

optional_flags:
  --project: "Override project name detection"
  --no-save: "Display summary without saving to file"

---

Process

Step 1: Gather Context (30 seconds)

Quickly scan what happened this session. Do NOT re-read entire files — use what you already know from conversation context.

Collect from conversation context:
  - What tasks/features were worked on
  - What was completed vs left partial
  - What blockers were hit
  - What decisions were made
  - What files were created/modified

IF in a git repo:
  git log --oneline --since="4 hours ago" 2>/dev/null | head -10

IF .planning/CONSCIENCE.md exists:
  Read current phase and status (first 20 lines only)

Step 2: Detect Project Name

Priority order:
  1. --project flag if provided
  2. .planning/VISION.md project name
  3. Git repo name (basename of git root)
  4. Current directory name
  5. "general" (fallback for System32/multi-project sessions)

Step 3: Generate Summary

Write the summary using EXACTLY this template. Keep each section to 2-4 lines max.

---
session: {YYYY-MM-DD}
project: {detected project name}
type: session_summary
---

# Session Summary: {YYYY-MM-DD}

## Status
| Item | State | Detail |
|------|-------|--------|
| {work item 1} | DONE / PARTIAL / BLOCKED | {one-line detail} |
| {work item 2} | DONE / PARTIAL / BLOCKED | {one-line detail} |

## Readiness
- **Ready:** {what next session can immediately start on}
- **Blocked:** {external blockers, or "None"}
- **Needs first:** {prerequisites before main work, or "Nothing"}

## Outlook
- **Trajectory:** {on-track / behind / ahead / exploratory}
- **Risk:** {key risk, or "Low"}
- **Momentum:** {what's going well — one line}

## Next Steps
1. **{Priority 1}** — {specific actionable description}
2. **{Priority 2}** — {specific actionable description}
3. **{Priority 3}** — {specific actionable description}

## Decisions Made
- {Decision — rationale in 10 words or less}