Scan automatico di repos, API, messaggi e VPS ad ogni sessione. L'AI coder sa dove sei prima ancora che tu parli.
Ogni nuova sessione del tuo AI coder parte da zero. Non sa quali repo hai, non sa lo stato dei commit, non sa se il server e online, non sa se ci sono messaggi dai collaboratori. Devi spiegargli tutto ogni volta. Tempo perso, contesto perso.
Senza awareness: Apri la sessione. "Qual e lo stato di THIA?" Aspetti. "Ci sono file non committati?" Aspetti. "Il VPS e online?" Aspetti. "Qualcuno mi ha scritto?" Aspetti ancora. Quattro domande, quattro attese. E lo fai ogni volta che inizi a lavorare.
Un hook che si attiva automaticamente ad ogni inizio sessione. Scansiona tutto, genera un report strutturato e lo inietta nel contesto. L'AI coder sa gia tutto prima che tu dica una parola.
Scansiona tutti i repo git nella base: branch, commit, dirty files, ahead/behind rispetto al remote.
Controlla la salute delle API e del VPS con un curl all'endpoint health. Status, modello, uptime.
Legge i messaggi inter-nodo non letti. Telegram relay, bridge, notifiche dai collaboratori.
Genera un report leggibile che l'AI coder riceve nel contesto iniziale della sessione.
Lo stato viene salvato in system_state.md per riferimento anche dopo la sessione.
Filosofia: System Awareness non e un dashboard da consultare. E un riflesso automatico: l'AI coder apre gli occhi e vede. Non serve chiedere, non serve navigare. Il contesto arriva prima della domanda.
Ogni scan produce dati strutturati. L'AI coder li riceve come testo nel contesto, pronti per ragionare.
| Cosa scansiona | Informazione | Esempio output |
|---|---|---|
| Git repos | branch, commit hash, dirty files, ahead/behind | THIA: c6160e3 main | dirty:2 |
| VPS / API | status, modello attivo, uptime | online | gemini-3-flash | 2h32m |
| Messaggi | canale, mittente, anteprima testo | 1 unread: [telegram-relay] Op->TM1: ... |
| Warning | anomalie, divergenze, problemi | 3 repos ahead of remote |
Mattina, apri il progetto. Il tuo AI coder ti saluta e dice:
Non hai detto nulla. Non hai fatto nessuna domanda. Lui sa gia tutto. Puoi iniziare a lavorare dal primo secondo.
Scarica il seed file. Contiene le istruzioni per configurare lo scan multi-repo automatico.
Copia SEED-system-awareness.md nella root del tuo progetto.
Il tuo AI coder legge il seed, genera lo script di scan, configura l'hook SessionStart, e inizia a scansionare.
# 1. Clone il repo d-nd-seed
git clone https://github.com/GrazianoGuiducci/d-nd-seed.git
cd d-nd-seed
./install.sh profiles/example.json
# 2. Oppure configura manualmente in .claude/settings.local.json
{
"hooks": {
"SessionStart": [
{
"matcher": "",
"hooks": [{
"type": "command",
"command": "bash .claude/hooks/system_awareness.sh"
}]
}
]
}
}
# 3. Crea lo script .claude/hooks/system_awareness.sh
#!/bin/bash
BASE_DIR="$(pwd)"
STATE_FILE=".claude/hooks/system_state.md"
echo "# System State - $(date)" > "$STATE_FILE"
# Scan git repos
for dir in */; do
if [ -d "$dir/.git" ]; then
cd "$dir"
BRANCH=$(git branch --show-current 2>/dev/null)
HASH=$(git rev-parse --short HEAD 2>/dev/null)
DIRTY=$(git status --porcelain | wc -l)
echo "$dir: $HASH $BRANCH | dirty:$DIRTY" >> "../$STATE_FILE"
cd "$BASE_DIR"
fi
done
# Check VPS health
HEALTH=$(curl -s --max-time 5 http://YOUR_VPS:3002/health)
echo "VPS: $HEALTH" >> "$STATE_FILE"
# Output to stdout (injected into context)
cat "$STATE_FILE"
# 4. Rendi eseguibile
chmod +x .claude/hooks/system_awareness.sh