@antoneeo/agentic-sdlc-skill 1.1.0 → 1.2.1

package/CHANGELOG.md

@@ -1,6 +1,24 @@
 # Changelog - Agentic SDLC Skill
 
-Tutte le modifiche significative a questa skill saranno documentate in questo file.
+Tutte le modifiche significative a questa skill saranno documentate in questo file.
+
+## [1.2.1] - 2026-05-10
+### Fixed
+- `postinstall` ora registra la skill anche per Codex copiandola in `$CODEX_HOME/skills/agentic-sdlc/` oppure `~/.codex/skills/agentic-sdlc/`.
+- `preuninstall` rimuove anche la copia Codex della skill.
+- `agentic-sdlc-init` ora crea `AGENTS.md` per Codex invece di `.codex/hooks.json`, che Codex non carica come istruzioni di progetto.
+
+## [1.2.0] - 2026-05-10
+### Added
+- **Auto-installazione skill nativa Claude Code**: il `postinstall` ora copia `skills/agentic-sdlc-skill/` in `~/.claude/skills/agentic-sdlc/` quando rileva il CLI `claude`. La skill diventa disponibile come `agentic-sdlc` nel tool `Skill` di Claude Code dopo riavvio.
+- Nuovo script `preuninstall.js` che rimuove la skill da `~/.claude/skills/agentic-sdlc/` durante `npm uninstall`.
+- Fallback `copyRecursive` per Node < 16.7 (quando `fs.cpSync` non disponibile).
+
+### Changed
+- `package.json`: bump versione a 1.2.0, aggiunti keyword `claude-code` e `claude-skill`, descrizione aggiornata per riflettere supporto Claude Code nativo.
+
+### Fixed
+- Risolto bug per cui il pacchetto npm non registrava la skill in Claude Code (la cartella `~/.claude/skills/` non veniva mai popolata).
 
 ## [1.1.0] - 2026-05-10
 ### Fixed

package/README.md

@@ -1,6 +1,6 @@
-# Agentic SDLC Skill for Gemini CLI
+# Agentic SDLC Skill for Claude Code, Gemini CLI & Codex
 
-Protocollo SDLC "Documentation-First" progettato per gestire in modo rigoroso il ciclo di vita dello sviluppo software direttamente tramite Gemini CLI.
+Protocollo SDLC "Documentation-First" progettato per gestire in modo rigoroso il ciclo di vita dello sviluppo software. Supporta nativamente **Claude Code** (skill auto-installata in `~/.claude/skills/`), **Gemini CLI** (extension) e **Codex AI** (skill auto-installata in `~/.codex/skills/`).
 
 ## Caratteristiche principali
 - **Documentation-First**: Obbliga alla creazione/aggiornamento della documentazione (`docs/`) prima di scrivere codice.
@@ -8,7 +8,23 @@ Protocollo SDLC "Documentation-First" progettato per gestire in modo rigoroso il
 - **Workflow Tracciabile**: Gestisce lo stato delle feature in `features_history.md`.
 - **Qualità Garantita**: Integrazione nativa di analisi, sviluppo e test.
 
-## Installazione (da chiavetta USB o locale)
+## Installazione
+
+### Via npm (consigliato — installa per tutti i CLI rilevati)
+
+```bash
+npm install -g @antoneeo/agentic-sdlc-skill
+```
+
+Il `postinstall` rileva automaticamente i CLI installati e configura ciascuno:
+
+- **Claude Code** → copia la skill in `~/.claude/skills/agentic-sdlc/`. Riavvia Claude Code; invocala via tool `Skill` come `agentic-sdlc`, o lasciala triggerare automaticamente da prompt SDLC/audit.
+- **Gemini CLI** → suggerisce `gemini extensions install` (vedi sotto).
+- **Codex AI** → copia la skill in `$CODEX_HOME/skills/agentic-sdlc/` oppure `~/.codex/skills/agentic-sdlc/`. Riavvia Codex per caricarla.
+
+`npm uninstall -g @antoneeo/agentic-sdlc-skill` rimuove anche le skill da `~/.claude/skills/agentic-sdlc/` e `~/.codex/skills/agentic-sdlc/`.
+
+### Via Gemini CLI (alternativa locale)
 
 > **Consiglio:** Prima di installare, copia questa cartella dalla chiavetta USB sul disco fisso del tuo computer (es. in `C:\tools\agentic-sdlc-skill`). In questo modo la skill rimarrà sempre disponibile anche dopo aver rimosso la chiavetta.
 

