@antoneeo/agentic-sdlc-skill 1.0.0
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.
package/SKILL.md
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agentic-sdlc
|
|
3
|
+
description: Protocollo SDLC "Documentation-First". Utilizzare per gestire lo sviluppo di nuove feature, eseguire l'audit di progetti esistenti e mantenere rigorosamente aggiornata la documentazione tecnica prima, durante e dopo l'implementazione del codice.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Agentic SDLC
|
|
7
|
+
|
|
8
|
+
Questa skill implementa un workflow rigoroso per lo sviluppo software, assicurando che la documentazione preceda sempre l'implementazione (Documentation-First). Sei un ingegnere del software senior che segue rigorosamente questo processo.
|
|
9
|
+
|
|
10
|
+
## Workflow Operativo
|
|
11
|
+
|
|
12
|
+
### 1. Fase di Audit e Allineamento
|
|
13
|
+
Prima di rispondere a qualsiasi richiesta operativa, verifica lo stato della documentazione del progetto.
|
|
14
|
+
- Controlla l'esistenza della cartella `/docs`.
|
|
15
|
+
- Se `/docs` non esiste o mancano i documenti fondamentali, creali analizzando il codice sorgente utilizzando i seguenti template:
|
|
16
|
+
1. `docs/architecture.md`: Usa `references/architecture_template.md`. Deve contenere Stack Tecnologico, Struttura delle Directory e Pattern architetturali principali.
|
|
17
|
+
2. `docs/existing_features.md`: Usa `references/existing_features_template.md`. Elenco puntato delle funzionalità già presenti.
|
|
18
|
+
3. `docs/features_history.md`: Usa `references/features_history_template.md`. Aggiorna rigorosamente lo stato delle feature.
|
|
19
|
+
|
|
20
|
+
### 2. Fase di Analisi della Richiesta
|
|
21
|
+
Per ogni nuova feature richiesta dall'utente:
|
|
22
|
+
- Crea `docs/solutions/ANALYSIS_[nome_feature].md` usando `references/analysis_template.md` (Obiettivo, Impatto, Piano, Strategia Test).
|
|
23
|
+
- Aggiungi una riga in `docs/features_history.md` con stato `[PLANNED]`.
|
|
24
|
+
|
|
25
|
+
### 3. Fase di Sviluppo e Test
|
|
26
|
+
Solo dopo aver completato la Fase 2:
|
|
27
|
+
1. Aggiorna lo stato della feature in `docs/features_history.md` a `[IN_PROGRESS]`.
|
|
28
|
+
2. Implementa il codice in modo chirurgico.
|
|
29
|
+
3. **Obbligatorio:** Scrivi i test automatici seguendo il pattern AAA (Arrange, Act, Assert).
|
|
30
|
+
4. Esegui i test. Se falliscono, correggi e riesegui finché l'Exit Code non è 0.
|
|
31
|
+
|
|
32
|
+
### 4. Fase di Chiusura
|
|
33
|
+
A completamento della feature:
|
|
34
|
+
- Aggiorna `architecture.md` e `existing_features.md` se necessario (es. nuove dipendenze o nuove capacità di sistema).
|
|
35
|
+
- Aggiorna `docs/features_history.md` impostando lo stato a `[COMPLETED]` e aggiungendo la data di fine.
|
|
36
|
+
|
|
37
|
+
## Risorse Disponibili
|
|
38
|
+
|
|
39
|
+
### References
|
|
40
|
+
- `architecture_template.md`: Struttura per il documento di architettura.
|
|
41
|
+
- `existing_features_template.md`: Formato per l'elenco delle feature esistenti.
|
|
42
|
+
- `features_history_template.md`: Schema per la tabella dello storico delle feature.
|
|
43
|
+
- `analysis_template.md`: Guida per la creazione del documento di analisi di una nuova feature.
|
package/package.json
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@antoneeo/agentic-sdlc-skill",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Protocollo SDLC Documentation-First per Gemini CLI. Gestisce audit, analisi, sviluppo e chiusura feature con documentazione sincronizzata.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"gemini-cli",
|
|
7
|
+
"skill",
|
|
8
|
+
"sdlc",
|
|
9
|
+
"documentation",
|
|
10
|
+
"ai-agent"
|
|
11
|
+
],
|
|
12
|
+
"author": "antoneeo",
|
|
13
|
+
"license": "MIT",
|
|
14
|
+
"publishConfig": {
|
|
15
|
+
"access": "public"
|
|
16
|
+
},
|
|
17
|
+
"files": [
|
|
18
|
+
"SKILL.md",
|
|
19
|
+
"references",
|
|
20
|
+
"assets",
|
|
21
|
+
"scripts"
|
|
22
|
+
]
|
|
23
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Analisi della Feature: [Nome Feature]
|
|
2
|
+
|
|
3
|
+
## Obiettivo
|
|
4
|
+
- Cosa si vuole ottenere?
|
|
5
|
+
- Quali problemi risolve?
|
|
6
|
+
|
|
7
|
+
## Impatto
|
|
8
|
+
- Modifiche ai file esistenti?
|
|
9
|
+
- Impatti sulle performance?
|
|
10
|
+
- Nuove dipendenze?
|
|
11
|
+
|
|
12
|
+
## Piano d'Azione
|
|
13
|
+
1. [ ] Sviluppo...
|
|
14
|
+
2. [ ] Test...
|
|
15
|
+
|
|
16
|
+
## Strategia di Test
|
|
17
|
+
- Test unitari (AAA Pattern)
|
|
18
|
+
- Test d'integrazione
|
|
19
|
+
- Esempi di input e output attesi
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Architettura del Progetto
|
|
2
|
+
|
|
3
|
+
## Stack Tecnologico
|
|
4
|
+
- **Linguaggio:** [es. TypeScript]
|
|
5
|
+
- **Framework:** [es. React, Express]
|
|
6
|
+
- **Database:** [es. PostgreSQL]
|
|
7
|
+
- **Strumenti di Test:** [es. Jest, Vitest]
|
|
8
|
+
|
|
9
|
+
## Struttura delle Directory
|
|
10
|
+
- `src/`: Codice sorgente.
|
|
11
|
+
- `docs/`: Documentazione tecnica.
|
|
12
|
+
- `tests/`: Test automatici.
|
|
13
|
+
|
|
14
|
+
## Pattern Architetturali
|
|
15
|
+
- [es. MVC, Clean Architecture, Layered Architecture]
|
|
16
|
+
- [es. Dependency Injection]
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Storico delle Feature
|
|
2
|
+
|
|
3
|
+
| ID | Nome Feature | Stato | Data Inizio | Data Fine | Doc. Analisi | Note |
|
|
4
|
+
|:---|:-------------|:------|:------------|:----------|:-------------|:-----|
|
|
5
|
+
| [ID] | Nome | [PLANNED] | YYYY-MM-DD | - | [ANALYSIS_nome.md] | In attesa |
|
|
6
|
+
| [ID] | Altra | [COMPLETED] | YYYY-MM-DD | YYYY-MM-DD | [ANALYSIS_altra.md] | Conclusa |
|