bonfire-strategic

```bash

npx skills add vieko/bonfire

```

Works with Claude Code, Cursor, and other [Agent Skills](https://agentskills.io/) compatible tools.

AI agents are stateless. Every conversation starts from scratch. The agent doesn't remember what you decided yesterday, why you chose that architecture, or where you left off.

Bonfire maintains a living context document—read at session start, updated at session end.

```

/bonfire start → work → /bonfire end

```

No complex setup. No external services. Just Markdown files in your repo.

| Command | Outcome |

|---------|---------|

| /bonfire start | Session started, context loaded, ready to work |

| /bonfire end | Work captured, context healthy, completed work archived |

| /bonfire config | Settings updated to your preferences |

| /bonfire spec | Implementation spec that enables building the feature |

| /bonfire doc | Reference documentation for a system or feature |

| /bonfire review | Blindspots identified, actionable improvements offered |

```

.bonfire/

├── index.md # Living context

├── config.json # Settings

├── archive/ # Completed work

├── specs/ # Implementation specs

└── docs/ # Documentation

```

Commands define outcomes, not procedures. Each command specifies:

• What success looks like
• How to verify it worked
• Boundaries and constraints

The agent determines the procedure. This follows [ctate's patterns for autonomous agents](https://ctate.com).

| Setting | Options | Default |

|---------|---------|---------|

| specsLocation | .bonfire/specs/ or specs/ | .bonfire/specs/ |

| docsLocation | .bonfire/docs/ or docs/ | .bonfire/docs/ |

| gitStrategy | ignore-all, hybrid, commit-all | ignore-all |

| linearEnabled | true or false | false |

• Git repository
• Agent Skills compatible tool

Optional: gh CLI for GitHub, [linear-cli](https://github.com/schpet/linear-cli) for Linear.

• [Blog](https://vieko.dev/bonfire)
• [skills.sh](https://skills.sh)
• [agentskills.io](https://agentskills.io)

Animation by [Jon Romero Ruiz](https://x.com/jonroru).

MIT © [Vieko Franetovic](https://vieko.dev)