package/package.json

@@ -1,8 +1,10 @@
 {
   "name": "@antoneeo/agentic-sdlc-skill",
-  "version": "1.1.0",
-  "description": "Protocollo SDLC Documentation-First per Gemini CLI. Gestisce audit, analisi, sviluppo e chiusura feature con documentazione sincronizzata.",
+  "version": "1.2.1",
+  "description": "Protocollo SDLC Documentation-First per Claude Code, Gemini CLI e Codex. Auto-installa le skill native in ~/.claude/skills/ e ~/.codex/skills/. Gestisce audit, analisi, sviluppo e chiusura feature con documentazione sincronizzata.",
   "keywords": [
+    "claude-code",
+    "claude-skill",
     "gemini-cli",
     "skill",
     "sdlc",
@@ -18,7 +20,8 @@
     "agentic-sdlc-init": "scripts/init.js"
   },
   "scripts": {
-    "postinstall": "node scripts/postinstall.js"
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js"
   },
   "files": [
     "skills",
@@ -29,4 +32,4 @@
     "assets",
     "scripts"
   ]
-}
+}

package/scripts/init.js

@@ -18,24 +18,23 @@ function checkCommand(cmd) {
 
 // 1. Path definitions
 const directories = [
-  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')
-];
+  path.join(cwd, 'ai_docs'),
+  path.join(cwd, 'ai_docs', 'strategic'),
+  path.join(cwd, 'ai_docs', 'audit'),
+  path.join(cwd, 'ai_docs', 'solutions')
+];
 
 const files = {
   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'),
-  codexHooks: path.join(cwd, '.codex', 'hooks.json'),
-  cursorRules: path.join(cwd, '.cursorrules')
-};
+  handoff: path.join(cwd, 'ai_docs', 'audit', 'handoff.md'),
+  claudeConfig: path.join(cwd, 'CLAUDE.md'),
+  geminiConfig: path.join(cwd, 'GEMINI.md'),
+  codexAgents: path.join(cwd, 'AGENTS.md'),
+  cursorRules: path.join(cwd, '.cursorrules')
+};
 
 // 2. Operational Protocol (System Prompt)
 const protocolContent = `# "Agentic SDLC" Operational Protocol
@@ -69,22 +68,7 @@ Upon feature completion:
 - Update \`ai_docs/strategic/features_history.md\` setting status to \`[COMPLETED]\`.
 `;
 
-const codexHooksContent = JSON.stringify({
-  hooks: {
-    SessionStart: [
-      {
-        hooks: [
-          {
-            type: "command",
-            command: `echo '${protocolContent.replace(/'/g, "'\\''")}'`
-          }
-        ]
-      }
-    ]
-  }
-}, null, 2);
-
-const historyBoilerplate = `# Feature History
+const historyBoilerplate = `# Feature History
 
 | ID | Feature Name | Status | Start Date | End Date | Analysis Doc | Notes |
 |:---|:---|:---|:---|:---|:---|:---|
@@ -131,17 +115,17 @@ if (checkCommand('gemini')) {
   writeIfNotExists(files.geminiConfig, protocolContent, 'Gemini Configuration');
 }
 
-if (checkCommand('codex')) {
-  console.log('✅ Codex AI detected.');
-  writeIfNotExists(files.codexHooks, codexHooksContent, 'Codex AI Hooks');
-}
+if (checkCommand('codex')) {
+  console.log('✅ Codex AI detected.');
+  writeIfNotExists(files.codexAgents, protocolContent, 'Codex AGENTS.md');
+}
 
 // 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.');
+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, restart/open the project so it reads AGENTS.md.');
+console.log('   4. Start analyzing the codebase following ai_docs/audit/audit_plan.md.');

package/scripts/postinstall.js

@@ -1,6 +1,17 @@
 #!/usr/bin/env node
 
 const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const SKILL_SOURCE = path.join(PACKAGE_ROOT, 'skills', 'agentic-sdlc-skill');
