tbd Workflow

Automate task tracking, spec-driven planning, and knowledge injection for AI coding agents.

75|7|Updated Jan 8, 2026

Ready to run

npx skills add https://github.com/jlevy/tbd --skill tbd-workflow

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tbd Workflow
Source: https://github.com/jlevy/tbd/tree/main/packages/tbd/docs/shortcuts/system
Command: npx skills add https://github.com/jlevy/tbd --skill tbd-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

tbd Workflow helps teams and AI agents manage multi-step software projects by centralizing task tracking, spec-driven planning, and knowledge injection into a single, repeatable workflow.

Core Features & Use Cases

Beads: Git-native task tracking to persist work across sessions.
Spec-Driven Workflows: Plan features, break into beads, and implement systematically.
Shortcuts: Reusable instruction templates for common tasks and handoffs.

Quick Start

Install the tbd CLI globally with npm install -g get-tbd@latest, initialize a project with tbd setup --auto, then run tbd prime to bootstrap context. After that, tell the agent to start with tbd ready or tbd shortcut welcome-user to begin.

Frequently Asked Questions about tbd Workflow

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

FAQPage Schema

How do I manage multi-session AI coding agents and persist context across handoffs?▼

Multi-session agent coordination persists context using git-native beads for task tracking and spec-driven workflows. This centralizes planning and knowledge injection, ensuring AI coding agents maintain state across session handoffs.

What is spec-driven planning for software projects and how does it break down features?▼

Spec-driven planning decomposes software features into systematic implementation steps. It uses beads to track individual tasks within a broader specification, allowing AI agents to implement complex project requirements methodically.

Do I need the tbd CLI installed to orchestrate agent workflows with beads and specs?▼

Yes, orchestrating agent workflows requires the tbd CLI installed globally via npm. You must initialize projects using setup commands and bootstrap agent context before starting workflow orchestration.

How do I bootstrap context and start an AI agent workflow after installing the CLI?▼

After installing the CLI, initialize your project with the auto setup command, run the prime command to bootstrap context, then instruct the agent to start with ready or a welcome shortcut to begin orchestration.

Can I use reusable instruction templates for common AI agent tasks and handoffs?▼

Yes, reusable instruction templates called shortcuts automate common tasks and handoffs. They provide standardized instruction sets that AI agents execute repeatedly across different workflow stages.

When should I use git-native task tracking for AI coding agents?▼

Git-native task tracking suits software projects requiring multi-session coordination and planning. Use it when persisting work across sessions and managing handoffs between AI agents and human developers.