@antoneeo/agentic-sdlc-skill 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -1,8 +1,19 @@
 # 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.2] - 2026-05-10
+### Changed
+- README convertito in inglese per la pubblicazione npm.
+- Versione allineata a `1.2.2` in `package.json` e `gemini-extension.json`.
+
+## [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,61 +1,61 @@
-# 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).
-
-## Caratteristiche principali
-- **Documentation-First**: Obbliga alla creazione/aggiornamento della documentazione (`docs/`) prima di scrivere codice.
-- **Audit Automatico**: Analizza l'architettura e le feature esistenti.
-- **Workflow Tracciabile**: Gestisce lo stato delle feature in `features_history.md`.
-- **Qualità Garantita**: Integrazione nativa di analisi, sviluppo e test.
-
-## 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** → configurabile via `npx agentic-sdlc-init` nel progetto.
-
-`npm uninstall -g @antoneeo/agentic-sdlc-skill` rimuove anche la skill da `~/.claude/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.
-
-Per installare questa estensione, apri il terminale nella cartella che contiene questo README e digita:
-
-```bash
-gemini extensions install .
-```
-
-*Nota: Se ti trovi in una cartella diversa, sostituisci `.` con il percorso completo della cartella della skill.*
-
-## Disponibilità Globale
-Una volta completata l'installazione, la skill è **disponibile globalmente**. Puoi chiudere questa cartella e spostarti in **qualsiasi altro progetto** sul tuo PC: Gemini CLI riconoscerà automaticamente i comandi e il workflow della skill `agentic-sdlc`.
-
-## Come iniziare
-
-Una volta installata, avvia Gemini CLI e verifica che la skill sia presente:
-
-1. **Elenca le skill disponibili:**
-   ```bash
-   /skills list all
-   ```
-2. **Attiva la skill:**
-   La skill si attiva automaticamente quando rileva richieste relative a sviluppo, audit o gestione feature. Puoi anche richiamarla esplicitamente:
-   > "Usa la skill agentic-sdlc per analizzare questo progetto"
-
-## Struttura del Progetto
-- `skills/`: Contiene la logica della skill (`SKILL.md`).
-- `references/`: Template Markdown per architettura, analisi e storico feature.
-- `gemini-extension.json`: Manifesto dell'estensione.
-
----
-Realizzato da **Antonio Pinto** ([GitHub](https://github.com/Antoneeo))
-© 2026 Antonio Pinto. Tutti i diritti riservati.
+# Agentic SDLC Skill for Claude Code, Gemini CLI & Codex
+
+A "Documentation-First" SDLC protocol designed to manage the software development lifecycle rigorously. It natively supports **Claude Code** (skill auto-installed in `~/.claude/skills/`), **Gemini CLI** (extension), and **Codex AI** (skill auto-installed in `~/.codex/skills/`).
+
+## Key Features
+- **Documentation-First**: Requires documentation (`docs/`) to be created or updated before writing code.
+- **Automatic Audit**: Analyzes the existing architecture and features.
+- **Traceable Workflow**: Tracks feature status in `features_history.md`.
+- **Built-In Quality**: Native integration of analysis, development, and testing.
+
+## Installation
+
+### Via npm (recommended - installs for all detected CLIs)
+
+```bash
+npm install -g @antoneeo/agentic-sdlc-skill
+```
+
+The `postinstall` script automatically detects installed CLIs and configures each one:
+
+- **Claude Code**: copies the skill to `~/.claude/skills/agentic-sdlc/`. Restart Claude Code; invoke it through the `Skill` tool as `agentic-sdlc`, or let it trigger automatically from SDLC/audit prompts.
+- **Gemini CLI**: suggests `gemini extensions install` (see below).
+- **Codex AI**: copies the skill to `$CODEX_HOME/skills/agentic-sdlc/` or `~/.codex/skills/agentic-sdlc/`. Restart Codex to load it.
+
+`npm uninstall -g @antoneeo/agentic-sdlc-skill` also removes the skills from `~/.claude/skills/agentic-sdlc/` and `~/.codex/skills/agentic-sdlc/`.
+
+### Via Gemini CLI (local alternative)
+
+> **Tip:** Before installing, copy this folder from the USB drive to your computer's hard drive (for example, `C:\tools\agentic-sdlc-skill`). This keeps the skill available even after the USB drive is removed.
+
+To install this extension, open a terminal in the folder that contains this README and run:
+
+```bash
+gemini extensions install .
+```
+
+*Note: If you are in a different folder, replace `.` with the full path to the skill folder.*
+
+## Global Availability
+Once installation is complete, the skill is **globally available**. You can close this folder and move to **any other project** on your PC: Gemini CLI will automatically recognize the commands and workflow of the `agentic-sdlc` skill.
+
+## Getting Started
+
+After installation, start Gemini CLI and verify that the skill is available:
+
+1. **List available skills:**
+   ```bash
+   /skills list all
+   ```
+2. **Activate the skill:**
+   The skill activates automatically when it detects requests related to development, audits, or feature management. You can also invoke it explicitly:
+   > "Use the agentic-sdlc skill to analyze this project"
+
+## Project Structure
+- `skills/`: Contains the skill logic (`SKILL.md`).
+- `references/`: Markdown templates for architecture, analysis, and feature history.
+- `gemini-extension.json`: Extension manifest.
+
+---
+Created by **Antonio Pinto** ([GitHub](https://github.com/Antoneeo))
+(c) 2026 Antonio Pinto. All rights reserved.

package/gemini-extension.json

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

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.2",
+  "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');