+const CLAUDE_SKILLS_DIR = path.join(os.homedir(), '.claude', 'skills');
+const CLAUDE_SKILL_TARGET = path.join(CLAUDE_SKILLS_DIR, 'agentic-sdlc');
+const CODEX_HOME = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+const CODEX_SKILLS_DIR = path.join(CODEX_HOME, 'skills');
+const CODEX_SKILL_TARGET = path.join(CODEX_SKILLS_DIR, 'agentic-sdlc');
 
 function checkCommand(cmd) {
   try {
@@ -11,23 +22,84 @@ function checkCommand(cmd) {
   }
 }
 
-console.log('\n--- Agentic SDLC Skill Discovery ---');
+function copyRecursive(src, dest) {
+  if (typeof fs.cpSync === 'function') {
+    fs.cpSync(src, dest, { recursive: true, force: true });
+    return;
+  }
+  // Fallback for Node < 16.7
+  if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, entry.name);
+    if (entry.isDirectory()) copyRecursive(s, d);
+    else fs.copyFileSync(s, d);
+  }
+}
+
+function installClaudeSkill() {
+  if (!fs.existsSync(SKILL_SOURCE)) {
+    console.log(`⚠️  Skill source not found at ${SKILL_SOURCE}; skipping Claude Code install.`);
+    return false;
+  }
+  try {
+    fs.mkdirSync(CLAUDE_SKILLS_DIR, { recursive: true });
+    copyRecursive(SKILL_SOURCE, CLAUDE_SKILL_TARGET);
+    console.log(`📦 Installed Claude Code skill at: ${CLAUDE_SKILL_TARGET}`);
+    console.log('   Restart Claude Code to load it. Invoke via Skill tool as "agentic-sdlc".');
+    return true;
+  } catch (err) {
+    console.log(`⚠️  Failed to install Claude Code skill: ${err.message}`);
+    console.log(`   Manual install: copy "${SKILL_SOURCE}" to "${CLAUDE_SKILL_TARGET}".`);
+    return false;
+  }
+}
+
+function installCodexSkill() {
+  if (!fs.existsSync(SKILL_SOURCE)) {
+    console.log(`⚠️  Skill source not found at ${SKILL_SOURCE}; skipping Codex install.`);
+    return false;
+  }
+  try {
+    fs.mkdirSync(CODEX_SKILLS_DIR, { recursive: true });
+    copyRecursive(SKILL_SOURCE, CODEX_SKILL_TARGET);
+    console.log(`📦 Installed Codex skill at: ${CODEX_SKILL_TARGET}`);
+    console.log('   Restart Codex to load it. Invoke it as "$agentic-sdlc" or by asking for Agentic SDLC.');
+    return true;
+  } catch (err) {
+    console.log(`⚠️  Failed to install Codex skill: ${err.message}`);
+    console.log(`   Manual install: copy "${SKILL_SOURCE}" to "${CODEX_SKILL_TARGET}".`);
+    return false;
+  }
+}
+
+function hasCodexHome() {
+  return Boolean(process.env.CODEX_HOME) || fs.existsSync(CODEX_HOME);
+}
+
+console.log('\n--- Agentic SDLC Skill Discovery ---');
 
-const agents = [
-  { name: 'Claude Code', cmd: 'claude' },
-  { name: 'Gemini CLI', cmd: 'gemini' },
-  { name: 'Codex AI', cmd: 'codex' }
-];
+const agents = [
+  { name: 'Claude Code', cmd: 'claude', onDetect: installClaudeSkill },
+  { name: 'Gemini CLI', cmd: 'gemini' }
+];
 
 let detected = false;
 agents.forEach(agent => {
   if (checkCommand(agent.cmd)) {
     console.log(`✅ Detected: ${agent.name}`);
     detected = true;
-  }
-});
-
-if (!detected) {
+    if (typeof agent.onDetect === 'function') agent.onDetect();
+  }
+});
+
+if (checkCommand('codex') || hasCodexHome()) {
+  console.log(`✅ Detected: Codex AI`);
+  detected = true;
+  installCodexSkill();
+}
+
+if (!detected) {
   console.log('ℹ️  No specific AI CLI detected globally, but you can still use the skill.');
 }
 

package/scripts/preuninstall.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CLAUDE_SKILL_TARGET = path.join(os.homedir(), '.claude', 'skills', 'agentic-sdlc');
+const CODEX_HOME = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+const CODEX_SKILL_TARGET = path.join(CODEX_HOME, 'skills', 'agentic-sdlc');
+
+function removeSkill(target, label) {
+  if (!fs.existsSync(target)) return;
+  try {
+    fs.rmSync(target, { recursive: true, force: true });
+    console.log(`🧹 Removed ${label} skill at: ${target}`);
+  } catch (err) {
+    console.log(`⚠️  Could not remove ${target}: ${err.message}`);
+  }
+}
+
+removeSkill(CLAUDE_SKILL_TARGET, 'Claude Code');
+removeSkill(CODEX_SKILL_TARGET, 'Codex');