AI-ready (.cursorrules + CLAUDE.md)

Questo è il differenziatore vero di ZeroToShip. Il repo contiene due file di istruzioni scritti apposta per il tuo AI — .cursorrules per Cursor e CLAUDE_INSTRUCTIONS.md per Claude Code. La tua AI apre il progetto e capisce già struttura, convenzioni, quali file toccare per aggiungere una feature.

Cosa contengono

Entrambi i file descrivono:

lo stack (Next.js 15 App Router, Supabase, Stripe, Resend);
la struttura delle cartelle (libs/, components/, app/api/);
le convenzioni: TypeScript ovunque, Server Components di default, token di tema da app/globals.css, no emoji nel codice;
dove vive ogni feature — auth in libs/supabase/, pagamenti in app/api/stripe/ e nel webhook, email in libs/resend.ts.

Come funziona in pratica

Cursor legge .cursorrules automaticamente ad ogni prompt. Claude Code legge CLAUDE_INSTRUCTIONS.md (o un CLAUDE.md nella root) quando apre il repo. Non devi fare copia-incolla del contesto — l'AI ce l'ha già in memoria.

Prompt che funzionano

Con la struttura chiara, prompt vaghi diventano richieste eseguibili. Esempi che girano bene:

prompt esempio

bash

Aggiungi una tabella "posts" su Supabase con RLS e un
Server Component /blog che ne lista i titoli.

Nel webhook Stripe, dopo checkout.session.completed,
manda una email di benvenuto usando sendEmail di libs/resend.ts.

Crea un componente Testimonial in stile brutalist
usando i token da globals.css e WobbleBorder di drawn/.

Se cambi lo stack

Aggiorna i due file. Non sono documentazione decorativa — sono la fonte di verità che il tuo AI legge prima di scrivere codice. Se sostituisci Resend con un altro provider, aggiornalo lì dentro e i prompt torneranno a produrre codice corretto.