# Naming Conventions

## File Naming

| Doc Type | Pattern                              | Example                          |
| -------- | ------------------------------------ | -------------------------------- |
| Actor    | kebab-case                           | `sales-representative.md`        |
| Flow     | kebab-case directory                 | `employee-onboarding/README.md`  |
| Story    | `<actor>--<story-name>.md`           | `admin--create-user.md`          |
| Screen   | kebab-case, noun-focused             | `supplier-list.md`               |
| Resolver | camelCase action-verb                | `createSupplierInvitation.md`    |

## Heading Conventions

See [schema-constraints.md](schema-constraints.md) for H1 heading rules enforced by `erp-kit app check`.

Additional conventions:

- Story heading: Title Case of story name after `--` prefix (e.g., `admin--create-user.md` → `# Create User`)
- Screen heading: Title Case of filename slug
- Resolver heading: camelCase matching filename
