bonfire

📁 vieko/bonfire 📅 Jan 27, 2026
64
总安装量
64
周安装量
#3416
全站排名
安装命令
npx skills add https://github.com/vieko/bonfire --skill bonfire

Agent 安装分布

claude-code 63
cursor 49
opencode 21
codex 21
amp 14

Skill 文档

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 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
  • 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/            # Implementation specs
├── docs/             # Documentation
└── .gitignore        # Git strategy