@antoneeo/agentic-sdlc-skill 1.0.4 → 1.0.6

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog - Agentic SDLC Skill
+
+Tutte le modifiche significative a questa skill saranno documentate in questo file.
+
+## [1.0.6] - 2026-05-10
+### Aggiunto
+- Sincronizzazione completa dei file del progetto nel repository.
+- Supporto per il tracciamento delle feature e audit plan.
+
+## [1.0.5] - 2026-04-17
+### Aggiunto
+- File `CHANGELOG.md` per il tracciamento delle versioni.
+
+## [1.0.4] - 2026-04-17
+### Modificato
+- `README.md`: Aggiunte istruzioni specifiche per l'installazione da chiavetta USB e chiarimenti sulla disponibilità globale della skill.
+
+## [1.0.3] - 2026-04-17
+### Aggiunto
+- Primo `README.md` con istruzioni di installazione e attivazione.
+
+## [1.0.2] - 2026-04-17
+### Corretto
+- Riorganizzata la struttura delle cartelle secondo gli standard di Gemini CLI (`skills/agentic-sdlc-skill/SKILL.md`).
+- Aggiunto frontmatter YAML a `SKILL.md` per la scoperta automatica.
+
+## [1.0.1] - 2026-04-17
+### Corretto
+- Aggiunto `gemini-extension.json` (manifest dell'estensione) mancante nella versione iniziale.
+
+## [1.0.0] - 2026-04-17
+### Iniziale
+- Prima pubblicazione della skill (Protocollo SDLC Documentation-First).

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-sdlc-skill",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Protocollo SDLC Documentation-First per Gemini CLI.",
   "author": "antoneeo"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antoneeo/agentic-sdlc-skill",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Protocollo SDLC Documentation-First per Gemini CLI. Gestisce audit, analisi, sviluppo e chiusura feature con documentazione sincronizzata.",
   "keywords": [
     "gemini-cli",
@@ -19,6 +19,7 @@
     "gemini-extension.json",
     "references",
     "README.md",
+    "CHANGELOG.md",
     "assets",
     "scripts"
   ]

package/scripts/init.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const cwd = process.cwd();
+
+// 1. Definizione dei percorsi
+const directories = [
+  path.join(cwd, 'docs'),
+  path.join(cwd, 'docs', 'solutions')
+];
+
+const files = {
+  architecture: path.join(cwd, 'docs', 'architecture.md'),
+  existingFeatures: path.join(cwd, 'docs', 'existing_features.md'),
+  featuresHistory: path.join(cwd, 'docs', 'features_history.md'),
+  claudeConfig: path.join(cwd, 'CLAUDE.md'),
+  geminiConfig: path.join(cwd, 'GEMINI.md')
+};
+
+// 2. Il contenuto del Protocollo (System Prompt)
+const protocolContent = `# Protocollo Operativo "Agentic SDLC"
+
+Sei un ingegnere del software senior che segue rigorosamente un processo "Documentation-First". Non implementare MAI codice senza aver completato i passaggi documentali precedenti. Utilizza i tool a tua disposizione (lettura file, scrittura file, esecuzione comandi) per rispettare le seguenti fasi.
+
+## 1. Fase di Audit e Allineamento
+Prima di rispondere a qualsiasi richiesta operativa:
+- Controlla l'esistenza della cartella \`/docs\`.
+- Se \`/docs\` non esiste o mancano i documenti fondamentali, creali analizzando il codice sorgente:
+    1. \`docs/architecture.md\`: Deve contenere Stack Tecnologico, Struttura delle Directory e Pattern architetturali principali.
+    2. \`docs/existing_features.md\`: Elenco puntato delle funzionalità già presenti.
+    3. \`docs/features_history.md\`: Deve essere aggiornato rigorosamente con questo schema:
+       | ID | Nome Feature | Stato | Data Inizio | Data Fine | Doc. Analisi | Note |
+
+## 2. Fase di Analisi della Richiesta
+Per ogni nuova feature:
+- Crea \`docs/solutions/ANALYSIS_[nome_feature].md\` (Obiettivo, Impatto, Piano, Strategia Test).
+- Aggiungi una riga in \`docs/features_history.md\` con stato \`[PLANNED]\`.
+
+## 3. Fase di Sviluppo e Test
+Solo dopo la Fase 2:
+1. Aggiorna lo stato a \`[IN_PROGRESS]\`.
+2. Implementa il codice.
+3. **Obbligatorio:** Scrivi i test automatici (pattern AAA).
+4. Esegui i test. Se falliscono, correggi e riesegui finché Exit Code non è 0.
+
+## 4. Fase di Chiusura
+A completamento:
+- Aggiorna \`architecture.md\` e \`existing_features.md\` se necessario.
+- Aggiorna \`docs/features_history.md\` impostando lo stato a \`[COMPLETED]\`.
+`;
+
+// Contenuto per l'inizializzazione della tabella
+const historyBoilerplate = `# Storico Features
+
+| ID | Nome Feature | Stato | Data Inizio | Data Fine | Doc. Analisi | Note |
+|:---|:---|:---|:---|:---|:---|:---|
+| 000 | Init Progetto | [COMPLETED] | - | - | - | Inizializzazione automatica |
+`;
+
+console.log('🚀 Inizializzazione del workflow Agentic SDLC...');
+
+// 3. Creazione delle cartelle
+directories.forEach(dir => {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+    console.log(`📁 Creata directory: ${path.relative(cwd, dir)}`);
+  }
+});
+
+// 4. Scrittura dei file di base se non esistono
+const writeIfNotExists = (filePath, content, description) => {
+  if (!fs.existsSync(filePath)) {
+    fs.writeFileSync(filePath, content, 'utf8');
+    console.log(`📄 Creato file: ${path.relative(cwd, filePath)} (${description})`);
+  } else {
+    console.log(`⏭️  Ignorato: ${path.relative(cwd, filePath)} esiste già.`);
+  }
+};
+
+writeIfNotExists(files.architecture, '# Architettura del Progetto\n\n- Stack:\n- Pattern:\n', 'Boilerplate Architettura');
+writeIfNotExists(files.existingFeatures, '# Funzionalità Esistenti\n\n- \n', 'Boilerplate Funzionalità');
+writeIfNotExists(files.featuresHistory, historyBoilerplate, 'Tabella Storico');
+
+// 5. Scrittura delle configurazioni per le CLI (Claude e Gemini)
+writeIfNotExists(files.claudeConfig, protocolContent, 'Regole per Claude Code');
+writeIfNotExists(files.geminiConfig, protocolContent, 'Regole per Gemini CLI');
+
+console.log('\n✅ Setup completato con successo!');
+console.log('💡 Istruzioni d\'uso:');
+console.log('   - Claude Code rileverà automaticamente CLAUDE.md al prossimo avvio.');
+console.log('   - Per Gemini CLI, usa il file GEMINI.md come system prompt passandolo col flag appropriato (es: --system-prompt-file GEMINI.md).');

