Does this skill support Test-Driven Development (TDD)?

Yes, the import flow includes a default TDD-ready structure that generates test-beads before implementation beads, though this can be disabled using the --skip-tdd flag.

How does the 'specgap' command help my workflow?

Specgap scans your git history and codebase for recent commits, TODOs, or new files that haven't been associated with an official task or specification yet, helping you capture 'stealth' work.

Can I sync changes from the implementation back to the specification?

Yes, the update command supports a bidirectional flow using the --direction=beads-to-spec flag, allowing you to update documentation based on completed tasks.

What is the primary purpose of the BD Sync skill?

BD Sync is designed to ensure that technical specifications (OpenSpec) and implementation tasks (Beads) stay perfectly aligned, preventing documentation rot and untracked work.

Beads & OpenSpec Synchronization

Name: Beads & OpenSpec Synchronization
Author: tmsjngx0

bytmsjngx0

0•

Productivity & Workflow

Synchronizes OpenSpec design changes with implementation beads to maintain project alignment and track execution progress.

BD Sync is a specialized coordination tool for Claude Code designed to bridge the gap between design specifications and technical execution. By automating the synchronization between OpenSpec changes and 'beads' epics, it ensures that your project's implementation always reflects the latest design decisions. The skill provides a suite of subcommands to audit synchronization health, import new proposals into implementation-ready task structures, and scan for untracked technical debt or commits, keeping your documentation and codebase in perfect harmony.

Key Features

01Intelligent importing with support for TDD-ready task generation or lightweight tracking

020 GitHub stars

03Bidirectional updates to maintain consistency between tasks.md files and project management state

04Automated synchronization between OpenSpec proposals and beads implementation epics

05Specgap scanning to detect untracked commits or TODOs and convert them into managed tasks

06Comprehensive audit reporting to identify drift, orphaned tasks, and missing specifications

Use Cases

01Auditing a large project to find 'orphaned' code or implementation work that lacks a corresponding specification

02Converting a complex design proposal into a structured, implementation-ready epic with decomposed tasks

03Keeping documentation-based task lists (tasks.md) perfectly synced with live project management beads

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tmsjngx0/mindcontext-core bd-sync

For use in Claude.ai and ChatGPT