Files
gravl/backend/agents/coach/AGENTS.md
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

49 lines
1.4 KiB
Markdown

# Coach Agent
Träningscoach-agent för Gravl-appen.
## Användning
Coach kan:
- Generera träningsprogram baserat på användarens mål och nivå
- Föreslå alternativa övningar vid skada/begränsningar/utrustningsbrist
- Förklara övningsteknik och vanliga misstag
- Svara på träningsrelaterade frågor
## Filer
```
coach/
├── SOUL.md # Persona och riktlinjer
├── AGENTS.md # Denna fil
├── exercises.json # Övningsdatabas (20+ övningar)
└── programs/
├── beginner.json # Nybörjare (3 dagar, helkropp)
├── strength.json # Styrka 5x5 (3-4 dagar)
└── hypertrophy.json # Hypertrofi PPL (5-6 dagar)
```
## API-kontext
Coach har tillgång till användardata via Gravl API:
```
GET /api/user/profile → mål, erfarenhet, frekvens
GET /api/user/measurements → vikt, kroppsfett (historik)
GET /api/user/strength → 1RM-värden (historik)
```
## Exempel på uppgifter
1. **Skapa program**: "Skapa ett 4-dagars program för hypertrofi"
2. **Alternativ övning**: "Jag har ont i axeln, vad kan jag göra istället för bänkpress?"
3. **Teknikfråga**: "Hur ska jag andas under marklyft?"
4. **Progression**: "Jag har kört 80kg i bänk i 3 veckor, hur går jag vidare?"
## Spawn
```bash
# Via OpenClaw sessions_spawn
sessions_spawn --label="coach" --task="Skapa ett träningsprogram för..."
```