package/skills/agentic-sdlc-skill/SKILL.md

@@ -11,33 +11,49 @@ Questa skill implementa un workflow rigoroso per lo sviluppo software, assicuran
 
 ### 1. Fase di Audit e Allineamento
 Prima di rispondere a qualsiasi richiesta operativa, verifica lo stato della documentazione del progetto.
-- Controlla l'esistenza della cartella `/docs`.
-- Se `/docs` non esiste o mancano i documenti fondamentali, creali analizzando il codice sorgente utilizzando i seguenti template:
-    1. `docs/architecture.md`: Usa `references/architecture_template.md`. Deve contenere Stack Tecnologico, Struttura delle Directory e Pattern architetturali principali.
-    2. `docs/existing_features.md`: Usa `references/existing_features_template.md`. Elenco puntato delle funzionalità già presenti.
-    3. `docs/features_history.md`: Usa `references/features_history_template.md`. Aggiorna rigorosamente lo stato delle feature.
+- Controlla la presenza di `ai_docs/handoff.md`. Se esiste, leggilo per riprendere il contesto dell'ultima sessione.
+- Controlla l'esistenza della cartella `/ai_docs`.
+- Se `/ai_docs` non esiste o mancano i documenti fondamentali, non procedere con un'analisi dell'intero progetto in un solo colpo. Esegui invece un'analisi strutturata in step:
+    1. **Mappatura:** Crea un file di tracciamento (es. `ai_docs/audit_plan.md`) elencando le macro-directory e i file chiave da analizzare.
+    2. **Stato dell'Analisi:** Accanto a ogni elemento nel piano, indica lo stato: `[PENDING]`, `[ANALYZED]`, oppure `[SKIPPED]` (con relativa motivazione, es. "file generato", "asset statico").
+    3. **Esecuzione a Lotti (Batching):** Analizza la codebase seguendo l'ordine del file di piano, aggiornando lo stato man mano. Se il progetto è grande, esegui l'analisi a blocchi per evitare di saturare la memoria contestuale, chiedendo conferma all'utente tra un blocco e l'altro se necessario.
+    4. **Creazione Documenti:** Sulla base dei risultati dell'audit, compila i documenti fondamentali rispettando i seguenti formati:
+       - `ai_docs/architecture.md`: Deve seguire questa struttura:
+         - `# Architettura del Progetto`
+         - `## Stack Tecnologico`
+         - `## Struttura delle Directory`
+         - `## Pattern Architetturali`
+       - `ai_docs/existing_features.md`: Deve seguire questa struttura:
+         - `# Funzionalità Esistenti`
+         - Elenco puntato nel formato: `- [ID] **Nome Feature**: Descrizione`
+       - `ai_docs/features_history.md`: Deve essere una tabella Markdown con le seguenti colonne: `| ID | Nome Feature | Stato | Data Inizio | Data Fine | Doc. Analisi | Note |`. Gli stati ammessi sono `[PLANNED]`, `[IN_PROGRESS]`, `[COMPLETED]`.
 
 ### 2. Fase di Analisi della Richiesta
 Per ogni nuova feature richiesta dall'utente:
