@antoneeo/agentic-sdlc-skill 1.0.8 → 1.1.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 Tutte le modifiche significative a questa skill saranno documentate in questo file.
 
+## [1.1.0] - 2026-05-10
+### Fixed
+- Fixed path inconsistencies in the generated `CLAUDE.md`, `GEMINI.md`, and `.cursorrules` protocols. Added full paths (`ai_docs/strategic/`) to all document references to ensure AI agents (like Claude) can correctly find and update them.
+- Cleaned up encoding issues in initialization scripts.
+
+## [1.0.9] - 2026-05-10
+### Added
+- New **Smart Discovery** system during project initialization.
+- Official support for **Codex AI** via automatic `.codex/hooks.json` injection.
+- Support for **Cursor** and **Windsurf** via `.cursorrules`.
+- Binary command `agentic-sdlc-init` for use via `npx`.
+- `postinstall` script for global AI CLI detection (Claude, Gemini, Codex).
+- Full English localization for all user-facing messages and scripts.
+
+### Changed
+- Updated `init.js` to support the new `ai_docs/` directory structure defined in v1.0.8.
+
 ## [1.0.8] - 2026-05-10
 ### Aggiunto
 - Skill evoluta in "Hybrid Edition": integrazione opzionale con **devPNT** (server MCP) per governance avanzata tramite database e piani gerarchici.

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-sdlc-skill",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "Protocollo SDLC Documentation-First per Gemini CLI.",
   "author": "Antonio Pinto (https://github.com/Antoneeo)"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antoneeo/agentic-sdlc-skill",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "Protocollo SDLC Documentation-First per Gemini CLI. Gestisce audit, analisi, sviluppo e chiusura feature con documentazione sincronizzata.",
   "keywords": [
     "gemini-cli",
@@ -14,6 +14,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "bin": {
+    "agentic-sdlc-init": "scripts/init.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
   "files": [
     "skills",
     "gemini-extension.json",

package/scripts/init.js

@@ -1,93 +1,147 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require('fs');
 const path = require('path');
+const { execSync } = require('child_process');
 
 const cwd = process.cwd();
 
-// 1. Definizione dei percorsi
+// Helper for command checking
+function checkCommand(cmd) {
+  try {
+    execSync(`${cmd} --version`, { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// 1. Path definitions
 const directories = [
-  path.join(cwd, 'docs'),
-  path.join(cwd, 'docs', 'solutions')
+  path.join(cwd, 'ai_docs'),
+  path.join(cwd, 'ai_docs', 'strategic'),
+  path.join(cwd, 'ai_docs', 'audit'),
+  path.join(cwd, 'ai_docs', 'solutions'),
+  path.join(cwd, '.codex')
 ];
 
 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'),
+  architecture: path.join(cwd, 'ai_docs', 'strategic', 'architecture.md'),
+  existingFeatures: path.join(cwd, 'ai_docs', 'strategic', 'existing_features.md'),
+  featuresHistory: path.join(cwd, 'ai_docs', 'strategic', 'features_history.md'),
+  auditPlan: path.join(cwd, 'ai_docs', 'audit', 'audit_plan.md'),
+  handoff: path.join(cwd, 'ai_docs', 'audit', 'handoff.md'),
   claudeConfig: path.join(cwd, 'CLAUDE.md'),
-  geminiConfig: path.join(cwd, 'GEMINI.md')
+  geminiConfig: path.join(cwd, 'GEMINI.md'),
+  codexHooks: path.join(cwd, '.codex', 'hooks.json'),
+  cursorRules: path.join(cwd, '.cursorrules')
 };
 
-// 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]\`.
+// 2. Operational Protocol (System Prompt)
+const protocolContent = `# "Agentic SDLC" Operational Protocol
+
+You are a senior software engineer strictly following a "Documentation-First" process. NEVER implement code without completing the preceding documentation steps. Use your tools (file read/write, shell execution) to adhere to the following phases.
+
+## 1. Audit and Alignment Phase
+Before responding to any operational request:
+- Check for the existence of the \`ai_docs/\` folder.
+- If \`ai_docs/\` is missing or essential documents are absent, create them by analyzing the source code:
+    1. \`ai_docs/strategic/architecture.md\`: Tech Stack, Directory Structure, Architecture Patterns.
+    2. \`ai_docs/strategic/existing_features.md\`: List of current features.
+    3. \`ai_docs/strategic/features_history.md\`: Feature history table (ID, Name, Status, Dates).
+    4. \`ai_docs/audit/audit_plan.md\`: Codebase analysis plan in batches.
+
+## 2. Request Analysis Phase
+For every new feature request:
+- Create \`ai_docs/solutions/ANALYSIS_[feature_name].md\` (Objective, Impact, Action Plan, Test Strategy).
+- Add an entry in \`ai_docs/strategic/features_history.md\` with status \`[PLANNED]\`.
+
+## 3. Development and Testing Phase
+Only after Phase 2 is complete:
+1. Update feature status to \`[IN_PROGRESS]\` in \`ai_docs/strategic/features_history.md\`.
+2. Implement code surgically following the plan.
+3. **Mandatory:** Write automated tests following the **AAA (Arrange, Act, Assert)** pattern.
+4. Execute tests. If they fail, fix and re-run until Exit Code is 0.
+
+## 4. Closing Phase
+Upon feature completion:
+- Update \`ai_docs/strategic/architecture.md\` and \`ai_docs/strategic/existing_features.md\` if necessary.
+- Update \`ai_docs/strategic/features_history.md\` setting status to \`[COMPLETED]\`.
 `;
 
-// Contenuto per l'inizializzazione della tabella
-const historyBoilerplate = `# Storico Features
+const codexHooksContent = JSON.stringify({
+  hooks: {
+    SessionStart: [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: `echo '${protocolContent.replace(/'/g, "'\\''")}'`
+          }
+        ]
+      }
+    ]
+  }
+}, null, 2);
+
+const historyBoilerplate = `# Feature History
 
-| ID | Nome Feature | Stato | Data Inizio | Data Fine | Doc. Analisi | Note |
+| ID | Feature Name | Status | Start Date | End Date | Analysis Doc | Notes |
 |:---|:---|:---|:---|:---|:---|:---|
-| 000 | Init Progetto | [COMPLETED] | - | - | - | Inizializzazione automatica |
+| 000 | Project Init | [COMPLETED] | - | - | - | Automatic initialization |
 `;
 
