Back to Superclaude Framework

Task Management Mode

src/superclaude/modes/MODE_Task_Management.md

4.3.03.5 KB
Original Source

Task Management Mode

Purpose: Hierarchical task organization with persistent memory for complex multi-step operations

Activation Triggers

  • Operations with >3 steps requiring coordination
  • Multiple file/directory scope (>2 directories OR >3 files)
  • Complex dependencies requiring phases
  • Manual flags: --task-manage, --delegate
  • Quality improvement requests: polish, refine, enhance

Task Hierarchy with Memory

šŸ“‹ Plan → write_memory("plan", goal_statement) → šŸŽÆ Phase → write_memory("phase_X", milestone) → šŸ“¦ Task → write_memory("task_X.Y", deliverable) → āœ“ Todo → TodoWrite + write_memory("todo_X.Y.Z", status)

Memory Operations

Session Start

1. list_memories() → Show existing task state
2. read_memory("current_plan") → Resume context
3. think_about_collected_information() → Understand where we left off

During Execution

1. write_memory("task_2.1", "completed: auth middleware")
2. think_about_task_adherence() → Verify on track
3. Update TodoWrite status in parallel
4. write_memory("checkpoint", current_state) every 30min

Session End

1. think_about_whether_you_are_done() → Assess completion
2. write_memory("session_summary", outcomes)
3. delete_memory() for completed temporary items

Execution Pattern

  1. Load: list_memories() → read_memory() → Resume state
  2. Plan: Create hierarchy → write_memory() for each level
  3. Track: TodoWrite + memory updates in parallel
  4. Execute: Update memories as tasks complete
  5. Checkpoint: Periodic write_memory() for state preservation
  6. Complete: Final memory update with outcomes

Tool Selection

Task TypePrimary ToolMemory Key
AnalysisSequential MCP"analysis_results"
ImplementationMultiEdit/Morphllm"code_changes"
UI ComponentsMagic MCP"ui_components"
TestingPlaywright MCP"test_results"
DocumentationContext7 MCP"doc_patterns"

Memory Schema

plan_[timestamp]: Overall goal statement
phase_[1-5]: Major milestone descriptions
task_[phase].[number]: Specific deliverable status
todo_[task].[number]: Atomic action completion
checkpoint_[timestamp]: Current state snapshot
blockers: Active impediments requiring attention
decisions: Key architectural/design choices made

Examples

Session 1: Start Authentication Task

list_memories() → Empty
write_memory("plan_auth", "Implement JWT authentication system")
write_memory("phase_1", "Analysis - security requirements review")
write_memory("task_1.1", "pending: Review existing auth patterns")
TodoWrite: Create 5 specific todos
Execute task 1.1 → write_memory("task_1.1", "completed: Found 3 patterns")

Session 2: Resume After Interruption

list_memories() → Shows plan_auth, phase_1, task_1.1
read_memory("plan_auth") → "Implement JWT authentication system"
think_about_collected_information() → "Analysis complete, start implementation"
think_about_task_adherence() → "On track, moving to phase 2"
write_memory("phase_2", "Implementation - middleware and endpoints")
Continue with implementation tasks...

Session 3: Completion Check

think_about_whether_you_are_done() → "Testing phase remains incomplete"
Complete remaining testing tasks
write_memory("outcome_auth", "Successfully implemented with 95% test coverage")
delete_memory("checkpoint_*") → Clean temporary states
write_memory("session_summary", "Auth system complete and validated")