Skip to content

Add reproducibility runbooks for four multi-reasoner templates#57

Open
cafzal wants to merge 1 commit intotelco-network-recovery-templatefrom
worktree-runbooks-and-base-ontologies
Open

Add reproducibility runbooks for four multi-reasoner templates#57
cafzal wants to merge 1 commit intotelco-network-recovery-templatefrom
worktree-runbooks-and-base-ontologies

Conversation

@cafzal
Copy link
Copy Markdown
Collaborator

@cafzal cafzal commented May 5, 2026

Summary

Adds a customer-facing runbook.md to four multi-reasoner templates, each describing how an agent + RAI skills could recreate the template's pipeline using the bundled CSVs in the template's data/ directory.

Template Stages
telco_network_recovery descriptive → rules → graph → predictive → prescriptive
energy_grid_planning predictive → graph → rules → prescriptive (InvestmentLevel scenarios)
supply_chain_resilience blast-radius → graph → rules → min-cost flow + scenarios
machine_maintenance querying → graph → rules → prescriptive schedule → resilience

The telco runbook in this PR is the same structure as the one bundled with PR #56 (this PR is stacked on that branch). The other three were rewritten from older demo runbooks under ~/Documents/demos/runbooks/ — internal references and demo-context language stripped, stages and outputs aligned to each template's actual concept and property names, missing stages added (supply chain Stage 0 reachability, machine maintenance Stage 4 resilience), demo-only stages dropped (predictive supply chain step, manufacturing operator-shift block).

Test plan

  • Read each references/runbook.md and confirm stage outputs match the template's main script
  • Spot-check at least one template by running the main script and comparing numbers to the runbook's expected outputs
  • Confirm no internal references (account names, internal repo paths, eval CSVs) leaked into any runbook

Each runbook is an agent prompt sequence to recreate the template's
multi-reasoner pipeline using the bundled CSVs in ../data/, mapping
each stage to the template's actual concepts, properties, and outputs:

- telco_network_recovery (5-stage: descriptive -> rules -> graph ->
  predictive -> prescriptive; mirrors PR #56's existing structure)
- energy_grid_planning (4-stage: predictive -> graph -> rules ->
  prescriptive with InvestmentLevel scenarios)
- supply_chain_resilience (4-stage: blast-radius -> graph -> rules ->
  min-cost flow + scenarios)
- machine_maintenance (5-stage: querying -> graph -> rules ->
  prescriptive maintenance schedule -> resilience cross-training)

Reproducible against the bundled template CSVs; one-line notes on
swapping to a Snowflake schema for users wiring to their own data.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant