bd-to-br-migration

Migrates documentation and commands from bd to br system, updating IDs and sync behavior.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/0xrohan10/dotfiles --skill bd-to-br-migration-0xrohan10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-to-br-migration
Source: https://github.com/0xrohan10/dotfiles/tree/main/claude/.claude/skills/bd-to-br-migration
Command: npx skills add https://github.com/0xrohan10/dotfiles --skill bd-to-br-migration-0xrohan10

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and subagents (resource) components.

What problem does it solve?

This Skill automates the migration of documentation and commands from the bd (beads) system to the br (beads_rust) system, ensuring consistency and preventing errors caused by outdated references.

Core Features & Use Cases

  • Automated Command Transformation: Converts bd commands to their br equivalents, including the critical change in sync behavior.
  • Issue ID Convention Update: Renames issue IDs from bd-### to br-### across documentation.
  • Behavioral Change Enforcement: Ensures the new non-invasive nature of br and the requirement for manual Git steps are clearly documented and applied.
  • Use Case: When updating AGENTS.md files or other documentation that references bd commands or issue IDs, this Skill ensures all references are correctly updated to br syntax and behavior.

Quick Start

Use the bd-to-br-migration skill to migrate the file '/path/to/AGENTS.md' from bd to br.

Frequently Asked Questions about bd-to-br-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate documentation from beads to beads_rust?

Migrating beads documentation to beads_rust requires updating command syntax, converting issue IDs from bd-### to br-###, and revising sync behavior descriptions to reflect beads_rust's non-invasive nature.

What changes when converting bd commands to br equivalents?

Converting bd commands to br equivalents involves renaming commands, transforming sync behavior, and enforcing manual Git commit requirements. The br system operates non-invasively, requiring users to handle version control steps manually.

How do I update issue IDs from bd-### to br-### in documentation?

Updating issue IDs from bd-### to br-### requires scanning documentation files like AGENTS.md and systematically replacing all references. This ensures issue tracking remains consistent across the migrated beads_rust system.

Does beads_rust require manual Git commits after running commands?

Yes, beads_rust operates non-invasively, meaning it does not automatically perform Git commits. After running br commands, you must manually execute Git commits to track changes.

Can I automate AGENTS.md file updates for beads_rust migration?

Yes, you can automate AGENTS.md file updates for beads_rust migration by using scripting tools that handle command transformation and issue ID renaming. This ensures all bd references are correctly updated to br syntax.

What are the limitations of migrating bd docs to br syntax?

Migrating bd docs to br syntax requires careful handling of behavioral changes, as br's non-invasive nature and manual Git requirements must be clearly documented. Automated transformation may not capture all nuanced behavioral context without review.