@antoneeo/agentic-sdlc-skill 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,8 +1,14 @@
 # Changelog - Agentic SDLC Skill
 
-Tutte le modifiche significative a questa skill saranno documentate in questo file.
-
-## [1.2.0] - 2026-05-10
+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`.

package/README.md

@@ -1,6 +1,6 @@
 # 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. Supporta nativamente **Claude Code** (skill auto-installata in `~/.claude/skills/`), **Gemini CLI** (extension) e **Codex AI** (hooks).
+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.
@@ -20,9 +20,9 @@ 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** → configurabile via `npx agentic-sdlc-init` nel progetto.
-
-`npm uninstall -g @antoneeo/agentic-sdlc-skill` rimuove anche la skill da `~/.claude/skills/agentic-sdlc/`.
+- **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)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antoneeo/agentic-sdlc-skill",
-  "version": "1.2.0",
-  "description": "Protocollo SDLC Documentation-First per Claude Code, Gemini CLI e Codex. Auto-installa la skill nativa Claude Code in ~/.claude/skills/. 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",
@@ -32,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

@@ -5,10 +5,13 @@ 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 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 {
@@ -34,7 +37,7 @@ function copyRecursive(src, dest) {
   }
 }
 
-function installClaudeSkill() {
+function installClaudeSkill() {
   if (!fs.existsSync(SKILL_SOURCE)) {
     console.log(`⚠️  Skill source not found at ${SKILL_SOURCE}; skipping Claude Code install.`);
     return false;
@@ -49,16 +52,37 @@ function installClaudeSkill() {
     console.log(`⚠️  Failed to install Claude Code skill: ${err.message}`);
     console.log(`   Manual install: copy "${SKILL_SOURCE}" to "${CLAUDE_SKILL_TARGET}".`);
     return false;
-  }
-}
-
-console.log('\n--- Agentic SDLC Skill Discovery ---');
+  }
+}
+
+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', onDetect: installClaudeSkill },
-  { 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 => {
@@ -66,10 +90,16 @@ agents.forEach(agent => {
     console.log(`✅ Detected: ${agent.name}`);
     detected = true;
     if (typeof agent.onDetect === 'function') agent.onDetect();
-  }
-});
-
-if (!detected) {
+  }
+});
+
+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

@@ -2,15 +2,21 @@
 
 const fs = require('fs');
 const path = require('path');
-const os = require('os');
-
-const CLAUDE_SKILL_TARGET = path.join(os.homedir(), '.claude', 'skills', 'agentic-sdlc');
-
-if (fs.existsSync(CLAUDE_SKILL_TARGET)) {
-  try {
-    fs.rmSync(CLAUDE_SKILL_TARGET, { recursive: true, force: true });
-    console.log(`🧹 Removed Claude Code skill at: ${CLAUDE_SKILL_TARGET}`);
-  } catch (err) {
-    console.log(`⚠️  Could not remove ${CLAUDE_SKILL_TARGET}: ${err.message}`);
-  }
-}
+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');