DESIGN.md ยท diff

git:20260731.81b1dfc to git:20261025.4561c29

1 added, 1 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
## Principles
This repo has no UI. It's consumed by coding agents via skills (markdown) and scripts (Node.js). The "users" are agents, not humans.
## Skill format
- YAML frontmatter: `name`, `description`
- Plain markdown, no HTML
- Checklists with `- [ ]` for actionable steps
- Tables for structured data
- Code blocks for commands and SQL
- Maximum density per token: brief, direct, no decorative prose
## Naming conventions
- - Skills: kebab-case (`playwright-cli`, `job-search`)
+ - Skills: kebab-case (`browser-automation`, `job-search`)
- SQL tables: snake_case (`users`, `applications`)
- JSONB keys: snake_case (`job_preferences`, `style_profile`)
- Doc files: UPPERCASE (`ADR.md`, `PLATFORMS.md`)
## If UI is added in the future
Define here:
- Tokens (color, typography, spacing)
- Component catalog
- State patterns (loading, error, empty)
- Accessibility criteria