One sheet, before you open the agent

The four pieces every app is made of, on one page. Fill it in here, print it (or save it as a PDF) and bring it to the call. On the back are the exact questions to ask the client.

An agent executes decisions, it doesn't make them: whatever you don't write down, it fills in on its own, silently. This sheet exists to fill in the boxes beforehand — and you fill in three pieces out of four yourself, without bothering anyone. Only the first is left to the client.

Written by hand, saved on its own

Clear Brief the sheet to bring to the call · aipratika.com

Progetto Con chi Da mostrare il

La frase che dirà il giorno che lo mostra

Il flusso principale core loop

the client fills this in

Il giro che l’app esiste per far ripetere. L’unico pezzo che cambia da un’app all’altra.

Cosa guardo per decidere

↑ these become the fields of the record. Nothing more.

★ Il momento in cui dico «ha funzionato»

Il primo avvio onboarding

you fill this in

Dal primo tocco al momento in cui l’app serve a qualcosa.

Mandatory, before the flow

Every checked box is one more gate before understanding what the app is for.

Si chiede dopo, non subito Il primo giorno, quando non c’è ancora nessuno

Autenticazione e account auth

zero questions

Non si chiede. Si fa.

registrazione
accesso
password dimenticata
impostazioni
notifiche

L’unica decisione

Schermate secondarie e stati empty, loading, error

you fill this in

Dentro la prima versione Dopo Mai The three screens everyone always forgets

★

What it should look like

circle these with the client

Five words that fit, three that don't. Circle them, don't invent them: "modern" and "clean" aren't in the list on purpose — you can't draw them.

…and never like this

Tre indirizzi che gli piacciono, e perché Due che non gli piacciono

The contradictions

closed right here

The client will contradict themselves: it's the most useful part of the call. Every line closes with a decision and its price — otherwise they find out the price once the work is done.

Ha dettoDecidiamoCi perdiamo

Clear Brief · AI Pratika — the full guide at aipratika.com/en/guides/ux-ui/

The back the questions to ask, and what to do next

All in the past tense, on purpose: what the client has done is a fact, what they imagine they make up as they answer. Never ask them "how do you picture the app".

Il flusso principale · core loop

Raccontami l’ultima volta che hai provato a farlo senza app: quando è stato, cosa hai fatto, com’è finita?

Good. «Sabato al parco. Ho aspettato che i cani si annusassero, ho detto due parole, ci siamo scambiati il numero e non ci siamo più scritti.»

Vague. «Eh, di solito è difficile conoscere gente.» — è un’impressione, non un fatto.
Nei primi dieci secondi, cosa guardi per capire se può funzionare?

Good. «La taglia, se sta al guinzaglio, l’età, quanto è agitato.»

Vague. «Si capisce al volo.» — rifallo su un caso preciso: quale cane, ieri, cosa hai guardato.
Cosa ti ha fermato le ultime volte che ci hai provato?
C’è qualcosa che non faresti mai dentro un’app così, nemmeno se fosse comoda?
Di tutto il giro, qual è il momento in cui diresti «ecco, ha funzionato»?

Vague. «Tutto è importante.» — non è una risposta: fagliene scegliere uno.

Il primo avvio · onboarding

Prima di poter usare l’app, cosa serve per forza? E cosa possiamo chiedere dopo?
Il primo giorno, quando nella tua zona non c’è ancora nessun altro: cosa dovrebbe vedere la persona?

Vague. «Un messaggio che dice di riprovare.» — è un vicolo cieco: serve un’azione.

Schermate secondarie e stati

Se il giorno della presentazione ci fossero solo cinque cose, quali cinque salvi?
Cosa può arrivare nella versione dopo, senza che l’app sembri rotta?
C’è qualcosa che non ci deve stare nemmeno se avessimo tempo infinito?

Vague. «Non mi viene in mente niente.» — insisti: senza un «mai» non hai deciso niente.

Come deve sembrare

Da questa lista, quali cinque parole dovrebbero venire in mente a chi apre l’app? E quali tre non deve sembrare mai?
Mandami tre indirizzi di prodotti che ti piacciono esteticamente, con una riga sul perché. E due che non ti piacciono.

Vague. «Airbnb, Apple, Revolut.» — nomi senza link e senza perché: si torna a interpretare.
Esiste già un logo o dei colori da rispettare?

Vincoli

C’è un giorno entro cui deve esistere qualcosa da mostrare? Quale, e a chi lo mostri?

Vague. «Il prima possibile.» — non è una data, quindi non taglia niente.
C’è qualcosa che decide al posto nostro? Uno strumento che usate già, un budget, una regola del vostro settore.

→

And then: the prompt

The filled-in sheet is the context. Paste it into this prompt, in place of the last line.

Sei un design engineer. Qui sotto c'è il brief di un progetto, compilato a
mano su un foglio solo. È la fonte: quello che non c'è scritto NON lo decidi
tu in silenzio.

Tre regole che valgono su tutto:
1. Se un'informazione manca, CHIEDIMELA invece di inventarla.
2. Davanti a due indicazioni opposte non mediare: dichiara l'assunzione che
   stai facendo e scrivimela.
3. Alla fine di ogni giro elencami cosa hai creato, quali decisioni hai preso
   al posto mio e cosa NON hai fatto perché mancava un'informazione.

Costruisci in quest'ordine, una richiesta per blocco, fermandoti ogni volta:
1. Fondamenta — token, caratteri, spaziature, il guscio dell'app. Nessuna
   schermata.
2. Navigazione — le rotte e lo stato attivo, pagine ancora vuote.
3. La schermata del FLUSSO PRINCIPALE, da sola, con il suo gesto.
4. Le altre schermate, una per richiesta, riusando i componenti già in progetto.
5. Gli stati: vuoto, caricamento, errore, primo avvio.
6. Rifinitura: allineamenti, raggi, ombre, focus, transizioni.

Vincoli:
- Colori, caratteri e spaziature stanno in docs/ui.md e nel file dei token.
  Non inventarli qui: leggili e usa solo quelli.
- Autenticazione e account: standard, nessuna invenzione.
- Nessuna schermata deve apparire vuota per mancanza di contenuto: metti dati
  finti credibili, in italiano, come li scriverebbe una persona vera.
- Niente funzioni della lista «dopo» e della lista «mai».

<<INCOLLA QUI IL FOGLIO COMPILATO>>

How to use it

Before talking to the client, fill in pieces 2, 3 and 4: you already know them. Then bring the sheet to the call and use the back for piece 1 and for the words. Whatever's left blank isn't guessed: it's asked.

The full journey — from the client's confusing message all the way to the published interface, with the library to choose and the skills to install — is in the seven-part guide.

From messy brief to UX/UI with Claude Code →

Keep exploring

Guides, courses and tools picked for you, starting from this page.

Guide