Come funziona, dentro.
La scheda tecnica di workinonit: modello dati, risoluzione dello scope, log di eventi, sync tra Mac, consolidamento e pipeline. Con i comandi e i file veri.
Scope: dall'agente al master
Il modello e i tool restano generici. Istruzioni e memoria sono legate al posto in cui lavori, e il posto si ricava dalla cartella.
- modello e tool
- Generici: Claude Code così com'è. Nessun agente custom da scrivere o mantenere.
- istruzioni e memoria
- Legate allo scope, non all'agente. Aprire una sessione in un master equivale a istanziare l'agente di quel master.
Modello dati masters.json
# catalogo in iCloud, condiviso da tutti i Mac MASTER Studio Rossi cliente · agenzia · linea di prodotto · personale ├─ PROGETTO Sito site · app · tool · bot · assets · brand · video · docs │ ├─ luogo ~/Clienti/Rossi/sito │ ├─ luogo github.com/rossi/sito │ └─ luogo studiorossi.it └─ PROGETTO Brand └─ luogo ~/Clienti/Rossi/brand
- catalogo
masters.json: nomi, tipi, home dei master, siti, repo, raggruppamenti. Un progetto può avere molti luoghi.- note sui nodi
todo·fact·decision·handoff, appese a un progetto, a un master o globali.- ereditarietà
- Le note del master valgono per tutti i suoi progetti; quelle del progetto per tutti i suoi luoghi.
- spostamenti
- Un progetto che cambia master mantiene id, note e sessioni. Le cartelle spostate vengono ritrovate per nome e ricollegate.
Risoluzione per prefisso di percorso
| cartella di lavoro | regola | scope |
|---|---|---|
| ~/Clienti/Rossi/sito/src/components | prefisso più lungo nel catalogo | Studio Rossi › Sito |
| ~/Clienti/Rossi/preventivi | dentro la home del master | Studio Rossi › progetto automatico |
| ~/Downloads/prova | nessuna corrispondenza | inbox «Da smistare» |
| ~ · iCloud · /Users | cartella contenitore | mai un progetto |
- iniezione
- Hook
SessionStart→workinonit brief --hook. Nessun embedding, nessun ranking: la query è la cartella. - isolamento
- La gerarchia restringe lo spazio di recupero prima di qualsiasi domanda. Un master non contamina l'altro.
- cartella sconosciuta
- Claude chiede una volta dove va, poi
workinonit attach . <master>[/<progetto>].
Effetti
- zero setup
- Un master nuovo è vuoto e usabile subito: il contesto cresce dal lavoro.
- niente prompt drift
- Il brief viene rigenerato a ogni avvio dallo stato reale: sessioni recenti, git, note aperte.
- indipendenza dal modello
- La memoria sta fuori dal modello e dal fornitore. Cambiarli non fa perdere la configurazione.
Ingressi, log di eventi, consegna
Quattro canali d'ingresso, un solo log append-only. Scrivere un'informazione e usarla sono due momenti separati: il canale non conta.
Un evento
{
"ts": 1794838780.95, "dev": "MacBook", "op": "add", "id": "9ef11e5b21f4",
"master": "rossi", "project": "rossi-sito", "kind": "decision",
"text": "L'hosting resta su Lightsail", "tags": [], "author": "claude",
"created_at": "2026-11-16T19:00:39+00:00"
}
- tipo e scope
- Il tipo decide semantica e ciclo di vita; lo scope decide dove l'informazione riemerge.
- senza scope
- Finisce in «Da smistare».
workinonit assign <id> <master>/<progetto>la aggancia al nodo. - assegnazione
- È anch'essa un evento (
assign), quindi si propaga a tutti i Mac come il resto.
Sincronizzazione su più Mac, senza server
# iCloud / WORKINONIT / sync sync/ ├── macbook/ events.jsonl sessions.json state.json ├── mac-mini/ events.jsonl sessions.json state.json └── imac/ events.jsonl sessions.json state.json # per Mac, fuori da iCloud ~/.workinonit/ SQLite # dentro iCloud si corromperebbe
- scrittura
- Ogni Mac scrive solo nella propria cartella: note (
events.jsonl), sessioni e operazioni (sessions.json), stato git e presenza (state.json). - lettura
- Ogni Mac legge tutte le cartelle e ricostruisce lo stato nel proprio SQLite. Last-write-wins: niente lock, niente conflitti.
- codice
- Anche il codice sta in iCloud: tutti i Mac eseguono la stessa versione.
Ciclo di vita per tipo
| tipo | significato | ciclo di vita |
|---|---|---|
| todo | un'azione da fare, può essere urgente | aperto → workinonit done <id> → esce dal contesto attivo |
| fact | una verità stabile su cliente o progetto | persistente |
| decision | una scelta presa, da non rimettere in discussione | persistente |
| handoff | Stato · Fatto · Prossimo · In sospeso | sostituito dal successivo |
Il costo si sposta dalla lettura alla scrittura
Lo stesso principio di indici e viste materializzate: il lavoro costoso si fa una volta, quando il dato entra, non a ogni lettura.
Sempre, all'avvio
Iniettato dall'hook: progetto, handoff, urgenze, todo, decisioni, fatti, avvisi dagli altri Mac.
≈ 100 token · pushQuando serve
workinonit brief <progetto>, workinonit find "…": query sul database locale.
Raramente
Transcript completi, diario, storico git. Lettura mirata, con lo scope già noto.
solo quello che serve- scrittura
- Una chiamata a un modello piccolo per sessione, in background.
- lettura
- Circa 100 token costanti a ogni avvio, già pronti. Il modello costoso non fa mai da motore di ricerca: zero ricerche nel vault, zero note aperte.
- second brain
- Ogni domanda è un'esplorazione dentro la context window del modello costoso: il costo cresce con l'archivio.
Memoria ricavata dalle tracce del lavoro
La maggior parte della memoria non la scrive nessuno. Viene dai transcript di Claude Code, da git e da GitHub, e si aggancia all'albero per prefisso di percorso.
Sorgenti
| sorgente | cosa estrae |
|---|---|
| ~/.claude/projects/*/*.jsonl | cartella, branch, titolo, primo e ultimo prompt, costo, righe modificate |
| chiamate ai tool | operazioni tipizzate: file scritti, installazioni, commit, push, deploy, cancellazioni, ssh |
| git locale | branch, modifiche non committate, commit non pushati, ultimi commit |
| gh repo list | ogni ora: i repository senza una cartella locale restano visibili |
| timestamp | minuti attivi: le pause oltre 10 minuti non contano |
Handoff automatico
- isolamento
- La chiamata non carica hook e non registra la propria sessione: niente ricorsione, niente sessioni fantasma.
- sostituzione
- Ogni handoff sostituisce il precedente. Alla prima esecuzione ricostruisce lo storico di tutti i progetti.
- rescan
- Hook
SessionEnd→workinonit scanin background. Il server ripete la scansione ogni 10 minuti.
Il brief L0, riga per riga
- diario
- Sessioni, operazioni e commit in ordine cronologico, filtrabili per master e per Mac. Dashboard
127.0.0.1:7337, oppure/api/diary?days=7. - tra Mac
- Commit non pushati o modifiche non committate altrove arrivano nel brief prima che tu tocchi il progetto, non dopo il conflitto.
Learn: le correzioni diventano regole in arrivo
I transcript contengono già ogni correzione che hai fatto a Claude. Oggi valgono solo nella chat in cui le fai; learn le consoliderà in regole.
- segnali
- Contro-istruzione («no, così») · richiesta rifiutata · modifica annullata · operazione rifatta dopo un errore.
- consolidamento
- Correzioni equivalenti da sessioni diverse diventano una sola nota
lesson, con il numero di correzioni che la sostengono. - collocazione
- Sul progetto se specifica, sul master se generale. Passa ai progetti dello stesso tipo, ma non esce dal master.
- applicazione
- Le lesson entrano nel brief
SessionStartcome qualsiasi altra nota. Prompt riscritti: zero.
Pipeline: memoria procedurale portabile
Una pipeline è un metodo collaudato (passaggi, prompt degli agenti, script, criteri di qualità) separato dai dati del cliente. Si registra una volta e si usa in qualsiasi master.
# 1 · raccogli tutto quello che un progetto sa di come è stato fatto il lavoro (sola lettura) $ workinonit pipe harvest rossi-video # 2 · crea la pipeline da quel progetto $ workinonit pipe new video-social --from rossi-video # 3 · usala in un altro master: dentro la cartella del progetto di destinazione $ cd ~/Clienti/Alpi/video && workinonit pipe start video-social $ workinonit pipe step video-social montaggio done $ workinonit pipe status # 4 · quello che il run ha insegnato torna nella procedura: nuova versione $ workinonit pipe promote video-social "sottotitoli sempre fuori dalla safe zone"
PIPELINE.md pipelines/<id>/
--- name: Video social version: 3 origin: rossi-video description: Dal girato ai reel verticali, con sottotitoli e cover. --- ## Steps 1. [agent] selezione → prompts/selezione.md 2. [tu] scegli → tieni, scarta, riordina 3. [script] montaggio → scripts/render.py 4. [agent] controllo → guarda i fotogrammi, non solo il file ## Changelog - v3 sottotitoli sempre fuori dalla safe zone (da alpi-video) - v1 nata da rossi-video
Il run _pipeline/ nella cartella del progetto
{ "pipeline": "video-social", "version": "3", "project": "alpi-video",
"steps": { "selezione": "done", "scegli": "done", "montaggio": "todo", … },
"inputs": {}, "outputs": {}, "choices": {}, "deviations": [] }
- nella pipeline
- Passaggi, prompt, script, parametri, criteri di qualità, regole generali.
- nel master
- Asset, brand, fatti, decisioni e regole del cliente. I dati del master d'origine non entrano mai in un altro master.
- versioni
promoteincrementa la versione e registra nel changelog cosa è cambiato e da dove è arrivato. I nuovi run partono dall'ultima.- tracciamento
- L'avvio di un run è un evento nel log del progetto di destinazione, quindi è visibile da tutti i Mac.
Comandi e file
Installazione ~/.claude/settings.json
{ "hooks": {
"SessionStart": [{ "hooks": [{ "type": "command", "command": "workinonit brief --hook" }] }],
"SessionEnd": [{ "hooks": [{ "type": "command", "command": "(workinonit scan -q >/dev/null 2>&1 &)" }] }]
} }
Più un LaunchAgent che tiene in piedi la dashboard e lo scanner, e una skill che dice a Claude quando scrivere una nota.
- brief [path]
- Il brief del progetto (default: cartella corrente)
- note "…" --kind
- todo · fact · decision, su progetto,
--mastero--global - done · urgent
- Chiude un todo · lo fissa in cima
- handoff "…"
- Scrive a mano dove sei rimasto
- find "…"
- Cerca note, fatti e sessioni ovunque
- new · newmaster
- Crea un progetto nella home del master · crea un master
- attach · assign
- Collega una cartella · manda una nota dove va
- scan · serve
- Riscansiona · dashboard su
:7337 - notup
- Importa le note vocali di lavoro dal telefono
- pipe …
- list · show · harvest · new · start · status · step · promote
Dove sta cosa
| masters.json | catalogo master → progetti → luoghi, in iCloud |
| sync/<mac>/ | log di eventi, sessioni e stato di ogni Mac, in iCloud |
| ~/.workinonit/ | database SQLite locale, uno per Mac |
| ~/.claude/projects/ | transcript di Claude Code, letti e mai modificati |
| pipelines/<id>/ | PIPELINE.md, prompts/, scripts/ |
| 127.0.0.1:7337 | dashboard locale e API (/api/diary, /api/health) |