validate-beads

Validate bead definitions against the original spec for self-containment and dependencies.

1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Dunc4nJ/entropy-plugins --skill validate-beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-beads
Source: https://github.com/Dunc4nJ/entropy-plugins/tree/main/bead-pipeline/skills/validate-beads
Command: npx skills add https://github.com/Dunc4nJ/entropy-plugins --skill validate-beads

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Validates bead definitions against the original spec to ensure they are self-contained, aligned with requirements, and free of orphan work, while automatically fixing issues and creating missing beads after a decomposition plan.

Core Features & Use Cases

  • Self-containment checks for every bead, ensuring clear Task and Acceptance Criteria.
  • Spec coverage validation to map requirements to beads and create gaps beads when needed.
  • Orphan and dependency validation to ensure proper scope and acyclic dependencies.

Quick Start

Run the validation workflow after completing a decomposition plan to verify quality before implementation begins.

Frequently Asked Questions about validate-beads

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

FAQPage Schema
How do I validate bead definitions against a project spec?

You can validate bead definitions by running a quality gate check that ensures self-containment, complete spec coverage, and correct dependencies. The process maps requirements to beads and automatically creates missing gaps beads when needed.

How do I check for orphan work in a decomposition plan?

To check for orphan work, run a validation workflow after completing your decomposition plan. It performs orphan and dependency validation to ensure proper scope and acyclic dependencies across all generated beads.

What is the best way to ensure self-containment in bead definitions?

Self-containment checks validate that every bead definition includes a clear Task and Acceptance Criteria. Running the validation workflow after decompose-plan verifies this quality before implementation begins.

Can I automatically fix missing beads after generating a decomposition plan?

Yes, the validation process automatically fixes issues and creates missing beads as needed. It enforces required sections, cross-bead mappings, and dependency integrity using the beads toolkit and updates the decomposition log.

Does dependency validation enforce acyclic dependencies in bead workflows?

Dependency validation ensures proper scope and acyclic dependencies across beads. It verifies dependency integrity during planning and execution workflows to prevent circular references and orphan work.

When should I run spec coverage validation in a planning workflow?

Run spec coverage validation immediately after completing a decomposition plan and before implementation begins. This verifies bead quality, maps requirements to beads, and creates gaps beads for any missing coverage.