10 Regole HARD del sistema
Sono regole ferree CLAUDE.md (Sharkcode "Regole ferree" sezione). Claude le applica siempre. Vos no tenés que farne nulla, ma se vedi Claude rifiutare algo, probabilmente è una di queste.
MaiStack WordPress / Aruba per nuovi progetti
Perché: Legacy + GDPR risk (Google Fonts CDN vietato in WordPress default). Aruba ha latency + DX scarsa.
si un cliente te lo chiede, Claude propone pattern migration verso Astro + Sanity + Cloudflare Pages (default Sharkcode).
SiempreUTF-8 encoding files
Perché: Windows default CP1252 rompe accenti italiani. Su Mac M1 è UTF-8 default, quindi sei OK.
non devi fare nulla, è automáticamente su tuo Mac.
SiempreAccenti italiani corretti (è/à/ù/ì/ò)
Perché: Mai apostrofo al posto di accento (no "e'" → sì "è"). Documento cliente con accenti errati = unprofessional.
Claude (italian-writer + language-checker) verifica per te automáticamente. Vos no tenés que escribir italiano cliente direttamente.
MaiEm-dash (—) in testi cliente
Perché: Trigger AI-generated content detection. Sostituire con virgole, due punti, punti.
Claude lo sostituisce automáticamente. Tu se vedi — in un draft cliente, di "Claude, togli gli em-dash".
SiemprePalette OKLCH per brand R0-R6
Perché: Tailwind v4 native default, P3 wide gamut Apple M-series. HEX legacy fallback OK come secondario.
Quando Claude crea brand identity tuo Etsy shop o cliente Wedding, palette in OKLCH automáticamente.
MaiDistribuire agenti isolati per lavoro cliente
Perché: Entry point obligatorio è /run-pipeline [clientId] [fase]. Mantenne il flusso strutturato + tracking dashboard.
Vos decís "Claude, lavora sul cliente Mariposa fase brand" → Claude usa /run-pipeline. NON invoca agenti random.
SiempreVerificare file scritti dagli agenti
Perché: "Completed" non significa completato. Pattern recidivo Claude dice fatto ma file vuoto.
Dopo che Claude dice "fatto", tu di "Claude, mostrame il file che hai creato" + lui ti fa Read del file. Verifichi visivamente.
MaiEsporre colori brand cliente in Sanity CMS
Perché: Palette OKLCH vive in CSS code (Tailwind @theme). Cliente NON modifica colori da CMS Studio. Brand integrity preservata.
Tu non tocchi Sanity (è Michel-owned). Se cliente chiede "voglio cambiáre colori da admin", rimovés è "no, il brand è LOCKED per protezione qualità".
SiemprePipeline contract ≠ pipeline legal
Perché: Contract = doc commerciali pre-firma cliente (Michel-only). Legal = pagine sito GDPR (/privacy + /cookie + /terms + cookie banner). Due pipeline ortogonali.
Tu non firmi contratti cliente (è Michel-only Path 4). Lavori solo su pagine GDPR site quando cliente Wedding ha bisogno (Claude le genera automáticamente).
SiempreCosti stack incluso ~25-30 EUR/y cliente
Perché: Astro + Sanity + Cloudflare Pages incluso senza fee aggiuntive. Cliente paga solo dominio (~10€/y) + email Zoho (~12$/y). Hard cap pricing differenziatore vs Vercel/Netlify.
Quando cliente chiede "quanto mi costa al mese?", rimovés è "circa 25-30 € all'anno, no mensile". È differenziatore commerciale.
5 Regole pratiche pair-mode (per te)
Specifiche pair-mode tu + Michel + Claude. Lecciones distiladas da experience.
1 · Feedback diretto a Claude, NO preamboli
Ejemplo: "Claude, cambiá il colore del navbar a verde menta" non "voglio solo dire che tal vez, se ti va, potresti cambiáre il colore del navbar". Claude non si offende dal diretto. È più efficiente.
2 · Vedere risultati visivamente siempre
Browser per Etsy + Canva + Cloudflare Pages staging URL. Localhost per Wedding template dev (Claude apre pnpm dev + ti dà URL). Pinna per cliente review modifiche (quando fix #3 multi-utente attivo M5+).
3 · Backup MacBook Time Machine + iCloud siempre attivi
8GB RAM + 256GB storage tight. Se Mac crashea, backup ti salva. Time Machine se hai disco esterno, iCloud Drive in alternativa.
4 · Tab Chrome max 5-7 simultaneo
8GB RAM tight. Chrome con 20 tab + VSCode + dev server = lag pesante. Estensione OneTab utile per archive tab. Workflow disciplinato evita panic.
5 · CLIENT DATA HANDLING verbatim
IBAN, codice fiscale, telefono, indirizzi cliente: MAI parafrasi, MAI typing manual. Sempre copy-paste verbatim. Validate checksum. Read-back prima di deploy. (Incident 2026-05-02 IBAN errato in production.)
Lingua workflow · come parli con Claude
Spagnolo nativo tuo + italiano comprende + inglés fluente lavoro. Claude si adatta a te.
Default ES Latam
Claude risponde siempre in español (sudamericano neutro). Voseo argentino opcional ("vos sabés" + "tomá"), non obligatorio.
EN per tecnicismi universali
Termini come Git, VSCode, Etsy, deploy, branch, commit, npm restano in inglés. Claude li usa MA li spiega la prima volta + tu se non entendés dici "che vuol dire X?".
IT solo per
- Agenti OS già presenti (italian-writer, copywriting nomi)
- Skill names tecnici (impeccable, brandkit nomi)
- Revisione deliverable cliente IT via Michel
Italiano cliente output
Sempre via agenti OS (italian-writer + copywriting) + revisione finale Michel. Tu NON scrivi italiano cliente direttamente.
Tip pratico: se Claude dice una cosa che non entendés tipo "ho fatto un commit sul branch main", dici "Claude, che vuol dire? Spiegamelo come si lo dicessi a un niño". Claude traduce immediato. Nunca sentir vergüenza.
Protected paths · cosa NON tocchi
File che Claude NON deve modificare senza AUDIT preventivo approvato Michel. Tu non li tocchi direttamente, Claude li riconosce automáticamente.
Liste files protected
tools/orchestrator/compile-*.ts (compile-brand, compile-legal, compile-pack-2-blocchi)templates/brand/**, templates/founding-partner/**, templates/legal/**tools/orchestrator/utils/frontmatter.tstools/orchestrator/italian-text-cleanup.tstools/orchestrator/pdf-render.cjs.claude/agents/*.mdtemplates/site-scaffold/sections/**
Cosa significa per te: se Claude rifiuta una richiesta dicendo "Protected path, serve AUDIT", significa che hai chiesto algo che modifica un file fondamentale Sharkcode. Chiedi a Michel se è OK. Se Michel autorizza, Claude lo fa.