Brain System / Guida rapida per Stefano

Come funziona il brain

Struttura cartelle, skill, diary, frontmatter obbligatorio, secrets e la differenza fondamentale tra dati e azioni.

v5.0 — Marzo 2026 ABChat Brain System
Il concetto di base

Il brain è la tua memoria persistente. L'AI si sveglia ogni sessione senza ricordi — questi file sono la continuità. Il modello AI è sostituibile (Claude oggi, Gemini domani), il brain no. Costruiscilo bene e sopravvive a tutto.

Struttura cartelle
brain/
boot/Chi sei, chi è l'utente, configurazione locale
brain.mdCome funziona il sistema — leggi per primo
soul.mdPersonalità e tono dell'agente
user.mdInfo su di te (background, stile, preferenze)
local.yamlServer, hostname, capabilities
wiki/Database di entità strutturate
people/Persone con cui lavori
companies/Aziende e clienti
projects/Progetti attivi e archivio
passwords/Credenziali clienti (da creare!)
diary/YYYY/Log cronologici — cosa è successo e perché
todo/Task aperti con deadline
inbox/Punto di passaggio — tienilo vuoto
public/File serviti via web (minisiti, report)
storage/Cache, db, file non strutturati
.envSecrets — MAI nel git!
Dati vs Azioni — la distinzione fondamentale
🧠
Brain = Dati
Il brain contiene solo informazioni: wiki, diary, note, configurazioni, credenziali (in .env). Non contiene codice eseguibile, non fa azioni da solo. È un database di conoscenza in Markdown.
⚙️
Skill = Azioni
Le skill sono moduli che fanno cose: mandare email, gestire domini, fare screenshot di siti, pubblicare pagine. Si installano con /brain e vivono in .claude/skills/. Separare dati e azioni rende tutto più sicuro e gestibile.
🔒
Sicurezza Skill
Prima di installare una skill da GitHub di terzi: ispeziona il megaprompt e il codice. Una skill malevola può fare danni reali. Il sistema è sicuro by design, ma la vigilanza è necessaria.
Frontmatter obbligatorio

Ogni file .md nel brain deve iniziare con un frontmatter YAML. Senza frontmatter, i file non sono ricercabili e il brain non può fare inferenze automatiche sul contesto. Il campo project nei diary è particolarmente importante.

--- # frontmatter obbligatorio in ogni .md ---
date: '2026-03-27'
type: diary          # diary | wiki | todo | log
project: stevetech  # progetto di riferimento — sempre!
created_at: '2026-03-27 14:30:00'
created_with: anacleto
tags:
  - dns
  - dominio
---

# Titolo del file

Contenuto qui...
Secrets e .env

Tutte le credenziali, API key, password vanno nel file .env nella root del brain. Il .env è nel .gitignore — non finisce mai nel repository. Se commetti una credenziale per errore, cambiala subito.

# .env — in root del brain, MAI nel git
INTERNETBS_USER=tuo-username
INTERNETBS_PASSWORD=password-api-key
EMAIL_ADDRESS=stefano@stevetech.it
EMAIL_PASSWORD=...

# Credenziali cliente (mai inline nei file wiki!)
CLIENT_ROSSANO_ARUBA_USER=...
CLIENT_ROSSANO_ARUBA_PASS=...
🚫
Mai mettere password o token dentro file wiki/ o diary/ Anche se il file non è pubblico, finisce nel git. Il .env no.
✓
Nel wiki puoi mettere riferimenti alle credenziali Es. "password Aruba in .env come CLIENT_ROSSANO_ARUBA_PASS"
Skill disponibili
Skill Cosa fa Comando
/brain Gestisce il brain: installa skill, aggiorna, checkpoint /brain
public Pubblica pagine web su public.stevetech.it tramite /brain
kindle Pubblica note su kindle.stevetech.it tramite /brain
radar Audit automatico siti: screenshot, problemi, fix suggeriti /radar
internetbs Gestisce domini e DNS su InternetBS via API tramite /brain
ghostwriter Scrive testi nel tuo stile: email, post, documenti /ghostwriter
brain-writer Scrive file nel brain con frontmatter corretto e naming interno al sistema
Regole operative
📝
Dopo ogni azione significativa aggiorna wiki/ e scrivi in diary/ Email inviata, task completato, deploy, call — loggalo. Se non è nel brain, non è successo.
🛑
Azioni distruttive richiedono conferma esplicita Cancellare file, cambiare DNS, modificare database — annuncia cosa stai per fare, aspetta ok.
🔀
Checkpoint ai breakpoint naturali, non a metà operazione Task completato = checkpoint. Ancora in mezzo a qualcosa = aspetta.
🧅
Le persone sono entità separate dai progetti Laura è una persona, non una proprietà del progetto "cliente Rossano". Crea wiki/people/laura.md separato.
📅
Ogni diary entry deve avere il campo project Senza project nel frontmatter, la entry è orfana e irrintracciabile. Sempre.
TMUX — sessioni persistenti

TMUX mantiene le sessioni aperte anche quando chiudi il terminale. Indispensabile per lavori lunghi sul server.

# Creare sessione named
tmux new -s brain

# Attaccarsi a sessione esistente
tmux attach -t brain

# Listare sessioni aperte
tmux ls

# Staccarsi senza chiudere (Ctrl+B poi D)
Ctrl+B D

# Nuova finestra nella sessione (Ctrl+B poi C)
Ctrl+B C
Modello: Opus vs Sonnet
🏆
Opus — per lavoro complesso
Qualità massima. Meglio per architetture, decisioni, analisi profonde. Consuma più token — con piano Pro esaurisce i limiti orari/settimanali più in fretta.
⚡
Sonnet — per lavoro quotidiano
Veloce, capace, economico in token. Ottimo per la maggior parte dei task: scrivere, leggere file, eseguire comandi. Default consigliato per uso quotidiano.
♾️
Piano Max
Rimuove i limiti rilevanti. Se arrivi spesso al limite token con Opus, vale l'upgrade. Giobi usa questo. Stima costo extra autonomia AI: ~40€/ora con Opus senza piano.
Awareness Layer (futuro)

Giobi ha un awareness layer attivo: il suo Pixel 8 Pro manda ogni 15 minuti dati di contesto al brain — posizione (WiFi SSID), batteria, passi, luce ambientale, pressione. Il brain sa se è in ufficio, a casa, in giro, se è notte fonda, se il telefono sta morendo.

Il risultato: l'AI apre ogni sessione con un commento contestualizzato invece che al buio. Nessun accesso attivo alle cam — solo sensori passivi e log. Privacy by design.

Questo si può replicare anche per il tuo brain, con uno smartphone Android e Termux configurato.