DESIGN.md · diff

git:20260729.68c84be to git:20260729.77491e9

22 added, 2 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

# DESIGN.md
- No hay UI en este repo. Es un repo de skills + scripts consumido por agentes coding.
+ ## Principios
- Si en el futuro se agrega un dashboard o UI, definir acá:
+ Este repo no tiene UI. Es consumido por agentes coding via skills (markdown) y scripts (Node.js). Los "usuarios" son agentes, no humanos.
+
+ ## Formato de skills
+
+ - Frontmatter YAML: `name`, `description`
+ - Markdown plano, sin HTML
+ - Checklists con `- [ ]` para pasos accionables
+ - Tablas para datos estructurados
+ - Bloques de código para comandos y SQL
+ - Máxima densidad por token: breve, directo, sin prosa decorativa
+
+ ## Convenciones de nombres
+
+ - Skills: kebab-case (`playwright-cli`, `job-search`)
+ - Tablas SQL: snake_case (`users`, `applications`)
+ - JSONB keys: snake_case (`job_preferences`, `style_profile`)
+ - Archivos de doc: UPPERCASE (`ADR.md`, `PLATFORMS.md`)
+
+ ## Si se agrega UI en el futuro
+
+ Definir acá:
- Tokens (color, tipografía, espaciado)
- Catálogo de componentes
- Patrones de estados (loading, error, empty)
- Criterios de accesibilidad