DESIGN.md · git:20261025.4561c29 · 2026-10-25 · sha256 915321eb03bbf6b6

DESIGN.md git:20261025.4561c29A

Immutable. This exact content never changes and is served at /api/v1/blob/915321eb03bbf6b6.

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