task-decomposition

Convert OAK implementation plans into structured tasks.md files.

62|6|Updated Sep 12, 2024
One-click install
npx skills add https://github.com/sirkirby/unifi-network-rules --skill task-decomposition-sirkirby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-decomposition
Source: https://github.com/sirkirby/unifi-network-rules/tree/main/.claude/skills/task-decomposition
Command: npx skills add https://github.com/sirkirby/unifi-network-rules --skill task-decomposition-sirkirby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The task-decomposition skill translates high-level OAK plans into a structured, executable set of tasks that guide implementation and tracking.

Core Features & Use Cases

  • Plan to task mapping: converts goals and research into a task hierarchy (Epic/Story/Task/Subtask) suitable for /oak.plan-tasks.
  • Sprint-ready planning: produces a coherent tasks.md file that supports sprint planning and issue export to GitHub Issues or Azure DevOps.
  • Standardized structure: enforces a consistent oak/plan/<name>/ layout with plan.md, research, and tasks.md to streamline collaboration.

Quick Start

Create a plan under oak/plan/<name>/ with plan.md and optional research/, then run /oak.plan-tasks to generate tasks.md and align your work for export.

Frequently Asked Questions about task-decomposition

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

FAQPage Schema
How do I break down an implementation plan into actionable tasks for GitHub Issues?

Task decomposition converts high-level OAK plans into a structured task hierarchy of Epics, Stories, and Subtasks. The generated tasks.md file organizes work into a standardized structure suitable for sprint planning and direct export to GitHub Issues.

What is the required file structure for generating a tasks.md file?

The required file structure enforces a consistent oak/plan/<name>/ directory layout containing plan.md, optional research, and the generated tasks.md. This standardization streamlines collaboration and ensures plans are discovered via required frontmatter containing name and description.

Can I use task decomposition for sprint planning in Azure DevOps?

Yes, task decomposition supports sprint planning by producing a coherent tasks.md file that structures implementation phases. This structured work output aligns directly for issue export to Azure DevOps, ensuring sprint-ready mapping from plan goals to actionable tasks.

Do I need to create a plan.md before generating tasks?

Yes, you must create a plan under the oak/plan/<name>/ directory with a plan.md file and optional research folder. Running the plan-tasks command then processes these inputs to generate the tasks.md file and align your work for export.

What's the best way to structure work hierarchies from high-level goals?

Task decomposition maps high-level goals and research into a structured task hierarchy containing Epics, Stories, Tasks, and Subtasks. This approach translates abstract implementation plans into executable sets that guide both implementation tracking and issue export.