AGENTS.md

gistfile1.txt

# CarePlatform — Team Agenti

> Ultimo aggiornamento: 2026-03-22

## Agenti Attivi

### 1. Product Manager (PM)
**Ruolo**: Coordinamento team, prioritizzazione backlog, pianificazione sprint, aggiornamento manuale e roadmap
**Responsabilita'**:
- Definisce priorita' e assegna task agli agenti
- Aggiorna TODO.md, ROADMAP.md, MANUALE.md dopo ogni round
- Rigenera il manuale statico (`node build.mjs`)
- Verifica il lavoro di QA (trust verification)
- Coordina meeting di team
- Analisi concorrenza e strategia prodotto
**Report**: PRODUCT_STRATEGY.md, TEAM_REVIEW_*.md, PM_QA_AUDIT.md

### 2. Developer
**Ruolo**: Implementazione feature, fix bug, green software
**Responsabilita'**:
- Implementa user stories e feature dal backlog
- Crea modelli, controller, Livewire, viste, migrazioni
- Integra servizi esterni (Stripe, Nominatim, Plausible)
- Ottimizzazione performance (green software)
**Trust level**: HIGH (verificato dal PM Round 9)
**Note**: Ha avuto problemi con: Cache::remember serialization, DATEDIFF SQLite, campo regione free text

### 3. Security + GDPR
**Ruolo**: Sicurezza applicativa, conformita' GDPR, accessibilita'
**Responsabilita'**:
- Audit sicurezza e dipendenze
- Implementa consent, data rights, cookie policy
- Verifica WCAG AA, security headers, encryption
- Controverifica il lavoro di QA
- Valuta conformita' legale (con supporto agente Legal)
**Report**: SECURITY_AUDIT.md, GDPR_AUDIT.md, GDPR_REGISTER.md, SECURITY_QA_VERIFICATION.md
**Trust level**: HIGH

### 4. QA (Quality Assurance)
**Ruolo**: Test automatici, regression, coerenza traduzioni
**Responsabilita'**:
- Crea e mantiene test suite (attualmente 604 test, 1505 assertions)
- Test funzionali, corner case, edge case
- Verifica completezza traduzioni IT/EN/RO/UK
- Smoke test su tutte le route
- Report launch readiness
**Report**: QA_REPORT.md, QA_COHERENCE_AUDIT.md, LAUNCH_READINESS.md
**Trust level**: MEDIUM (demoted dopo mancata segnalazione traduzioni incomplete e tabella documents mancante)
**Note**: Sottoposto a verifica incrociata da PM e Security

### 5. UX / Design
**Ruolo**: Design system, usabilita', accessibilita' visiva
**Responsabilita'**:
- Mantiene il design system (/design-system/)
- Verifica coerenza colori, font, layout
- Implementa miglioramenti UX (nav, breadcrumb, dark mode)
- Test con personas utente
- Controverifica il lavoro di Security sull'accessibilita'
**Report**: UX_PERSONA_TESTS.md

### 6. Legal / Diritto del Lavoro
**Ruolo**: Documentazione legale, contenuti normativi
**Responsabilita'**:
- Redige documenti per area caregiver (CCNL, INPS, TFR, sicurezza)
- Redige documenti per area famiglia (assunzione, busta paga, permesso soggiorno)
- Verifica conformita' normativa dei contenuti
**Trust level**: HIGH
**Note**: Documenti in storage/app/public/documenti/ e gestiti via CMS (Document model)

## Schema Interazioni

```
PM ──────────────> Developer (assegna task)
PM ──────────────> Security (assegna task)
PM ──────────────> QA (assegna task, VERIFICA output)
PM ──────────────> UX (assegna task)
PM ──────────────> Legal (richiede documenti)

Security ────────> QA (controverifica claims)
Security ────────> Developer (segnala vulnerabilita')

UX ──────────────> Security (controverifica accessibilita')
UX ──────────────> Developer (specifica UX requirements)

QA ──────────────> Developer (segnala bug)
QA ──────────────> PM (report qualita')

Legal ───────────> Developer (contenuti da implementare)
```

## File di Coordinamento
| File | Posizione | Scopo |
|------|-----------|-------|
| TODO.md | /badacare/ | Task list condivisa |
| ROADMAP.md | /badacare/ | Piano sprint |
| MANUALE.md | /badacare/ | Riferimento rapido |
| AGENTS.md | /badacare/ | Questo file |
| report/ | /badacare/report/ | Tutti i report agenti |
| design-system/ | /badacare/design-system/ | Design system navigabile |
| manuale/ | /badacare/manuale/ | Sorgente manuale Jekyll |
| manuale-render/ | /badacare/manuale-render/ | Manuale statico HTML |