sdd-tasks

Generate TDD task breakdowns with estimates and acceptance criteria from design specs.

48|4|Updated Sep 8, 2025
One-click install
npx skills add https://github.com/yi-john-huang/sdd-mcp --skill sdd-tasks-yi-john-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-tasks
Source: https://github.com/yi-john-huang/sdd-mcp/tree/main/.claude/skills/sdd-tasks
Command: npx skills add https://github.com/yi-john-huang/sdd-mcp --skill sdd-tasks-yi-john-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Breaks down approved designs into actionable, test-first tasks so teams can plan, estimate, and implement features consistently.

Core Features & Use Cases

  • Automated task breakdown: Converts a design into a hierarchical set of tasks aligned with tests.
  • TDD-aligned workflow: Guides Red-Green-Refactor cycles for each task and arranges tests accordingly.
  • Design-to-implementation mapping: References design specs located in .spec/specs/{feature}/design.md to determine scope and dependencies.
  • Usage scenario: When a feature name is provided, the skill outputs a ready-to-paste Tasks document with groups, estimates, and acceptance criteria.

Quick Start

Invoke the sdd-tasks workflow with a feature name (for example "user-auth") to generate a complete TDD task breakdown.

Frequently Asked Questions about sdd-tasks

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

FAQPage Schema
How do I break down a software design into TDD tasks?

TDD task breakdown converts approved design specs into a hierarchical set of implementable tasks. It produces a structured Tasks document with task groups, estimates, dependencies, and acceptance criteria to guide test-first development.

How do I generate a task breakdown from a design.md file?

To generate a task breakdown from a design.md file, invoke the workflow with a feature name. It references design specs located in .spec/specs/{feature}/design.md to determine scope and produces a structured Task.md with hierarchical groups and dependencies.

What is the best way to plan test-first implementation for a feature?

The best way to plan test-first implementation is using an automated TDD task breakdown. This approach arranges hierarchical tasks according to Red-Green-Refactor cycles, ensuring each task has corresponding tests and clear acceptance criteria.

Do I need an approved design before generating TDD task breakdowns?

Yes, you need an approved design before generating TDD task breakdowns. The workflow specifically breaks down approved designs located in .spec/specs/{feature}/design.md into actionable, test-first tasks for consistent implementation planning.

Can I estimate dependencies and scope using task breakdown for SDD workflows?

Yes, task breakdown for SDD workflows provides estimates and dependencies. The generated Task.md includes hierarchical task groups, time estimates, and dependencies mapped directly from the approved design specifications for accurate implementation planning.