| name | siae-executing-plans |
| description | Use when executing an approved implementation plan in a separate session (different from where plan was written). Reads docs/plans/<topic>/ overview + task-NN files, executes batch with human checkpoints. Examples: "esegui il piano nella sessione nuova", "carica il piano e implementa", "batch execution", piano con REQUIRED SUB-SKILL siae-executing-plans header.
|
SIAE Executing Plans — Esecuzione Piano in Sessione Separata
Tipo: Rigid | Fase SDLC: 4. Implementation (sessione separata)
LA LEGGE DI FERRO
LEGGI IL PIANO CRITICAMENTE PRIMA DI TOCCARE QUALSIASI FILE.
ESEGUI PER BATCH. RIPORTA. ATTENDI FEEDBACK.
Stai per implementare task da un piano senza aver letto e rivisto il piano completo?
FERMATI. Leggi TUTTO il piano prima di toccare qualsiasi file.
Stai per procedere senza checkpoint umano dopo il batch?
FERMATI. Ogni batch di 3 task richiede report + attesa feedback. Non procedere alla cieca.
Stai per improvvisare qualcosa non previsto dal piano?
FERMATI. Se non e' nel piano, non farlo. Proponi la modifica nel report e attendi.
Annuncia all'inizio: "Uso siae-executing-plans per implementare il piano."
Differenza da siae-subagent-development
| Questa skill | siae-subagent-development |
|---|
| Sessione separata aperta dall'utente | Stessa sessione dell'orchestratore |
| Claude esegue direttamente i task | Claude dispatcha subagent per ogni task |
| Batch di 3 task + checkpoint umano | 2 reviewer automatici per ogni task |
| Checkpoint: l'utente decide se continuare | Checkpoint: spec-reviewer + code-quality-reviewer |
| Adatto per iterazione lenta/controllata | Adatto per iterazione rapida e automatizzata |
Quando si Applica
Sessione nuova con piano in docs/plans/ + header REQUIRED SUB-SKILL: siae-executing-plans (oppure scelta "sessione separata" da siae-writing-plans).
NON usare: sessione originale con orchestratore (siae-subagent-development)
o piano inesistente (siae-brainstorming).
Processo
Step 0 — Setup Workspace Isolato (opzionale)
Se il progetto richiede branch dedicato o workspace isolato:
REQUIRED SUB-SKILL: siae-git-worktrees (opzionale)
Dettagli setup, sync hooks, cleanup → reference/executing-plans-worktree.md.
Step 1 — Carica e Rivedi il Piano
🟢 SICURO
- Leggi il file piano in
docs/plans/. Rivedi criticamente.
- Se hai dubbi: solleva PRIMA di iniziare. Non procedere alla cieca.
- Se nessun dubbio: crea task per ogni item e procedi.
Detect formato: directory con overview.md → split (leggi overview.md
per lista task + stato); altrimenti file *-plan.md → legacy monolitico.
Annuncia:
PIANO CARICATO: docs/plans/<topic>/overview.md (split)
| docs/plans/<filename>.md (legacy)
Task totali: N · Primo batch: Task 1-3
Domande/problemi: [nessuno | lista]
Step 2 — Esegui Batch (default: 3 task)
🟡 MEDIO — Pre-flight prima di ogni task con modifica file
Formato split: per ogni task nel batch, leggi solo
docs/plans/<topic>/task-NN-<nome>.md. Non rileggere overview o altri task.
Formato legacy: estrai la sezione task dal file monolitico.
Per ogni task nel batch:
- Segna come in_progress
- Segui ogni step esattamente come scritto nel piano
- Esegui le verifiche specificate nel piano
- Segna come completato
- Aggiorna marker piano (
[PENDING] → [DONE]/[BLOCKED]) e checkbox
dual-format → dettagli reference/executing-plans-sync.md
- Committa il piano aggiornato (commit separato dal codice)
Per ogni task implementativo:
REQUIRED SUB-SKILL: siae-tdd
Stop immediato se:
- Blocco a meta' task (dipendenza mancante, test fallisce ripetutamente)
- Il piano ha lacune che impediscono di procedere
- Non capisci un'istruzione
- La verifica fallisce piu' di 2 volte sullo stesso step
Step 3 — Report Post-Batch
🟢 SICURO
Dopo ogni batch completato, riporta:
BATCH COMPLETATO: Task [N]-[M]
Implementato:
- [descrizione task 1]
- [descrizione task 2]
- [descrizione task 3]
Stato piano: X/Y [DONE], Z [BLOCKED], W [PENDING]
Verifica:
[output sintetico dei comandi eseguiti]
Prossimo batch: Task [N+1]-[N+3]
Pronto per feedback.
Attendi risposta dell'utente prima di procedere.
Step 4 — Continua o Correggi
In base al feedback:
- Applica le correzioni se richiesto
- Esegui il batch successivo se OK
- Ripeti fino al completamento di tutti i task
Step 4b — Plan Completion Gate
Verifica marker [PENDING]/[BLOCKED]/[DONE] sull'intero piano (comandi
grep -c in reference/executing-plans-sync.md).
Se PENDING > 0 o BLOCKED > 0: STOP. Piano non completo.
Se tutti [DONE]: procedi con Step 5.
Step 5 — Completamento
REQUIRED SUB-SKILL: siae-verification
REQUIRED SUB-SKILL: siae-finishing-branch
Limiti Operativi
| Vincolo | Limite | Se superato |
|---|
| Tentativi max per step | 2 | Fermati. Chiedi all'utente prima di riprovare. |
| Step totali per batch | 3 | Decomponi se serve di piu'. |
| Output max per analisi | 300 righe | Sintetizza. |
Permission Denied Handling
Bash negato (test/build): presenta i comandi esatti, chiedi all'utente
di eseguirli, procedi al Report sui risultati forniti.
Write negato: presenta il codice come output testuale con path esatti,
attendi che l'utente applichi, riprendi dalla verifica.
Skill correlate
siae-writing-plans — produce il piano che questa skill eseguesiae-subagent-development — alternativa per sessione unica con subagentsiae-git-worktrees — setup workspace isolato (opzionale)siae-tdd — per ogni task implementativosiae-verification — verifica finale pre-completamentosiae-finishing-branch — chiusura branch post-implementazione
Guardrail operativi (centralizzati)
- Classificazione Rischio Operazioni: vedi
lib/risk-taxonomy.md (tassonomia comune DevForge).
- Tabella Anti-Razionalizzazione: vedi
lib/risk-taxonomy.md + lib/permission-denied-handling.md; regola locale: nessuna scorciatoia "solo questa volta" — se un gate blocca, il fix è soddisfarlo, non aggirarlo.
