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.