Files

Michele c22d9dde97 docs(02): capture phase context

Phase 02: Prompt Control + Output Review
- Implementation decisions documented
- Phase boundary established

2026-03-08 19:57:36 +01:00

2.6 KiB

Raw Blame History

Phase 2: Prompt Control + Output Review - Context

Gathered: 2026-03-08 Status: Ready for planning

## 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).

## 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)

## 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

## Deferred Ideas

None — discussion stayed within phase scope

Phase: 02-prompt-control-output-review Context gathered: 2026-03-08

2.6 KiB Raw Blame History