bonfire

⚠Review·Scanned 2/18/2026

This skill manages session context for coding and persists notes, specs, and docs under .bonfire/ and project templates. It also instructs running CLI tools like gh/git and updating agent memory at ~/.claude/projects/<project-dir>/memory/MEMORY.md, which has security implications.

by vieko·v4.3.0·14.0 KB·70 installs
Scanned from main at 451541d · Transparency log ↗
$ vett add vieko/bonfire/bonfireReview findings below

Bonfire

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

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

Commands

CommandPurposeDetails
/bonfire startBegin session, load contextcommands/start.md
/bonfire endSave context, health checkcommands/end.md
/bonfire configChange settingscommands/config.md
/bonfire spec <topic>Create outcome speccommands/spec.md
/bonfire doc <topic>Create documentationcommands/doc.md
/bonfire reviewReview current workcommands/review.md

Command Routing

Parse $ARGUMENTS to determine which command to run:

InputAction
startRead commands/start.md and execute
endRead commands/end.md and execute
config or configureRead commands/config.md and execute
spec <topic>Read commands/spec.md and execute
doc <topic> or document <topic>Read commands/doc.md and execute
reviewRead commands/review.md and execute
Empty or context questionRead 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 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":

  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