Files
gravl/backend/agents/README.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

1.5 KiB

Gravl Agents

AI-agenter för Gravl-projektet.

Översikt

agents/
├── coach/          # 🏋️ Träningscoach
│   ├── SOUL.md
│   ├── exercises.json
│   └── programs/
│       ├── beginner.json
│       ├── strength.json
│       └── hypertrophy.json
│
├── architect/      # 🏗️ Systemarkitekt
│   └── SOUL.md
│
├── frontend-dev/   # ⚛️ React/Frontend
│   └── SOUL.md
│
├── backend-dev/    # 🖥️ Node.js/API
│   └── SOUL.md
│
└── reviewer/       # 🔍 Code Review
    └── SOUL.md

Användning

Via OpenClaw

# Spawn coach för träningsfrågor
sessions_spawn --agentId="coach" --task="Skapa 4-dagars hypertrofiprogram för intermediate"

# Spawn för kod-tasks
sessions_spawn --agentId="backend-dev" --task="Lägg till endpoint för att radera mätning"

Som kontext

Läs relevant SOUL.md för att "bli" den agenten:

Läs /workspace/gravl/agents/coach/SOUL.md och agera som Coach.
Användaren vill ha ett styrkeprogram för 3 dagar/vecka.

Agent-specifika resurser

Coach

  • exercises.json - 20+ övningar med alternativ, cues, vanliga misstag
  • programs/ - Färdiga programmallar för olika mål

Dev-agenter

  • Gravl-specifika konventioner
  • Stack: React + Vite, Node + Express, PostgreSQL, Docker

Lägga till ny agent

  1. Skapa mapp: agents/<namn>/
  2. Skapa SOUL.md med persona och riktlinjer
  3. Lägg till resursfiler om relevant
  4. Uppdatera denna README