@antoneeo/agentic-sdlc-skill 1.2.1 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/README.md +61 -61
  3. package/gemini-extension.json +2 -2
  4. package/package.json +3 -3
  5. package/skills/agentic-sdlc-skill/SKILL.md +13 -0
package/CHANGELOG.md CHANGED
@@ -2,6 +2,11 @@
2
2
 
3
3
  Tutte le modifiche significative a questa skill saranno documentate in questo file.
4
4
 
5
+ ## [1.2.2] - 2026-05-10
6
+ ### Changed
7
+ - README convertito in inglese per la pubblicazione npm.
8
+ - Versione allineata a `1.2.2` in `package.json` e `gemini-extension.json`.
9
+
5
10
  ## [1.2.1] - 2026-05-10
6
11
  ### Fixed
7
12
  - `postinstall` ora registra la skill anche per Codex copiandola in `$CODEX_HOME/skills/agentic-sdlc/` oppure `~/.codex/skills/agentic-sdlc/`.
package/README.md CHANGED
@@ -1,61 +1,61 @@
1
- # Agentic SDLC Skill for Claude Code, Gemini CLI & Codex
2
-
3
- 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/`).
4
-
5
- ## Caratteristiche principali
6
- - **Documentation-First**: Obbliga alla creazione/aggiornamento della documentazione (`docs/`) prima di scrivere codice.
7
- - **Audit Automatico**: Analizza l'architettura e le feature esistenti.
8
- - **Workflow Tracciabile**: Gestisce lo stato delle feature in `features_history.md`.
9
- - **Qualità Garantita**: Integrazione nativa di analisi, sviluppo e test.
10
-
11
- ## Installazione
12
-
13
- ### Via npm (consigliato — installa per tutti i CLI rilevati)
14
-
15
- ```bash
16
- npm install -g @antoneeo/agentic-sdlc-skill
17
- ```
18
-
19
- Il `postinstall` rileva automaticamente i CLI installati e configura ciascuno:
20
-
21
- - **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.
22
- - **Gemini CLI** → suggerisce `gemini extensions install` (vedi sotto).
23
- - **Codex AI** → copia la skill in `$CODEX_HOME/skills/agentic-sdlc/` oppure `~/.codex/skills/agentic-sdlc/`. Riavvia Codex per caricarla.
24
-
25
- `npm uninstall -g @antoneeo/agentic-sdlc-skill` rimuove anche le skill da `~/.claude/skills/agentic-sdlc/` e `~/.codex/skills/agentic-sdlc/`.
26
-
27
- ### Via Gemini CLI (alternativa locale)
28
-
29
- > **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.
30
-
31
- Per installare questa estensione, apri il terminale nella cartella che contiene questo README e digita:
32
-
33
- ```bash
34
- gemini extensions install .
35
- ```
36
-
37
- *Nota: Se ti trovi in una cartella diversa, sostituisci `.` con il percorso completo della cartella della skill.*
38
-
39
- ## Disponibilità Globale
40
- 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`.
41
-
42
- ## Come iniziare
43
-
44
- Una volta installata, avvia Gemini CLI e verifica che la skill sia presente:
45
-
46
- 1. **Elenca le skill disponibili:**
47
- ```bash
48
- /skills list all
49
- ```
50
- 2. **Attiva la skill:**
51
- La skill si attiva automaticamente quando rileva richieste relative a sviluppo, audit o gestione feature. Puoi anche richiamarla esplicitamente:
52
- > "Usa la skill agentic-sdlc per analizzare questo progetto"
53
-
54
- ## Struttura del Progetto
55
- - `skills/`: Contiene la logica della skill (`SKILL.md`).
56
- - `references/`: Template Markdown per architettura, analisi e storico feature.
57
- - `gemini-extension.json`: Manifesto dell'estensione.
58
-
59
- ---
60
- Realizzato da **Antonio Pinto** ([GitHub](https://github.com/Antoneeo))
61
- © 2026 Antonio Pinto. Tutti i diritti riservati.
1
+ # Agentic SDLC Skill for Claude Code, Gemini CLI & Codex
2
+
3
+ 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/`).
4
+
5
+ ## Key Features
6
+ - **Documentation-First**: Requires documentation (`docs/`) to be created or updated before writing code.
7
+ - **Automatic Audit**: Analyzes the existing architecture and features.
8
+ - **Traceable Workflow**: Tracks feature status in `features_history.md`.
9
+ - **Built-In Quality**: Native integration of analysis, development, and testing.
10
+
11
+ ## Installation
12
+
13
+ ### Via npm (recommended - installs for all detected CLIs)
14
+
15
+ ```bash
16
+ npm install -g @antoneeo/agentic-sdlc-skill
17
+ ```
18
+
19
+ The `postinstall` script automatically detects installed CLIs and configures each one:
20
+
21
+ - **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.
22
+ - **Gemini CLI**: suggests `gemini extensions install` (see below).
23
+ - **Codex AI**: copies the skill to `$CODEX_HOME/skills/agentic-sdlc/` or `~/.codex/skills/agentic-sdlc/`. Restart Codex to load it.
24
+
25
+ `npm uninstall -g @antoneeo/agentic-sdlc-skill` also removes the skills from `~/.claude/skills/agentic-sdlc/` and `~/.codex/skills/agentic-sdlc/`.
26
+
27
+ ### Via Gemini CLI (local alternative)
28
+
29
+ > **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.
30
+
31
+ To install this extension, open a terminal in the folder that contains this README and run:
32
+
33
+ ```bash
34
+ gemini extensions install .
35
+ ```
36
+
37
+ *Note: If you are in a different folder, replace `.` with the full path to the skill folder.*
38
+
39
+ ## Global Availability
40
+ 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.
41
+
42
+ ## Getting Started
43
+
44
+ After installation, start Gemini CLI and verify that the skill is available:
45
+
46
+ 1. **List available skills:**
47
+ ```bash
48
+ /skills list all
49
+ ```
50
+ 2. **Activate the skill:**
51
+ The skill activates automatically when it detects requests related to development, audits, or feature management. You can also invoke it explicitly:
52
+ > "Use the agentic-sdlc skill to analyze this project"
53
+
54
+ ## Project Structure
55
+ - `skills/`: Contains the skill logic (`SKILL.md`).
56
+ - `references/`: Markdown templates for architecture, analysis, and feature history.
57
+ - `gemini-extension.json`: Extension manifest.
58
+
59
+ ---
60
+ Created by **Antonio Pinto** ([GitHub](https://github.com/Antoneeo))
61
+ (c) 2026 Antonio Pinto. All rights reserved.
package/gemini-extension.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-sdlc-skill",
3
- "version": "1.1.0",
3
+ "version": "1.2.3",
4
4
  "description": "Protocollo SDLC Documentation-First per Gemini CLI.",
5
5
  "author": "Antonio Pinto (https://github.com/Antoneeo)"
6
- }
6
+ }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@antoneeo/agentic-sdlc-skill",
3
- "version": "1.2.1",
4
- "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.",
3
+ "version": "1.2.3",
4
+ "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.",
5
5
  "keywords": [
6
6
  "claude-code",
7
7
  "claude-skill",
@@ -32,4 +32,4 @@
32
32
  "assets",
33
33
  "scripts"
34
34
  ]
35
- }
35
+ }
package/skills/agentic-sdlc-skill/SKILL.md CHANGED
@@ -11,6 +11,19 @@ Questa skill implementa un workflow rigoroso per lo sviluppo software, assicuran
11
11
 
12
12
  Realizzata da **Antonio Pinto** (https://github.com/Antoneeo).
13
13
 
14
+ ## Valori Tecnici
15
+
16
+ Privilegia qualità e comprensione rispetto alla velocità apparente.
17
+
18
+ - **Comprendi prima di agire:** non modificare codice senza aver capito il motivo; nei bug cerca la root cause, non workaround.
19
+ - **Mantieni coerenza architetturale:** rispetta layer, responsabilità, naming, pattern e convenzioni esistenti.
20
+ - **Applica DRY e semplicità:** non duplicare logica o conoscenza; crea astrazioni solo se riducono complessità reale.
21
+ - **Preserva la qualità:** ogni modifica deve mantenere o migliorare stabilità, testabilità e manutenibilità.
22
+ - **Verifica tecnicamente:** chiudi ogni task implementativo con test/lint/smoke test, o spiega perché non eseguiti.
23
+ - **Mantieni memoria utile:** documenta decisioni e stato operativo rilevanti, non rumore.
24
+
25
+ Se una patch sembra facile ma non capisci perché il codice attuale è fatto così, indaga prima di modificarlo.
26
+
14
27
  ## Workflow Operativo
15
28
 
16
29
  ### 0. Fase di Discovery (Ambiente)