task-planning

Structured task planning workflow with user feedback loops. Use when the user explicitly requests planning (e.g., "make a plan", "plan first", "create a plan"). Covers creating plans with actionable steps, iterating based on feedback, saving confirmed plans, and executing step-by-step with progress tracking.

⭐116stars🔀8forks📁View on GitHub🕐Updated Jan 6, 2026⬇️1downloads

When & Why to Use This Skill

The Task Planning skill provides a structured framework for managing complex objectives through iterative feedback loops and step-by-step execution. It enables Claude to draft actionable plans, save them as persistent markdown files for progress tracking, and refine tasks based on real-time user input, ensuring high alignment and transparency throughout the project lifecycle.

Use Cases

  • Software Development: Breaking down complex coding tasks into manageable steps, such as implementing a new API endpoint or refactoring a legacy module, with clear progress tracking and file-based documentation.
  • Content Strategy: Creating and executing a multi-stage content plan, from initial research and outlining to drafting and final editing, while maintaining a persistent record of completed milestones.
  • Operational Workflows: Designing and following standard operating procedures for repetitive business tasks, ensuring every step is validated by the user before execution to minimize errors.
nametask-planning
descriptionStructured task planning workflow with user feedback loops. Use when the user explicitly requests planning (e.g., "make a plan", "plan first", "create a plan"). Covers creating plans with actionable steps, iterating based on feedback, saving confirmed plans, and executing step-by-step with progress tracking.

Task Planning

Structured workflow for planning and executing tasks when explicitly requested by the user.

Planning Phase

1. Create Initial Plan

Draft a plan with clear, actionable steps using markdown checklist format:

- [ ] Step 1: Description
- [ ] Step 2: Description
- [ ] Step 3: Description

2. Request Feedback

Present the plan to the user and ask for feedback. Do not proceed until feedback is received.

3. Iterate Until Confirmed

Revise the plan based on user feedback. Continue the proposal-feedback loop until the user confirms.

4. Save Confirmed Plan

Write the confirmed plan to .freeact/plans/<task-name>.md where:

  • <task-name> is a descriptive kebab-case name
  • Example: .freeact/plans/add-user-authentication.md
  • The .freeact/plans/ directory already exists

Execution Phase

5. Execute Step-by-Step

Work through the plan sequentially:

  • First unchecked item is the current task
  • After completing each step, mark with checkmark: - [x] Step description
  • Update the plan file to reflect progress

6. Revise as Needed

If execution reveals the need for plan adjustments:

  • Update the plan file with revised steps
  • Inform the user of significant changes

7. Request Feedback During Execution

If encountering uncertainty or needing user input during execution, ask for feedback before proceeding.

Plan File Format

# <Task Title>

## Steps

- [x] Completed step
- [ ] Pending step
- [ ] Another pending step

## Notes

Optional section for context, decisions made, or issues encountered.