# CLAUDE.md — proyecto que usa Arckode UI

> Copiá a la raíz de tu proyecto como `CLAUDE.md`. Claude Code / OpenCode lo cargan automáticamente.

## ⚠️ LECTURA OBLIGATORIA antes de generar código

```
node_modules/arckode-ui/AIREF.md
```

Lookup compacto (~500 líneas) con stack obligatorio, bootstrap exacto, 27 reglas del analyzer, 18 patrones canónicos, 52 primitivos UI, troubleshooting. Cargá ese archivo de golpe — ya cubre todo lo común.

## Validación obligatoria pre-commit

```bash
npx ark analyze    # debe pasar con 0 errors
```

Si reporta una violation: leer el campo `fix:` literal y aplicarlo. No improvisar.

## Sub-skills (solo si necesitás profundizar)

```
node_modules/arckode-ui/skills/runtime/SKILL.md      ← signals/lifecycle interno
node_modules/arckode-ui/skills/compiler/SKILL.md     ← directivas/scoped CSS
node_modules/arckode-ui/skills/analyzer/SKILL.md     ← agregar regla nueva
node_modules/arckode-ui/skills/components/SKILL.md   ← patrones detallados con razón
node_modules/arckode-ui/skills/cli/SKILL.md          ← CLI interno
node_modules/arckode-ui/skills/testing/SKILL.md      ← Vitest + happy-dom
```