Task Planning Skill

Explores requirements via brainstorming, then creates structured task folder for implementation.

REQUIRED SUB-SKILL: Use superpowers:brainstorming FIRST to explore requirements before creating files.

When to Use

• •Starting a feature that spans multiple files
• •Work that needs design before implementation
• •Complex changes requiring step-by-step planning

Workflow

1. Run Brainstorming

MANDATORY: Invoke superpowers:brainstorming skill first to:

• •Clarify user intent and requirements
• •Explore technical approaches
• •Identify edge cases and constraints
• •Get user approval on design direction

Only proceed to step 2 after brainstorming is complete.

2. Determine Next Folder Number

CRITICAL: Use the Glob tool (not ls) to find existing task folders in BOTH locations:

# Check BOTH locations (completed tasks move to _done/)
Glob pattern: _tasks/[0-9][0-9]-*
Glob pattern: _tasks/_done/[0-9][0-9]-*

Find the highest {NN} across BOTH folders and increment by 1 (e.g., if _done/44-multi-currency-receipts is highest, use 45).

WARNING: Do NOT use ls _tasks/ or Glob _tasks/* — these may miss subdirectories or return incomplete results.

3. Create Folder and Task File

Create folder and write _tasks/{NN}-{feature-name}/01-task.md with brainstorming output:

**Date:** YYYY-MM-DD
**Subject:** {Feature description from brainstorming}
**Status:** Planning

## Goal

{Goal refined during brainstorming}

## Requirements

{Requirements gathered during brainstorming}

## Technical Notes

{Constraints and considerations from brainstorming}

4. Create Plan File

Use superpowers:writing-plans to create detailed implementation plan, then write to _tasks/{NN}-{feature-name}/02-plan.md:

# {Feature Name} Implementation Plan

> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

**Goal:** {One-line summary}

**Architecture:** {High-level approach}

---

## Task 1: {Description}

**Files:**
- Modify: `path/to/file`
- Create: `path/to/new/file`

**Steps:**
1. {Step details}
2. {Step details}

**Verification:** {How to verify this task is complete}

---

## Task 2: ...

5. Commit Planning Docs

git add _tasks/{NN}-{feature-name}/
git commit -m "docs: add task and plan for {feature-name}"

File Naming Convention

Files are numbered sequentially — no two files share the same number:

Common patterns:

• •Task only: 01-task.md
• •Task + plan: 01-task.md, 02-plan.md
• •Task + design + plan: 01-task.md, 02-design.md, 03-plan.md

Notes

• •Always commit planning docs BEFORE starting implementation
• •Reference tech debt if task originates from _TECH_DEBT/
• •Keep plans actionable with specific file paths and verification steps