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 M2 è 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 cómo 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 sin 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 (Day 1-14 solo iCloud, Day 14+ + Time Machine)
Decisione Michel mattina 2026-05-24 (D-B7+8): Day 1 setup solo iCloud Drive 200 GB attivo (~3 EUR/mese tu pagás). Time Machine SSD externo defer Day 14+ post Welcome Tutorial commitment empirico (~80 EUR SanDisk Extreme Portable 1TB). 8GB RAM + 256GB storage ajustado. Si Mac crashea Day 1-14, iCloud Drive te recupera. Day 14+ dual layer belt+suspenders.
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.)
Decisiones cementadas Michel mattina 2026-05-24 (audit ambient pre-setup)
7 decisiones hard locked durante audit ambient pre-setup Mac. Tu Day 1 ya tenés todo decidido, no hay que renegociar.
D1Branch strategy Scenario A · branch dedicados noelia-XYZ desde Day 1
Vos trabajás siempre en branch dedicado tuyo (ej. noelia-etsy-launch para listings, noelia-mariposa-practice para Wedding cliente fittizio Day 2-7, noelia-cliente-X para Wedding real Day 30+). Michel queda en main. Merge a main controlado via PR (manual single-dev OK).
Day 1 Michel te enseña a crear primer branch con alias
gnoelia noelia-etsy-launch. Después vos repetí pattern para cada task largo. Detalle completo:
GIT-WORKFLOW-COLLAB.html.
D3Day 0 GitHub prep · vos sola pre-pair-mode
~30-45 min vos sola ANTES setup pair-mode con Michel: cuenta GitHub + Bitwarden install + SSH key Mac + manda key+username a Michel WhatsApp. Ahorro Day 1 ~25 min + zero catch-22 Collaborator invite.
D5Canva Pro DEFERRED post-Welcome Tutorial Day 7+
Day 1 solo cuenta free Canva (Michel NO usa Canva, no hay team Sharkcode para invitarte). Decisión Pro upgrade Day 7+ post Welcome Tutorial T1-T5 empirica: si necesitás magic resize / background remover / brand kit unlimited → upgrade 11,99 EUR/mes (o 109,99 EUR/año). Si no → free OK. Skin in the game M0 NO es Canva Pro (decisión posticipata).
Day 1 NO pagás Canva Pro. Probás free 7 dias, después decidís sola.
D7Memory sync weekly Sunday 21:00 automatic
Michel-side Win Task Scheduler automatic: cada Domenica 21:00 syncs memorie Win → repo memory-shared/ → push origin/main. Vos Mac suo Day 8+ gp para recibir memorie aggiornate.
Vos no hace nada. Todos los lunes a la mañana cdsc && gp trae memorias frescas automatic. Claude las lee via env SHARKCODE_MEMORY_DIR.
B1.1Sub Michel Max Claude Code · sesión compartida
Vos usás cuenta Anthropic de Michel para Claude Code (sub Max $200/mes Michel-paid). Empirical: vos ya usás Claude.ai con cuenta Michel sin issues desde meses. Decisión informed: continuar pattern.
Login Claude Code Day 1 con credenciales Michel (decisión D-B1 pending sera: screen share remoto Michel hace login OR password share). Quota weekly Max compartida = no hacer Welcome Tutorial 6h continuas si Michel está trabajando intensamente en paralelo.
D-B10Memorie cliente shared · vos vedes 90 file inclusi Mary + Valerio + Lindorug + Pinna + Auraviva
Trust full team interno Sharkcode. Vos lees status cliente, decisiones strategic, fee, stack tech, voice tone, lessons. Razionale: capisci workflow + cliente context per fare bene Day 30+ pair-mode Wedding. Verified zero IBAN/passwords leak (grep clean).
Cuando Claude trabaja en task tuo (Etsy listing o Wedding template), automáticamente lee memorias relevantes via auto-retrieval hook. Vos podés también cat memory-shared/project_mary_status.md para entender cliente real.
Wave 4Hooks essential Mac · auto-retrieval + protected-paths + 8 più attivi Day 1
Setup script automatic Step 10.3 SETUP-MACBOOK instala 10 hook Mac-friendly in ~/.claude/hooks/ + registra 4 hook events in ~/.claude/settings.json: UserPromptSubmit (auto-retrieval Topic Matches) + PreToolUse (protected-paths-block) + Stop (desktop notification Mac native) + PostToolUse (change-logger audit).
No hace nada manual. Cada vez que escribís un prompt Claude, hook auto-retrieval inietta memorie rilevanti automatic (vedes "Topic Matches" en respuesta). Cada vez que Claude termina, Mac te notifica osascript. Detalle:
tools/atelier-noelia/hooks-mac/README.md.
Lingua workflow · cómo 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 hecho un commit sul branch main", dici "Claude, che vuol dire? Spiegamelo cómo 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.