Mappa delle cartelle

🟢 attivaagg. 2026-09-03Agente Residente openclaw/00_MAPPA_CARTELLE.md

Mappa delle cartelle — Agente Residente openclaw

Chi legge questo file sa dov'è cosa e chi lo cura. Regola: *ognuno tiene ordine a casa
propria; Romeo fa il check globale. In caso di dubbio su una cartella nuova → Generale*.

Legenda

🟦 Generale — la usano/consultano più agenti. Vive a root.
🐱 Romeo (main) — gestione, orchestrazione, contesto globale.
🛠️ Archimede — codice, CATPIT, infrastruttura, sicurezza, grafica (ex ruoli Sprite e Bartolomeo, assorbiti).
💰 Creso — investimenti (paper trading, L2).
🔒 NON SPOSTARE — referenziata da percorsi vivi (app/prompt/script): spostarla rompe qualcosa.

Nota agenti (aggiornata 2026-08-25). Gli agenti veri a runtime sono sei id sul gateway:
Romeo (main), Archimede, Creso, Catone in due marce (catone su Sonnet 5 ·
catone-opus su Opus 5, riserva economica) e Seneca (spazio personale su Telegram, non
prende task di progetto). Maurus è deciso ma non ancora acceso (task a56). Sprite e
Bartolomeo non esistono più come agenti dal 2026-07-12: i loro ruoli stanno dentro
Archimede. Registro completo: .openclaw\workspace\CREW.md + CATPIT_vault\agents_registry.json.
(La versione precedente di questa nota, ferma al 2026-07-12, diceva "tre agenti": era un residuo.)

Cartelle a root

Ordine della tabella: prima le case degli agenti, poi il sistema CATPIT, poi i
cantieri di codice che vivono a root, poi i registri e gli archivi, infine i **file
indice**. Non è l'ordine alfabetico: è l'ordine in cui uno che arriva nuovo deve guardarle.

