siae-executing-plans

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

1. Leggi il file piano in docs/plans/. Rivedi criticamente.
2. Se hai dubbi: solleva PRIMA di iniziare. Non procedere alla cieca.
3. 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:

1. Segna come in_progress
2. Segui ogni step esattamente come scritto nel piano
3. Esegui le verifiche specificate nel piano
4. Segna come completato
5. Aggiorna marker piano ([PENDING] → [DONE]/[BLOCKED]) e checkbox dual-format → dettagli reference/executing-plans-sync.md
6. 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 esegue
• siae-subagent-development — alternativa per sessione unica con subagent
• siae-git-worktrees — setup workspace isolato (opzionale)
• siae-tdd — per ogni task implementativo
• siae-verification — verifica finale pre-completamento
• siae-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.