write-code-beads

Decompose Implementation Briefs into atomic beads for structured code development.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Dektora/dekspec-public --skill write-code-beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-code-beads
Source: https://github.com/Dektora/dekspec-public/tree/main/plugins/dekspec/skills/write-code-beads
Command: npx skills add https://github.com/Dektora/dekspec-public --skill write-code-beads

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires br, Claude Code, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of converting Implementation Briefs (IBs) into beads, which are atomic work units that can be used to develop code efficiently.

Core Features & Use Cases

  • Convert IBs to Beads: Automatically decompose IBs into self-contained beads for focused development tasks.
  • Fidelity Audit: Re-audit existing beads against their corresponding IBs to ensure consistency and accuracy.
  • Rebuild Beads: Delete all open beads for an IB and re-create them from scratch, useful after significant changes to the IB.
  • Use Case: After an IB is finalized and approved, use this Skill to generate beads that can be used by developers to work on specific parts of the codebase.

Quick Start

Use the /write-code-beads skill with the path to your Implementation Brief, e.g., /write-code-beads dekspec/impl-briefs/IB-014-graph-injection-brief.md.

Frequently Asked Questions about write-code-beads

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

FAQPage Schema
How do I decompose an Implementation Brief into atomic code development tasks?

Decomposing an Implementation Brief into atomic code development tasks is done by converting it into beads, which are self-contained work units for focused development. This Skill automates that decomposition using YAML manifest processing and file synchronization.

What are beads in a code development workflow?

Beads in a code development workflow are atomic, self-contained work units derived from an Implementation Brief. They allow developers to focus on specific parts of a codebase by breaking down structured specifications into actionable coding tasks.

Do I need a br tracker and Claude Code to convert Implementation Briefs?

Yes, converting Implementation Briefs requires both a br tracker and Claude Code. The Skill operates within a repository utilizing a br tracker for execution and relies on Claude Code models to process YAML manifests and audit rules.

How do I rebuild beads after making significant changes to an Implementation Brief?

Rebuilding beads after significant changes to an Implementation Brief involves deleting all open beads for that brief and re-creating them from scratch. This ensures the new beads accurately reflect the updated specifications.

Can I audit existing beads against an Implementation Brief for consistency?

Auditing existing beads against an Implementation Brief for consistency is supported through a fidelity audit. This re-audits the beads to ensure they remain accurate and consistent with their corresponding Implementation Brief specifications.