From c22d9dde9774b8a0b2ed3f71e57a9ff98e5837eb Mon Sep 17 00:00:00 2001
From: Michele <michele@mlhub.it>
Date: Sun, 8 Mar 2026 19:57:36 +0100
Subject: [PATCH] docs(02): capture phase context

Phase 02: Prompt Control + Output Review
- Implementation decisions documented
- Phase boundary established
---
 .../02-CONTEXT.md                             | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 .planning/phases/02-prompt-control-output-review/02-CONTEXT.md

diff --git a/.planning/phases/02-prompt-control-output-review/02-CONTEXT.md b/.planning/phases/02-prompt-control-output-review/02-CONTEXT.md
new file mode 100644
index 0000000..146e2d2
--- /dev/null
+++ b/.planning/phases/02-prompt-control-output-review/02-CONTEXT.md
@@ -0,0 +1,62 @@
+# Phase 2: Prompt Control + Output Review - Context
+
+**Gathered:** 2026-03-08
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+L'utente puo' modificare i prompt LLM direttamente dalla Web UI senza toccare il codice, rigenerare singoli post insoddisfacenti, e rivedere l'anteprima completa di ogni carosello prima di esportare il CSV. Non include nuove capability (Swipe File, Unsplash, storico campagne).
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Prompt Editor UX
+- Bottone "Rigenera" visibile direttamente su ogni PostCard nella Output Review (non menu contestuale)
+- Ogni prompt ha un pulsante "Reset al default" per ripristinare la versione originale pre-installata
+- Accanto all'editor, una sezione mostra la lista delle variabili disponibili (es. {{topic}}, {{obiettivo}}, {{nicchia}}) con descrizione per ciascuna
+
+### Rigenerazione singolo post
+- Trigger: bottone diretto sulla card del post nella Output Review
+- Prima di rigenerare, un piccolo form permette di inserire un topic diverso o note aggiuntive (non solo "stessi parametri")
+
+### Flusso Output Review
+- Post rigenerati hanno un badge/icona visivo (es. freccia circolare) che li distingue dai post originali
+- Summary counter in cima alla Output Review: "13 post - X rigenerati - Y modificati manualmente" per overview rapida dello stato del batch
+
+### Claude's Discretion
+- Tipo di editor prompt (textarea semplice vs syntax highlight per variabili {{...}})
+- Layout navigazione tra prompt (sidebar, tab, accordion)
+- Posizionamento Prompt Editor (pagina dedicata vs sezione dashboard)
+- Anteprima live del prompt compilato con variabili esempio (implementare se il costo e' basso)
+- Feedback visivo durante rigenerazione (spinner, overlay, dimming)
+- Undo one-step dopo rigenerazione (implementare se pragmatico)
+- Gestione variabili obbligatorie mancanti (blocco salvataggio vs warning)
+- Badge "Modificato" vs "Default" sui prompt nella lista
+- Card espandibile per dettaglio slide vs card compatta
+- CSV scaricato sempre con ultime versioni (approccio piu' pragmatico)
+
+</decisions>
+
+<specifics>
+## Specific Ideas
+
+- Il form pre-rigenerazione deve essere leggero (non un dialog modale pesante) — idealmente inline o popover sulla card
+- Il summary counter in cima alla Output Review deve aggiornarsi in tempo reale dopo ogni regen
+- Le variabili disponibili mostrate nell'editor devono corrispondere esattamente a quelle che PromptService si aspetta per quel tipo di prompt
+
+</specifics>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope
+
+</deferred>
+
+---
+
+*Phase: 02-prompt-control-output-review*
+*Context gathered: 2026-03-08*