decompose

Break project briefs into parallelizable Track task files and decomposition plans.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Hugopeck/track --skill decompose-hugopeck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decompose
Source: https://github.com/Hugopeck/track/tree/main/skills/decompose
Command: npx skills add https://github.com/Hugopeck/track --skill decompose-hugopeck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts a project brief into concrete, parallelizable work units so AI agents can execute a repo change without wasting time on overlapping or sequentially blocked tasks. It is designed for Track projects that need automatic decomposition, stale-task cleanup, and plan regeneration as the brief evolves.

Core Features & Use Cases

  • Project Brief Parsing: Reads the brief as the source of truth and identifies the target project automatically.
  • Codebase Exploration: Scans the repository to find module boundaries, data dependencies, and safe file-scope splits.
  • Task Lifecycle Management: Preserves active or completed work, cancels stale todo items, creates new task files, and saves a decomposition plan.
  • Validation and Regeneration: Runs Track validation and regenerates todo views so the task graph stays consistent.
  • Use Case: Use this Skill when a product brief needs to be broken into agent-ready tasks for a multi-module codebase, especially when tasks must be parallel-safe and overlap-free.

Quick Start

Ask the track decompose skill to read the project brief, analyze the repository, and create the task breakdown and plan automatically.

Frequently Asked Questions about decompose

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

FAQPage Schema
How do I break a project brief into parallel tasks for AI agents?

To break a project brief into parallel tasks, the Skill parses the brief, scans the codebase for module boundaries and data dependencies, and generates parallelizable Track task files along with a saved decomposition plan. This ensures AI agents can execute repository changes without overlapping or sequentially blocked work.

How does task decomposition handle multi-module repositories with overlapping file scopes?

Task decomposition handles multi-module repositories by exploring the codebase to map safe file-scope splits and dependency chains. It identifies boundaries that prevent overlapping work, ensuring generated tasks remain parallel-safe across modules even when file scopes intersect.

Can I regenerate a task breakdown plan after a project brief changes?

Yes, you can regenerate a task breakdown after a brief changes. The Skill performs re-decomposition by preserving active or completed work, canceling stale todo items, running Track validation, and offline regenerating Track views to keep the task graph consistent with the updated brief.

What is the best way to clean up stale todo items when re-decomposing a codebase?

The best way to clean up stale todo items during re-decomposition is through automated task lifecycle management. The Skill preserves active or completed work, cancels outdated stale tasks automatically, creates new task files, and saves the updated decomposition plan.

Does parallel task generation work with existing codebases or only new projects?

Parallel task generation works with existing codebases that need fresh decomposition or re-decomposition. The Skill requires codebase exploration to find module boundaries, data dependencies, and safe file-scope splits, making it suitable for evolving multi-module repositories rather than just new projects.

When do I need to use automated project decomposition for agent workflows?

You need automated project decomposition when a product brief must be broken into agent-ready tasks for a multi-module codebase, especially when tasks must be parallel-safe and overlap-free. It is required when briefs evolve and stale tasks need cleanup to maintain a consistent task graph.