Why does this skill output a markdown file instead of creating tasks directly?

It generates a BEADS.md file to allow for human review and architectural validation of the implementation plan before the tasks are batch-created in a tracking system.

How are unresolved architectural choices handled?

The skill creates DECISION beads which act as gates; these beads explicitly block dependent implementation tasks until the specific decision is documented and resolved.

Is the output compatible with task management tools?

The output is specifically formatted for the bd CLI tool for batch creation, but follows standard Markdown conventions suitable for any structured documentation system.

What is a 'bead' in this workflow?

A bead is the smallest possible unit of work that has a single responsibility, is self-contained, and can be completed in a focused session of 30 minutes or less.

Does it support parallel development?

Yes, it includes parallelism metadata for every task, identifying which beads are 'parallel-safe' and which must be executed in a strict sequence.

Technical Design to Implementation Beads

Name: Technical Design to Implementation Beads
Author: quantfiction

byquantfiction

0•

生产力与工作流

Transforms technical design documents into atomic, trackable implementation tasks optimized for autonomous coding agents.

This skill streamlines the transition from high-level architecture to execution by converting Technical Design Documents (TDDs) into standardized BEADS.md files. It breaks down complex features into 'beads'—the smallest possible units of work that are self-contained, testable, and completable in under 30 minutes. By utilizing visual dependency mapping with Mermaid diagrams, automated shell scripts for task creation, and strict decision-gating to prevent implementation stalls, it ensures that both human developers and AI agents have clear, unambiguous paths to completion.

主要功能

01Strict implementation metadata including parallelism and confidence levels

02Visual dependency mapping via Mermaid JS integration

03Automated shell script generation for bd CLI batch creation

040 GitHub stars

05Atomic task decomposition for 30-minute work units

06Decision-gate beads to block work on unresolved choices

使用场景

01Standardizing team task definitions to ensure high-quality, testable outputs

02Converting a monolithic architecture document into a trackable sprint backlog

03Preparing a complex feature branch for autonomous agent execution

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add quantfiction/dotfiles write-beads

For use in Claude.ai and ChatGPT