beads

Record plan, progress, decisions, and verification in a per-step ledger.

66|2|Updated Feb 18, 2015
One-click install
npx skills add https://github.com/tkersey/dotfiles --skill beads-tkersey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/tkersey/dotfiles/tree/main/codex/skills/beads
Command: npx skills add https://github.com/tkersey/dotfiles --skill beads-tkersey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads provides a durable, auditable ledger for plan, progress, decisions, and verification by using a per-step workflow. The active bead becomes the canonical place to record context and outcomes, ensuring that session state survives resets and that work is traceable over time.

Core Features & Use Cases

  • Durable per-step ledger: Record plan, progress, decisions, and verification as individual beads.
  • Workflow lifecycle: Use beads lifecycle concepts (prime, ready, update, close) to manage work slices.
  • Molecules and steps: Model work with Proto/Mol/Wisp concepts to capture templates, instantiations, and ephemeral experiments.
  • Audit trail: Maintain per-step notes and a ChangeLog to support reproducibility and accountability.

Quick Start

Initialize the beads workflow in your project, prime the context, and create your first bead with an initial plan and verification.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I create an auditable ledger for development project management?

To create an auditable ledger for development project management, use a per-step workflow that captures plan, progress, decisions, and verification. This enforces per-step notes and ChangeLog templates, ensuring work is traceable and session state survives resets.

What is the best way to track per-step decisions and progress in software engineering?

Tracking per-step decisions and progress in software engineering is best handled by a durable ledger that models work slices with a lifecycle loop. By using prime, ready, update, and close phases, you maintain an auditable trail of context and outcomes.

How do I record reproducible work slices and ephemeral experiments?

To record reproducible work slices and ephemeral experiments, use a workflow that models templates, instantiations, and experiments as distinct concepts. This captures plan and verification data, ensuring accountability and reproducibility over time.

Does a per-step workflow require specific dependencies to maintain an audit trail?

A per-step workflow for maintaining an audit trail requires no external dependencies. It activates when a specific directory exists or when you run a dedicated workflow command to organize work into a durable, auditable ledger.

When do I need a durable ledger for project management and session state?

You need a durable ledger for project management when session state must survive resets and work requires traceability over time. It provides a canonical place to record context and outcomes, enforcing per-step notes for accountability.

How to initialize a per-step workflow to organize development tasks?

To initialize a per-step workflow to organize development tasks, create the required directory or run the workflow command. This primes the context, allowing you to create your first bead with an initial plan and verification step.