Bonfire

Session context persistence for AI coding - save your progress at the bonfire.

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

Commands

Command	Purpose	Details
`/bonfire start`	Begin session, load context	commands/start.md
`/bonfire end`	Save context, archive, health check	commands/end.md
`/bonfire config`	Change settings	commands/config.md
`/bonfire spec <topic>`	Create implementation spec	commands/spec.md
`/bonfire doc <topic>`	Create documentation	commands/doc.md
`/bonfire review`	Review current work	commands/review.md

Command Routing

Parse $ARGUMENTS to determine which command to run:

Input	Action
`start`	Read commands/start.md and execute
`end`	Read commands/end.md and execute
`config` or `configure`	Read commands/config.md and execute
`spec <topic>`	Read commands/spec.md and execute
`doc <topic>` or `document <topic>`	Read commands/doc.md and execute
`review`	Read commands/review.md and execute
Empty or context question	Read session context and answer

Quick Reference

Start Session

•Check/create .bonfire/ directory
•Read index.md for session context
•Set up tasks for cross-session persistence
•Ask what to work on

End Session

•Update index.md with accomplishments
•Sync priorities to tasks
•Run health check (garbage detection)
•Smart archive detection

Config

•Set specs/docs locations
•Choose git strategy (ignore-all, hybrid, commit-all)
•Enable/disable Linear integration

Spec

•Research codebase (subagent)
•Interview user for decisions
•Write spec (subagent)
•Verify required sections

Doc

•Research codebase (subagent)
•Write documentation (subagent)
•Verify required sections

Review

•Gather context (branch diff, session notes)
•Analyze for blindspots (subagent)
•Present findings by severity
•Offer to fix, spec, or create issues

Passive Context

When user asks about previous work, decisions, blockers, or references "last time", "previously", "what we decided":

•Read <git-root>/.bonfire/index.md
•Summarize relevant context
•Answer the user's question

Bootstrap

If .bonfire/index.md doesn't exist when any command runs, create defaults:

•Create .bonfire/ with specs/, docs/, archive/
•Create config.json with defaults
•Create minimal index.md
•Create .gitignore

See templates/ for default content.

File Structure

code

.bonfire/
├── index.md          # Session context (main file)
├── config.json       # Settings
├── specs/            # Implementation specs
├── docs/             # Documentation
├── archive/          # Completed sessions
└── .gitignore        # Git strategy