@antoneeo/agentic-sdlc-skill 1.0.9 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 Tutte le modifiche significative a questa skill saranno documentate in questo file.
 
+## [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
+- 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.

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** (hooks).
 
 ## 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** → 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.
 

package/gemini-extension.json

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

package/package.json

@@ -1,8 +1,10 @@
 {
   "name": "@antoneeo/agentic-sdlc-skill",
-  "version": "1.0.9",
-  "description": "Protocollo SDLC Documentation-First per Gemini CLI. Gestisce audit, analisi, sviluppo e chiusura feature con documentazione sincronizzata.",
+  "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.",
   "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",

package/scripts/init.js

@@ -54,19 +54,19 @@ Before responding to any operational request:
 ## 2. Request Analysis Phase
 For every new feature request:
 - Create \`ai_docs/solutions/ANALYSIS_[feature_name].md\` (Objective, Impact, Action Plan, Test Strategy).
-- Add a entry in \`features_history.md\` with status \`[PLANNED]\`.
+- 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]\`.
+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 \`architecture.md\` and \`existing_features.md\` if necessary.
-- Update \`features_history.md\` setting status to \`[COMPLETED]\`.
+- 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]\`.
 `;
 
 const codexHooksContent = JSON.stringify({

package/scripts/postinstall.js

@@ -1,6 +1,14 @@
 #!/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');
 
 function checkCommand(cmd) {
   try {
@@ -11,10 +19,43 @@ function checkCommand(cmd) {
   }
 }
 
+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;
+  }
+}
+
 console.log('\n--- Agentic SDLC Skill Discovery ---');
 
 const agents = [
-  { name: 'Claude Code', cmd: 'claude' },
+  { name: 'Claude Code', cmd: 'claude', onDetect: installClaudeSkill },
   { name: 'Gemini CLI', cmd: 'gemini' },
   { name: 'Codex AI', cmd: 'codex' }
 ];
@@ -24,6 +65,7 @@ agents.forEach(agent => {
   if (checkCommand(agent.cmd)) {
     console.log(`✅ Detected: ${agent.name}`);
     detected = true;
+    if (typeof agent.onDetect === 'function') agent.onDetect();
   }
 });
 

package/scripts/preuninstall.js

@@ -0,0 +1,16 @@
+#!/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');
+
+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}`);
+  }
+}