bd-to-br-migration

Migrate documentation from bd to br workflows with deterministic transforms.

10|2|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/lambdamechanic/tooltest --skill bd-to-br-migration-lambdamechanic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-to-br-migration
Source: https://github.com/lambdamechanic/tooltest/tree/main/skills/bd-to-br-migration
Command: npx skills add https://github.com/lambdamechanic/tooltest --skill bd-to-br-migration-lambdamechanic

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a repeatable path to migrate documentation from the bd (beads) workflow to the br (beads_rust) workflow, ensuring consistent references, command mappings, and IDs.

Core Features & Use Cases

  • Deterministic section and command transforms that convert bd references to br equivalents.
  • Built-in verification and discovery scripts to identify remaining bd references and validate br patterns.
  • Guidelines for single-file migrations and batch migrations with clear reporting and rollback guidance.

Quick Start

To migrate a single AGENTS.md file, run the migration tool with the file path and then run the verification script to confirm completion.

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 markdown documentation from beads to beads_rust?

Migrating markdown documentation from beads to beads_rust involves running a migration tool on target files to apply deterministic section, command, and ID transforms, followed by executing verification scripts to confirm completion.

Can I batch migrate multiple markdown files from bd to br workflows?

Yes, you can batch migrate multiple markdown files from bd to br workflows using the skill's batch migration mode, which provides clear reporting and rollback guidance for project-wide consistency across all updated references and IDs.

What documentation references are updated during a bd to br migration?

A bd to br migration updates exact section and header transformations, command mappings, sync behavior, and ID/link updates, converting all beads references to their beads_rust equivalents.

How do I verify remaining bd references after migrating to beads_rust?

To verify remaining bd references after migrating to beads_rust, run the built-in discovery and verification scripts which identify leftover bd patterns and validate that br references are correctly applied across the project.

Does the bd-to-br migration require any external dependencies?

The bd-to-br migration does not require external dependencies, relying solely on the skill's SKILL.md presence and its internal scripts for executing deterministic transforms and verification utilities.

What is the best way to handle rollback for a beads to beads_rust migration?

The best way to handle rollback for a beads to beads_rust migration is to follow the batch migration guidelines, which provide clear reporting and rollback guidance to safely revert deterministic transforms if verification fails.