Self-Improving Agent (With Self-Reflection)

• Correggi frequentemente gli stessi errori dell'agente e vuoi che quelle correzioni rimangano valide tra una sessione e l'altra.
• Lavori su progetti ricorrenti o in domini specifici (codice, scrittura, comunicazioni) dove uno stile coerente e le preferenze personali sono importanti.
• Vuoi un agente che verifichi autonomamente i propri output dopo attività multi-step e registri automaticamente le lezioni apprese.
• La conoscenza dovrebbe accumularsi nel tempo — preferisci costruire un profilo di preferenze dinamico piuttosto che rispiegare il contesto a ogni sessione.

• Hai bisogno di memoria solo per una singola sessione o un'attività occasionale — questa skill è progettata per un apprendimento persistente e a lungo termine.
• Hai bisogno che l'agente apprenda dall'osservazione passiva o dal silenzio; questa skill registra solo correzioni esplicite e preferenze dichiarate.
• Ti trovi in un ambiente in cui la scrittura di file locali in ~/self-improving/ non è consentita o possibile.

La memoria è suddivisa in tre livelli: memory.md (HOT, ≤100 righe, sempre caricato), file per progetto e per dominio (WARM, caricati in base alla corrispondenza del contesto) e un archivio (COLD, caricato su richiesta esplicita). Questo mantiene le conoscenze più rilevanti nel contesto senza superare i limiti.

I pattern utilizzati 3 volte in 7 giorni vengono automaticamente promossi allo storage HOT. I pattern inutilizzati decadono a WARM dopo 30 giorni e vengono archiviati in COLD dopo 90 giorni. Nulla viene eliminato senza un'esplicita conferma da parte dell'utente.

Dopo aver completato attività multi-fase, ricevuto feedback o corretto bug, l'agente di Self-Improving Agent (With Self-Reflection) si ferma a valutare: il risultato ha soddisfatto l'intento, cosa si potrebbe migliorare e si tratta di uno schema ripetibile? Le lezioni vengono registrate in un formato strutturato e promosse secondo le stesse regole delle correzioni degli utenti.

L'agente riconosce i segnali di correzione ("No, è sbagliato", "Te l'ho già detto…", "Smetti di fare X") e i segnali di preferenza ("Mi piace quando…", "Fai sempre X") e li instrada automaticamente al livello di memoria corretto. Le istruzioni occasionali o specifiche per un determinato contesto vengono intenzionalmente ignorate.

I pattern specifici del progetto rimangono in projects/{name}.md, le preferenze globali in HOT, e i pattern di dominio (codice, scrittura) in domains/. Quando i pattern sono in conflitto, vince la regola più specifica e più recente — con una richiesta di chiarimento all'utente se rimane ambiguità.

Ogni azione proveniente dalla memoria cita il file e la riga corrispondente (ad es., "Utilizzo X (da projects/foo.md:12)"). Un riepilogo settimanale dei pattern appresi, retrocessi e archiviati è disponibile su richiesta. La skill non memorizza mai credenziali, dati sanitari o informazioni di terze parti, e non legge mai file al di fuori di ~/self-improving/.

Uno sviluppatore corregge una volta le scelte di formattazione o architettura dell'agente. L'agente registra la correzione in corrections.md, e dopo la terza ricorrenza la promuove in domains/code.md. Le sessioni future applicano la regola automaticamente senza promemoria.

Per un progetto di più settimane, l'agente memorizza convenzioni, decisioni sui nomi e preferenze di flusso di lavoro in projects/{name}.md. Ogni sessione carica quel file di livello intermedio quando viene menzionato il progetto, mantenendo l'agente costantemente allineato con le regole del progetto.

Dopo aver generato una funzionalità su più file o un documento lungo, Self-Improving Agent (With Self-Reflection) riflette su se la spaziatura, la struttura o il tono avrebbero potuto essere migliori, registra una lezione appresa e la applica la volta successiva in cui viene attivata un'attività simile — senza che l'utente debba segnalare lo stesso problema due volte.

Un utente dichiara "Preferisco risposte concise senza preamboli." L'agente registra questa come una preferenza HOT globale e la cita in ogni risposta, assicurando che lo stile venga mantenuto in tutte le conversazioni future senza dover ripetere la preferenza.