Files
gravl/.claude/commands/hooks/pre-task.md
T
clawd d81e403f01 Phase 06 Tier 1: Complete Backend Implementation - Recovery Tracking & Swap System
COMPLETED TASKS:
 06-01: Workout Swap System
   - Added swapped_from_id to workout_logs
   - Created workout_swaps table for history
   - POST /api/workouts/:id/swap endpoint
   - GET /api/workouts/available endpoint
   - Reversible swaps with audit trail

 06-02: Muscle Group Recovery Tracking
   - Created muscle_group_recovery table
   - Implemented calculateRecoveryScore() function
   - GET /api/recovery/muscle-groups endpoint
   - GET /api/recovery/most-recovered endpoint
   - Auto-tracking on workout log completion

 06-03: Smart Workout Recommendations
   - GET /api/recommendations/smart-workout endpoint
   - 7-day workout analysis algorithm
   - Recovery-based filtering (>30% threshold)
   - Top 3 recommendations with context
   - Context-aware reasoning messages

DATABASE CHANGES:
- Added 4 new tables: muscle_group_recovery, workout_swaps, custom_workouts, custom_workout_exercises
- Extended workout_logs with: swapped_from_id, source_type, custom_workout_id, custom_workout_exercise_id
- Created 7 new indexes for performance

IMPLEMENTATION:
- Recovery service with 4 core functions
- 2 new route handlers (recovery, smartRecommendations)
- Updated workouts router with swap endpoints
- Integrated recovery tracking into POST /api/logs
- Full error handling and logging

TESTING:
- Test file created: /backend/test/phase-06-tests.js
- Ready for E2E and staging validation

STATUS: Ready for frontend integration and production review
Branch: feature/06-phase-06
2026-03-06 20:54:03 +01:00

2.1 KiB

hook pre-task

Execute pre-task preparations and context loading.

Usage

npx claude-flow hook pre-task [options]

Options

  • --description, -d <text> - Task description for context
  • --auto-spawn-agents - Automatically spawn required agents (default: true)
  • --load-memory - Load relevant memory from previous sessions
  • --optimize-topology - Select optimal swarm topology
  • --estimate-complexity - Analyze task complexity

Examples

Basic pre-task hook

npx claude-flow hook pre-task --description "Implement user authentication"

With memory loading

npx claude-flow hook pre-task -d "Continue API development" --load-memory

Manual agent control

npx claude-flow hook pre-task -d "Debug issue #123" --auto-spawn-agents false

Full optimization

npx claude-flow hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity

Features

Auto Agent Assignment

  • Analyzes task requirements
  • Determines needed agent types
  • Spawns agents automatically
  • Configures agent parameters

Memory Loading

  • Retrieves relevant past decisions
  • Loads previous task contexts
  • Restores agent configurations
  • Maintains continuity

Topology Optimization

  • Analyzes task structure
  • Selects best swarm topology
  • Configures communication patterns
  • Optimizes for performance

Complexity Estimation

  • Evaluates task difficulty
  • Estimates time requirements
  • Suggests agent count
  • Identifies dependencies

Integration

This hook is automatically called by Claude Code when:

  • Starting a new task
  • Resuming work after a break
  • Switching between projects
  • Beginning complex operations

Manual usage in agents:

# In agent coordination
npx claude-flow hook pre-task --description "Your task here"

Output

Returns JSON with:

{
  "continue": true,
  "topology": "hierarchical",
  "agentsSpawned": 5,
  "complexity": "medium",
  "estimatedMinutes": 30,
  "memoryLoaded": true
}

See Also

  • hook post-task - Post-task cleanup
  • agent spawn - Manual agent creation
  • memory usage - Memory management
  • swarm init - Swarm initialization