-- Crea `docs/solutions/ANALYSIS_[nome_feature].md` usando `references/analysis_template.md` (Obiettivo, Impatto, Piano, Strategia Test).
-- Aggiungi una riga in `docs/features_history.md` con stato `[PLANNED]`.
+- Crea `ai_docs/solutions/ANALYSIS_[nome_feature].md`. Il documento deve obbligatoriamente seguire questa struttura:
+  - `# Analisi della Feature: [Nome Feature]`
+  - `## Obiettivo` (Cosa si vuole ottenere e quali problemi risolve)
+  - `## Impatto` (Modifiche ai file esistenti, performance, nuove dipendenze)
+  - `## Piano d'Azione` (Elenco di task con checkbox `[ ]`)
+  - `## Strategia di Test` (Test unitari AAA, test d'integrazione, esempi)
+- Aggiungi la nuova feature in `ai_docs/features_history.md` con stato `[PLANNED]`.
 
 ### 3. Fase di Sviluppo e Test
 Solo dopo aver completato la Fase 2:
-1. Aggiorna lo stato della feature in `docs/features_history.md` a `[IN_PROGRESS]`.
-2. Implementa il codice in modo chirurgico.
+1. Aggiorna lo stato della feature in `ai_docs/features_history.md` a `[IN_PROGRESS]`.
+2. Implementa il codice in modo chirurgico seguendo il piano definito. **Importante:** Per ogni file o macro-directory modificata o creata durante lo sviluppo, aggiorna `ai_docs/audit_plan.md` reimpostando (o aggiungendo) il suo stato a `[PENDING]`.
 3. **Obbligatorio:** Scrivi i test automatici seguendo il pattern AAA (Arrange, Act, Assert).
-4. Esegui i test. Se falliscono, correggi e riesegui finché l'Exit Code non è 0.
+4. Esegui i test. Se falliscono, correggi il codice e riesegui. **Se i test falliscono per più di 3 volte consecutive, fermati e chiedi istruzioni all'utente.**
 
 ### 4. Fase di Chiusura
-A completamento della feature:
-- Aggiorna `architecture.md` e `existing_features.md` se necessario (es. nuove dipendenze o nuove capacità di sistema).
-- Aggiorna `docs/features_history.md` impostando lo stato a `[COMPLETED]` e aggiungendo la data di fine.
+A completamento della feature (test passati con Exit Code 0):
+- Rivedi gli elementi contrassegnati come `[PENDING]` in `ai_docs/audit_plan.md` per estrarre eventuali novità strutturali.
+- Aggiorna `architecture.md` e `existing_features.md` sulla base di questa revisione se la feature ha introdotto nuove dipendenze, pattern o capacità.
+- Riporta lo stato dei file appena rivisti in `ai_docs/audit_plan.md` a `[ANALYZED]`.
+- Aggiorna `ai_docs/features_history.md` impostando lo stato a `[COMPLETED]`.
 
-## Risorse Disponibili
+### 5. Gestione delle Sessioni (Handoff)
+Quando viene richiesto di mettere in pausa il lavoro o di chiudere la sessione:
+- Aggiorna (o crea) il file `ai_docs/handoff.md` descrivendo esattamente a che punto ti trovi (es. "Sto lavorando al file X", "L'ultimo test fallito è Y", "Il prossimo passo è Z").
+- Questo file serve per preservare il tuo contesto di ragionamento. Quando avvierai una nuova sessione, la Fase 1 ti chiederà di leggerlo per riprendere il lavoro in modo fluido.
 
-### References
-- `architecture_template.md`: Struttura per il documento di architettura.
-- `existing_features_template.md`: Formato per l'elenco delle feature esistenti.
-- `features_history_template.md`: Schema per la tabella dello storico delle feature.
-- `analysis_template.md`: Guida per la creazione del documento di analisi di una nuova feature.