beads-schema

Define bead fields, state transitions, and recovery semantics for execution workflows.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cmtkdot/arc --skill beads-schema-cmtkdot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-schema
Source: https://github.com/cmtkdot/arc/tree/main/skills/beads-schema
Command: npx skills add https://github.com/cmtkdot/arc --skill beads-schema-cmtkdot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The beads-schema solves the challenge of designing, validating, and tracking the lifecycle of beads in an execution workflow by defining a consistent structure for bead objectives, touchpoints, dependencies, verification, and traceability.

Core Features & Use Cases

  • Defines required fields for every bead, including Objective, Files and Touch Points, Dependency Links, Verification Commands, and Traceability.
  • Specifies the State Model and recovery semantics to ensure robust progression, handling of blocked states, and recovery from crashes or stalls.
  • Supports Gates, Bead Types (Standard, Formula, Molecules, Wisps) and Coordination Primitives (bd lock, bd pin, bd slot) to enable flexible, safe orchestration.
  • Use Case: Design a complex task as a chain of beads with explicit dependencies and verification steps to guarantee end-to-end quality.

Quick Start

Define a new bead by completing its Objective, Touch Points, and Dependencies using the beads-schema.

Frequently Asked Questions about beads-schema

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

FAQPage Schema
What is bead workflow execution and when do I need it for task decomposition?

Bead workflow execution decomposes tasks into discrete units with explicit dependencies and verification steps. You need it when coordinating complex execution chains that require deterministic progression, state tracking, and end-to-end traceability to guarantee quality.

How do I define a bead with dependencies and verification commands?

To define a bead, complete its required fields: Objective, Files and Touch Points, Dependency Links, Verification Commands, and Traceability. This structure establishes deterministic execution by binding each bead to explicit dependencies and validation steps.

How does bead state model recovery handle blocked states and crashes?

The bead state model recovery semantics handle blocked states and crashes by enforcing robust progression rules. It specifies state transitions and recovery primitives like bd lock, bd pin, and bd slot to safely resume or roll back stalled workflows.

What bead types are available for workflow orchestration?

Available bead types include Standard, Formula, Molecules, and Wisps. These types combine with gate beads and coordination primitives to enable flexible, safe orchestration across complex task chains with varying execution requirements.

Can I use bead schema for complex task chains with end-to-end traceability?

Yes, bead schema supports designing complex tasks as chains of beads with explicit dependencies and verification steps. It enforces traceability through Spec ID and dependency links, guaranteeing end-to-end quality across the entire workflow lifecycle.

What are the limitations of bead schema for workflow validation?

Bead schema requires all required fields—Objective, Touch Points, Dependencies, Verification Commands, Traceability, and Spec ID—to be explicitly defined. Workflows lacking these fields cannot enforce deterministic execution, state recovery, or coordination primitives.