fsd:do-task

Plan or execute cross-project tasks using projects.yaml and task-detail files.

7|3|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/tbeack/fsad_playbook --skill fsd-do-task
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fsd:do-task
Source: https://github.com/tbeack/fsad_playbook/tree/main/skills/do-task
Command: npx skills add https://github.com/tbeack/fsad_playbook --skill fsd-do-task

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plans or executes tasks for any registered project by auto-detecting the active project from the working directory, reading conventions from ~/.claude/commands/fsd/projects.yaml, and guiding a two-phase workflow (plan mode vs execute mode) with explicit task-detail requirements.

Core Features & Use Cases

  • Auto-detects the current project from the working directory and the projects.yaml configuration
  • Plan mode when a task-detail file is missing; Execute mode when a task-detail file exists
  • Ensures a task-detail file is created before executing, and updates CHANGELOG and task status accordingly
  • Supports multi-task prompts by referring to task IDs and dispatching per-ID flows
  • Strictly operates within a registered project’s repository context

Quick Start

Run fsd:do-task CBP-087 to start planning or executing the specified task in the active project.

Frequently Asked Questions about fsd:do-task

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

FAQPage Schema
How do I plan and execute tasks across multiple projects automatically?▼

Task planning and execution across multiple projects is handled by auto-detecting your active project from the working directory and consulting your projects.yaml configuration. It operates in plan mode to create task-detail files, then switches to execute mode.

How do I start planning a specific task in my current project?▼

To start planning a task, run the command with your task ID. If no task-detail file exists for that ID, the system enters plan mode to define the work before any execution begins.

Can I execute multiple tasks in a single prompt using task IDs?▼

Yes, you can execute multiple tasks by including multiple task IDs in your prompt. The system dispatches separate per-ID workflows to resolve and orchestrate each task independently.

Does this task management workflow require a specific configuration file?▼

Yes, the workflow requires a projects.yaml configuration file located in your Claude commands directory. It reads project conventions from this file and strictly operates within registered project repositories.

What happens after a cross-project task is executed successfully?▼

After task execution, the system updates the task status and automatically updates the project's CHANGELOG. It also manages worktree usage and optional version updates as part of the multi-step workflow.

Why does task execution require a task-detail file to be created first?▼

Task execution requires a task-detail file to ensure a concrete plan is defined before any changes are made. This two-phase workflow prevents undefined work by enforcing plan creation before entering execute mode.