Questa cartella ospita la documentazione di secondo livello: un file HTML per ogni componente architetturale. Viene popolata progressivamente. Regola di vita: un componente non viene implementato prima che il suo HTML esista e sia approvato.
neurone
→ executor, sinapsi → mnest,
proteoma → mnestoma. L'intera microprogettazione
va riletta e riscritta prima di essere usata come riferimento per
l'implementazione. I file restano qui come tracciabilità del percorso.
executor.html
(sostituisce neuron.html, approvato il 24/4/2026),
mnest.html (sostituisce synapse.html,
under approval), mnestoma.html
(nuovo, under approval). Il 25/4/2026 si sono aggiunti
synt.html (sostituisce synthesizer.html)
e telos.html v1.1 (riscrittura), portando i
canonici a cinque. Tutti bilingui (IT · EN) e tutti approvati
dopo simulazione end-to-end del caso «fatture in mail» (25/4/2026).
Gli altri componenti seguiranno nell'ordine indicato sotto.
| Componente | Cosa copre | Lingue | Stato |
|---|---|---|---|
executor.html |
Anatomia di una capacità eseguibile: manifest, firma Ed25519, profilo di sandbox (con esempio operativo «chiamato male»), lifecycle, sintesi (cascata in §7.1), executor remoti. Sostituisce neuron.html. |
IT · EN | approvato 24/4 |
mnest.html |
La traccia di co-attivazione fra due executor: anatomia, lifecycle, decadimento, persistenza, proto-mnest. Sostituisce synapse.html. |
IT · EN | approvato 25/4 |
mnestoma.html |
Il grafo emergente di tutti i mnest: schema dati SQLite, operazioni atomiche, ager, snapshot. Concetto nuovo (in EN: mnestome). | IT · EN | approvato 25/4 |
synt.html |
Come nasce e matura il pool: cascata reattiva (comporre, generare) e introvertiva (fondere, generalizzare, specializzare). Telos di non-rinuncia, punteggio R esteso. Sostituisce synthesizer.html. |
IT · EN | approvato 25/4 |
telos.html |
Fini ultimi dell'utente, funzione di allineamento, bother budget con quote di scheduler, telos di non-rinuncia (t.coltivazione_strumenti) e clausola di stop. Riscrittura di telos v1.0. |
IT · EN | approvato 25/4 |
A valle di Prospettive & Giudizio v1, l'ordine di scrittura dei doc di microprogettazione è cambiato: tre doc trasversali vanno prima dei quattro classici, perché senza di essi i quattro sarebbero pattern-violators.
| # | Doc trasversale | Cosa risolve delle critiche bloccanti |
|---|---|---|
| 1 | agent_runtime.html |
reasoning loop, tool-call validation, ExecutionTrace, prompt structure |
| 2 | approval_ux.html |
batching approvazioni, pausa lettura, revoca, tutor mode |
| 3 | eval.html |
15-20 scenari YAML + harness replay + report success/cost |
| Componente | Cosa copre | Fase | Stato |
|---|---|---|---|
types.html ✓ |
Indice canonico dei tipi cross-componente. Introduce PlannedAction e TrustScore. Disciplina di versioning e drift detection. |
1 (trasversale) | obsoleto |
agent_runtime.html ✓ |
Reasoning loop (ReAct), prompt structure, tool-call validation, ExecutionTrace, provider failover via supra | 1 (prima) | obsoleto |
approval_ux.html ✓ |
Flussi approvazione CLI/Telegram, batching, pausa lettura, revoca, tutor mode | 1 (prima) | obsoleto |
eval.html ✓ |
Scenari YAML, harness replay, metriche success/latency/cost, CI gate | 1 (prima) | obsoleto |
gateway.html ✓ |
FastAPI, sessioni, webhook, cron, auth | 1 | obsoleto |
channel.html ✓ |
Protocol Channel, CLI, poi Telegram |
1 / 3 | obsoleto |
tool.html ✓ |
Protocol Tool, base set (fs, shell, web_fetch, supra adapters) |
1 | obsoleto |
sandbox.html ✓ |
Profili bubblewrap, hardening systemd, Docker opzionale | 1 | obsoleto |
policy.html ✓ |
Livelli di autonomia, approval gating, rate/cost limits, forbidden paths, cost tiering | 2 | obsoleto |
workspace.html ✓ |
File markdown IDENTITY / USER / MEMORY / AGENTS / SOUL | 2 | obsoleto |
observability.html ✓ |
Logging JSON, audit log append-only, metrics, health | 2 | obsoleto |
pairing.html ✓ |
DM pairing: flusso codice, firma, revoca | 3 | obsoleto |
memory.html ✓ |
Protocol Memory, persistenza sessioni + fatti long-term |
4 | obsoleto |
config.html ✓ |
Schema pydantic-settings, overrides, secrets | 1 (trasversale) | obsoleto |
| Estensione "Neuroni e Memoria" (vedi doc v1) | |||
rl_offline.html ✓ |
Autosviluppo senza training. 3 esperimenti trace-scoring / synth-reward / neuron self-play. Introduce TrustStore. |
5 / 7 (trasversale) | obsoleto |
neuron.html ✓ |
Struttura di un neurone: manifest, corpo, test di nascita, firma, journal | 6 | obsoleto |
synthesizer.html ✓ |
Pipeline di sintesi: fallimento → spec → bozza → analisi statica → test → approvazione umana | 5 / 6 | obsoleto |
synapse.html ✓ |
Grafo dei neuroni: sinapsi dichiarate/osservate, counter, decadimento, potatura | 7 | obsoleto |
constitution.html ✓ |
Le 4 Leggi, SOUL.md, rito di modifica, enforcement nei prompt | 2 | obsoleto |
| Estensione "Prospettive estese" (vedi doc v1) | |||
telos.html v1.0 |
(riga storica) TELOS.md, funzione di allineamento, bother budget. Promosso a v1.1 il 25/4/2026: vedi tabella v1.1 canonici nuovi sopra. | 4-5 | v1.1 canonico |
vaglio.html ✓ |
Guardia costituzionale (binaria, deterministica) + Giudice teleologico (gradiente, LLM indipendente). Risolve il self-critic bias; coppia con telos. |
4-5 | obsoleto |
Ogni file HTML di microprogettazione segue lo stesso template di Architettura — Introduzione:
id;
pianificato — componente riconosciuto, documento non ancora scritto.
in stesura — documento in bozza, non usare come riferimento.
approvato — documento finale. L'implementazione può iniziare.
implementato — codice esistente in src/myclaw/<componente>/.
obsoleto — documento superato da decisioni successive (rinomine del Dialogo sugli executor, Architettura v1.1). Conservato come tracciabilità, da riscrivere prima dell'implementazione.
La microprogettazione ha senso solo contro i documenti fondamentali. Se stai leggendo un componente di questa cartella, tienili a portata: