DESIGN.md · git:20260731.81b1dfc · 2026-07-31 · sha256 716cca947122c4ae

DESIGN.md git:20260731.81b1dfcA

Immutable. This exact content never changes and is served at /api/v1/blob/716cca947122c4ae.

# 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`)
- 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