ros/claude-plugins-official
1
0
Fork 0
mirror of https://github.com/anthropics/claude-plugins-official.git synced 2026-03-17 10:33:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
cccd8b3ea2909afd6bf8c220b9372a38ae6d6ee4
claude-plugins-official/external_plugins/bonfire/commands/git-strategy.md
Tobin South 478ea5b46a add(plugin): bonfire — session-context workflow tooling 
Adapted from PR #108 by @vieko (Vercel).
Original: https://github.com/anthropics/claude-plugins-official/pull/108
2026-03-16 12:51:34 -07:00

2.1 KiB
Raw Blame History

description, allowed-tools, model
description allowed-tools model
Change how .bonfire/ is handled in git Bash(git:*), Read, Write, AskUserQuestion haiku

Change Git Strategy

Step 1: Find Git Root

Run git rev-parse --show-toplevel to locate the repository root.

Step 2: Read Current Config

Read <git-root>/.bonfire/config.json to check current specsLocation and docsLocation settings.

Step 3: Explain Options

Present the git strategy options:

  1. Ignore all - Keep sessions completely local

    • Everything in .bonfire/ is gitignored
    • Most private, nothing shared
    • Good for: solo work, sensitive projects

  2. Hybrid - Commit docs/specs, keep notes private

    • docs/ and specs/ are committed
    • index.md and archive/ stay local
    • Good for: teams that want shared docs but private notes

  3. Commit all - Share everything with team

    • All session content is committed
    • Only data/ and scratch/ ignored
    • Good for: full transparency, team continuity

Step 4: Get User Choice

Use AskUserQuestion to ask which strategy:

"Which git strategy for .bonfire/?" (Header: "Git")

  • ignore-all (Recommended) - Keep sessions private/local
  • hybrid - Commit docs/specs, keep notes private
  • commit-all - Share everything with team

Step 5: Update .gitignore

Write the appropriate .gitignore to <git-root>/.bonfire/.gitignore:

Ignore all:

*
!.gitignore

Hybrid (only include dirs that are inside .bonfire/):

*
!.gitignore

If docsLocation is .bonfire/docs/, add:

!docs/
!docs/**

If specsLocation is .bonfire/specs/, add:

!specs/
!specs/**

Commit all:

data/
scratch/
scripts/

Step 6: Handle Git Tracking

If switching FROM commit/hybrid TO ignore:

  • Warn user that existing tracked files will remain tracked
  • Offer to run: git rm -r --cached .bonfire/ (removes from git but keeps files)
  • They'll need to commit this change

If switching TO commit/hybrid:

  • Files will be picked up on next commit
  • No special action needed

Step 7: Confirm

Report:

  • New strategy applied
  • Any manual steps needed
  • How to verify the change