Files
SuperClaude/.claude/commands/task.md
NomenAK 7413eb631c Enhanced Task Management System - Adaptation of PR #5 (#7)
* Add comprehensive task management system with hybrid todo integration

- Automatic task detection based on complexity scoring (8+ points)
- Seamless .tasks/ folder structure (pending/in-progress/completed)
- Two-tier architecture: Tasks for persistence, TodoWrite for focus
- Auto-conversion of task breakdowns to TodoWrite steps
- Session recovery with context preservation
- Git integration with automatic branching
- Zero-interruption workflow for complex requirements

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Enhance task management system with SuperClaude integration

- Update all .tasks/ paths to ./claudedocs/tasks/ for consistency
- Add plan mode integration for intelligent task suggestions
- Implement UltraCompressed format (~70% token reduction)
- Enhance git workflow with clean branch strategy and atomic commits
- Add task-ultracompressed.yml configuration
- Update install.sh to reflect new file counts
- Integrate with exit_plan_mode for complex work detection

This adapts PR #5's excellent task tracking functionality to fit
SuperClaude's architecture while adding valuable enhancements.

---------

Co-authored-by: Mohammad Aziz <mdaziz067@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-06-24 11:29:02 +02:00

2.6 KiB

/task: - Task Management & Session Recovery

@task-management.yml

Purpose

Manage complex features & requirements across sessions with automatic breakdown, context preservation & recovery.

Syntax

/task:create <title> [--type feature|bugfix|refactor|docs|test] [--priority high|medium|low]
/task:list [--status pending|in-progress|completed] [--priority high|medium|low]
/task:start <id>
/task:pause <id>
/task:complete <id>
/task:resume <id>
/task:cancel <id>
/task:show <id>
/task:update <id> --status <status> --priority <priority>

Workflow

Creation:
  1. Analyze requirement complexity
  2. Generate unique task ID (YYYYMMDD-HHMMSS)
  3. Break down into phases & steps
  4. Create task file from template
  5. Create git branch
  6. Move to pending folder

Execution:
  1. Move to in-progress folder
  2. Create git checkpoint
  3. Execute steps sequentially
  4. Update progress & context
  5. Handle session breaks gracefully

Completion:
  1. Verify all steps completed
  2. Run final tests
  3. Create completion checkpoint
  4. Move to completed folder
  5. Merge git branch

Auto-Detection

Triggers:
  - "build feature X"
  - "implement functionality Y"
  - "add component Z"
  - Requirements >3 files
  - Complex multi-step work

Response:
  "This looks like a multi-step task. Should I create a task breakdown?"
  Options: [Yes - create task] [No - proceed directly]

Session Recovery

Startup:
  1. Scan .tasks/in-progress/
  2. Identify active tasks
  3. Restore context from task files
  4. Suggest resumption steps

Context:
  - Key architectural decisions
  - Current implementation state
  - Known blockers & solutions
  - File modification history

Examples

# Create new feature task
/task:create "User authentication system" --type feature --priority high

# List all pending tasks
/task:list --status pending

# Start working on a task
/task:start 20250623-143052

# Pause current work (auto-saves context)
/task:pause 20250623-143052

# Resume after session break
/task:resume 20250623-143052

# Mark task complete
/task:complete 20250623-143052

Integration

  • Git: Automatic branching & checkpoints
  • TodoWrite: Sync with current todo system
  • Personas: Task-specific persona activation
  • MCP: Context preservation across tools
  • Commands: Chain with other /user: commands

File Structure

./claudedocs/tasks/
├── pending/feature-20250623-143052-user-auth.md
├── in-progress/bugfix-20250623-144022-login-error.md
├── completed/refactor-20250623-142033-api-cleanup.md
└── templates/feature-template.md