# Prompt Decomposition

> Structured planning and task decomposition for complex, multi-step work. Use this skill whenever the user needs to break a large task into smaller parts, create an implementation plan, organize a migration, or structure a refactoring. Activates for: planning complex features, migrating architectures, refactoring codebases, organizing multi-service work, or any request that involves multiple phases of coordinated implementation. Also handles resuming or suspending previously saved plans. Without this skill, complex requests are executed monolithically instead of being decomposed into atomic, parallelizable sub-tasks with dependency tracking.

- Skill: `fgiova/prompt-decomposition` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fgiova/prompt-decomposition`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fgiova/prompt-decomposition/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: fgiova (https://skillmd.com/u/fgiova)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fgiova/prompt-decomposition

---


# Prompt Decomposition

Skill orchestrate structured task decomposition. Delegate planning workflow to `@planner-agent`.

## When This Skill Activates

Activate when user want:
- Plan complex feature, migration, refactoring
- Break big task into atomic, parallelizable sub-tasks
- Make structured execution plan with phases + dependencies
- Resume or review existing plan from past session
- Suspend plan in progress for later

## Execution

On activate, **immediately delegate to `@planner-agent`** via Agent tool. Agent run full planning workflow autonomous:

1. **Resume Check** — Look for existing `.plans/*/plan.md` files to resume
2. **Analyze** — Understand scope, read referenced files
3. **Decompose** — Break into atomic tasks with dependency mapping
4. **Organize** — Group into parallel phases, avoid file conflicts
5. **Persist** — Save plan to `.plans/` before presenting
6. **Iterate** — Review with user, apply modifications
7. **Execute** — Run tasks via sub-agents when approved

### How to Delegate

Use Agent tool with `@planner-agent`. Pass user request as prompt. Include context user gave:

- User named project/goal → include
- User referenced files/codebase areas → mention
- User want resume plan → pass along

**Example delegation prompt:**
> "The user wants to plan [topic]. They mentioned [any context]. Follow the full planning workflow."

### What NOT to Do

- No run planning workflow yourself — agent do
- No ask prelim questions before delegate — agent handle interaction
- No post-process agent output — agent manage plan lifecycle direct with user