Cartella / file	Categoria	Cura	Note
`Agente_1_Romeo/`	🐱 Romeo	Romeo	lavoro proprio di Romeo
`Agente_2_Archimede/`	🛠️ Archimede	Archimede	lavoro proprio + `Security_Checks/` (report di sicurezza) + `screenshots/` (prove a schermo)
`Agente_3_Creso/`	💰 Creso	Creso	lavoro proprio (01_agente … 07_operazioni) + `03_dati_mercato/store/` (database di mercato)
`catpit/`	🟦 Generale (infra)	Archimede	🔒 app Next.js di Mission Control + script — non spostare: nel codice ci sono percorsi assoluti
`CATPIT_vault/`	🟦 Generale	Archimede	🔒 master dei dati progetti/task/richieste — path assoluto in `catpit/lib/config.ts` — non spostare
`RICHIESTE/`	🟦 Generale	Archimede	Quaderno delle richieste: messaggi originali di Ettore (sola lettura) + `indice.json` per la stanza `/quaderno`; i prompt delle catene notturne stanno in `_prompts/`; snapshot in `_storico/`
`business-os/`	🟦 Generale (progetto p16)	Archimede	Gestionale Business — app in beta sulla porta 8831, raggiungibile sulla 8460
`vf-plancia/`	🟦 Generale (progetto p01)	Archimede	Plancia Video Factory — app Next.js sulla porta 3020, raggiungibile sulla 8459
`efesto/`	🟦 Generale (progetto p03)	Archimede	La gabbia: banco di prova isolato in Docker per modelli esterni; `fucina/` è il bancone condiviso con l'host
`ricerca-poster/`	🟦 Generale (progetto p24)	Archimede	1 di 3 — la Ricerca: dice cosa vende il mercato. App sulla 8800 (8469), 95 concorrenti e 6.271 poster con le immagini in casa; dentro `dna/` la catena che ricava la ricetta di un poster e in `dati/dna/template/` gli otto modelli riusabili
`lavorazione-poster/`	🟦 Generale (progetto p24)	altro agente	2 di 3 — la Lavorazione: dice com'è fatto un poster. App sulla 8801. ⚠️ In costruzione: non toccare
`produzione-poster/`	🟦 Generale (progetto p24)	Archimede	3 di 3 — la Produzione: rifà i poster a modo nostro. Nata il 02/09 con `P1_prova/` (a134): dieci poster nuovi dai template del DNA, il foglio da guardare e la relazione con i costi misurati. L'app vera arriva con P4 (a137), solo se P1 passa. Dal 03/09 dentro c'e' anche `M1_catalogo/`: la lista dei 40 poster da produrre (`catalogo_40.csv`), il perche' di ogni riga (`CRITERIO.md`) e lo script che la rigenera dai dati veri
`spazio-porto/`	🟦 Generale (progetto p25)	Romeo	Spazio-Porto, il gestionale di Hermes: nato il 03/09, l'app non è ancora scritta. Dentro `docs-hermes/` la documentazione ufficiale di Hermes Agent (indice `llms.txt` + testo integrale `llms-full.txt`) e `schema_hermes.html`, la scheda d'insieme impaginata
`docs-openclaw/`	🟦 Generale (riferimento)	Romeo	Documentazione ufficiale di OpenClaw scaricata il 03/09: `llms.txt` (indice delle 768 pagine) e `llms-full.txt` (testo integrale, 13,7 MB). Serve per lavorare su noi stessi senza andare a memoria; la copia della versione installata sta in `AppData/Roaming/npm/node_modules/openclaw/docs`
`docker/`	🟦 Generale (infra)	Archimede	Immagini e compose delle mini-app containerizzate + `CENSIMENTO_DOCKER.md`
`scripts/`	🟦 Generale (infra)	Romeo	Script di servizio riusabili — fra cui `limiti.mjs`, il cancello che legge i limiti prima dei turni notturni
`REGISTRO_GUASTI/`	🟦 Generale (meta)	tutti	I guasti già pagati, uno per file, con causa e rimedio: si legge prima di ripetere l'errore
`REGISTRO_SVILUPPO/`	🟦 Generale (meta)	tutti	Come sono cambiate le app: `APP.md` (dove vive ogni codice), `DECISIONI.md`, e una cartella per app con dentro `DIARIO.md` — una riga per intervento, col perché. Si guarda prima di toccare un'app e si scrive dopo
`materiale condiviso/`	🟦 Generale	tutti	Tutto ciò che non è di un singolo agente — dettaglio nella tabella qui sotto
`tmp/`	🟦 Generale (usa e getta)	tutti	Lavoro di passaggio: script una-tantum, schermate, file da allegare in chat. Niente di valore qui dentro
`ELENCO_PROGETTI.md`	🟦 Generale (stato)	Romeo	Sintesi narrativa dei progetti — la verità dei dati sono i CSV di `CATPIT_vault`
`00_MAPPA_CARTELLE.md`	🟦 Generale (indice)	Romeo	questo file
`ACCESSI_E_PORTE.md`	🟦 Generale (indice)	Romeo	A quale indirizzo si raggiunge ogni app, da qualsiasi dispositivo. Si aggiorna a ogni app o esposizione nuova
`CLASSIFICAZIONE_PROGETTI.md`	🟦 Generale (indice)	Romeo	Le quattro categorie fisse in cui stanno i progetti
`DOVE_VIVONO_GLI_AGENTI.md`	🟦 Generale (indice)	Romeo	Le tre case di un agente: workspace, memoria di macchina, canale
`REGOLE_STANZE_DISCORD.md`	🟦 Generale (indice)	Romeo	Quale stanza Discord serve a cosa, e dove consegna ogni loop
`MAPPA_SKILL_2026-08-02.md`	🟦 Generale (storico)	Romeo	Censimento delle skill installate per agente — fotografia del 02/08
`PIANO_SKILL_2026-08-02.md`	🟦 Generale (storico)	Romeo	Piano di ripartizione delle skill fra gli agenti — 02/08
`PIANO_FINESTRE_2026-08-02.md`	🟦 Generale (storico)	Romeo	Piano d'uso delle finestre da 5 ore — 02/08
`RICOGNIZIONE_SISTEMA_2026-08-19.md`	🟦 Generale (storico)	Romeo	Ricognizione completa del sistema — fotografia del 19/08

`materiale condiviso/` — condivise, non di un singolo agente

Ordine della tabella: prima le cartelle vive (ci si scrive adesso), poi quelle di
conoscenza, infine gli archivi.

