# Istruzioni per gli agent (Copilot Chat & simili)

Questo repository è **condiviso tra due agent**:

- **Agent A — Fusion/Blender side**: lavora su `ExportKinematicGraph.py` (add-in Autodesk Fusion 360) e `build_glb_from_fusion_export.py` (script Blender). Genera `plotter.glb` + `joints.json`.
- **Agent B — Three.js viewer side**: consuma `plotter.glb` in un viewer web (React + Three.js) tramite `FusionRig.js`. Vive in **un altro workspace/repo**.

## Regole d'oro

1. **Prima di toccare l'export o il viewer, leggi [FUSION_GLB_CONTRACT.md](FUSION_GLB_CONTRACT.md).** È la fonte di verità su schema JSON, convenzioni `userData`, unità di misura, ecc. Se serve cambiare qualcosa, modifica **prima** il contratto e commit-a in un branch dedicato.
2. **Annotare i problemi aperti in [BRIDGE_NOTES.md](BRIDGE_NOTES.md)**, sezione "Risposte ai problemi aperti". Marcare `[OPEN]` o `[RESOLVED YYYY-MM-DD]`.
3. **Non rinominare i 5 driver** (`Motore A`, `Motore asse X`, `Motore asse Y`, `Asse Penna ` con spazio finale, `asse Z pneumatico M5?`) senza un commit coordinato anche sul viewer. Vedi §4 del contratto.
4. **Mai** committare:
   - file binari di output (`*.glb`, `*.obj`, `hierarchy.json`, `joints.json` rigenerabili) — già esclusi via `.gitignore`
   - credenziali, token, chiavi SSH
5. **Branch convention**: `feature/<nome-breve>` per modifiche, mai push diretto su `main`. Aprire PR/MR su Gitea.
6. **Commit message**: prima riga ≤ 72 char, prefisso area:
   - `fusion: ...` per modifiche ad `ExportKinematicGraph.py`
   - `blender: ...` per `build_glb_from_fusion_export.py`
   - `contract: ...` per il `.md` di contratto
   - `bridge: ...` per le note operative
7. **Operazioni distruttive**: niente `git push --force`, niente `git reset --hard` su branch condivisi. Mai.

## Come l'altro agent legge questo contratto

L'agent Three.js può scaricare il contratto direttamente dalla raw URL Gitea:

```
https://git.automationdev.info/automationkriz/syncro_multi_agente/raw/branch/main/FUSION_GLB_CONTRACT.md
```

In alternativa, può clonare il repo e aggiungerlo come folder al workspace VS Code per averlo sempre in contesto.

## Stack tecnico (riepilogo)

- **Fusion 360 API**: Python 3.10 (integrato in Fusion). Add-in installato in `%APPDATA%\Autodesk\Autodesk Fusion 360\API\Scripts\ExportKinematicGraph\`.
- **Blender 4.2 LTS**: Python 3.11. Script eseguito in modalità `--background`.
- **Output**: `plotter.glb` (binario glTF 2.0) in `C:\Users\croce\OneDrive\Desktop\export\`.

## Comandi tipici

Vedi sezione "Comandi operativi" di [BRIDGE_NOTES.md](BRIDGE_NOTES.md).