10 Regole HARD del sistema
Son reglas ferreas CLAUDE.md (Sharkcode "Regole ferree" sección). Claude las aplica siempre. Vos no tenés que hacer nada, pero si ves a Claude rechazar algo, probablemente es una de estas.
MaiStack WordPress / Aruba per nuovi progetti
Por qué: 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
Por qué: Windows default CP1252 rompe accenti italiani. Su Mac M1 è UTF-8 default, quindi sei OK.
No tenés que hacer nada, es automático en tu Mac.
SiempreAccenti italiani corretti (è/à/ù/ì/ò)
Por qué: Nunca apóstrofe en lugar del acento (no "e'" → sí "è"). Documento cliente con acentos errados = unprofessional.
Claude (italian-writer + language-checker) verifica por vos automáticamente. Vos no tenés que escribir italiano cliente directamente.
MaiEm-dash (—) in testi cliente
Por qué: Trigger AI-generated content detection. Sostituire con virgole, due punti, punti.
Claude lo sustituye automáticamente. Si ves — en un draft cliente, decile "Claude, sacá los em-dash".
SiemprePalette OKLCH per brand R0-R6
Por qué: Tailwind v4 native default, P3 wide gamut Apple M-series. HEX legacy fallback OK come secondario.
Cuando Claude crea brand identity de tu Etsy shop o cliente Wedding, palette en OKLCH automáticamente.
MaiDistribuire agenti isolati per lavoro cliente
Por qué: Entry point obligatorio es /run-pipeline [clientId] [fase]. Mantiene el flujo estructurado + tracking dashboard.
Vos decís "Claude, trabajá sobre el cliente Mariposa fase brand" → Claude usa /run-pipeline. NO invoca agentes random.
SiempreVerificare file scritti dagli agenti
Por qué: "Completed" no significa completado. Patrón recidivo Claude dice hecho pero el archivo está vacío.
Después que Claude dice "hecho", vos decile "Claude, mostrame el archivo que creaste" + él te hace Read del archivo. Verificás visualmente.
MaiEsporre colori brand cliente in Sanity CMS
Por qué: Palette OKLCH vive in CSS code (Tailwind @theme). Cliente NON modifica colori da CMS Studio. Brand integrity preservata.
Vos no tocás Sanity (es Michel-owned). Si el cliente pide "quiero cambiar colores desde admin", respondés "no, el brand está LOCKED para protección de calidad".
SiemprePipeline contract ≠ pipeline legal
Por qué: Contract = doc commerciali pre-firma cliente (Michel-only). Legal = pagine sito GDPR (/privacy + /cookie + /terms + cookie banner). Due pipeline ortogonali.
Vos no firmás contratos cliente (es Michel-only Path 4). Trabajás solo en páginas GDPR site cuando cliente Wedding lo necesita (Claude las genera automáticamente).
SiempreCosti stack incluso ~25-30 EUR/y cliente
Por qué: 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.
Cuando cliente pregunta "¿cuánto me cuesta al mes?", respondés "alrededor de 25-30 € al año, no mensual". Es diferenciador comercial.
5 Reglas prácticas pair-mode (para vos)
Específicas pair-mode vos + Michel + Claude. Lecciones destiladas de experiencia.
1 · Feedback directo a Claude, SIN preámbulos
Ejemplo: "Claude, cambiá el color del navbar a verde menta" no "quería decir que tal vez, si te parece, podrías cambiar el color del navbar". Claude no se ofende con lo directo. Es más eficiente.
2 · Ver resultados visualmente siempre
Browser para Etsy + Canva + Cloudflare Pages staging URL. Localhost para Wedding template dev (Claude abre pnpm dev + te da URL). Pinna para review modificaciones cliente (cuando fix #3 multi-usuario activo M5+).
3 · Backup MacBook Time Machine + iCloud siempre activos
8GB RAM + 256GB storage ajustado. Si Mac crashea, backup te salva. Time Machine si tenés disco externo, iCloud Drive como alternativa.
4 · Tabs Chrome máximo 5-7 simultáneo
8GB RAM ajustado. Chrome con 20 tabs + VSCode + dev server = lag pesado. Extensión OneTab útil para archivar tabs. Workflow disciplinado evita panic.
5 · CLIENT DATA HANDLING verbatim
IBAN, código fiscal, teléfono, direcciones cliente: NUNCA paráfrasis, NUNCA typing manual. Siempre copy-paste verbatim. Validate checksum. Read-back antes de deploy. (Incidente 2026-05-02 IBAN errado en producción.)
Lingua workflow · come parli con Claude
Spagnolo nativo tuo + italiano comprende + inglés fluente lavoro. Claude si adatta a te.
Default ES Latam
Claude responde siempre en español (sudamericano neutro). Voseo argentino opcional ("vos sabés" + "tomá"), no obligatorio.
EN para tecnicismos universales
Términos como Git, VSCode, Etsy, deploy, branch, commit, npm quedan en inglés. Claude los usa PERO los explica la primera vez + si no entendés decile "¿qué quiere decir X?".
IT solo para
- Agentes OS ya presentes (italian-writer, copywriting nombres)
- Skill names técnicos (impeccable, brandkit nombres)
- Revisión deliverable cliente IT vía Michel
Italiano cliente output
Siempre vía agentes OS (italian-writer + copywriting) + revisión final Michel. Vos NO escribís italiano cliente directamente.
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
Archivos que Claude NO debe modificar sin AUDIT preventivo aprobado por Michel. Vos no los tocás directamente, Claude los reconoce automáticamente.
Lista de archivos 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.