Cartella	Categoria	Cura	Note
`Chat/`	🟦 Generale	Romeo	Archivio umano delle conversazioni: un file per sessione, con le decisioni in fondo
`Sviluppo_Sistema_Agentico/`	🟦 Generale (meta)	Romeo	Qui vanno le proposte di auto-miglioramento (`proposte_giornaliere/`) e i referti sul sistema
`Gestione_Agentica_/`	🟦 Generale (meta)	Romeo	Note di sessione su architettura e riordino
`QUADERNO_AGENTI/`	🟦 Generale (meta)	tutti	Appunti degli agenti fra un turno e l'altro. ⚠️ `PER_ETTORE_azioni.md` è superato: le domande vanno nella stanza Richieste di CATPIT
`Video_Factory/`	🟦 Generale (progetto p01)	tutti	Materiale di Video Factory: montaggio Remotion, automazione della catena, archetipi
`ON-line_Business/`	🟦 Generale (progetto p24)	Romeo	Materiale della linea di vendita online: documento di avvio 31/08, strategia, fornitori, negozio
`Piattaforma_Dashboard/`	🟦 Generale (progetto p15)	Archimede	Materiale della Piattaforma e di Life OS — git-tracked
`KnoBase_p05/`	🟦 Generale (progetto p05)	Romeo	Materiale di KnoBase, la base di conoscenza
`progetti_collab_martino/`	🟦 Generale (collab)	Romeo	Rapology, lavoro con Martino — git-tracked
`KB_Fix_Tecnici/`	🟦 Generale	tutti	Base di conoscenza dei fix già pagati (es. i cron con claude-cli)
`KB_Sprite/`	🛠️ Archimede	Archimede	Base di conoscenza grafica/pixel (ex Sprite): reference markdown, `Squadra_Topini.md`, `SPRITE.md` archiviato il 2026-07-12
`Galleria_Prompt/`	🟦 Generale	Romeo	Prompt riusabili messi da parte
`Ricerche/`	🟦 Generale	tutti	Referti di ricerca prodotti dai loop
`_storico_progetti/`	🟦 Generale (archivio)	Romeo	Snapshot datati di `ELENCO_PROGETTI.md`
`Archivio/`	🟦 Generale (archivio)	tutti	Repo esterni e prove — gitignorati

Dove vive la conoscenza (puntatori — non duplicare qui!)

Nozioni di riferimento (prompting, n8n, guide strumenti, Docker, LaTeX, Obsidian): → `MD_DB_v1/01_STRUMENTI_di_LAVORO/` (copia unica). Non ricopiare nel repo agenti.
Mappe concettuali del sistema → `MD_DB_v1/01_STRUMENTI_di_LAVORO/Metodo_di_lavoro/mappe_concettuali/` (le legge la stanza Mappe concettuali di CATPIT: basta droppare un .md con un blocco mermaid).
Conoscenza personale / dataset / schede progetti → `MD_DB_v1/02_CONOSCENZA/` e le cartelle 03_*.
Anima degli agenti (regole, tono, tools) → `C:\Users\Ettore\.openclaw\workspace-<agente>\`.
Stato vivo dei progetti → `CATPIT_vault/` (+ ELENCO_PROGETTI.md come sintesi).

Regola d'oro (in 3 righe)

Un fatto in un posto solo: regola→anima, nozione→MD_DB_v1, capacità→skill, stato→file di stato.
Se cambi lo stato di un progetto, aggiorna subito CATPIT/ELENCO (e questa mappa se tocchi la struttura).
Non spostare le cartelle 🔒 senza aggiornare insieme i percorsi che le referenziano.

Changelog

2026-09-02 — Aggiunte le tre cartelle della famiglia poster del progetto p24: ricerca-poster/, lavorazione-poster/ (esistevano già e non erano in mappa) e produzione-poster/, creata oggi per la fase Produzione. (Archimede)
2026-08-25 — Rimessa in pari nella notte "sezione Sistema" (turno del contenuto, Romeo). La mappa dichiarava 19 voci e ne mancavano 12 reali a root: business-os/, vf-plancia/, efesto/, docker/, scripts/, REGISTRO_GUASTI/, tmp/ e i file indice ACCESSI_E_PORTE.md, CLASSIFICAZIONE_PROGETTI.md, DOVE_VIVONO_GLI_AGENTI.md, REGOLE_STANZE_DISCORD.md, più i tre documenti del 02/08 e la ricognizione del 19/08. In materiale condiviso/ mancavano QUADERNO_AGENTI/, Video_Factory/, KnoBase_p05/, Galleria_Prompt/, Ricerche/. Aggiornata la nota agenti da tre a sei. Dichiarato l'ordine delle due tabelle. Da 19 a 38 voci.
2026-07-12 — Riordino: a root restano solo le case degli agenti e il sistema CATPIT; tutto il resto confluisce in materiale condiviso/. Security_Checks/ spostata dentro Agente_2_Archimede/.

Riferimenti