sync-feature-branch

Commit Git feature-branch work while updating Beads issue metadata and trailers.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/stars-end/affordabot --skill sync-feature-branch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-feature-branch
Source: https://github.com/stars-end/affordabot/tree/main/.claude/skills/sync-feature-branch
Command: npx skills add https://github.com/stars-end/affordabot --skill sync-feature-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually committing work, ensuring proper metadata tracking, and handling discovered issues during development can be error-prone and time-consuming.

Core Features & Use Cases

  • Automated Beads Tracking: Commits current work to your feature branch, automatically updating Beads issue status and including Feature-Key trailers for seamless project management.
  • Smart Discovery Handling: Analyzes code diffs to detect and proactively create child Beads issues for bugs or new tasks, linking them to your current work.
  • Auto Phase Transitions: Intelligently checks for phase completion and automatically transitions to the next ready task in an epic workflow, keeping your project moving forward.
  • Use Case: Instead of manually running git add, git commit, and bd update, simply say "commit my work" to save progress and keep your Beads issues in sync.

Quick Start

To commit your current changes and update your Beads issue, simply say: "commit my work"

Frequently Asked Questions about sync-feature-branch

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

FAQPage Schema
How do I automate committing work and updating issue metadata in a git workflow?

Automated git commits with Beads metadata tracking let you save progress and sync issue status in one step. Instead of running separate `git add`, `git commit`, and `bd update` commands, use the Skill to commit your current changes and automatically update your Beads issues with Feature-Key trailers.

Can I automatically detect and create issues for bugs discovered during development?

Smart discovery handling analyzes your code diffs to detect bugs and new tasks, then proactively creates child Beads issues linked to your current work. This surfaces discovered problems as trackable tasks without manual issue creation.

What's the best way to keep feature branch work synchronized with issue tracking?

Feature branch synchronization with Beads tracking ensures every commit updates your issue status and includes proper metadata. The Skill manages this integration by linking commits to issues, auto-transitioning phases, and maintaining traceability across your development workflow.

How do I move to the next task automatically when a phase completes?

Auto phase transitions check for phase completion and automatically advance to the next ready task in your epic workflow. This keeps your project moving forward without manual status updates or task switching.

Does this work with discovery-driven development where new tasks emerge during commits?

Yes. The Skill handles discovery-driven tasks by detecting changes via git diff, auto-creating related Beads issues, and linking them to your feature branch work. It supports workflows where bugs and new requirements surface during development.