Where is the task data stored?

All tasks and statuses are stored in a .beads/beads.jsonl file within your project, allowing them to be versioned and shared via Git.

Can I use Beads without the spec commands?

Yes, Beads provides a full CLI (bd) for manual task creation, updates, and dependency management independent of the automated spec workflows.

What is the difference between an Epic and a Task in Beads?

An Epic serves as a high-level container for a specific feature or change, while Tasks represent the individual units of implementation work.

How does Beads handle task dependencies?

Beads uses a 'blocks' relationship to ensure tasks are completed in a logical order, such as building a database entity before the repository that uses it.

How do I find the next piece of work to do?

Use the 'bd ready' command to instantly surface tasks that are currently unblocked and ready for implementation.

Atelier Spec Beads

Name: Atelier Spec Beads
Author: martinffx

bymartinffx

•

Productivity & Workflow

Manages dependency-aware software development tasks through a Git-backed CLI integrated with spec-driven workflows.

Atelier Spec Beads is a specialized task tracking system designed for Claude Code that enforces logical implementation order through dependency management. By tracking tasks in a local JSONL file, it allows Claude to identify unblocked work, visualize implementation trees, and maintain state across sessions. It is specifically optimized for spec-driven development, automatically generating task epics from technical designs and ensuring that foundational components like entities and repositories are completed before high-level services or routers are attempted.

Key Features

01Seamless integration with spec-driven development commands

02Detailed progress reporting and dependency tree visualization

03Git-backed persistence using a flat .beads/beads.jsonl file

04Automated Epic and task generation from technical specifications

056 GitHub stars

06Dependency-aware task tracking with 'ready' status surfacing

Use Cases

01Structuring complex feature implementations with strict layer-by-layer dependencies

02Managing long-running coding sessions where task state must persist in Git

03Automating implementation plans from spec documents into actionable code tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add martinffx/claude-code-atelier atelier-spec-beads

For use in Claude.ai and ChatGPT

Download Skill