coulomb/runbook-tutorials
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A userinterface specialized to present runbook tutorials that with parameters can guide through actual it administration and operation tasks.
16 commits 1 branch 0 tags 1.4 MiB
Find a file
custodian-sync c1391f418c
Some checks failed
Work Records / validate (push) Waiting to run
Details
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Has been cancelled
Details
chore(consistency): sync task status from DB [auto] 
Updated by fix-consistency on 2026-09-29:
  - update .custodian-brief.md for runbook-tutorials

Assistant: claude-code
Assistant-Model: sonnet
Assistant-Process: 295952@bnt-lap001
Assistant-Session: e93f64ad-516c-46eb-9666-aad8d300c477
2026-09-29 10:31:55 +02:00
.claude/rules Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
.forgejo/workflows Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
docs Record UX review, propose spec v0.2, add workplan RBT-WP-0007 and UI tasks 2026-09-29 10:31:17 +02:00
registry Add runbook pack spec, validator, legacy launcher, and workplans RBT-WP-0002..0006 2026-09-29 00:24:05 +02:00
rtut Add text parameter type; verify commands run in the owning repo root 2026-09-29 08:33:47 +02:00
runbooks/example-hello Add runbook pack spec, validator, legacy launcher, and workplans RBT-WP-0002..0006 2026-09-29 00:24:05 +02:00
schema Add text parameter type; verify commands run in the owning repo root 2026-09-29 08:33:47 +02:00
tests Add text parameter type; verify commands run in the owning repo root 2026-09-29 08:33:47 +02:00
workplans Record UX review, propose spec v0.2, add workplan RBT-WP-0007 and UI tasks 2026-09-29 10:31:17 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-09-29 10:31:55 +02:00
.gitignore Add run records, step state machine, verification and exercise-status diff (RBT-WP-0003) 2026-09-29 00:43:38 +02:00
.repo-classification.yaml Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
AGENTS.md Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
CLAUDE.md Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
INTENT.md Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
LICENSE Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
Makefile Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
README.md Add local web UI for native packs (RBT-WP-0004-T02) 2026-09-29 00:45:20 +02:00
SCOPE.md Scaffold runbook-tutorials repo: intent, scope, agent rules, State Hub registration 2026-09-29 00:20:46 +02:00
WORK-RECORDS.md Sync consistency output 2026-09-29 00:45:51 +02:00

README.md

runbook-tutorials

A user interface specialized to present runbook tutorials that with parameters can guide through actual IT administration and operation tasks.

  • Intent: INTENT.md · Scope: SCOPE.md
  • Pack specification: docs/pack-spec.md, schema in schema/
  • Packs live where the procedure lives: runbooks/<pack>/pack.yaml in the owning repo. Examples: net-kingdom/runbooks/, and runbooks/example-hello/ here.
python3 -m rtut validate <repo-root>      # validate every pack
python3 -m rtut list <repo-root>          # id, engine, exercise status, title
python3 -m rtut show <pack.yaml>          # steps with owners and done-when
python3 -m rtut render <pack.yaml> <step> -p name=value
python3 -m rtut launch <pack.yaml>        # legacy-command packs: start the existing console
python3 -m rtut ui <repo-root>            # local web UI on 127.0.0.1:8877: walk a pack, record a run
python3 -m rtut run new|start|verify|done|finish <pack.yaml> ...   # the same run record from the terminal
make test

Status: specification, validator, legacy launch, run records with verification and exercise-status diff, and a first local web UI work. Terminal walk-through mode and the console migration are open (workplans/).