Pagina per nerd

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.

Python solo stdlibSQLite locale per Mac0 server≈ 100 token all'avvio2 hook di Claude Code
01

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.

sessione=modello+tool+contesto(scope)
scope=master→progetto→luogorisolto dalla cartella di lavoro
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 lavororegolascope
~/Clienti/Rossi/sito/src/componentsprefisso più lungo nel catalogoStudio Rossi › Sito
~/Clienti/Rossi/preventividentro la home del masterStudio Rossi › progetto automatico
~/Downloads/provanessuna corrispondenzainbox «Da smistare»
~ · iCloud · /Userscartella contenitoremai 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.
02

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.

ingressi
Claude in sessionela skill dice quando scrivere
CLIworkinonit note "…" --kind …
Note vocali dal telefonotrascritte, importate ogni ora
Inbox Obsidian- [ ] → todo · #tag → scope
sync/<mac>/events.jsonl
{"op": "add", "kind": "decision", "project": "rossi-sito", …}
{"op": "add", "kind": "todo", "urgent": 1, …}
{"op": "assign", "id": "a3f9c1…", "project": "alpi-shop", …}
{"op": "done", "id": "7be210…", …}
{"op": "move", …}
nodi dell'albero
Studio Rossi › Sito
Shop Alpi › Shop
Brand Nova nota del master
Da smistare senza scope, in attesa di assign

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

tiposignificatociclo di vita
todoun'azione da fare, può essere urgenteaperto → workinonit done <id> → esce dal contesto attivo
factuna verità stabile su cliente o progettopersistente
decisionuna scelta presa, da non rimettere in discussionepersistente
handoffStato · Fatto · Prossimo · In sospesosostituito dal successivo
03

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.

L0 · brief

Sempre, all'avvio

Iniettato dall'hook: progetto, handoff, urgenze, todo, decisioni, fatti, avvisi dagli altri Mac.

≈ 100 token · push
L1 · on demand

Quando serve

workinonit brief <progetto>, workinonit find "…": query sul database locale.

costo quasi nullo
L2 · verbatim

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.
04

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

sorgentecosa estrae
~/.claude/projects/*/*.jsonlcartella, branch, titolo, primo e ultimo prompt, costo, righe modificate
chiamate ai tooloperazioni tipizzate: file scritti, installazioni, commit, push, deploy, cancellazioni, ssh
git localebranch, modifiche non committate, commit non pushati, ultimi commit
gh repo listogni ora: i repository senza una cartella locale restano visibili
timestampminuti attivi: le pause oltre 10 minuti non contano

Handoff automatico

sessione ferma da 20 min→estratto del transcript→claude -p --model haiku→Stato · Fatto · Prossimo · In sospeso
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 scan in background. Il server ripete la scansione ogni 10 minuti.

Il brief L0, riga per riga

WORKINONIT · Studio Rossi › Sito [active]← risoluzione per prefisso
⚠ su Mac mini: 2 commit non pushati← state.json dell'altro Mac
Stato: menu mobile su branch menu, non in main← handoff automatico
Prossimo: merge e deploy← handoff automatico
In sospeso: foto dal cliente, venerdì← handoff automatico
- [URGENTE] rinnovare il dominio entro il 30/11← nota todo --urgent
- [decision] l'hosting resta su Lightsail← nota decision
- [fact] risponde solo su WhatsApp← nota del master, ereditata
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.
05

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.

transcript dello scope→punti di correzione→errore → regola→lesson nel brief
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 SessionStart come qualsiasi altra nota. Prompt riscritti: zero.
06

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
promote incrementa 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, --master o --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.jsoncatalogo 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:7337dashboard locale e API (/api/diary, /api/health)
↑ torna su