docs: add Mermaid architecture diagrams

2026-08-26 10:00:50 +02:00
parent c1290c782c
commit 23bc2f6555
9 changed files with 130 additions and 0 deletions
@@ -6,6 +6,23 @@ Il principio architetturale è **human-in-the-middle**: il modello propone inter

 La procedura è definita nella skill canonica [tht-sessione](../harness/.pi/skills/tht-sessione/SKILL.md), soprattutto nelle sezioni F1 e F2, ed è applicata dai widget in [tht-gate.js](../harness/.pi/extensions/tht-gate.js).

+```mermaid
+stateDiagram-v2
+    [*] --> DETECT
+    state "Detect ambiguity" as DETECT
+    state "Build reviewer options" as PROPOSE
+    state "Ask with reviewer_select" as ASK
+    state "Multiple valid answers" as MULTI
+    state "Record accepted decision" as ACCEPTED
+    DETECT --> PROPOSE: ambiguity found
+    DETECT --> ASK: safe default unavailable
+    PROPOSE --> ASK
+    ASK --> ACCEPTED: one option selected
+    ASK --> MULTI: multiple answers valid
+    MULTI --> ACCEPTED
+    ACCEPTED --> [*]
+```
+
 ## Dove avviene la disambiguazione

 La disambiguazione iniziale attraversa quattro passaggi distinti: