boma/roles/README.md

14 lines
615 B
Markdown
Raw Permalink Normal View History

# roles/
Local Ansible roles. **No Galaxy roles** — every role is written and maintained here
(ADR-003). Scaffold new ones with `make new-role NAME=<name>`; never create the
directory structure by hand.
Each role must have: a `molecule/default/` scenario (Debian 13), a populated
`README.md`, and a filled-in `meta/main.yml`. Conventions: CLAUDE.md and
`docs/runbooks/new-role.md`.
Current state: `base` and `docker_host` are **not built yet** — they exist only as
empty, untracked dirs, so `site.yml` would fail on a clean clone. Build them with
`make new-role` when defining the baseline. See `STATUS.md`.