Docs: levels and starting points (WP10)

[Arthurvdv]

Summary

• docs/levels.md (new): levels and starting points for organizations.
  • What a level is, and the four shipped levels with their intent, what is on, the default-stage counts and links to their generated pages in the engine: essential, recommended, strict, complete (index).
  • Picking a starting point: the closest shipped level plus overrides, everything off with New-RulebookOffLevel.ps1, no maintenance with update.schedule.
  • The branch route that gets the endpoints, skeletons and Change Rule lists onto a pull request before the merge (C11 and C12 until then), in both variants: a direct commit to the branch or a pull request into it; merge-first and local regeneration as alternatives.
  • Adding a level, publishing one under another name (alias), everything off (the script's output, CRLF clones, the C8 and housekeeping caveats), adding a stage (and its quarantine file), removing a level or stage, how levels show up (endpoints, skeletons, index, rulebook.json, the Change Rule choices, the init script), and a troubleshooting table with the exact Validate, update and script messages.
  • Facts from the WP10 live run on a scratch repository are marked observed; the rest is code-derived.
• docs/README.md: the levels.md row is linked, its intent updated, status "written (WP10, #12)"; the intro sentence notes that a row may name another work package.
• README.md: the "Start strict or start lenient" row and getting-started step 2 link docs/levels.md.

Engine side: ALCops/rulebook-engine#80 (Rulebook.Levels, the off-level script, the generated level pages, authoring-levels.md, D49), merged; WP10 is ALCops/rulebook-engine#12 (closed).

Review

Two Sonnet rounds (round 1 manual plus skill, round 2 manual), approve with fixes each, no must-fix.

🤖 Generated with Claude Code