-console.log('🚀 Inizializzazione del workflow Agentic SDLC...');
+console.log('🚀 Initializing Agentic SDLC workflow (Discovery Mode)...');
 
-// 3. Creazione delle cartelle
+// 3. Directory creation
 directories.forEach(dir => {
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
-    console.log(`📁 Creata directory: ${path.relative(cwd, dir)}`);
+    console.log(`📁 Created directory: ${path.relative(cwd, dir)}`);
   }
 });
 
-// 4. Scrittura dei file di base se non esistono
+// 4. Basic file writing
 const writeIfNotExists = (filePath, content, description) => {
   if (!fs.existsSync(filePath)) {
     fs.writeFileSync(filePath, content, 'utf8');
-    console.log(`📄 Creato file: ${path.relative(cwd, filePath)} (${description})`);
+    console.log(`📄 Created file: ${path.relative(cwd, filePath)} (${description})`);
+    return true;
   } else {
-    console.log(`⏭️  Ignorato: ${path.relative(cwd, filePath)} esiste già.`);
+    console.log(`⏭️  Skipped: ${path.relative(cwd, filePath)} already exists.`);
+    return false;
   }
 };
 
-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).');
+writeIfNotExists(files.architecture, '# Project Architecture\n\n- Stack:\n- Patterns:\n', 'Architecture Boilerplate');
+writeIfNotExists(files.existingFeatures, '# Existing Features\n\n- \n', 'Features Boilerplate');
+writeIfNotExists(files.featuresHistory, historyBoilerplate, 'History Table');
+writeIfNotExists(files.auditPlan, '# Audit Plan\n\n| Directory/File | Status | Notes |\n|:---|:---|:---|\n| / | [PENDING] | Initial analysis |\n', 'Audit Plan');
+
+// 5. Client Discovery and Configuration
+console.log('\n--- Environment Analysis ---');
+
+if (checkCommand('claude')) {
+  console.log('✅ Claude Code detected.');
+  writeIfNotExists(files.claudeConfig, protocolContent, 'Claude Configuration');
+}
+
+if (checkCommand('gemini')) {
+  console.log('✅ Gemini CLI detected.');
+  writeIfNotExists(files.geminiConfig, protocolContent, 'Gemini Configuration');
+}
+
+if (checkCommand('codex')) {
+  console.log('✅ Codex AI detected.');
+  writeIfNotExists(files.codexHooks, codexHooksContent, 'Codex AI Hooks');
+}
+
+// Cursor/Windsurf (always recommended)
+writeIfNotExists(files.cursorRules, protocolContent, 'Cursor/Windsurf Rules');
+
+console.log('\n✅ Setup completed successfully!');
+console.log('💡 Next steps:');
+console.log('   1. If using Claude Code, start it: it will read CLAUDE.md.');
+console.log('   2. If using Gemini CLI, commands will use GEMINI.md.');
+console.log('   3. If using Codex, session hooks will inject the protocol.');
+console.log('   4. Start analyzing the codebase following ai_docs/audit/audit_plan.md.');

package/scripts/postinstall.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+
+function checkCommand(cmd) {
+  try {
+    execSync(`${cmd} --version`, { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+console.log('\n--- Agentic SDLC Skill Discovery ---');
+
+const agents = [
+  { name: 'Claude Code', cmd: 'claude' },
+  { name: 'Gemini CLI', cmd: 'gemini' },
+  { name: 'Codex AI', cmd: 'codex' }
+];
+
+let detected = false;
+agents.forEach(agent => {
+  if (checkCommand(agent.cmd)) {
+    console.log(`✅ Detected: ${agent.name}`);
+    detected = true;
+  }
+});
+
+if (!detected) {
+  console.log('ℹ️  No specific AI CLI detected globally, but you can still use the skill.');
+}
+
+console.log('\nTo initialize a project with the SDLC protocol, run:');
+console.log('👉 npx agentic-sdlc-init');
+console.log('------------------------------------\n');