feat: complete evidence restructuring worktree
This commit is contained in:
+48
-50
@@ -1,82 +1,80 @@
|
||||
# Workflow operativo di ThothII
|
||||
# ThothII operating workflow
|
||||
|
||||
ThothII guida ogni domanda attraverso otto fasi. Il modello propone i passaggi, il revisore
|
||||
decide nei gate e il sistema registra artefatti e decisioni persistenti.
|
||||
ThothII guides every question through eight phases. The model proposes the work, the reviewer
|
||||
makes decisions at gates, and the system records persistent artifacts and decisions.
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
Q["Domanda"] --> F1["F1 Chiarimento"]
|
||||
Q["Question"] --> F1["F1 Clarification"]
|
||||
F1 --> F2["F2 Memory"]
|
||||
F2 --> F3["F3 Riscrittura"]
|
||||
F2 --> F3["F3 Rewriting"]
|
||||
F3 --> F4["F4 Evidence"]
|
||||
F4 --> F5["F5 Schema"]
|
||||
F5 --> F6["F6 Piano CTE"]
|
||||
F5 --> F6["F6 CTE plan"]
|
||||
F6 --> F7["F7 SQL"]
|
||||
F7 --> F8["F8 Promozione"]
|
||||
F8 --> DONE["Sessione finalizzata"]
|
||||
F7 --> F8["F8 Promotion"]
|
||||
F8 --> DONE["Finalized session"]
|
||||
```
|
||||
|
||||
## Principi del workflow
|
||||
## Workflow principles
|
||||
|
||||
- Il modello propone; il revisore approva, corregge o rifiuta.
|
||||
- Ogni decisione rilevante viene registrata nel ledger della sessione.
|
||||
- Lo stato persistito è la fonte di verità.
|
||||
- Una fase può avanzare soltanto quando i suoi artefatti e gate sono completi.
|
||||
- La ripresa ricostruisce il contesto dagli artefatti persistiti, non dalla conversazione.
|
||||
- The model proposes; the reviewer approves, corrects, or rejects.
|
||||
- The session ledger records every material decision.
|
||||
- Persisted state is the source of truth.
|
||||
- A phase advances only when its artifacts and gates are complete.
|
||||
- Resume rebuilds context from persisted artifacts, not from the conversation.
|
||||
|
||||
## F1 — Chiarimento
|
||||
## F1: clarification
|
||||
|
||||
Il sistema identifica l'ambiguità con maggiore impatto sul significato della domanda e presenta
|
||||
una sola decisione per volta. Interpretazioni mutuamente esclusive usano una scelta singola;
|
||||
risposte contemporaneamente valide usano una scelta multipla.
|
||||
The system identifies the ambiguity most likely to change the meaning of the question and presents
|
||||
one decision at a time. Mutually exclusive interpretations use a single choice; multiple valid
|
||||
answers use a multiple choice.
|
||||
|
||||
## F2 — Memory
|
||||
## F2: Memory
|
||||
|
||||
Le Memory compatibili con la domanda vengono proposte al revisore. Quelle selezionate entrano
|
||||
nel contesto della sessione corrente; quelle non selezionate restano disponibili per domande
|
||||
future.
|
||||
The system proposes Memory items that fit the question. Selected items enter the current session
|
||||
context; unselected items remain available for future questions.
|
||||
|
||||
## F3 — Riscrittura
|
||||
## F3: rewriting
|
||||
|
||||
La domanda viene riscritta in forma esplicita usando i chiarimenti approvati. Il revisore verifica
|
||||
la domanda risultante e le assunzioni prima di proseguire.
|
||||
The system rewrites the question explicitly using the approved clarifications. The reviewer checks
|
||||
the resulting question and its assumptions before continuing.
|
||||
|
||||
## F4 — Evidence
|
||||
## F4: Evidence
|
||||
|
||||
Il sistema recupera Evidence dal corpus attivo e presenta citazioni e provenienza. Il revisore
|
||||
decide quali elementi sono pertinenti alla domanda.
|
||||
The system retrieves Evidence from the active corpus and presents citations and provenance. The
|
||||
reviewer decides which items apply to the question.
|
||||
|
||||
## F5 — Schema
|
||||
## F5: schema
|
||||
|
||||
Tabelle, colonne, relazioni e filtri vengono collegati al significato approvato della domanda.
|
||||
Il riepilogo chiude la fase quando domanda, assunzioni ed elementi del DWH sono coerenti.
|
||||
Tables, columns, relationships, and filters are linked to the approved meaning of the question.
|
||||
The summary closes the phase when the question, assumptions, and DWH elements are consistent.
|
||||
|
||||
## F6 — Piano CTE
|
||||
## F6: CTE plan
|
||||
|
||||
La query viene scomposta in CTE nominati con scopo, dipendenze, tabelle, filtri e colonne di
|
||||
output. Ogni passaggio viene presentato al revisore prima della produzione dell'SQL finale.
|
||||
The query is broken into named CTEs with a purpose, dependencies, tables, filters, and output
|
||||
columns. The reviewer sees each step before the system produces the final SQL.
|
||||
|
||||
## F7 — SQL finale
|
||||
## F7: final SQL
|
||||
|
||||
Il sistema produce `sql_final.sql`, ne controlla la coerenza con il piano approvato e presenta
|
||||
l'artefatto al revisore. Una correzione può riaprire il piano CTE senza perdere le decisioni
|
||||
ancora valide.
|
||||
The system produces `sql_final.sql`, checks it against the approved plan, and presents the artifact
|
||||
to the reviewer. A correction can reopen the CTE plan without discarding decisions that remain valid.
|
||||
|
||||
## F8 — Promozione delle Memory
|
||||
## F8: Memory promotion
|
||||
|
||||
Alla fine della sessione il sistema propone i chiarimenti riutilizzabili. Il revisore decide
|
||||
quali promuovere nel registro globale; la sessione viene quindi finalizzata.
|
||||
At the end of the session, the system proposes reusable clarifications. The reviewer decides which
|
||||
ones to promote to the global registry, and the session is then finalized.
|
||||
|
||||
## Gate disponibili
|
||||
## Available gates
|
||||
|
||||
| Gate | Uso |
|
||||
| Gate | Use |
|
||||
| --- | --- |
|
||||
| Scelta singola | Una sola interpretazione può essere valida |
|
||||
| Scelta multipla | Più elementi possono essere validi contemporaneamente |
|
||||
| Conferma artefatto | Approvazione di un documento o risultato della fase |
|
||||
| Conferma fase | Chiusura esplicita di una fase |
|
||||
| Single choice | Only one interpretation can be valid |
|
||||
| Multiple choice | Several items can be valid at the same time |
|
||||
| Artifact confirmation | Approval of a document or phase result |
|
||||
| Phase confirmation | Explicitly closes a phase |
|
||||
|
||||
## Ripresa e riapertura
|
||||
## Resume and reopening
|
||||
|
||||
Una sessione ripresa rientra nell'ultima fase incompleta. Una riapertura invalida soltanto le
|
||||
decisioni e gli artefatti che dipendono dal punto modificato; il resto del lavoro rimane valido.
|
||||
A resumed session returns to its last incomplete phase. Reopening invalidates only the decisions
|
||||
and artifacts that depend on the changed point; the rest of the work remains valid.
|
||||
|
||||
Reference in New Issue
Block a user