flywheel-beads

Convert a Markdown plan into executable beads with dependencies and tests for br-driven workflows.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/quangdang46/flywheel-skills --skill flywheel-beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flywheel-beads
Source: https://github.com/quangdang46/flywheel-skills/tree/main/flywheel-beads
Command: npx skills add https://github.com/quangdang46/flywheel-skills --skill flywheel-beads

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert a markdown plan into polished beads that are executable by agents. Beads carry context, rationale, and test obligations, enabling reliable execution without constantly parsing the original plan.

Core Features & Use Cases

  • Bead generation from plan markdown for deterministic task execution.
  • Bead polishing, deduplication, and cross-referencing against a plan to ensure traceability.
  • Bead quality validation, dependency graph establishment, and testing scaffolding to support reliable implementations.

Quick Start

Provide a markdown plan and run the bead-generation workflow to generate self-contained beads ready for execution.

Frequently Asked Questions about flywheel-beads

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

FAQPage Schema
How do I convert a markdown plan into executable tasks for automated agents?

To convert a markdown plan into executable tasks, you generate self-contained beads carrying context, rationale, and test obligations. This allows reliable execution by an automated swarm without parsing the original plan.

What are beads in a deterministic workflow and how do they work?

Beads in a deterministic workflow are structured artifacts containing dependencies, priorities, labels, and testing expectations. They enable reliable task execution by carrying necessary context and validation rules independently.

How do I ensure task traceability when generating execution plans from markdown?

To ensure task traceability when generating execution plans, use bead polishing, deduplication, and cross-referencing against the original markdown. This validates that every generated bead accurately reflects the plan.

Can I establish dependency graphs and testing scaffolding from a markdown plan?

Yes, you can establish dependency graphs and testing scaffolding from a markdown plan. The workflow performs bead quality validation and generates br-compatible artifacts to support reliable implementations.

Do I need any dependencies to run the bead-generation workflow?

No dependencies are required to run the bead-generation workflow. You simply provide a markdown plan to generate polished, self-contained beads ready for deterministic execution.