beads-guard

Official

Soft Beads guardrails to prevent conflicts.

Authorstars-end
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Beads Guard provides warning-only guidance to avoid recurring .beads/issues.jsonl conflicts and accidental master commits. It helps ensure you are on a feature branch, up to date with origin/master, and that Beads files are staged with proper Feature-Key commits.

Core Features & Use Cases

  • Warning-only checks before bd sync/close/create to prevent conflicts
  • Guides on branch alignment, up-to-date status, and proper staging
  • One-click manual workflow steps for the safest Beads operations

Quick Start

On a Beads-enabled repo, run the guard steps to preflight your Beads work, then proceed with your normal Beads workflow:

  1. Ensure you are on a feature branch: git status -sb
  2. Rebase to the latest master: git fetch origin master && git rebase origin/master
  3. Pull latest Beads DB: bd pull
  4. Stage Beads files before commit: git add .beads/issues.jsonl

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: beads-guard
Download link: https://github.com/stars-end/agent-skills/archive/main.zip#beads-guard

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository