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, health check	commands/end.md
/bonfire config	Change settings	commands/config.md
/bonfire spec <topic>	Create outcome 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
• Ask what to work on

End Session

• Update index.md with accomplishments
• Run health check (garbage detection)

Config

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

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":

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

Bootstrap

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

1. Create .bonfire/ with specs/ and docs/ subdirectories
2. Create index.md with frontmatter config (see templates/)
3. Create .gitignore

See templates/ for default content.

File Structure

.bonfire/
├── index.md          # Session context with config in frontmatter
├── specs/            # Outcome specs
├── docs/             # Documentation
└── .gitignore        # Git strategy