coulomb/runbook-tutorials
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Close the runbook-tutorials workplans: statuses, backlog with qualified tasks, documents refreshed (RBT-WP-0009-T03, T07)
Some checks are pending
CI Smoke / host-smoke (push) Waiting to run
Details
CI Smoke / container-smoke (push) Waiting to run
Details
Tests / tests (push) Waiting to run
Details
Work Records / validate (push) Waiting to run
Details

Browse source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: sonnet
Assistant-Process: 295952@bnt-lap001
Assistant-Session: e93f64ad-516c-46eb-9666-aad8d300c477
This commit is contained in:
tegwick 2026-09-29 21:45:24 +02:00
parent 2967ebb929
commit 1398b8f95a
15 changed files with 119 additions and 37 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/README.md Normal file
View file

@ -0,0 +1,12 @@
# Documents
| Document | What it is |
| --- | --- |
| [`pack-spec-v0.2.md`](pack-spec-v0.2.md) | The current runbook pack specification: stages, steps, alternatives, gates, actors, datapoints, artefacts, modes, deviations |
| [`pack-spec.md`](pack-spec.md) | The v0.1 specification, still supported |
| [`run-spec.md`](run-spec.md) | What a run records and the rules the engine enforces: outcomes and scores, locked and sealed records, exports, captures, timestamps, v0.2 runs |
| [`maturity-and-projects.md`](maturity-and-projects.md) | Maturity, attribute sets, projects, templates, project runs, and the retirement of `exercise_status` |
| [`console-mapping.md`](console-mapping.md) | The security bootstrap console mapped onto v0.2, and the seven gaps a v0.3 would close |
| [`ux-review-2026-09-29.md`](ux-review-2026-09-29.md) | The first hands-on review that shaped v0.2 and the UI |
Direction is in [`../INTENT.md`](../INTENT.md), scope and current state in [`../SCOPE.md`](../SCOPE.md), work in [`../workplans/`](../workplans/).

4
docs/pack-spec-v0.2.md
View file

@ -3,7 +3,9 @@
Status: **adopted 2026-09-29** (Bernd's review answers are in the Decisions section).
Derived from `docs/ux-review-2026-09-29.md`. v0.1 stays valid; v0.2 is a superset.
Machine-checkable form: `rtut/schema/runbook-pack-v0.2.schema.json` plus the semantic
checks in `rtut/v2.py`. The engine and UI do not run v0.2 packs yet (RBT-WP-0007).
checks in `rtut/v2.py`. The engine (`rtut/run2.py`) and the UI run v0.2 packs. This is the
current version for new packs; a change that would invalidate existing v0.2 packs becomes v0.3
(candidates: `docs/console-mapping.md`, gaps G1 to G7).
## Principle

2
docs/pack-spec.md
View file

@ -1,5 +1,7 @@
# Runbook pack specification v0.1
Status: supported, no longer extended. New packs use v0.2 (`docs/pack-spec-v0.2.md`); v0.1 packs keep running unchanged.
A **runbook pack** is a directory `runbooks/<pack-dir>/` in the repository that
owns the procedure. It contains `pack.yaml`, validated by
`rtut/schema/runbook-pack.schema.json`, plus optional supporting files. The engine