ratacat/claude-skills/bd-to-br-migration

Migrate this file from bd (beads) to br (beads_rust).
 
Apply transforms IN THIS ORDER (order matters):
1. Section headers: "bd (beads)" → "br (beads_rust)"
2. Add non-invasive note after beads section header
3. Commands: `bd X` → `br X` for ready/list/show/create/update/close/dep/stats
4. Sync command: `bd sync` → `br sync --flush-only`
5. Add git steps after EVERY sync:
   git add .beads/
   git commit -m "sync beads"
6. Issue IDs: bd-### → br-### in thread_ids, subjects, reasons, commits
7. Links: beads_viewer → beads_rust (if present)
 
Remove completely:
- Daemon references
- Auto-commit assumptions
- Hook installation mentions
- RPC mode
 
Keep unchanged:
- SQLite/WAL cautions
- bv integration
- Priority system (P0-P4)
 
VERIFY after editing:
grep -c '`bd ' file.md     # Must be 0
grep -c 'bd sync' file.md  # Must be 0
grep -c 'br sync --flush-only' file.md  # Must be > 0

What are you migrating?
│
├─ Single file (AGENTS.md)
│  │
│  └─ Follow THE EXACT PROMPT above
│     Use: ./scripts/verify-migration.sh file.md
│
├─ Multiple files (batch)
│  │
│  ├─ <10 files → Sequential: apply prompt to each
│  │
│  └─ 10+ files → Parallel subagents
│     Batch ~10 files per agent
│     See: [BULK.md](references/BULK.md)
│
└─ Verify existing migration
   │
   └─ Run: ./scripts/find-bd-refs.sh /path
      Any output = incomplete migration

┌─────────────────────────────────────────────────────────────────┐
│                    bd (Go)              br (Rust)               │
├─────────────────────────────────────────────────────────────────┤
│  bd sync                     →    br sync --flush-only          │
│  (auto-commits to git)            (exports JSONL only)          │
│                                                                 │
│                              +    git add .beads/               │
│                              +    git commit -m "..."           │
└─────────────────────────────────────────────────────────────────┘
 
Everything else is literally s/bd/br/g

**Note:** `br` is non-invasive and never executes git commands. After `br sync --flush-only`, you must manually run `git add .beads/ && git commit`.

bd sync

br sync --flush-only
git add .beads/
git commit -m "sync beads"

git add <files>
bd sync
git push

git add <files>
br sync --flush-only
git add .beads/
git commit -m "..."
git push

thread_id: bd-123
subject: [bd-123] Feature implementation
reason: bd-123

thread_id: br-123
subject: [br-123] Feature implementation
reason: br-123

┌─────────────────────────────────────────────────────────────────┐
│                     VALIDATION IS MANDATORY                     │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  1. Apply transforms                                            │
│                    ↓                                            │
│  2. Run verification:                                           │
│     ./scripts/verify-migration.sh file.md                       │
│                    ↓                                            │
│  3. If FAIL → read error → fix specific issue → goto 2          │
│                    ↓                                            │
│  4. Only proceed when PASS                                      │
│                                                                 │
│  ⚠️ Never skip verification. Incomplete migrations break agents.│
└─────────────────────────────────────────────────────────────────┘

# MUST return 0:
grep -c '`bd ' file.md
grep -c 'bd sync' file.md
grep -c 'bd ready' file.md
 
# MUST return > 0 (if file has sync sections):
grep -c 'br sync --flush-only' file.md
grep -c 'git add .beads/' file.md

## Issue Tracking with bd (beads)
 
Key invariants:
-`.beads/` is authoritative
 
### Agent workflow:
1.`bd ready` to find work
2.`bd update <id> --status in_progress`
3.Implement
4.`bd close <id>`
5.`bd sync` commits changes

## Issue Tracking with br (beads_rust)
 
**Note:** `br` is non-invasive and never executes git commands. After `br sync --flush-only`, you must manually run `git add .beads/ && git commit`.
 
Key invariants:
-`.beads/` is authoritative
 
### Agent workflow:
1.`br ready` to find work
2.`br update <id> --status in_progress`
3.Implement
4.`br close <id>`
5.Sync and commit:
   ```bash
   br sync --flush-only
   git add .beads/
   git commit -m "sync beads"
   ```

# Full verification
./scripts/verify-migration.sh /path/to/AGENTS.md
 
# Quick check (should return nothing)
grep '`bd ' /path/to/AGENTS.md