# Format

Audience: AI coding agents first.

The format and the authoring protocol are owned by the `create-journeys` skill
(`~/.claude/skills/create-journeys/SKILL.md`). Do not duplicate them here — read the skill.

Pipeline: `create-journeys` (contract) → `creating-journey-e2e-tests` (test) → run the test.
The test is the verifier; a `VALID` gate proves structure and citation, never semantics.

Local facts an agent needs before authoring in this catalog:

- **Project root for the validator is the monorepo root** (`/home/user/Projects/platform`), not
  `apps/mod-cms`. Journeys cite `packages/auth/**` as well as `apps/mod-cms/**`, so evidence paths are
  relative to the monorepo root.
- **Roles** are defined at `apps/mod-cms/src/lib/admin-engine.ts:8`; see `01-actors.md`.
- **Blockers** live in `scan-problems.md`, one ID per missing capability, each tied to one `UNKNOWN`
  contract field.