docs: focus public documentation on product usage

This commit is contained in:
2026-08-26 10:15:07 +02:00
parent 23bc2f6555
commit a54d4769dd
67 changed files with 290 additions and 9963 deletions
+2 -9
View File
@@ -35,11 +35,6 @@ F8: il reviewer decide se promuoverla
L'invariante principale è `REUSABLE_TYPES = {"concept_clarified"}`: le sole memory generabili, salvabili, ricercabili e proponibili sono i concetti chiariti. Le decisioni `table_promoted`, `table_excluded`, `column_promoted` e analoghe restano decisioni locali alla domanda.
Implementazione principale: la façade [harness/tht/memory/](../harness/tht/memory/),
con le policy riusabili in
[harness/tht/memory/core.py](../harness/tht/memory/core.py), e l'adapter
[harness/tht/cli/memory_cmd.py](../harness/tht/cli/memory_cmd.py).
## I tre livelli della gestione
| Livello | Contenuto | Funzione |
@@ -54,8 +49,8 @@ Il ledger contiene la provenienza e le decisioni umane. Il record globale contie
Durante F1 il workflow registra i chiarimenti come decisioni `concept_clarified`. Un chiarimento può esprimere:
- definizioni di concetti clinici o organizzativi;
- criteri di inclusione ed esclusione di una popolazione;
- definizioni di concetti produttivi o organizzativi;
- criteri di inclusione ed esclusione di una linea di prodotto;
- formule e metodi di calcolo;
- interpretazioni temporali;
- mapping verso tabelle e colonne specifiche;
@@ -167,8 +162,6 @@ Il comando:
6. esclude le memory già decise nella sessione corrente;
7. restituisce i risultati ordinati per similarità.
L'implementazione è in [harness/tht/cli/memory_cmd.py](../harness/tht/cli/memory_cmd.py:368).
Le memory non vengono mai applicate automaticamente. Il modello deve presentarle in un'unica scelta `reviewer_decide`:
- una memory selezionata viene registrata come nuovo `concept_clarified` nella sessione corrente;