spec:beads
Beads Task Tracker
Dependency-aware task management integrated with spec workflows. Tasks are stored in .beads/beads.jsonl and persist across sessions via git.
Overview
Beads enforces implementation order through dependency tracking:
- Dependency-driven execution -
bd readysurfaces only unblocked tasks - Bottom-up enforcement - Dependencies ensure Entity → Repository → Service → Router
- Git-backed persistence -
.beads/beads.jsonltracks all tasks and status - Spec integration - Commands like
/spec:planauto-create epics with ordered tasks
Core Workflow Commands
| Command | Purpose | Example |
|---|---|---|
bd init |
Initialize Beads in project | bd init |
bd create <name> |
Create task or epic | bd create "Implement UserEntity" -t task -p 2 -l entity,user |
bd ready |
Find next unblocked task | bd ready --label user --json |
More from martinffx/atelier
typescript:drizzle-orm
Type-safe SQL with Drizzle ORM in TypeScript. Use when defining database schemas, writing queries, setting up relations, running migrations, or working with PostgreSQL/MySQL/SQLite/Cloudflare D1/Durable Objects data layers.
14typescript-drizzle-orm
Type-safe SQL with Drizzle ORM in TypeScript. Use when defining database schemas, writing queries, setting up relations, running migrations, or working with PostgreSQL/MySQL/SQLite/Cloudflare D1/Durable Objects data layers.
13typescript-fastify
Building REST APIs with Fastify in TypeScript. Use when creating routes, handling requests, implementing validation with TypeBox, structuring applications, or working with HTTP handlers and plugins.
12spec-research
>
10oracle:thinkdeep
Extended reasoning analysis using sequential thinking. Use for deep exploration, comprehensive analysis, complex decisions, or when you need fresh perspectives on difficult problems.
10code:review
Multi-agent code review with parallel specialized reviewers, architecture validation, and challenge validation. Use `rq` to request a review of diffs (defaults to main branch), `rs` to respond to PR feedback. Triggers on "review this", "review my code", "code review", "check for bugs", "audit this", when examining PRs, pull requests, branches, or diffs. Supports line-by-line PR comments via gfreview with severity prefixes (Blocker/Issue/Suggestion/Nit). Always asks user before applying fixes or posting responses.
10