timeline resize view

.claude/CLAUDE.md

@@ -14,6 +14,16 @@ Update when lesson learned. Update when:
 
 Do **not** add derivable-from-code things, generic best practices, or ephemeral task notes — durable knowledge only.
 
+## graphify
+
+This project has a graphify knowledge graph at graphify-out/.
+
+Rules:
+- Before answering architecture or codebase questions, read graphify-out/GRAPH_REPORT.md for god nodes and community structure
+- If graphify-out/wiki/index.md exists, navigate it instead of reading raw files
+- For cross-module "how does X relate to Y" questions, prefer `graphify query "<question>"`, `graphify path "<A>" "<B>"`, or `graphify explain "<concept>"` over grep — these traverse the graph's EXTRACTED + INFERRED edges instead of scanning files
+- After modifying code files in this session, run `graphify update .` to keep the graph current (AST-only, no API cost)
+
 ## Repository Layout
 
 **Monorepo with git submodules.** Each submodule independent repo with own `.claude/CLAUDE.md`.

docs/executive_assistant_scout.md

@@ -0,0 +1,33 @@
+### Gestione Agenti Autonomi
+
+L'utente deve avere la possibilità di creare degli *Executive Assistant Scout*. Questi agenti devono essere autonomi nella ricerca e nell'estrapolazione di:
+
+* **Task:** Creazione di attività che riguardano l'utente o modifica di quelle già presenti, con relative variazioni o inserimento di commenti. I task possono essere di competenza diretta dell'utente o di suo interesse (da assegnare quindi a un collaboratore, ma sempre afferenti al suo ruolo). 
+    > *Ad esempio: se l'utente è Project Manager (PM) di un progetto e c'è un task importante che deve essere svolto dalla risorsa "X", il sistema deve creare il task all'interno di quel progetto e assegnarlo a "X".*
+* **Eventi:** Tutte le fasi di un progetto, includendo attività (da data a data), milestone e checkpoint.
+* **Note:** Informazioni riguardanti un progetto (ad esempio, le decisioni prese o l'architettura della soluzione).
+* **Progetti:** L'insieme organizzato di task, eventi e note.
+
+#### Funzionamento e Limitazioni
+
+L'utente deve poter indicare una cartella (folder) di riferimento.
+
+Una volta indicata la cartella, l'*Scout* deve poterla esaminare per identificare le tipologie di file presenti, analizzarli e definire una strategia di estrazione per task, timeline, note e progetti, adattandola in base al formato dei file.
+
+Questa fase di configurazione deve avvenire in modo naturale per l'utente, similmente alla fase di on-boarding di OpenClaw. Una volta configurato, l'*Scout* dovrà procedere all'estrazione in totale autonomia. Idealmente, l'agente dovrebbe poter analizzare tutti i tipi di file.
+
+#### Frequenza e Tracciamento
+
+* **Sincronizzazione:** L'utente deve poter indicare la frequenza con cui l'*Scout* analizzerà i file. Nei cicli successivi, l'agente dovrà processare solamente le differenze (diff) rispetto al controllo precedente.
+* **Tracciabilità:** Per ogni elemento estratto, il sistema deve mantenere il riferimento al documento sorgente da cui è stato ricavato.
+
+---
+
+### Questioni Aperte e Valutazioni
+
+Per proseguire con la corretta implementazione, occorre definire i seguenti punti:
+
+* **Navigazione Note di Progetto:** È preferibile implementare una Wiki oppure generare un file indice per le note di progetto, in modo da permettere una facile navigazione all'AI tra le informazioni (es. decisioni, architettura)?
+* **Limiti di Sistema sulla Cartella (Folder):** Bisognerà stabilire come applicare dei limiti all'utente sulla cartella di riferimento. Quali parametri usiamo? Ad esempio: numero massimo di file, dimensione massima dei file, profondità e numero di sottocartelle, o limite complessivo di token utilizzabili per giorno o esecuzione?
+* **Gestione Consumo Token:** Consentendo all'agente di analizzare tutti i tipi di file, occorre considerare che il consumo di token potrebbe aumentare drasticamente (es. elaborando documenti PDF o Word molto pesanti). Come vogliamo gestire o limitare questo aspetto?
+* **Autonomia vs Controllo (Human-in-the-Loop):** Gli agenti devono essere completamente autonomi nella creazione di task, eventi e note a sistema, oppure dobbiamo prevedere l'implementazione di un meccanismo *Human-in-the-Loop* in cui l'utente riceve una proposta e deve approvarne preventivamente la creazione?