tbd Workflow

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

75|7|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/jlevy/tbd --skill tbd-workflow
Or copy as Structured Prompt for Agent
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.

Related Skills