From c16e68f0d0424e77d088055569a728e48478c2ce Mon Sep 17 00:00:00 2001 From: Roberto Date: Wed, 29 Apr 2026 23:13:49 +0200 Subject: [PATCH] timeline resize view --- .claude/CLAUDE.md | 10 ++++++++++ adiuvAI | 2 +- docs/executive_assistant_scout.md | 33 +++++++++++++++++++++++++++++++ 3 files changed, 44 insertions(+), 1 deletion(-) create mode 100644 docs/executive_assistant_scout.md diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 9c715fd..1a7fbe1 100644 --- a/.claude/CLAUDE.md +++ b/.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 ""`, `graphify path "" ""`, or `graphify explain ""` 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`. diff --git a/adiuvAI b/adiuvAI index 1f4adfc..d0b344b 160000 --- a/adiuvAI +++ b/adiuvAI @@ -1 +1 @@ -Subproject commit 1f4adfca900cb2289c5b345106afca68f9241c24 +Subproject commit d0b344beece9eb22f787bdc1ee7c46f302515fb5 diff --git a/docs/executive_assistant_scout.md b/docs/executive_assistant_scout.md new file mode 100644 index 0000000..314c94e --- /dev/null +++ b/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? \ No newline at end of file