From 9aea0d3ab34246e20bfc100c812ded22e1182b19 Mon Sep 17 00:00:00 2001
From: cafzal <cameron.afzal@gmail.com>
Date: Mon, 8 Jun 2026 10:41:10 -0700
Subject: [PATCH 1/3] Move templates index to root README; enrich and normalize
 by industry

- Restructure root README: replace "Repository layout" with a "Templates"
  section (per-folder contents list, now including runbook.md) plus a
  generated, collapsible-by-industry index
- generate_version_indexes.py now extracts industry + reasoning_types and
  writes the index to both the root README (between markers) and each
  version README, grouped by industry
- Normalize industry frontmatter into 8 coarse, mutually-exclusive buckets
  across all version dirs
- Update CONTRIBUTING, pre-commit, and the verify-version-indexes workflow
  to cover the root README and the new front-matter fields
---
 .github/workflows/verify-version-indexes.yml  |   1 +
 .pre-commit-config.yaml                       |   2 +-
 CONTRIBUTING.md                               |   6 +-
 README.md                                     | 130 +++++++++++++-
 scripts/generate_version_indexes.py           | 143 ++++++++++++---
 v0.13/README.md                               | 105 ++++++++---
 v0.13/ad_spend_allocation/README.md           |   2 +-
 v0.13/diet/README.md                          |   2 +-
 v0.13/hospital_staffing/README.md             |   2 +-
 v0.13/inventory_rebalancing/README.md         |   2 +-
 v0.13/network_flow/README.md                  |   2 +-
 v0.13/order_fulfillment/README.md             |   2 +-
 v0.13/portfolio_balancing/README.md           |   2 +-
 v0.13/retail_markdown/README.md               |   2 +-
 v0.13/shift_assignment/README.md              |   2 +-
 v0.13/supplier_reliability/README.md          |   2 +-
 v0.13/supply_chain_transport/README.md        |   2 +-
 v0.13/test_data_generation/README.md          |   2 +-
 v0.13/traveling_salesman/README.md            |   2 +-
 v0.13/vehicle_scheduling/README.md            |   2 +-
 v0.13/water_allocation/README.md              |   2 +-
 v0.14/README.md                               | 105 ++++++++---
 v0.14/ad_spend_allocation/README.md           |   2 +-
 v0.14/diet/README.md                          |   2 +-
 v0.14/hospital_staffing/README.md             |   2 +-
 v0.14/inventory_rebalancing/README.md         |   2 +-
 v0.14/network_flow/README.md                  |   2 +-
 v0.14/order_fulfillment/README.md             |   2 +-
 v0.14/portfolio_balancing/README.md           |   2 +-
 v0.14/retail_markdown/README.md               |   2 +-
 v0.14/shift_assignment/README.md              |   2 +-
 v0.14/supplier_reliability/README.md          |   2 +-
 v0.14/supply_chain_transport/README.md        |   2 +-
 v0.14/test_data_generation/README.md          |   2 +-
 v0.14/traveling_salesman/README.md            |   2 +-
 v0.14/vehicle_scheduling/README.md            |   2 +-
 v0.14/water_allocation/README.md              |   2 +-
 v1/README.md                                  | 163 ++++++++++++------
 v1/ad_spend_allocation/README.md              |   2 +-
 v1/book_slate_recommendation/README.md        |   2 +-
 v1/campaign_roi/README.md                     |   2 +-
 v1/cell_tower_coverage/README.md              |   2 +-
 v1/cicd_runner_allocation/README.md           |   2 +-
 v1/commercial_underwriting/README.md          |   2 +-
 v1/datacenter_compute_allocation/README.md    |   2 +-
 v1/demand_forecasting/README.md               |   2 +-
 v1/demand_planning_temporal/README.md         |   2 +-
 v1/diet/README.md                             |   2 +-
 v1/disease-outbreak-prevention/README.md      |   2 +-
 v1/financial_index_replication/README.md      |   2 +-
 v1/hospital_staffing/README.md                |   2 +-
 v1/humanitarian-aid-supply-chain/README.md    |   2 +-
 v1/memory_supply_allocation/README.md         |   2 +-
 v1/money_laundering_motif_detection/README.md |   2 +-
 v1/patient_cohort_recruitment/README.md       |   2 +-
 v1/planogram_optimization/README.md           |   2 +-
 v1/pod_placement/README.md                    |   2 +-
 v1/portfolio_balancing/README.md              |   2 +-
 v1/rai-agent-scaffold/README.md               |   2 +-
 v1/retail_markdown/README.md                  |   2 +-
 v1/retail_planning/README.md                  |   2 +-
 v1/shift_assignment/README.md                 |   2 +-
 v1/simple-start/README.md                     |   2 +-
 v1/smoker_status_prediction/README.md         |   2 +-
 v1/sprint_scheduling/README.md                |   2 +-
 v1/subscriber_retention/README.md             |   2 +-
 v1/synthetic_eligibility_records/README.md    |   2 +-
 v1/synthetic_order_lifecycle/README.md        |   2 +-
 v1/telco_network_recovery/README.md           |   2 +-
 v1/test_data_generation/README.md             |   2 +-
 v1/traveling_salesman/README.md               |   2 +-
 v1/underwriting_audit/README.md               |   2 +-
 v1/water_allocation/README.md                 |   2 +-
 v1/wildlife-conservation-network/README.md    |   2 +-
 74 files changed, 593 insertions(+), 194 deletions(-)

diff --git a/.github/workflows/verify-version-indexes.yml b/.github/workflows/verify-version-indexes.yml
index b96b1a46..21256bee 100644
--- a/.github/workflows/verify-version-indexes.yml
+++ b/.github/workflows/verify-version-indexes.yml
@@ -3,6 +3,7 @@ name: Verify version indexes
 on:
   pull_request:
     paths:
+      - "README.md"
       - "v*/**/README.md"
       - "scripts/generate_version_indexes.py"
       - "requirements-dev.txt"
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 2fc2a691..9853a912 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -23,4 +23,4 @@ repos:
         pass_filenames: false
         additional_dependencies:
           - PyYAML==6.0.2
-        files: ^(v\d.*/.*/README\.md|scripts/generate_version_indexes\.py)$
+        files: ^(README\.md|v\d.*/.*/README\.md|scripts/generate_version_indexes\.py)$
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index bf5ceebf..3e5b3457 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -159,11 +159,11 @@ Before opening a PR, make sure you can complete this checklist from a clean envi
   python scripts/generate_version_indexes.py --check
   ```
 
-## Keep version README indexes in sync
+## Keep template indexes in sync
 
-Version README files (`v0.13/README.md`, `v0.14/README.md`, `v1/README.md`) are generated from template README metadata, specifically the `description` field in front matter.
+The template index is generated from each template README's front matter — the `description`, `industry`, and `reasoning_types` fields. It is written to each version README (`v0.13/README.md`, `v0.14/README.md`, `v1/README.md`) and to the repository root `README.md`, between its `<!-- BEGIN TEMPLATE INDEX -->` / `<!-- END TEMPLATE INDEX -->` markers.
 
-If you add a template or update a template description, regenerate the version indexes and commit the resulting README changes.
+If you add a template or change a template's `description`, `industry`, or `reasoning_types`, regenerate the indexes and commit the resulting README changes.
 
 ```bash
 python scripts/generate_version_indexes.py
diff --git a/README.md b/README.md
index 57004130..a288b85b 100644
--- a/README.md
+++ b/README.md
@@ -4,14 +4,7 @@ This repository contains runnable RelationalAI templates that demonstrate end-to
 
 Each template lives in its own folder with code, sample data, and a template-specific README. Templates are grouped into versioned directories so the repository can support multiple generations of examples side by side.
 
-## Repository layout
-
-| Path | Purpose |
-| --- | --- |
-| [`sample-template/`](sample-template/) | Starting point for authoring a new template. Includes the expected file layout and README template. |
-| [`v0.13/`](v0.13/) | Older templates for version `0.13` of the `relationalai` Python package. Included for reference, only. |
-| [`v0.14/`](v0.14/) | Older templates for version `0.14` of the `relationalai` Python package. Included for reference, only. |
-| [`v1/`](v1/) | Newer templates for versions `>=1.0` of the `relationalai` Python package. **Use these for new development.** |
+## Templates
 
 Within a template folder, you will usually find:
 
@@ -19,6 +12,125 @@ Within a template folder, you will usually find:
 - `pyproject.toml` for template-local dependencies
 - a main runner such as `<template>.py` or a notebook
 - `data/` containing sample input data when the template uses local files
+- `runbook.md` with ordered prompts to recreate or adapt the template using a coding agent with RelationalAI skills (multi-reasoner templates)
+
+The index below covers the current (`v1`) templates, grouped by industry. Expand an industry to see its templates, the reasoners each uses, and a one-line description. Older templates remain under [`v0.13/`](v0.13/) and [`v0.14/`](v0.14/) for reference; use `v1` for new development.
+
+<!-- BEGIN TEMPLATE INDEX -->
+
+<details>
+<summary>Cross-Industry (4)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [rai-agent-scaffold](v1/rai-agent-scaffold/) | Graph | Scaffold for packaging a RelationalAI semantic model as a Snowflake Cortex agent and exposing it through Snowflake Intelligence. |
+| [shift_assignment](v1/shift_assignment/) | Prescriptive | Assign workers to shifts based on availability to meet coverage requirements. |
+| [simple-start](v1/simple-start/) | Graph | A minimal notebook to connect to Snowflake, model a small graph, and compute betweenness centrality with RelationalAI. |
+| [wildlife-conservation-network](v1/wildlife-conservation-network/) | Graph | Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs. |
+
+</details>
+
+<details>
+<summary>Energy & Utilities (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [energy_grid_planning](v1/energy_grid_planning/) | Graph, Rules-based, Prescriptive | Multi-reasoner template: demand forecasting, grid vulnerability analysis, compliance rules, and multi-objective optimization for AI data center interconnection planning on the ERCOT (Texas) grid. |
+| [water_allocation](v1/water_allocation/) | Prescriptive | Minimize the cost of distributing water from sources to users with nonlinear transmission losses. |
+
+</details>
+
+<details>
+<summary>Financial Services (7)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [commercial_underwriting](v1/commercial_underwriting/) | Rules-based | Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
+| [financial_index_replication](v1/financial_index_replication/) | Prescriptive, Rules-based | Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
+| [fraud-detection](v1/fraud-detection/) | Graph, Rules-based, Predictive, Prescriptive | Multi-reasoner transaction-fraud pipeline: account PageRank (Graph) + high-volume account flags (Rules) feed a GNN binary classifier (Predictive) whose per-transaction scores drive a knapsack investigator-budget MILP (Prescriptive). |
+| [money_laundering_motif_detection](v1/money_laundering_motif_detection/) | Prescriptive | Detect three classes of layering motif on the same transaction ledger, each demonstrating a different CSP technique that rules / paths / graph reasoning alone cannot enforce: per-vertex aggregate equality (butterfly), pairwise distinctness over a chosen subset (smurf army), and cardinality on a chosen subset (KYC-mix burst). |
+| [portfolio_balancing](v1/portfolio_balancing/) | Prescriptive, Rules-based, Graph | Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
+| [synthetic_order_lifecycle](v1/synthetic_order_lifecycle/) | Prescriptive | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver. |
+| [underwriting_audit](v1/underwriting_audit/) | Prescriptive | Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode. |
+
+</details>
+
+<details>
+<summary>Healthcare & Life Sciences (6)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [diet](v1/diet/) | Prescriptive | Select foods to satisfy nutritional requirements at minimum cost. |
+| [disease-outbreak-prevention](v1/disease-outbreak-prevention/) | Graph | Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks. |
+| [hospital_staffing](v1/hospital_staffing/) | Prescriptive | Explore the tradeoff between overtime cost and patient service level using bi-objective optimization with epsilon constraint. |
+| [patient_cohort_recruitment](v1/patient_cohort_recruitment/) | Graph, Rules-based, Prescriptive | Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize. |
+| [smoker_status_prediction](v1/smoker_status_prediction/) | Predictive | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network. |
+| [synthetic_eligibility_records](v1/synthetic_eligibility_records/) | Prescriptive | Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
+
+</details>
+
+<details>
+<summary>Manufacturing (4)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [bom-reachability](v1/bom-reachability/) | Graph | Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks. |
+| [factory_production](v1/factory_production/) | Prescriptive | Maximize production profit under per-factory resource limits, then read the sensitivity marginals (capacity shadow prices and product reduced costs) from one solve. |
+| [product_configurator](v1/product_configurator/) | Prescriptive | Enumerate every feasible build of a configurable product using a CSP solver in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
+| [production_planning](v1/production_planning/) | Prescriptive | Schedule production across machines to meet demand and maximize profit with scenario analysis. |
+
+</details>
+
+<details>
+<summary>Retail & Consumer (7)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [ad_spend_allocation](v1/ad_spend_allocation/) | Prescriptive | Allocate marketing budget across channels and campaigns to maximize conversions. |
+| [book_slate_recommendation](v1/book_slate_recommendation/) | Graph, Prescriptive | Recommend K books per reader and order them by slot, under diversity, freshness, and explainability constraints. |
+| [campaign_roi](v1/campaign_roi/) | Prescriptive | Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region. |
+| [demand_forecasting](v1/demand_forecasting/) | Predictive | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies. |
+| [planogram_optimization](v1/planogram_optimization/) | Predictive, Prescriptive | Decide integer facing counts per SKU to maximize predicted weekly demand under shelf capacity and category cardinality limits, where per-(SKU, facing_count) demand comes from a regression model. |
+| [retail_markdown](v1/retail_markdown/) | Prescriptive | Set discount levels across weeks to maximize revenue while clearing inventory. |
+| [retail_planning](v1/retail_planning/) | Predictive, Prescriptive | Predict article sales and customer churn with GNNs, then optimize markdown pricing and inventory planning to maximize revenue and minimize costs. |
+
+</details>
+
+<details>
+<summary>Supply Chain & Logistics (9)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [demand_planning_temporal](v1/demand_planning_temporal/) | Prescriptive | Plan weekly production and inventory across sites over a date-filtered planning horizon to minimize total cost while meeting demand. |
+| [humanitarian-aid-supply-chain](v1/humanitarian-aid-supply-chain/) | Graph | Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies. |
+| [network_flow_planning](v1/network_flow_planning/) | Prescriptive | Plan a multi-tier distribution flow that decides which fulfillment centers to open and how much to ship on every lane to satisfy customer demand at minimum cost. |
+| [shipment_compliance](v1/shipment_compliance/) | Rules-based | Define derived business rules for shipment compliance, sourcing risk, and demand escalation. |
+| [supplier_reliability](v1/supplier_reliability/) | Prescriptive | Select suppliers to meet product demand at minimum cost, with sensitivity marginals and supplier-disruption scenario analysis. |
+| [supply_chain_resilience](v1/supply_chain_resilience/) | Graph, Rules-based, Prescriptive | A multi-reasoner template that chains blast-radius reachability, graph analysis, rules-based classification, and prescriptive optimization to build a risk-adjusted minimum-cost network flow for supply chain routing. |
+| [supply_chain_transport](v1/supply_chain_transport/) | Prescriptive | Minimize inventory holding and transport costs with TL/LTL mode selection. |
+| [traveling_salesman](v1/traveling_salesman/) | Prescriptive | Find the shortest route visiting all cities exactly once using the MTZ formulation. |
+| [warehouse_allocation](v1/warehouse_allocation/) | Graph, Prescriptive | Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs. |
+
+</details>
+
+<details>
+<summary>Technology & Telecom (9)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [cell_tower_coverage](v1/cell_tower_coverage/) | Prescriptive | Select candidate cell tower sites and assign demand zones to maximize covered population under budget, tower-count, and capacity limits. |
+| [cicd_runner_allocation](v1/cicd_runner_allocation/) | Prescriptive | Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels and conflict analysis to diagnose an infeasible outage. |
+| [datacenter_compute_allocation](v1/datacenter_compute_allocation/) | Predictive, Graph, Rules-based, Prescriptive | Multi-reasoner template (chain follow-up to energy_grid_planning): heterogeneous-graph GNN classification of per-workload utilization probability, hardware-compatibility rules, dependency PageRank, and 24-cell scenario MIP for inside-the-fence GPU allocation across hyperscaler campuses. |
+| [memory_supply_allocation](v1/memory_supply_allocation/) | Predictive, Rules-based, Prescriptive, Graph | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
+| [pod_placement](v1/pod_placement/) | Prescriptive | Assign pods to nodes in a Kubernetes-style cluster subject to per-node CPU / memory / GPU bin-packing, pairwise tenant anti-affinity, deployment co-location affinity, failure-domain spread, gang-placement atomicity, and topology rack-clique rules. Pure CSP via MiniZinc / Chuffed. |
+| [sprint_scheduling](v1/sprint_scheduling/) | Prescriptive | Assign backlog issues to developers across sprints, minimizing weighted completion time while respecting capacity and skill constraints. |
+| [subscriber_retention](v1/subscriber_retention/) | Graph, Predictive | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns. |
+| [telco_network_recovery](v1/telco_network_recovery/) | Predictive, Rules-based, Graph, Prescriptive | Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology. |
+| [test_data_generation](v1/test_data_generation/) | Prescriptive | Determine optimal row counts for test database tables satisfying schema and referential integrity constraints. |
+
+</details>
+
+<!-- END TEMPLATE INDEX -->
 
 ## Choose a template
 
@@ -27,7 +139,7 @@ Use the version folder and template README to pick the example that matches your
 - If you want a minimal onboarding example, start with [`v1/simple-start/`](v1/simple-start/).
 - If you want to create a new template, start from [`sample-template/`](sample-template/).
 
-For a full list of templates and their descriptions, check out the [`v1/README.md`](v1/README.md) file.
+For the full list of templates and their descriptions, see the [Templates](#templates) index above.
 
 ## Getting started with a template
 
diff --git a/scripts/generate_version_indexes.py b/scripts/generate_version_indexes.py
index 489a817b..cb1e1893 100644
--- a/scripts/generate_version_indexes.py
+++ b/scripts/generate_version_indexes.py
@@ -1,9 +1,16 @@
 #!/usr/bin/env python3
-"""Generate version README template indexes from template README metadata.
+"""Generate template indexes from template README front matter.
 
 This script scans version folders (e.g. v0.13, v0.14, v1), reads each
-template README front matter, extracts `description`, and writes a concise
-index README for each version.
+template README front matter, extracts `description`, `industry`, and
+`reasoning_types`, and writes a collapsible, industry-grouped index.
+
+The index is written to two places:
+
+* each version folder's `README.md` (the per-version index), and
+* the repository root `README.md`, between the
+  `<!-- BEGIN TEMPLATE INDEX -->` / `<!-- END TEMPLATE INDEX -->`
+  markers (the index for the current `v1` templates).
 """
 
 from __future__ import annotations
@@ -19,11 +26,24 @@
 VERSION_DIR_RE = re.compile(r"^v\d")
 FRONT_MATTER_RE = re.compile(r"^---\s*\n(.*?)\n---\s*(?:\n|$)", re.DOTALL)
 
+# Version whose index is mirrored into the repository root README.
+ROOT_INDEX_VERSION = "v1"
+ROOT_INDEX_BEGIN = "<!-- BEGIN TEMPLATE INDEX -->"
+ROOT_INDEX_END = "<!-- END TEMPLATE INDEX -->"
+ROOT_INDEX_RE = re.compile(
+    re.escape(ROOT_INDEX_BEGIN) + r".*?" + re.escape(ROOT_INDEX_END),
+    re.DOTALL,
+)
+
+UNCATEGORIZED = "Uncategorized"
+
 
 @dataclass(frozen=True)
 class TemplateEntry:
     name: str
     description: str
+    industry: str
+    reasoners: tuple[str, ...]
 
 
 def escape_md_table_cell(value: str) -> str:
@@ -31,29 +51,47 @@ def escape_md_table_cell(value: str) -> str:
     return " ".join(value.split()).replace("|", r"\|")
 
 
-def extract_description(readme_path: Path) -> str:
+def parse_front_matter(readme_path: Path) -> dict:
     text = readme_path.read_text(encoding="utf-8")
     front_matter_match = FRONT_MATTER_RE.match(text)
     if not front_matter_match:
         raise ValueError("missing YAML front matter block")
 
-    front_matter = front_matter_match.group(1)
     try:
-        metadata = yaml.safe_load(front_matter) or {}
+        metadata = yaml.safe_load(front_matter_match.group(1)) or {}
     except yaml.YAMLError as exc:
         raise ValueError(f"invalid YAML front matter: {exc}") from exc
 
     if not isinstance(metadata, dict):
         raise ValueError("front matter must parse to a mapping")
 
-    value = metadata.get("description")
-    if not isinstance(value, str):
+    return metadata
+
+
+def build_entry(name: str, metadata: dict) -> TemplateEntry:
+    description = metadata.get("description")
+    if not isinstance(description, str) or not description.strip():
         raise ValueError("description key not found in front matter")
 
-    value = escape_md_table_cell(value)
-    if not value:
-        raise ValueError("empty description value")
-    return value
+    industry = metadata.get("industry")
+    if not isinstance(industry, str) or not industry.strip():
+        industry = UNCATEGORIZED
+
+    raw_reasoners = metadata.get("reasoning_types")
+    if not isinstance(raw_reasoners, list):
+        raw_reasoners = []
+    reasoners = tuple(
+        escape_md_table_cell(str(item))
+        for item in raw_reasoners
+        if str(item).strip()
+    )
+
+    return TemplateEntry(
+        name=name,
+        description=escape_md_table_cell(description),
+        industry=escape_md_table_cell(industry),
+        reasoners=reasoners,
+    )
 
 
 def collect_templates(version_dir: Path) -> list[TemplateEntry]:
@@ -66,8 +104,8 @@ def collect_templates(version_dir: Path) -> list[TemplateEntry]:
         if not template_readme.exists():
             continue
 
-        description = extract_description(template_readme)
-        entries.append(TemplateEntry(name=child.name, description=description))
+        metadata = parse_front_matter(template_readme)
+        entries.append(build_entry(child.name, metadata))
 
     if not entries:
         raise ValueError(f"no template README files found in {version_dir}")
@@ -75,8 +113,41 @@ def collect_templates(version_dir: Path) -> list[TemplateEntry]:
     return entries
 
 
+def build_index(entries: list[TemplateEntry], link_prefix: str) -> str:
+    """Build the collapsible, industry-grouped index body.
+
+    `link_prefix` is prepended to each template's folder link: `./` for a
+    per-version README that sits beside the templates, `v1/` for the root
+    README one level up.
+    """
+    by_industry: dict[str, list[TemplateEntry]] = {}
+    for entry in entries:
+        by_industry.setdefault(entry.industry, []).append(entry)
+
+    blocks: list[str] = []
+    for industry in sorted(by_industry, key=str.lower):
+        group = sorted(by_industry[industry], key=lambda e: e.name)
+        block = [
+            "<details>",
+            f"<summary>{industry} ({len(group)})</summary>",
+            "",
+            "| Template | Reasoners | Description |",
+            "| --- | --- | --- |",
+        ]
+        for entry in group:
+            reasoners = ", ".join(entry.reasoners) if entry.reasoners else "—"
+            block.append(
+                f"| [{entry.name}]({link_prefix}{entry.name}/) "
+                f"| {reasoners} | {entry.description} |"
+            )
+        block.extend(["", "</details>"])
+        blocks.append("\n".join(block))
+
+    return "\n\n".join(blocks)
+
+
 def build_version_readme(version: str, entries: list[TemplateEntry]) -> str:
-    lines = [
+    parts = [
         f"# {version} Templates",
         "",
         (
@@ -86,14 +157,27 @@ def build_version_readme(version: str, entries: list[TemplateEntry]) -> str:
         "",
         "## Template Index",
         "",
-        "| Template | Description |",
-        "| --- | --- |",
+        "Templates are grouped by industry. Expand an industry to see its "
+        "templates, the reasoners each uses, and a one-line description.",
+        "",
+        build_index(entries, "./"),
+        "",
     ]
+    return "\n".join(parts)
 
-    for entry in entries:
-        lines.append(f"| [{entry.name}](./{entry.name}/) | {entry.description} |")
 
-    return "\n".join(lines) + "\n"
+def build_root_readme(current: str, entries: list[TemplateEntry]) -> str:
+    if not ROOT_INDEX_RE.search(current):
+        raise ValueError(
+            "root README missing "
+            f"{ROOT_INDEX_BEGIN} / {ROOT_INDEX_END} markers"
+        )
+
+    index = build_index(entries, f"{ROOT_INDEX_VERSION}/")
+    block = f"{ROOT_INDEX_BEGIN}\n\n{index}\n\n{ROOT_INDEX_END}"
+    # Use a replacement function so backslashes in `block` (escaped table
+    # cells) are not interpreted as regex backreferences.
+    return ROOT_INDEX_RE.sub(lambda _match: block, current)
 
 
 def find_version_dirs(repo_root: Path) -> list[Path]:
@@ -114,9 +198,11 @@ def check_or_write(repo_root: Path, check_only: bool) -> int:
         return 1
 
     out_of_date: list[Path] = []
+    entries_by_version: dict[str, list[TemplateEntry]] = {}
 
     for version_dir in version_dirs:
         entries = collect_templates(version_dir)
+        entries_by_version[version_dir.name] = entries
         expected = build_version_readme(version_dir.name, entries)
         readme_path = version_dir / "README.md"
 
@@ -127,8 +213,19 @@ def check_or_write(repo_root: Path, check_only: bool) -> int:
                 readme_path.write_text(expected, encoding="utf-8")
                 print(f"Updated {readme_path.relative_to(repo_root)}")
 
+    root_readme = repo_root / "README.md"
+    root_entries = entries_by_version.get(ROOT_INDEX_VERSION)
+    if root_entries and root_readme.exists():
+        current = root_readme.read_text(encoding="utf-8")
+        expected = build_root_readme(current, root_entries)
+        if current != expected:
+            out_of_date.append(root_readme)
+            if not check_only:
+                root_readme.write_text(expected, encoding="utf-8")
+                print(f"Updated {root_readme.relative_to(repo_root)}")
+
     if check_only and out_of_date:
-        print("Version README indexes are out of date:", file=sys.stderr)
+        print("Template indexes are out of date:", file=sys.stderr)
         for path in out_of_date:
             print(f"- {path.relative_to(repo_root)}", file=sys.stderr)
         print(
@@ -138,14 +235,14 @@ def check_or_write(repo_root: Path, check_only: bool) -> int:
         return 1
 
     if check_only:
-        print("Version README indexes are up to date.")
+        print("Template indexes are up to date.")
 
     return 0
 
 
 def main() -> int:
     parser = argparse.ArgumentParser(
-        description="Generate version README indexes from template README metadata."
+        description="Generate template indexes from template README front matter."
     )
     parser.add_argument(
         "--check",
diff --git a/v0.13/README.md b/v0.13/README.md
index 46417fdc..ad4ad0c9 100644
--- a/v0.13/README.md
+++ b/v0.13/README.md
@@ -4,24 +4,87 @@ This directory contains the templates for v0.13. Each template folder includes i
 
 ## Template Index
 
-| Template | Description |
-| --- | --- |
-| [ad_spend_allocation](./ad_spend_allocation/) | Allocate a fixed budget across channel–campaign combinations to maximize expected conversions, subject to channel spend bounds and per-campaign budget limits. |
-| [diet](./diet/) | Select foods to satisfy daily nutritional requirements at minimum cost. |
-| [factory_production](./factory_production/) | Choose production quantities per machine-product pair to maximize profit while meeting minimum production requirements. |
-| [grid_interconnection](./grid_interconnection/) | Approve data center interconnection requests and substation upgrades to maximize net revenue within capital budget. |
-| [hospital_staffing](./hospital_staffing/) | Assign nurses to shifts to minimize overtime cost and overflow penalties from unmet patient demand. |
-| [inventory_rebalancing](./inventory_rebalancing/) | Transfer inventory between warehouse sites to meet demand at minimum cost. |
-| [machine_maintenance](./machine_maintenance/) | Schedule preventive maintenance across time slots to minimize cost while respecting crew-hour capacity and machine conflicts. |
-| [network_flow](./network_flow/) | Maximize flow through a capacitated network from a source node. |
-| [order_fulfillment](./order_fulfillment/) | Assign customer orders to fulfillment centers to minimize shipping and fixed costs. |
-| [portfolio_balancing](./portfolio_balancing/) | Allocate investment across stocks to minimize risk while achieving a target return. |
-| [production_planning](./production_planning/) | Schedule production across machines to meet demand while maximizing profit. |
-| [retail_markdown](./retail_markdown/) | Set discount levels for products across a selling season to maximize revenue while clearing inventory. |
-| [shift_assignment](./shift_assignment/) | Assign workers to shifts based on availability while meeting minimum coverage and per-worker capacity constraints. |
-| [supplier_reliability](./supplier_reliability/) | Select suppliers to meet product demand while balancing cost and reliability. |
-| [supply_chain_transport](./supply_chain_transport/) | Route shipments from warehouses to customers using multiple transport modes to minimize cost. |
-| [test_data_generation](./test_data_generation/) | Determine feasible row counts for test database tables that satisfy schema constraints, then generate example synthetic rows. |
-| [traveling_salesman](./traveling_salesman/) | Find the shortest route visiting all cities exactly once and returning to the start. |
-| [vehicle_scheduling](./vehicle_scheduling/) | Assign trips to vehicles to minimize total cost, including fixed vehicle activation costs and per-mile costs. |
-| [water_allocation](./water_allocation/) | Allocate water from sources to users at minimum cost while meeting demand, subject to connection limits and transmission losses. |
+Templates are grouped by industry. Expand an industry to see its templates, the reasoners each uses, and a one-line description.
+
+<details>
+<summary>Cross-Industry (1)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [shift_assignment](./shift_assignment/) | Prescriptive | Assign workers to shifts based on availability while meeting minimum coverage and per-worker capacity constraints. |
+
+</details>
+
+<details>
+<summary>Energy & Utilities (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [grid_interconnection](./grid_interconnection/) | Prescriptive | Approve data center interconnection requests and substation upgrades to maximize net revenue within capital budget. |
+| [water_allocation](./water_allocation/) | Prescriptive | Allocate water from sources to users at minimum cost while meeting demand, subject to connection limits and transmission losses. |
+
+</details>
+
+<details>
+<summary>Financial Services (1)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [portfolio_balancing](./portfolio_balancing/) | Prescriptive | Allocate investment across stocks to minimize risk while achieving a target return. |
+
+</details>
+
+<details>
+<summary>Healthcare & Life Sciences (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [diet](./diet/) | Prescriptive | Select foods to satisfy daily nutritional requirements at minimum cost. |
+| [hospital_staffing](./hospital_staffing/) | Prescriptive | Assign nurses to shifts to minimize overtime cost and overflow penalties from unmet patient demand. |
+
+</details>
+
+<details>
+<summary>Manufacturing (3)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [factory_production](./factory_production/) | Prescriptive | Choose production quantities per machine-product pair to maximize profit while meeting minimum production requirements. |
+| [machine_maintenance](./machine_maintenance/) | Prescriptive | Schedule preventive maintenance across time slots to minimize cost while respecting crew-hour capacity and machine conflicts. |
+| [production_planning](./production_planning/) | Prescriptive | Schedule production across machines to meet demand while maximizing profit. |
+
+</details>
+
+<details>
+<summary>Retail & Consumer (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [ad_spend_allocation](./ad_spend_allocation/) | Prescriptive | Allocate a fixed budget across channel–campaign combinations to maximize expected conversions, subject to channel spend bounds and per-campaign budget limits. |
+| [retail_markdown](./retail_markdown/) | Prescriptive | Set discount levels for products across a selling season to maximize revenue while clearing inventory. |
+
+</details>
+
+<details>
+<summary>Supply Chain & Logistics (7)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [inventory_rebalancing](./inventory_rebalancing/) | Prescriptive | Transfer inventory between warehouse sites to meet demand at minimum cost. |
+| [network_flow](./network_flow/) | Prescriptive | Maximize flow through a capacitated network from a source node. |
+| [order_fulfillment](./order_fulfillment/) | Prescriptive | Assign customer orders to fulfillment centers to minimize shipping and fixed costs. |
+| [supplier_reliability](./supplier_reliability/) | Prescriptive | Select suppliers to meet product demand while balancing cost and reliability. |
+| [supply_chain_transport](./supply_chain_transport/) | Prescriptive | Route shipments from warehouses to customers using multiple transport modes to minimize cost. |
+| [traveling_salesman](./traveling_salesman/) | Prescriptive | Find the shortest route visiting all cities exactly once and returning to the start. |
+| [vehicle_scheduling](./vehicle_scheduling/) | Prescriptive | Assign trips to vehicles to minimize total cost, including fixed vehicle activation costs and per-mile costs. |
+
+</details>
+
+<details>
+<summary>Technology & Telecom (1)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [test_data_generation](./test_data_generation/) | Prescriptive | Determine feasible row counts for test database tables that satisfy schema constraints, then generate example synthetic rows. |
+
+</details>
diff --git a/v0.13/ad_spend_allocation/README.md b/v0.13/ad_spend_allocation/README.md
index f08953bc..ec76101b 100644
--- a/v0.13/ad_spend_allocation/README.md
+++ b/v0.13/ad_spend_allocation/README.md
@@ -3,7 +3,7 @@ title: "Ad Spend Allocation"
 description: "Allocate a fixed budget across channel–campaign combinations to maximize expected conversions, subject to channel spend bounds and per-campaign budget limits."
 featured: false
 experience_level: intermediate
-industry: "Marketing"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/diet/README.md b/v0.13/diet/README.md
index 4e41328e..34702cc5 100644
--- a/v0.13/diet/README.md
+++ b/v0.13/diet/README.md
@@ -3,7 +3,7 @@ title: "Diet Optimization"
 description: "Select foods to satisfy daily nutritional requirements at minimum cost."
 featured: false
 experience_level: beginner
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/hospital_staffing/README.md b/v0.13/hospital_staffing/README.md
index b764994d..e2faec4b 100644
--- a/v0.13/hospital_staffing/README.md
+++ b/v0.13/hospital_staffing/README.md
@@ -3,7 +3,7 @@ title: "Hospital Staffing"
 description: "Assign nurses to shifts to minimize overtime cost and overflow penalties from unmet patient demand."
 featured: false
 experience_level: intermediate
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/inventory_rebalancing/README.md b/v0.13/inventory_rebalancing/README.md
index e435ebb1..0f8e18f0 100644
--- a/v0.13/inventory_rebalancing/README.md
+++ b/v0.13/inventory_rebalancing/README.md
@@ -3,7 +3,7 @@ title: "Inventory Rebalancing"
 description: "Transfer inventory between warehouse sites to meet demand at minimum cost."
 featured: false
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/network_flow/README.md b/v0.13/network_flow/README.md
index 91dcd581..7f6e9c87 100644
--- a/v0.13/network_flow/README.md
+++ b/v0.13/network_flow/README.md
@@ -3,7 +3,7 @@ title: "Network Flow"
 description: "Maximize flow through a capacitated network from a source node."
 featured: false
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/order_fulfillment/README.md b/v0.13/order_fulfillment/README.md
index 44a71d41..f8444732 100644
--- a/v0.13/order_fulfillment/README.md
+++ b/v0.13/order_fulfillment/README.md
@@ -3,7 +3,7 @@ title: "Order Fulfillment"
 description: "Assign customer orders to fulfillment centers to minimize shipping and fixed costs."
 featured: true
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
    - Prescriptive
 tags:
diff --git a/v0.13/portfolio_balancing/README.md b/v0.13/portfolio_balancing/README.md
index b9351f7b..33a540d8 100644
--- a/v0.13/portfolio_balancing/README.md
+++ b/v0.13/portfolio_balancing/README.md
@@ -3,7 +3,7 @@ title: "Portfolio Optimization"
 description: "Allocate investment across stocks to minimize risk while achieving a target return."
 featured: false
 experience_level: intermediate
-industry: "Finance"
+industry: "Financial Services"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/retail_markdown/README.md b/v0.13/retail_markdown/README.md
index fa6fd89b..a23b32f8 100644
--- a/v0.13/retail_markdown/README.md
+++ b/v0.13/retail_markdown/README.md
@@ -3,7 +3,7 @@ title: "Markdown Optimization"
 description: "Set discount levels for products across a selling season to maximize revenue while clearing inventory."
 featured: false
 experience_level: intermediate
-industry: "Retail"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/shift_assignment/README.md b/v0.13/shift_assignment/README.md
index a7f36b8b..458e85da 100644
--- a/v0.13/shift_assignment/README.md
+++ b/v0.13/shift_assignment/README.md
@@ -3,7 +3,7 @@ title: "Shift Assignment"
 description: "Assign workers to shifts based on availability while meeting minimum coverage and per-worker capacity constraints."
 featured: true
 experience_level: beginner
-industry: "Workforce Management"
+industry: "Cross-Industry"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/supplier_reliability/README.md b/v0.13/supplier_reliability/README.md
index 93027aba..96c62a10 100644
--- a/v0.13/supplier_reliability/README.md
+++ b/v0.13/supplier_reliability/README.md
@@ -3,7 +3,7 @@ title: "Supplier Reliability"
 description: "Select suppliers to meet product demand while balancing cost and reliability."
 featured: false
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/supply_chain_transport/README.md b/v0.13/supply_chain_transport/README.md
index 7edff71f..f7643ab0 100644
--- a/v0.13/supply_chain_transport/README.md
+++ b/v0.13/supply_chain_transport/README.md
@@ -3,7 +3,7 @@ title: "Supply Chain Transport"
 description: "Route shipments from warehouses to customers using multiple transport modes to minimize cost."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/test_data_generation/README.md b/v0.13/test_data_generation/README.md
index 5bbaf4bf..70c91547 100644
--- a/v0.13/test_data_generation/README.md
+++ b/v0.13/test_data_generation/README.md
@@ -3,7 +3,7 @@ title: "Test Data Generation"
 description: "Determine feasible row counts for test database tables that satisfy schema constraints, then generate example synthetic rows."
 featured: false
 experience_level: intermediate
-industry: "Data Engineering"
+industry: "Technology & Telecom"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/traveling_salesman/README.md b/v0.13/traveling_salesman/README.md
index c74de916..8c40fcbe 100644
--- a/v0.13/traveling_salesman/README.md
+++ b/v0.13/traveling_salesman/README.md
@@ -3,7 +3,7 @@ title: "Traveling Salesman"
 description: "Find the shortest route visiting all cities exactly once and returning to the start."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/vehicle_scheduling/README.md b/v0.13/vehicle_scheduling/README.md
index 78cc534a..5ece99cc 100644
--- a/v0.13/vehicle_scheduling/README.md
+++ b/v0.13/vehicle_scheduling/README.md
@@ -3,7 +3,7 @@ title: "Vehicle Scheduling"
 description: "Assign trips to vehicles to minimize total cost, including fixed vehicle activation costs and per-mile costs."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.13/water_allocation/README.md b/v0.13/water_allocation/README.md
index ac6bbb9c..46ae017e 100644
--- a/v0.13/water_allocation/README.md
+++ b/v0.13/water_allocation/README.md
@@ -3,7 +3,7 @@ title: "Water Allocation"
 description: "Allocate water from sources to users at minimum cost while meeting demand, subject to connection limits and transmission losses."
 featured: false
 experience_level: beginner
-industry: "Utilities"
+industry: "Energy & Utilities"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/README.md b/v0.14/README.md
index 24f6e173..e02ddd2f 100644
--- a/v0.14/README.md
+++ b/v0.14/README.md
@@ -4,24 +4,87 @@ This directory contains the templates for v0.14. Each template folder includes i
 
 ## Template Index
 
-| Template | Description |
-| --- | --- |
-| [ad_spend_allocation](./ad_spend_allocation/) | Allocate a fixed budget across channel–campaign combinations to maximize expected conversions, subject to channel spend bounds and per-campaign budget limits. |
-| [diet](./diet/) | Select foods to satisfy daily nutritional requirements at minimum cost. |
-| [factory_production](./factory_production/) | Choose production quantities per machine-product pair to maximize profit while meeting minimum production requirements. |
-| [grid_interconnection](./grid_interconnection/) | Approve data center interconnection requests and substation upgrades to maximize net revenue within capital budget. |
-| [hospital_staffing](./hospital_staffing/) | Assign nurses to shifts to minimize overtime cost and overflow penalties from unmet patient demand. |
-| [inventory_rebalancing](./inventory_rebalancing/) | Transfer inventory between warehouse sites to meet demand at minimum cost. |
-| [machine_maintenance](./machine_maintenance/) | Schedule preventive maintenance across time slots to minimize cost while respecting crew-hour capacity and machine conflicts. |
-| [network_flow](./network_flow/) | Maximize flow through a capacitated network from a source node. |
-| [order_fulfillment](./order_fulfillment/) | Assign customer orders to fulfillment centers to minimize shipping and fixed costs. |
-| [portfolio_balancing](./portfolio_balancing/) | Allocate investment across stocks to minimize risk while achieving a target return. |
-| [production_planning](./production_planning/) | Schedule production across machines to meet demand while maximizing profit. |
-| [retail_markdown](./retail_markdown/) | Set discount levels for products across a selling season to maximize revenue while clearing inventory. |
-| [shift_assignment](./shift_assignment/) | Assign workers to shifts based on availability while meeting minimum coverage and per-worker capacity constraints. |
-| [supplier_reliability](./supplier_reliability/) | Select suppliers to meet product demand while balancing cost and reliability. |
-| [supply_chain_transport](./supply_chain_transport/) | Route shipments from warehouses to customers using multiple transport modes to minimize cost. |
-| [test_data_generation](./test_data_generation/) | Determine feasible row counts for test database tables that satisfy schema constraints, then generate example synthetic rows. |
-| [traveling_salesman](./traveling_salesman/) | Find the shortest route visiting all cities exactly once and returning to the start. |
-| [vehicle_scheduling](./vehicle_scheduling/) | Assign trips to vehicles to minimize total cost, including fixed vehicle activation costs and per-mile costs. |
-| [water_allocation](./water_allocation/) | Allocate water from sources to users at minimum cost while meeting demand, subject to connection limits and transmission losses. |
+Templates are grouped by industry. Expand an industry to see its templates, the reasoners each uses, and a one-line description.
+
+<details>
+<summary>Cross-Industry (1)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [shift_assignment](./shift_assignment/) | Prescriptive | Assign workers to shifts based on availability while meeting minimum coverage and per-worker capacity constraints. |
+
+</details>
+
+<details>
+<summary>Energy & Utilities (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [grid_interconnection](./grid_interconnection/) | Prescriptive | Approve data center interconnection requests and substation upgrades to maximize net revenue within capital budget. |
+| [water_allocation](./water_allocation/) | Prescriptive | Allocate water from sources to users at minimum cost while meeting demand, subject to connection limits and transmission losses. |
+
+</details>
+
+<details>
+<summary>Financial Services (1)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [portfolio_balancing](./portfolio_balancing/) | Prescriptive | Allocate investment across stocks to minimize risk while achieving a target return. |
+
+</details>
+
+<details>
+<summary>Healthcare & Life Sciences (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [diet](./diet/) | Prescriptive | Select foods to satisfy daily nutritional requirements at minimum cost. |
+| [hospital_staffing](./hospital_staffing/) | Prescriptive | Assign nurses to shifts to minimize overtime cost and overflow penalties from unmet patient demand. |
+
+</details>
+
+<details>
+<summary>Manufacturing (3)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [factory_production](./factory_production/) | Prescriptive | Choose production quantities per machine-product pair to maximize profit while meeting minimum production requirements. |
+| [machine_maintenance](./machine_maintenance/) | Prescriptive | Schedule preventive maintenance across time slots to minimize cost while respecting crew-hour capacity and machine conflicts. |
+| [production_planning](./production_planning/) | Prescriptive | Schedule production across machines to meet demand while maximizing profit. |
+
+</details>
+
+<details>
+<summary>Retail & Consumer (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [ad_spend_allocation](./ad_spend_allocation/) | Prescriptive | Allocate a fixed budget across channel–campaign combinations to maximize expected conversions, subject to channel spend bounds and per-campaign budget limits. |
+| [retail_markdown](./retail_markdown/) | Prescriptive | Set discount levels for products across a selling season to maximize revenue while clearing inventory. |
+
+</details>
+
+<details>
+<summary>Supply Chain & Logistics (7)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [inventory_rebalancing](./inventory_rebalancing/) | Prescriptive | Transfer inventory between warehouse sites to meet demand at minimum cost. |
+| [network_flow](./network_flow/) | Prescriptive | Maximize flow through a capacitated network from a source node. |
+| [order_fulfillment](./order_fulfillment/) | Prescriptive | Assign customer orders to fulfillment centers to minimize shipping and fixed costs. |
+| [supplier_reliability](./supplier_reliability/) | Prescriptive | Select suppliers to meet product demand while balancing cost and reliability. |
+| [supply_chain_transport](./supply_chain_transport/) | Prescriptive | Route shipments from warehouses to customers using multiple transport modes to minimize cost. |
+| [traveling_salesman](./traveling_salesman/) | Prescriptive | Find the shortest route visiting all cities exactly once and returning to the start. |
+| [vehicle_scheduling](./vehicle_scheduling/) | Prescriptive | Assign trips to vehicles to minimize total cost, including fixed vehicle activation costs and per-mile costs. |
+
+</details>
+
+<details>
+<summary>Technology & Telecom (1)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [test_data_generation](./test_data_generation/) | Prescriptive | Determine feasible row counts for test database tables that satisfy schema constraints, then generate example synthetic rows. |
+
+</details>
diff --git a/v0.14/ad_spend_allocation/README.md b/v0.14/ad_spend_allocation/README.md
index 07a9f19b..7229df2b 100644
--- a/v0.14/ad_spend_allocation/README.md
+++ b/v0.14/ad_spend_allocation/README.md
@@ -3,7 +3,7 @@ title: "Ad Spend Allocation"
 description: "Allocate a fixed budget across channel–campaign combinations to maximize expected conversions, subject to channel spend bounds and per-campaign budget limits."
 featured: false
 experience_level: intermediate
-industry: "Marketing"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/diet/README.md b/v0.14/diet/README.md
index 0f633295..04c506c5 100644
--- a/v0.14/diet/README.md
+++ b/v0.14/diet/README.md
@@ -3,7 +3,7 @@ title: "Diet Optimization"
 description: "Select foods to satisfy daily nutritional requirements at minimum cost."
 featured: false
 experience_level: beginner
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/hospital_staffing/README.md b/v0.14/hospital_staffing/README.md
index 5270103d..273d4f92 100644
--- a/v0.14/hospital_staffing/README.md
+++ b/v0.14/hospital_staffing/README.md
@@ -3,7 +3,7 @@ title: "Hospital Staffing"
 description: "Assign nurses to shifts to minimize overtime cost and overflow penalties from unmet patient demand."
 featured: false
 experience_level: intermediate
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/inventory_rebalancing/README.md b/v0.14/inventory_rebalancing/README.md
index 45a1a637..70ad1ce8 100644
--- a/v0.14/inventory_rebalancing/README.md
+++ b/v0.14/inventory_rebalancing/README.md
@@ -3,7 +3,7 @@ title: "Inventory Rebalancing"
 description: "Transfer inventory between warehouse sites to meet demand at minimum cost."
 featured: false
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/network_flow/README.md b/v0.14/network_flow/README.md
index df90118e..ac89a600 100644
--- a/v0.14/network_flow/README.md
+++ b/v0.14/network_flow/README.md
@@ -3,7 +3,7 @@ title: "Network Flow"
 description: "Maximize flow through a capacitated network from a source node."
 featured: false
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/order_fulfillment/README.md b/v0.14/order_fulfillment/README.md
index fc889921..469280ae 100644
--- a/v0.14/order_fulfillment/README.md
+++ b/v0.14/order_fulfillment/README.md
@@ -3,7 +3,7 @@ title: "Order Fulfillment"
 description: "Assign customer orders to fulfillment centers to minimize shipping and fixed costs."
 featured: true
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
    - Prescriptive
 tags:
diff --git a/v0.14/portfolio_balancing/README.md b/v0.14/portfolio_balancing/README.md
index bf0ea5d8..b8465e27 100644
--- a/v0.14/portfolio_balancing/README.md
+++ b/v0.14/portfolio_balancing/README.md
@@ -3,7 +3,7 @@ title: "Portfolio Optimization"
 description: "Allocate investment across stocks to minimize risk while achieving a target return."
 featured: false
 experience_level: intermediate
-industry: "Finance"
+industry: "Financial Services"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/retail_markdown/README.md b/v0.14/retail_markdown/README.md
index 10afdb9f..1b15df49 100644
--- a/v0.14/retail_markdown/README.md
+++ b/v0.14/retail_markdown/README.md
@@ -3,7 +3,7 @@ title: "Markdown Optimization"
 description: "Set discount levels for products across a selling season to maximize revenue while clearing inventory."
 featured: false
 experience_level: intermediate
-industry: "Retail"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/shift_assignment/README.md b/v0.14/shift_assignment/README.md
index 60c9c560..9b09c5e0 100644
--- a/v0.14/shift_assignment/README.md
+++ b/v0.14/shift_assignment/README.md
@@ -3,7 +3,7 @@ title: "Shift Assignment"
 description: "Assign workers to shifts based on availability while meeting minimum coverage and per-worker capacity constraints."
 featured: true
 experience_level: beginner
-industry: "Workforce Management"
+industry: "Cross-Industry"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/supplier_reliability/README.md b/v0.14/supplier_reliability/README.md
index 72ac87ca..d13399a7 100644
--- a/v0.14/supplier_reliability/README.md
+++ b/v0.14/supplier_reliability/README.md
@@ -3,7 +3,7 @@ title: "Supplier Reliability"
 description: "Select suppliers to meet product demand while balancing cost and reliability."
 featured: false
 experience_level: beginner
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/supply_chain_transport/README.md b/v0.14/supply_chain_transport/README.md
index 5e21d2b7..17e8655a 100644
--- a/v0.14/supply_chain_transport/README.md
+++ b/v0.14/supply_chain_transport/README.md
@@ -3,7 +3,7 @@ title: "Supply Chain Transport"
 description: "Route shipments from warehouses to customers using multiple transport modes to minimize cost."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/test_data_generation/README.md b/v0.14/test_data_generation/README.md
index 5f02457a..89544e54 100644
--- a/v0.14/test_data_generation/README.md
+++ b/v0.14/test_data_generation/README.md
@@ -3,7 +3,7 @@ title: "Test Data Generation"
 description: "Determine feasible row counts for test database tables that satisfy schema constraints, then generate example synthetic rows."
 featured: false
 experience_level: intermediate
-industry: "Data Engineering"
+industry: "Technology & Telecom"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/traveling_salesman/README.md b/v0.14/traveling_salesman/README.md
index f723633a..093b706f 100644
--- a/v0.14/traveling_salesman/README.md
+++ b/v0.14/traveling_salesman/README.md
@@ -3,7 +3,7 @@ title: "Traveling Salesman"
 description: "Find the shortest route visiting all cities exactly once and returning to the start."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/vehicle_scheduling/README.md b/v0.14/vehicle_scheduling/README.md
index 377197b9..565a4557 100644
--- a/v0.14/vehicle_scheduling/README.md
+++ b/v0.14/vehicle_scheduling/README.md
@@ -3,7 +3,7 @@ title: "Vehicle Scheduling"
 description: "Assign trips to vehicles to minimize total cost, including fixed vehicle activation costs and per-mile costs."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v0.14/water_allocation/README.md b/v0.14/water_allocation/README.md
index 4ec00e4b..46e3ad69 100644
--- a/v0.14/water_allocation/README.md
+++ b/v0.14/water_allocation/README.md
@@ -3,7 +3,7 @@ title: "Water Allocation"
 description: "Allocate water from sources to users at minimum cost while meeting demand, subject to connection limits and transmission losses."
 featured: false
 experience_level: beginner
-industry: "Utilities"
+industry: "Energy & Utilities"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/README.md b/v1/README.md
index 9f5ad5b2..188c2720 100644
--- a/v1/README.md
+++ b/v1/README.md
@@ -4,53 +4,116 @@ This directory contains the templates for v1. Each template folder includes its
 
 ## Template Index
 
-| Template | Description |
-| --- | --- |
-| [ad_spend_allocation](./ad_spend_allocation/) | Allocate marketing budget across channels and campaigns to maximize conversions. |
-| [bom-reachability](./bom-reachability/) | Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks. |
-| [book_slate_recommendation](./book_slate_recommendation/) | Recommend K books per reader and order them by slot, under diversity, freshness, and explainability constraints. |
-| [campaign_roi](./campaign_roi/) | Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region. |
-| [cell_tower_coverage](./cell_tower_coverage/) | Select candidate cell tower sites and assign demand zones to maximize covered population under budget, tower-count, and capacity limits. |
-| [cicd_runner_allocation](./cicd_runner_allocation/) | Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels and conflict analysis to diagnose an infeasible outage. |
-| [commercial_underwriting](./commercial_underwriting/) | Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
-| [datacenter_compute_allocation](./datacenter_compute_allocation/) | Multi-reasoner template (chain follow-up to energy_grid_planning): heterogeneous-graph GNN classification of per-workload utilization probability, hardware-compatibility rules, dependency PageRank, and 24-cell scenario MIP for inside-the-fence GPU allocation across hyperscaler campuses. |
-| [demand_forecasting](./demand_forecasting/) | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies. |
-| [demand_planning_temporal](./demand_planning_temporal/) | Plan weekly production and inventory across sites over a date-filtered planning horizon to minimize total cost while meeting demand. |
-| [diet](./diet/) | Select foods to satisfy nutritional requirements at minimum cost. |
-| [disease-outbreak-prevention](./disease-outbreak-prevention/) | Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks. |
-| [energy_grid_planning](./energy_grid_planning/) | Multi-reasoner template: demand forecasting, grid vulnerability analysis, compliance rules, and multi-objective optimization for AI data center interconnection planning on the ERCOT (Texas) grid. |
-| [factory_production](./factory_production/) | Maximize production profit under per-factory resource limits, then read the sensitivity marginals (capacity shadow prices and product reduced costs) from one solve. |
-| [financial_index_replication](./financial_index_replication/) | Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
-| [fraud-detection](./fraud-detection/) | Multi-reasoner transaction-fraud pipeline: account PageRank (Graph) + high-volume account flags (Rules) feed a GNN binary classifier (Predictive) whose per-transaction scores drive a knapsack investigator-budget MILP (Prescriptive). |
-| [hospital_staffing](./hospital_staffing/) | Explore the tradeoff between overtime cost and patient service level using bi-objective optimization with epsilon constraint. |
-| [humanitarian-aid-supply-chain](./humanitarian-aid-supply-chain/) | Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies. |
-| [memory_supply_allocation](./memory_supply_allocation/) | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
-| [money_laundering_motif_detection](./money_laundering_motif_detection/) | Detect three classes of layering motif on the same transaction ledger, each demonstrating a different CSP technique that rules / paths / graph reasoning alone cannot enforce: per-vertex aggregate equality (butterfly), pairwise distinctness over a chosen subset (smurf army), and cardinality on a chosen subset (KYC-mix burst). |
-| [network_flow_planning](./network_flow_planning/) | Plan a multi-tier distribution flow that decides which fulfillment centers to open and how much to ship on every lane to satisfy customer demand at minimum cost. |
-| [patient_cohort_recruitment](./patient_cohort_recruitment/) | Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize. |
-| [planogram_optimization](./planogram_optimization/) | Decide integer facing counts per SKU to maximize predicted weekly demand under shelf capacity and category cardinality limits, where per-(SKU, facing_count) demand comes from a regression model. |
-| [pod_placement](./pod_placement/) | Assign pods to nodes in a Kubernetes-style cluster subject to per-node CPU / memory / GPU bin-packing, pairwise tenant anti-affinity, deployment co-location affinity, failure-domain spread, gang-placement atomicity, and topology rack-clique rules. Pure CSP via MiniZinc / Chuffed. |
-| [portfolio_balancing](./portfolio_balancing/) | Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
-| [product_configurator](./product_configurator/) | Enumerate every feasible build of a configurable product using a CSP solver in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
-| [production_planning](./production_planning/) | Schedule production across machines to meet demand and maximize profit with scenario analysis. |
-| [rai-agent-scaffold](./rai-agent-scaffold/) | Scaffold for packaging a RelationalAI semantic model as a Snowflake Cortex agent and exposing it through Snowflake Intelligence. |
-| [retail_markdown](./retail_markdown/) | Set discount levels across weeks to maximize revenue while clearing inventory. |
-| [retail_planning](./retail_planning/) | Predict article sales and customer churn with GNNs, then optimize markdown pricing and inventory planning to maximize revenue and minimize costs. |
-| [shift_assignment](./shift_assignment/) | Assign workers to shifts based on availability to meet coverage requirements. |
-| [shipment_compliance](./shipment_compliance/) | Define derived business rules for shipment compliance, sourcing risk, and demand escalation. |
-| [simple-start](./simple-start/) | A minimal notebook to connect to Snowflake, model a small graph, and compute betweenness centrality with RelationalAI. |
-| [smoker_status_prediction](./smoker_status_prediction/) | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network. |
-| [sprint_scheduling](./sprint_scheduling/) | Assign backlog issues to developers across sprints, minimizing weighted completion time while respecting capacity and skill constraints. |
-| [subscriber_retention](./subscriber_retention/) | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns. |
-| [supplier_reliability](./supplier_reliability/) | Select suppliers to meet product demand at minimum cost, with sensitivity marginals and supplier-disruption scenario analysis. |
-| [supply_chain_resilience](./supply_chain_resilience/) | A multi-reasoner template that chains blast-radius reachability, graph analysis, rules-based classification, and prescriptive optimization to build a risk-adjusted minimum-cost network flow for supply chain routing. |
-| [supply_chain_transport](./supply_chain_transport/) | Minimize inventory holding and transport costs with TL/LTL mode selection. |
-| [synthetic_eligibility_records](./synthetic_eligibility_records/) | Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
-| [synthetic_order_lifecycle](./synthetic_order_lifecycle/) | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver. |
-| [telco_network_recovery](./telco_network_recovery/) | Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology. |
-| [test_data_generation](./test_data_generation/) | Determine optimal row counts for test database tables satisfying schema and referential integrity constraints. |
-| [traveling_salesman](./traveling_salesman/) | Find the shortest route visiting all cities exactly once using the MTZ formulation. |
-| [underwriting_audit](./underwriting_audit/) | Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode. |
-| [warehouse_allocation](./warehouse_allocation/) | Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs. |
-| [water_allocation](./water_allocation/) | Minimize the cost of distributing water from sources to users with nonlinear transmission losses. |
-| [wildlife-conservation-network](./wildlife-conservation-network/) | Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs. |
+Templates are grouped by industry. Expand an industry to see its templates, the reasoners each uses, and a one-line description.
+
+<details>
+<summary>Cross-Industry (4)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [rai-agent-scaffold](./rai-agent-scaffold/) | Graph | Scaffold for packaging a RelationalAI semantic model as a Snowflake Cortex agent and exposing it through Snowflake Intelligence. |
+| [shift_assignment](./shift_assignment/) | Prescriptive | Assign workers to shifts based on availability to meet coverage requirements. |
+| [simple-start](./simple-start/) | Graph | A minimal notebook to connect to Snowflake, model a small graph, and compute betweenness centrality with RelationalAI. |
+| [wildlife-conservation-network](./wildlife-conservation-network/) | Graph | Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs. |
+
+</details>
+
+<details>
+<summary>Energy & Utilities (2)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [energy_grid_planning](./energy_grid_planning/) | Graph, Rules-based, Prescriptive | Multi-reasoner template: demand forecasting, grid vulnerability analysis, compliance rules, and multi-objective optimization for AI data center interconnection planning on the ERCOT (Texas) grid. |
+| [water_allocation](./water_allocation/) | Prescriptive | Minimize the cost of distributing water from sources to users with nonlinear transmission losses. |
+
+</details>
+
+<details>
+<summary>Financial Services (7)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [commercial_underwriting](./commercial_underwriting/) | Rules-based | Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
+| [financial_index_replication](./financial_index_replication/) | Prescriptive, Rules-based | Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
+| [fraud-detection](./fraud-detection/) | Graph, Rules-based, Predictive, Prescriptive | Multi-reasoner transaction-fraud pipeline: account PageRank (Graph) + high-volume account flags (Rules) feed a GNN binary classifier (Predictive) whose per-transaction scores drive a knapsack investigator-budget MILP (Prescriptive). |
+| [money_laundering_motif_detection](./money_laundering_motif_detection/) | Prescriptive | Detect three classes of layering motif on the same transaction ledger, each demonstrating a different CSP technique that rules / paths / graph reasoning alone cannot enforce: per-vertex aggregate equality (butterfly), pairwise distinctness over a chosen subset (smurf army), and cardinality on a chosen subset (KYC-mix burst). |
+| [portfolio_balancing](./portfolio_balancing/) | Prescriptive, Rules-based, Graph | Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
+| [synthetic_order_lifecycle](./synthetic_order_lifecycle/) | Prescriptive | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver. |
+| [underwriting_audit](./underwriting_audit/) | Prescriptive | Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode. |
+
+</details>
+
+<details>
+<summary>Healthcare & Life Sciences (6)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [diet](./diet/) | Prescriptive | Select foods to satisfy nutritional requirements at minimum cost. |
+| [disease-outbreak-prevention](./disease-outbreak-prevention/) | Graph | Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks. |
+| [hospital_staffing](./hospital_staffing/) | Prescriptive | Explore the tradeoff between overtime cost and patient service level using bi-objective optimization with epsilon constraint. |
+| [patient_cohort_recruitment](./patient_cohort_recruitment/) | Graph, Rules-based, Prescriptive | Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize. |
+| [smoker_status_prediction](./smoker_status_prediction/) | Predictive | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network. |
+| [synthetic_eligibility_records](./synthetic_eligibility_records/) | Prescriptive | Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
+
+</details>
+
+<details>
+<summary>Manufacturing (4)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [bom-reachability](./bom-reachability/) | Graph | Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks. |
+| [factory_production](./factory_production/) | Prescriptive | Maximize production profit under per-factory resource limits, then read the sensitivity marginals (capacity shadow prices and product reduced costs) from one solve. |
+| [product_configurator](./product_configurator/) | Prescriptive | Enumerate every feasible build of a configurable product using a CSP solver in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
+| [production_planning](./production_planning/) | Prescriptive | Schedule production across machines to meet demand and maximize profit with scenario analysis. |
+
+</details>
+
+<details>
+<summary>Retail & Consumer (7)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [ad_spend_allocation](./ad_spend_allocation/) | Prescriptive | Allocate marketing budget across channels and campaigns to maximize conversions. |
+| [book_slate_recommendation](./book_slate_recommendation/) | Graph, Prescriptive | Recommend K books per reader and order them by slot, under diversity, freshness, and explainability constraints. |
+| [campaign_roi](./campaign_roi/) | Prescriptive | Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region. |
+| [demand_forecasting](./demand_forecasting/) | Predictive | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies. |
+| [planogram_optimization](./planogram_optimization/) | Predictive, Prescriptive | Decide integer facing counts per SKU to maximize predicted weekly demand under shelf capacity and category cardinality limits, where per-(SKU, facing_count) demand comes from a regression model. |
+| [retail_markdown](./retail_markdown/) | Prescriptive | Set discount levels across weeks to maximize revenue while clearing inventory. |
+| [retail_planning](./retail_planning/) | Predictive, Prescriptive | Predict article sales and customer churn with GNNs, then optimize markdown pricing and inventory planning to maximize revenue and minimize costs. |
+
+</details>
+
+<details>
+<summary>Supply Chain & Logistics (9)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [demand_planning_temporal](./demand_planning_temporal/) | Prescriptive | Plan weekly production and inventory across sites over a date-filtered planning horizon to minimize total cost while meeting demand. |
+| [humanitarian-aid-supply-chain](./humanitarian-aid-supply-chain/) | Graph | Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies. |
+| [network_flow_planning](./network_flow_planning/) | Prescriptive | Plan a multi-tier distribution flow that decides which fulfillment centers to open and how much to ship on every lane to satisfy customer demand at minimum cost. |
+| [shipment_compliance](./shipment_compliance/) | Rules-based | Define derived business rules for shipment compliance, sourcing risk, and demand escalation. |
+| [supplier_reliability](./supplier_reliability/) | Prescriptive | Select suppliers to meet product demand at minimum cost, with sensitivity marginals and supplier-disruption scenario analysis. |
+| [supply_chain_resilience](./supply_chain_resilience/) | Graph, Rules-based, Prescriptive | A multi-reasoner template that chains blast-radius reachability, graph analysis, rules-based classification, and prescriptive optimization to build a risk-adjusted minimum-cost network flow for supply chain routing. |
+| [supply_chain_transport](./supply_chain_transport/) | Prescriptive | Minimize inventory holding and transport costs with TL/LTL mode selection. |
+| [traveling_salesman](./traveling_salesman/) | Prescriptive | Find the shortest route visiting all cities exactly once using the MTZ formulation. |
+| [warehouse_allocation](./warehouse_allocation/) | Graph, Prescriptive | Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs. |
+
+</details>
+
+<details>
+<summary>Technology & Telecom (9)</summary>
+
+| Template | Reasoners | Description |
+| --- | --- | --- |
+| [cell_tower_coverage](./cell_tower_coverage/) | Prescriptive | Select candidate cell tower sites and assign demand zones to maximize covered population under budget, tower-count, and capacity limits. |
+| [cicd_runner_allocation](./cicd_runner_allocation/) | Prescriptive | Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels and conflict analysis to diagnose an infeasible outage. |
+| [datacenter_compute_allocation](./datacenter_compute_allocation/) | Predictive, Graph, Rules-based, Prescriptive | Multi-reasoner template (chain follow-up to energy_grid_planning): heterogeneous-graph GNN classification of per-workload utilization probability, hardware-compatibility rules, dependency PageRank, and 24-cell scenario MIP for inside-the-fence GPU allocation across hyperscaler campuses. |
+| [memory_supply_allocation](./memory_supply_allocation/) | Predictive, Rules-based, Prescriptive, Graph | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
+| [pod_placement](./pod_placement/) | Prescriptive | Assign pods to nodes in a Kubernetes-style cluster subject to per-node CPU / memory / GPU bin-packing, pairwise tenant anti-affinity, deployment co-location affinity, failure-domain spread, gang-placement atomicity, and topology rack-clique rules. Pure CSP via MiniZinc / Chuffed. |
+| [sprint_scheduling](./sprint_scheduling/) | Prescriptive | Assign backlog issues to developers across sprints, minimizing weighted completion time while respecting capacity and skill constraints. |
+| [subscriber_retention](./subscriber_retention/) | Graph, Predictive | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns. |
+| [telco_network_recovery](./telco_network_recovery/) | Predictive, Rules-based, Graph, Prescriptive | Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology. |
+| [test_data_generation](./test_data_generation/) | Prescriptive | Determine optimal row counts for test database tables satisfying schema and referential integrity constraints. |
+
+</details>
diff --git a/v1/ad_spend_allocation/README.md b/v1/ad_spend_allocation/README.md
index 7c87ed6b..88c8d091 100644
--- a/v1/ad_spend_allocation/README.md
+++ b/v1/ad_spend_allocation/README.md
@@ -3,7 +3,7 @@ title: "Ad Spend Allocation"
 description: "Allocate marketing budget across channels and campaigns to maximize conversions."
 featured: false
 experience_level: intermediate
-industry: "Marketing"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/book_slate_recommendation/README.md b/v1/book_slate_recommendation/README.md
index d90dcf4d..28520c26 100644
--- a/v1/book_slate_recommendation/README.md
+++ b/v1/book_slate_recommendation/README.md
@@ -4,7 +4,7 @@ description: "Recommend K books per reader and order them by slot, under diversi
 featured: false
 private: true
 experience_level: advanced
-industry: "Media"
+industry: "Retail & Consumer"
 reasoning_types:
   - Graph
   - Prescriptive
diff --git a/v1/campaign_roi/README.md b/v1/campaign_roi/README.md
index 074f598d..c79abe95 100644
--- a/v1/campaign_roi/README.md
+++ b/v1/campaign_roi/README.md
@@ -3,7 +3,7 @@ title: "Campaign ROI"
 description: "Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region."
 featured: false
 experience_level: beginner
-industry: "Marketing"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/cell_tower_coverage/README.md b/v1/cell_tower_coverage/README.md
index e2225150..b8859491 100644
--- a/v1/cell_tower_coverage/README.md
+++ b/v1/cell_tower_coverage/README.md
@@ -3,7 +3,7 @@ title: "Cell Tower Coverage"
 description: "Select candidate cell tower sites and assign demand zones to maximize covered population under budget, tower-count, and capacity limits."
 featured: false
 experience_level: beginner
-industry: "Energy & Utilities"
+industry: "Technology & Telecom"
 reasoning_types:
     - Prescriptive
 tags:
diff --git a/v1/cicd_runner_allocation/README.md b/v1/cicd_runner_allocation/README.md
index 42ff6bef..419edcae 100644
--- a/v1/cicd_runner_allocation/README.md
+++ b/v1/cicd_runner_allocation/README.md
@@ -3,7 +3,7 @@ title: "CI/CD Runner Allocation"
 description: "Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels and conflict analysis to diagnose an infeasible outage."
 featured: false
 experience_level: intermediate
-industry: "Software Engineering"
+industry: "Technology & Telecom"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/commercial_underwriting/README.md b/v1/commercial_underwriting/README.md
index 9caea6e7..9812d83f 100644
--- a/v1/commercial_underwriting/README.md
+++ b/v1/commercial_underwriting/README.md
@@ -3,7 +3,7 @@ title: "Commercial Underwriting"
 description: "Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage)."
 featured: false
 experience_level: intermediate
-industry: "Insurance"
+industry: "Financial Services"
 reasoning_types:
   - Rules-based
 tags:
diff --git a/v1/datacenter_compute_allocation/README.md b/v1/datacenter_compute_allocation/README.md
index 4cc5769b..21601008 100644
--- a/v1/datacenter_compute_allocation/README.md
+++ b/v1/datacenter_compute_allocation/README.md
@@ -4,7 +4,7 @@ description: "Multi-reasoner template (chain follow-up to energy_grid_planning):
 featured: false
 private: true
 experience_level: advanced
-industry: "AI Infrastructure"
+industry: "Technology & Telecom"
 reasoning_types:
   - Predictive
   - Graph
diff --git a/v1/demand_forecasting/README.md b/v1/demand_forecasting/README.md
index ac2bb93a..ae37d58e 100644
--- a/v1/demand_forecasting/README.md
+++ b/v1/demand_forecasting/README.md
@@ -3,7 +3,7 @@ title: "Demand Forecasting"
 description: "Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies."
 featured: false
 experience_level: advanced
-industry: "Retail"
+industry: "Retail & Consumer"
 reasoning_types:
   - Predictive
 tags:
diff --git a/v1/demand_planning_temporal/README.md b/v1/demand_planning_temporal/README.md
index 49fa5288..1221cd85 100644
--- a/v1/demand_planning_temporal/README.md
+++ b/v1/demand_planning_temporal/README.md
@@ -3,7 +3,7 @@ title: "Demand Planning Temporal"
 description: "Plan weekly production and inventory across sites over a date-filtered planning horizon to minimize total cost while meeting demand."
 featured: false
 experience_level: intermediate
-industry: "Supply Chain"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/diet/README.md b/v1/diet/README.md
index fa7cb73f..52fea1aa 100644
--- a/v1/diet/README.md
+++ b/v1/diet/README.md
@@ -3,7 +3,7 @@ title: "Diet Optimization"
 description: "Select foods to satisfy nutritional requirements at minimum cost."
 featured: false
 experience_level: beginner
-industry: "Healthcare & Nutrition"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/disease-outbreak-prevention/README.md b/v1/disease-outbreak-prevention/README.md
index 128b34aa..3f9037e1 100644
--- a/v1/disease-outbreak-prevention/README.md
+++ b/v1/disease-outbreak-prevention/README.md
@@ -2,7 +2,7 @@
 title: "Disease Outbreak Prevention"
 description: "Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks."
 experience_level: intermediate
-industry: Healthcare
+industry: "Healthcare & Life Sciences"
 featured: true
 reasoning_types:
   - Graph
diff --git a/v1/financial_index_replication/README.md b/v1/financial_index_replication/README.md
index 9ab2156a..c8114833 100644
--- a/v1/financial_index_replication/README.md
+++ b/v1/financial_index_replication/README.md
@@ -3,7 +3,7 @@ title: "Financial Index Replication"
 description: "Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark."
 featured: false
 experience_level: intermediate
-industry: "Finance"
+industry: "Financial Services"
 reasoning_types:
     - Prescriptive
     - Rules-based
diff --git a/v1/hospital_staffing/README.md b/v1/hospital_staffing/README.md
index c427ef38..326f1a20 100644
--- a/v1/hospital_staffing/README.md
+++ b/v1/hospital_staffing/README.md
@@ -3,7 +3,7 @@ title: "Hospital Staffing"
 description: "Explore the tradeoff between overtime cost and patient service level using bi-objective optimization with epsilon constraint."
 featured: false
 experience_level: intermediate
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/humanitarian-aid-supply-chain/README.md b/v1/humanitarian-aid-supply-chain/README.md
index a6e57467..d2ba7383 100644
--- a/v1/humanitarian-aid-supply-chain/README.md
+++ b/v1/humanitarian-aid-supply-chain/README.md
@@ -2,7 +2,7 @@
 title: "Humanitarian Aid Supply Chain Network"
 description: "Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies."
 experience_level: intermediate
-industry: Humanitarian & Emergency Response
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Graph
 tags:
diff --git a/v1/memory_supply_allocation/README.md b/v1/memory_supply_allocation/README.md
index 5cdbe1b1..8b514159 100644
--- a/v1/memory_supply_allocation/README.md
+++ b/v1/memory_supply_allocation/README.md
@@ -3,7 +3,7 @@ title: "Memory Supply Allocation"
 description: "Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades."
 featured: false
 experience_level: intermediate
-industry: "Semiconductors"
+industry: "Technology & Telecom"
 reasoning_types:
   - Predictive
   - Rules-based
diff --git a/v1/money_laundering_motif_detection/README.md b/v1/money_laundering_motif_detection/README.md
index 48e418c8..c295fa99 100644
--- a/v1/money_laundering_motif_detection/README.md
+++ b/v1/money_laundering_motif_detection/README.md
@@ -3,7 +3,7 @@ title: "Money-Laundering Motif Detection"
 description: "Detect three classes of layering motif on the same transaction ledger, each demonstrating a different CSP technique that rules / paths / graph reasoning alone cannot enforce: per-vertex aggregate equality (butterfly), pairwise distinctness over a chosen subset (smurf army), and cardinality on a chosen subset (KYC-mix burst)."
 featured: false
 experience_level: intermediate
-industry: "Banking"
+industry: "Financial Services"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/patient_cohort_recruitment/README.md b/v1/patient_cohort_recruitment/README.md
index d91ccc75..1366b8c1 100644
--- a/v1/patient_cohort_recruitment/README.md
+++ b/v1/patient_cohort_recruitment/README.md
@@ -3,7 +3,7 @@ title: "Patient Cohort Recruitment"
 description: "Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize."
 featured: false
 experience_level: intermediate
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Graph
   - Rules-based
diff --git a/v1/planogram_optimization/README.md b/v1/planogram_optimization/README.md
index d1323f0f..1264db92 100644
--- a/v1/planogram_optimization/README.md
+++ b/v1/planogram_optimization/README.md
@@ -4,7 +4,7 @@ description: "Decide integer facing counts per SKU to maximize predicted weekly
 featured: false
 private: true
 experience_level: intermediate
-industry: "Retail"
+industry: "Retail & Consumer"
 reasoning_types:
   - Predictive
   - Prescriptive
diff --git a/v1/pod_placement/README.md b/v1/pod_placement/README.md
index 1ce0a193..a755f2d2 100644
--- a/v1/pod_placement/README.md
+++ b/v1/pod_placement/README.md
@@ -3,7 +3,7 @@ title: "Pod Placement"
 description: "Assign pods to nodes in a Kubernetes-style cluster subject to per-node CPU / memory / GPU bin-packing, pairwise tenant anti-affinity, deployment co-location affinity, failure-domain spread, gang-placement atomicity, and topology rack-clique rules. Pure CSP via MiniZinc / Chuffed."
 featured: false
 experience_level: intermediate
-industry: "Cloud infrastructure"
+industry: "Technology & Telecom"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/portfolio_balancing/README.md b/v1/portfolio_balancing/README.md
index 8e7055ef..342a3ae0 100644
--- a/v1/portfolio_balancing/README.md
+++ b/v1/portfolio_balancing/README.md
@@ -3,7 +3,7 @@ title: "Portfolio Balancing"
 description: "Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test."
 featured: false
 experience_level: intermediate
-industry: "Finance"
+industry: "Financial Services"
 reasoning_types:
   - Prescriptive
   - Rules-based
diff --git a/v1/rai-agent-scaffold/README.md b/v1/rai-agent-scaffold/README.md
index b2076033..d9689325 100644
--- a/v1/rai-agent-scaffold/README.md
+++ b/v1/rai-agent-scaffold/README.md
@@ -2,7 +2,7 @@
 title: "Snowflake Intelligence Agent — RelationalAI Knowledge Graph"
 description: "Scaffold for packaging a RelationalAI semantic model as a Snowflake Cortex agent and exposing it through Snowflake Intelligence."
 experience_level: intermediate
-industry: General
+industry: "Cross-Industry"
 reasoning_types:
   - Graph
 tags:
diff --git a/v1/retail_markdown/README.md b/v1/retail_markdown/README.md
index ba177e14..b385df1a 100644
--- a/v1/retail_markdown/README.md
+++ b/v1/retail_markdown/README.md
@@ -3,7 +3,7 @@ title: "Retail Markdown"
 description: "Set discount levels across weeks to maximize revenue while clearing inventory."
 featured: false
 experience_level: intermediate
-industry: "Retail"
+industry: "Retail & Consumer"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/retail_planning/README.md b/v1/retail_planning/README.md
index 303cb7a1..81936118 100644
--- a/v1/retail_planning/README.md
+++ b/v1/retail_planning/README.md
@@ -3,7 +3,7 @@ title: "Retail Planning"
 description: "Predict article sales and customer churn with GNNs, then optimize markdown pricing and inventory planning to maximize revenue and minimize costs."
 featured: true
 experience_level: advanced
-industry: "Retail"
+industry: "Retail & Consumer"
 reasoning_types:
   - Predictive
   - Prescriptive
diff --git a/v1/shift_assignment/README.md b/v1/shift_assignment/README.md
index a8984d48..6ce7ee9e 100644
--- a/v1/shift_assignment/README.md
+++ b/v1/shift_assignment/README.md
@@ -3,7 +3,7 @@ title: "Shift Assignment"
 description: "Assign workers to shifts based on availability to meet coverage requirements."
 featured: false
 experience_level: beginner
-industry: "Operations"
+industry: "Cross-Industry"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/simple-start/README.md b/v1/simple-start/README.md
index f7e130cc..aff3ab26 100644
--- a/v1/simple-start/README.md
+++ b/v1/simple-start/README.md
@@ -2,7 +2,7 @@
 title: "Simple Start"
 description: "A minimal notebook to connect to Snowflake, model a small graph, and compute betweenness centrality with RelationalAI."
 experience_level: beginner
-industry: "General"
+industry: "Cross-Industry"
 featured: true
 reasoning_types:
   - Graph
diff --git a/v1/smoker_status_prediction/README.md b/v1/smoker_status_prediction/README.md
index 13163a62..24806c5d 100644
--- a/v1/smoker_status_prediction/README.md
+++ b/v1/smoker_status_prediction/README.md
@@ -3,7 +3,7 @@ title: "Smoker Status Prediction"
 description: "Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network."
 featured: false
 experience_level: intermediate
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Predictive
 tags:
diff --git a/v1/sprint_scheduling/README.md b/v1/sprint_scheduling/README.md
index 9920c95c..cf6a25d1 100644
--- a/v1/sprint_scheduling/README.md
+++ b/v1/sprint_scheduling/README.md
@@ -3,7 +3,7 @@ title: "Sprint Scheduling"
 description: "Assign backlog issues to developers across sprints, minimizing weighted completion time while respecting capacity and skill constraints."
 featured: false
 experience_level: intermediate
-industry: "Technology"
+industry: "Technology & Telecom"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/subscriber_retention/README.md b/v1/subscriber_retention/README.md
index bc827d64..56e68f78 100644
--- a/v1/subscriber_retention/README.md
+++ b/v1/subscriber_retention/README.md
@@ -3,7 +3,7 @@ title: "Subscriber Retention"
 description: "Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns."
 featured: false
 experience_level: advanced
-industry: "Telecommunications"
+industry: "Technology & Telecom"
 reasoning_types:
   - Graph
   - Predictive
diff --git a/v1/synthetic_eligibility_records/README.md b/v1/synthetic_eligibility_records/README.md
index b436e0f5..0504e044 100644
--- a/v1/synthetic_eligibility_records/README.md
+++ b/v1/synthetic_eligibility_records/README.md
@@ -3,7 +3,7 @@ title: "Synthetic Eligibility Records"
 description: "Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution."
 featured: false
 experience_level: intermediate
-industry: "Healthcare"
+industry: "Healthcare & Life Sciences"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/synthetic_order_lifecycle/README.md b/v1/synthetic_order_lifecycle/README.md
index f71c84a8..4ed22565 100644
--- a/v1/synthetic_order_lifecycle/README.md
+++ b/v1/synthetic_order_lifecycle/README.md
@@ -3,7 +3,7 @@ title: "Synthetic Order Lifecycle"
 description: "Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver."
 featured: false
 experience_level: intermediate
-industry: "Banking"
+industry: "Financial Services"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/telco_network_recovery/README.md b/v1/telco_network_recovery/README.md
index b7504419..5c0f8953 100644
--- a/v1/telco_network_recovery/README.md
+++ b/v1/telco_network_recovery/README.md
@@ -3,7 +3,7 @@ title: "Telco Network Recovery"
 description: "Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology."
 featured: false
 experience_level: advanced
-industry: "Telecommunications"
+industry: "Technology & Telecom"
 reasoning_types:
   - Predictive
   - Rules-based
diff --git a/v1/test_data_generation/README.md b/v1/test_data_generation/README.md
index ccecbb99..56af106f 100644
--- a/v1/test_data_generation/README.md
+++ b/v1/test_data_generation/README.md
@@ -3,7 +3,7 @@ title: "Test Data Generation"
 description: "Determine optimal row counts for test database tables satisfying schema and referential integrity constraints."
 featured: false
 experience_level: intermediate
-industry: "Software Engineering"
+industry: "Technology & Telecom"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/traveling_salesman/README.md b/v1/traveling_salesman/README.md
index 0e3ad4cc..b9fda9ff 100644
--- a/v1/traveling_salesman/README.md
+++ b/v1/traveling_salesman/README.md
@@ -3,7 +3,7 @@ title: "Traveling Salesman"
 description: "Find the shortest route visiting all cities exactly once using the MTZ formulation."
 featured: false
 experience_level: intermediate
-industry: "Logistics"
+industry: "Supply Chain & Logistics"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/underwriting_audit/README.md b/v1/underwriting_audit/README.md
index 0b8f1954..f7915b20 100644
--- a/v1/underwriting_audit/README.md
+++ b/v1/underwriting_audit/README.md
@@ -3,7 +3,7 @@ title: "Underwriting Audit"
 description: "Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode."
 featured: false
 experience_level: advanced
-industry: "Insurance"
+industry: "Financial Services"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/water_allocation/README.md b/v1/water_allocation/README.md
index 2e89a616..2c3c68f2 100644
--- a/v1/water_allocation/README.md
+++ b/v1/water_allocation/README.md
@@ -3,7 +3,7 @@ title: "Water Allocation"
 description: "Minimize the cost of distributing water from sources to users with nonlinear transmission losses."
 featured: false
 experience_level: intermediate
-industry: "Utilities & Resources"
+industry: "Energy & Utilities"
 reasoning_types:
   - Prescriptive
 tags:
diff --git a/v1/wildlife-conservation-network/README.md b/v1/wildlife-conservation-network/README.md
index bccc42f9..6b5bbb75 100644
--- a/v1/wildlife-conservation-network/README.md
+++ b/v1/wildlife-conservation-network/README.md
@@ -2,7 +2,7 @@
 title: "Wildlife Conservation Network"
 description: "Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs."
 experience_level: beginner
-industry: Environment & Sustainability
+industry: "Cross-Industry"
 reasoning_types:
   - Graph
 tags:

From 021ba1590e49ebb5ed74f9caaa339c70eccd0fbc Mon Sep 17 00:00:00 2001
From: cafzal <cameron.afzal@gmail.com>
Date: Tue, 9 Jun 2026 08:52:26 -0700
Subject: [PATCH 2/3] Tighten template descriptions: drop reasoner/industry
 restatement

The gallery and index already show each template's industry and reasoners
beside the description, so descriptions no longer repeat them: drop
'Multi-reasoner template:' prefixes, '(Graph)/(Rules)/...' family labels,
and 'using a CSP solver'-style phrasing, keeping the specific techniques
(PageRank, Louvain, MTZ, multi-solution mode). Also trims a few overlong
descriptions. Scoped to v1; index regenerated.
---
 README.md                                  | 44 +++++++++++-----------
 v1/README.md                               | 44 +++++++++++-----------
 v1/commercial_underwriting/README.md       |  2 +-
 v1/datacenter_compute_allocation/README.md |  2 +-
 v1/demand_forecasting/README.md            |  2 +-
 v1/disease-outbreak-prevention/README.md   |  2 +-
 v1/energy_grid_planning/README.md          |  2 +-
 v1/financial_index_replication/README.md   |  2 +-
 v1/fraud-detection/README.md               |  2 +-
 v1/humanitarian-aid-supply-chain/README.md |  2 +-
 v1/memory_supply_allocation/README.md      |  2 +-
 v1/patient_cohort_recruitment/README.md    |  2 +-
 v1/portfolio_balancing/README.md           |  2 +-
 v1/product_configurator/README.md          |  2 +-
 v1/shipment_compliance/README.md           |  2 +-
 v1/smoker_status_prediction/README.md      |  2 +-
 v1/subscriber_retention/README.md          |  2 +-
 v1/supply_chain_resilience/README.md       |  2 +-
 v1/synthetic_eligibility_records/README.md |  2 +-
 v1/synthetic_order_lifecycle/README.md     |  2 +-
 v1/telco_network_recovery/README.md        |  2 +-
 v1/underwriting_audit/README.md            |  2 +-
 v1/warehouse_allocation/README.md          |  2 +-
 v1/wildlife-conservation-network/README.md |  2 +-
 24 files changed, 66 insertions(+), 66 deletions(-)

diff --git a/README.md b/README.md
index a288b85b..ae8b71d1 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 | [rai-agent-scaffold](v1/rai-agent-scaffold/) | Graph | Scaffold for packaging a RelationalAI semantic model as a Snowflake Cortex agent and exposing it through Snowflake Intelligence. |
 | [shift_assignment](v1/shift_assignment/) | Prescriptive | Assign workers to shifts based on availability to meet coverage requirements. |
 | [simple-start](v1/simple-start/) | Graph | A minimal notebook to connect to Snowflake, model a small graph, and compute betweenness centrality with RelationalAI. |
-| [wildlife-conservation-network](v1/wildlife-conservation-network/) | Graph | Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs. |
+| [wildlife-conservation-network](v1/wildlife-conservation-network/) | Graph | Identify collaboration clusters among wildlife-conservation organizations with Louvain community detection and degree centrality, surfacing key coordination hubs for resource sharing. |
 
 </details>
 
@@ -35,7 +35,7 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 
 | Template | Reasoners | Description |
 | --- | --- | --- |
-| [energy_grid_planning](v1/energy_grid_planning/) | Graph, Rules-based, Prescriptive | Multi-reasoner template: demand forecasting, grid vulnerability analysis, compliance rules, and multi-objective optimization for AI data center interconnection planning on the ERCOT (Texas) grid. |
+| [energy_grid_planning](v1/energy_grid_planning/) | Graph, Rules-based, Prescriptive | AI data center interconnection planning on the ERCOT (Texas) grid: demand forecasting, grid-vulnerability analysis, compliance rules, and multi-objective optimization. |
 | [water_allocation](v1/water_allocation/) | Prescriptive | Minimize the cost of distributing water from sources to users with nonlinear transmission losses. |
 
 </details>
@@ -45,13 +45,13 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 
 | Template | Reasoners | Description |
 | --- | --- | --- |
-| [commercial_underwriting](v1/commercial_underwriting/) | Rules-based | Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
-| [financial_index_replication](v1/financial_index_replication/) | Prescriptive, Rules-based | Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
-| [fraud-detection](v1/fraud-detection/) | Graph, Rules-based, Predictive, Prescriptive | Multi-reasoner transaction-fraud pipeline: account PageRank (Graph) + high-volume account flags (Rules) feed a GNN binary classifier (Predictive) whose per-transaction scores drive a knapsack investigator-budget MILP (Prescriptive). |
+| [commercial_underwriting](v1/commercial_underwriting/) | Rules-based | Eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
+| [financial_index_replication](v1/financial_index_replication/) | Prescriptive, Rules-based | Select a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
+| [fraud-detection](v1/fraud-detection/) | Graph, Rules-based, Predictive, Prescriptive | Transaction-fraud pipeline: account PageRank and high-volume account flags feed a GNN binary classifier whose per-transaction scores drive a knapsack investigator-budget MILP. |
 | [money_laundering_motif_detection](v1/money_laundering_motif_detection/) | Prescriptive | Detect three classes of layering motif on the same transaction ledger, each demonstrating a different CSP technique that rules / paths / graph reasoning alone cannot enforce: per-vertex aggregate equality (butterfly), pairwise distinctness over a chosen subset (smurf army), and cardinality on a chosen subset (KYC-mix burst). |
-| [portfolio_balancing](v1/portfolio_balancing/) | Prescriptive, Rules-based, Graph | Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
-| [synthetic_order_lifecycle](v1/synthetic_order_lifecycle/) | Prescriptive | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver. |
-| [underwriting_audit](v1/underwriting_audit/) | Prescriptive | Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode. |
+| [portfolio_balancing](v1/portfolio_balancing/) | Prescriptive, Rules-based, Graph | Compliance screening, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
+| [synthetic_order_lifecycle](v1/synthetic_order_lifecycle/) | Prescriptive | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules. |
+| [underwriting_audit](v1/underwriting_audit/) | Prescriptive | Audit an underwriting ruleset against a catalog of properties. For each, either prove it holds (PASS) or return K distinct counterexample applicants that falsify it (FAIL). Multi-property batch audit in multi-solution mode. |
 
 </details>
 
@@ -61,11 +61,11 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 | Template | Reasoners | Description |
 | --- | --- | --- |
 | [diet](v1/diet/) | Prescriptive | Select foods to satisfy nutritional requirements at minimum cost. |
-| [disease-outbreak-prevention](v1/disease-outbreak-prevention/) | Graph | Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks. |
+| [disease-outbreak-prevention](v1/disease-outbreak-prevention/) | Graph | Rank the highest-risk facilities in a public health network by weighted degree centrality (connection volume and intensity) to prioritize resource deployment during outbreaks. |
 | [hospital_staffing](v1/hospital_staffing/) | Prescriptive | Explore the tradeoff between overtime cost and patient service level using bi-objective optimization with epsilon constraint. |
-| [patient_cohort_recruitment](v1/patient_cohort_recruitment/) | Graph, Rules-based, Prescriptive | Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize. |
-| [smoker_status_prediction](v1/smoker_status_prediction/) | Predictive | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network. |
-| [synthetic_eligibility_records](v1/synthetic_eligibility_records/) | Prescriptive | Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
+| [patient_cohort_recruitment](v1/patient_cohort_recruitment/) | Graph, Rules-based, Prescriptive | Build a clinical-research cohort over a patient knowledge graph: close a kinase-pathway sub-ontology, lift the closure to per-patient eligibility and coverage facts, then pick K patients whose joint coverage spans enough distinct genes, therapies, and adverse events to generalize. |
+| [smoker_status_prediction](v1/smoker_status_prediction/) | Predictive | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections. |
+| [synthetic_eligibility_records](v1/synthetic_eligibility_records/) | Prescriptive | Generate K distinct, internally consistent member eligibility records per solve in multi-solution mode: each satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
 
 </details>
 
@@ -76,7 +76,7 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 | --- | --- | --- |
 | [bom-reachability](v1/bom-reachability/) | Graph | Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks. |
 | [factory_production](v1/factory_production/) | Prescriptive | Maximize production profit under per-factory resource limits, then read the sensitivity marginals (capacity shadow prices and product reduced costs) from one solve. |
-| [product_configurator](v1/product_configurator/) | Prescriptive | Enumerate every feasible build of a configurable product using a CSP solver in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
+| [product_configurator](v1/product_configurator/) | Prescriptive | Enumerate every feasible build of a configurable product in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
 | [production_planning](v1/production_planning/) | Prescriptive | Schedule production across machines to meet demand and maximize profit with scenario analysis. |
 
 </details>
@@ -89,7 +89,7 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 | [ad_spend_allocation](v1/ad_spend_allocation/) | Prescriptive | Allocate marketing budget across channels and campaigns to maximize conversions. |
 | [book_slate_recommendation](v1/book_slate_recommendation/) | Graph, Prescriptive | Recommend K books per reader and order them by slot, under diversity, freshness, and explainability constraints. |
 | [campaign_roi](v1/campaign_roi/) | Prescriptive | Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region. |
-| [demand_forecasting](v1/demand_forecasting/) | Predictive | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies. |
+| [demand_forecasting](v1/demand_forecasting/) | Predictive | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail graph linking sales to stores, items, and item families. |
 | [planogram_optimization](v1/planogram_optimization/) | Predictive, Prescriptive | Decide integer facing counts per SKU to maximize predicted weekly demand under shelf capacity and category cardinality limits, where per-(SKU, facing_count) demand comes from a regression model. |
 | [retail_markdown](v1/retail_markdown/) | Prescriptive | Set discount levels across weeks to maximize revenue while clearing inventory. |
 | [retail_planning](v1/retail_planning/) | Predictive, Prescriptive | Predict article sales and customer churn with GNNs, then optimize markdown pricing and inventory planning to maximize revenue and minimize costs. |
@@ -102,14 +102,14 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 | Template | Reasoners | Description |
 | --- | --- | --- |
 | [demand_planning_temporal](v1/demand_planning_temporal/) | Prescriptive | Plan weekly production and inventory across sites over a date-filtered planning horizon to minimize total cost while meeting demand. |
-| [humanitarian-aid-supply-chain](v1/humanitarian-aid-supply-chain/) | Graph | Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies. |
+| [humanitarian-aid-supply-chain](v1/humanitarian-aid-supply-chain/) | Graph | Analyze a humanitarian aid supply-chain network with PageRank and weighted degree centrality to optimize resource distribution. |
 | [network_flow_planning](v1/network_flow_planning/) | Prescriptive | Plan a multi-tier distribution flow that decides which fulfillment centers to open and how much to ship on every lane to satisfy customer demand at minimum cost. |
-| [shipment_compliance](v1/shipment_compliance/) | Rules-based | Define derived business rules for shipment compliance, sourcing risk, and demand escalation. |
+| [shipment_compliance](v1/shipment_compliance/) | Rules-based | Derived classifications for shipment compliance, sourcing risk, and demand escalation. |
 | [supplier_reliability](v1/supplier_reliability/) | Prescriptive | Select suppliers to meet product demand at minimum cost, with sensitivity marginals and supplier-disruption scenario analysis. |
-| [supply_chain_resilience](v1/supply_chain_resilience/) | Graph, Rules-based, Prescriptive | A multi-reasoner template that chains blast-radius reachability, graph analysis, rules-based classification, and prescriptive optimization to build a risk-adjusted minimum-cost network flow for supply chain routing. |
+| [supply_chain_resilience](v1/supply_chain_resilience/) | Graph, Rules-based, Prescriptive | Chain blast-radius reachability, network analysis, and rule-based risk classification into a risk-adjusted minimum-cost network flow for supply-chain routing. |
 | [supply_chain_transport](v1/supply_chain_transport/) | Prescriptive | Minimize inventory holding and transport costs with TL/LTL mode selection. |
 | [traveling_salesman](v1/traveling_salesman/) | Prescriptive | Find the shortest route visiting all cities exactly once using the MTZ formulation. |
-| [warehouse_allocation](v1/warehouse_allocation/) | Graph, Prescriptive | Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs. |
+| [warehouse_allocation](v1/warehouse_allocation/) | Graph, Prescriptive | Allocate inventory across a distribution network using centrality, weakly-connected components, and bridge-route detection to prioritize critical hubs. |
 
 </details>
 
@@ -120,12 +120,12 @@ The index below covers the current (`v1`) templates, grouped by industry. Expand
 | --- | --- | --- |
 | [cell_tower_coverage](v1/cell_tower_coverage/) | Prescriptive | Select candidate cell tower sites and assign demand zones to maximize covered population under budget, tower-count, and capacity limits. |
 | [cicd_runner_allocation](v1/cicd_runner_allocation/) | Prescriptive | Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels and conflict analysis to diagnose an infeasible outage. |
-| [datacenter_compute_allocation](v1/datacenter_compute_allocation/) | Predictive, Graph, Rules-based, Prescriptive | Multi-reasoner template (chain follow-up to energy_grid_planning): heterogeneous-graph GNN classification of per-workload utilization probability, hardware-compatibility rules, dependency PageRank, and 24-cell scenario MIP for inside-the-fence GPU allocation across hyperscaler campuses. |
-| [memory_supply_allocation](v1/memory_supply_allocation/) | Predictive, Rules-based, Prescriptive, Graph | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
+| [datacenter_compute_allocation](v1/datacenter_compute_allocation/) | Predictive, Graph, Rules-based, Prescriptive | Inside-the-fence GPU allocation across hyperscaler campuses, a chain follow-up to energy_grid_planning: GNN-predicted per-workload utilization, hardware-compatibility rules, dependency PageRank, and a 24-cell scenario MIP. |
+| [memory_supply_allocation](v1/memory_supply_allocation/) | Predictive, Rules-based, Prescriptive, Graph | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with supplier dependencies, named foundries, and raw-material inputs: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
 | [pod_placement](v1/pod_placement/) | Prescriptive | Assign pods to nodes in a Kubernetes-style cluster subject to per-node CPU / memory / GPU bin-packing, pairwise tenant anti-affinity, deployment co-location affinity, failure-domain spread, gang-placement atomicity, and topology rack-clique rules. Pure CSP via MiniZinc / Chuffed. |
 | [sprint_scheduling](v1/sprint_scheduling/) | Prescriptive | Assign backlog issues to developers across sprints, minimizing weighted completion time while respecting capacity and skill constraints. |
-| [subscriber_retention](v1/subscriber_retention/) | Graph, Predictive | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns. |
-| [telco_network_recovery](v1/telco_network_recovery/) | Predictive, Rules-based, Graph, Prescriptive | Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology. |
+| [subscriber_retention](v1/subscriber_retention/) | Graph, Predictive | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph plus aggregate-derived call-volume features feed a regression GNN that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment. |
+| [telco_network_recovery](v1/telco_network_recovery/) | Predictive, Rules-based, Graph, Prescriptive | Tower-upgrade planning on a shared telco ontology: an equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, and customer-impact analysis (revenue × churn, with PageRank). |
 | [test_data_generation](v1/test_data_generation/) | Prescriptive | Determine optimal row counts for test database tables satisfying schema and referential integrity constraints. |
 
 </details>
diff --git a/v1/README.md b/v1/README.md
index 188c2720..cdb32a98 100644
--- a/v1/README.md
+++ b/v1/README.md
@@ -14,7 +14,7 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 | [rai-agent-scaffold](./rai-agent-scaffold/) | Graph | Scaffold for packaging a RelationalAI semantic model as a Snowflake Cortex agent and exposing it through Snowflake Intelligence. |
 | [shift_assignment](./shift_assignment/) | Prescriptive | Assign workers to shifts based on availability to meet coverage requirements. |
 | [simple-start](./simple-start/) | Graph | A minimal notebook to connect to Snowflake, model a small graph, and compute betweenness centrality with RelationalAI. |
-| [wildlife-conservation-network](./wildlife-conservation-network/) | Graph | Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs. |
+| [wildlife-conservation-network](./wildlife-conservation-network/) | Graph | Identify collaboration clusters among wildlife-conservation organizations with Louvain community detection and degree centrality, surfacing key coordination hubs for resource sharing. |
 
 </details>
 
@@ -23,7 +23,7 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 
 | Template | Reasoners | Description |
 | --- | --- | --- |
-| [energy_grid_planning](./energy_grid_planning/) | Graph, Rules-based, Prescriptive | Multi-reasoner template: demand forecasting, grid vulnerability analysis, compliance rules, and multi-objective optimization for AI data center interconnection planning on the ERCOT (Texas) grid. |
+| [energy_grid_planning](./energy_grid_planning/) | Graph, Rules-based, Prescriptive | AI data center interconnection planning on the ERCOT (Texas) grid: demand forecasting, grid-vulnerability analysis, compliance rules, and multi-objective optimization. |
 | [water_allocation](./water_allocation/) | Prescriptive | Minimize the cost of distributing water from sources to users with nonlinear transmission losses. |
 
 </details>
@@ -33,13 +33,13 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 
 | Template | Reasoners | Description |
 | --- | --- | --- |
-| [commercial_underwriting](./commercial_underwriting/) | Rules-based | Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
-| [financial_index_replication](./financial_index_replication/) | Prescriptive, Rules-based | Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
-| [fraud-detection](./fraud-detection/) | Graph, Rules-based, Predictive, Prescriptive | Multi-reasoner transaction-fraud pipeline: account PageRank (Graph) + high-volume account flags (Rules) feed a GNN binary classifier (Predictive) whose per-transaction scores drive a knapsack investigator-budget MILP (Prescriptive). |
+| [commercial_underwriting](./commercial_underwriting/) | Rules-based | Eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
+| [financial_index_replication](./financial_index_replication/) | Prescriptive, Rules-based | Select a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark. |
+| [fraud-detection](./fraud-detection/) | Graph, Rules-based, Predictive, Prescriptive | Transaction-fraud pipeline: account PageRank and high-volume account flags feed a GNN binary classifier whose per-transaction scores drive a knapsack investigator-budget MILP. |
 | [money_laundering_motif_detection](./money_laundering_motif_detection/) | Prescriptive | Detect three classes of layering motif on the same transaction ledger, each demonstrating a different CSP technique that rules / paths / graph reasoning alone cannot enforce: per-vertex aggregate equality (butterfly), pairwise distinctness over a chosen subset (smurf army), and cardinality on a chosen subset (KYC-mix burst). |
-| [portfolio_balancing](./portfolio_balancing/) | Prescriptive, Rules-based, Graph | Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
-| [synthetic_order_lifecycle](./synthetic_order_lifecycle/) | Prescriptive | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver. |
-| [underwriting_audit](./underwriting_audit/) | Prescriptive | Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode. |
+| [portfolio_balancing](./portfolio_balancing/) | Prescriptive, Rules-based, Graph | Compliance screening, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test. |
+| [synthetic_order_lifecycle](./synthetic_order_lifecycle/) | Prescriptive | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules. |
+| [underwriting_audit](./underwriting_audit/) | Prescriptive | Audit an underwriting ruleset against a catalog of properties. For each, either prove it holds (PASS) or return K distinct counterexample applicants that falsify it (FAIL). Multi-property batch audit in multi-solution mode. |
 
 </details>
 
@@ -49,11 +49,11 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 | Template | Reasoners | Description |
 | --- | --- | --- |
 | [diet](./diet/) | Prescriptive | Select foods to satisfy nutritional requirements at minimum cost. |
-| [disease-outbreak-prevention](./disease-outbreak-prevention/) | Graph | Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks. |
+| [disease-outbreak-prevention](./disease-outbreak-prevention/) | Graph | Rank the highest-risk facilities in a public health network by weighted degree centrality (connection volume and intensity) to prioritize resource deployment during outbreaks. |
 | [hospital_staffing](./hospital_staffing/) | Prescriptive | Explore the tradeoff between overtime cost and patient service level using bi-objective optimization with epsilon constraint. |
-| [patient_cohort_recruitment](./patient_cohort_recruitment/) | Graph, Rules-based, Prescriptive | Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize. |
-| [smoker_status_prediction](./smoker_status_prediction/) | Predictive | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network. |
-| [synthetic_eligibility_records](./synthetic_eligibility_records/) | Prescriptive | Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
+| [patient_cohort_recruitment](./patient_cohort_recruitment/) | Graph, Rules-based, Prescriptive | Build a clinical-research cohort over a patient knowledge graph: close a kinase-pathway sub-ontology, lift the closure to per-patient eligibility and coverage facts, then pick K patients whose joint coverage spans enough distinct genes, therapies, and adverse events to generalize. |
+| [smoker_status_prediction](./smoker_status_prediction/) | Predictive | Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections. |
+| [synthetic_eligibility_records](./synthetic_eligibility_records/) | Prescriptive | Generate K distinct, internally consistent member eligibility records per solve in multi-solution mode: each satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
 
 </details>
 
@@ -64,7 +64,7 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 | --- | --- | --- |
 | [bom-reachability](./bom-reachability/) | Graph | Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks. |
 | [factory_production](./factory_production/) | Prescriptive | Maximize production profit under per-factory resource limits, then read the sensitivity marginals (capacity shadow prices and product reduced costs) from one solve. |
-| [product_configurator](./product_configurator/) | Prescriptive | Enumerate every feasible build of a configurable product using a CSP solver in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
+| [product_configurator](./product_configurator/) | Prescriptive | Enumerate every feasible build of a configurable product in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling. |
 | [production_planning](./production_planning/) | Prescriptive | Schedule production across machines to meet demand and maximize profit with scenario analysis. |
 
 </details>
@@ -77,7 +77,7 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 | [ad_spend_allocation](./ad_spend_allocation/) | Prescriptive | Allocate marketing budget across channels and campaigns to maximize conversions. |
 | [book_slate_recommendation](./book_slate_recommendation/) | Graph, Prescriptive | Recommend K books per reader and order them by slot, under diversity, freshness, and explainability constraints. |
 | [campaign_roi](./campaign_roi/) | Prescriptive | Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region. |
-| [demand_forecasting](./demand_forecasting/) | Predictive | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies. |
+| [demand_forecasting](./demand_forecasting/) | Predictive | Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail graph linking sales to stores, items, and item families. |
 | [planogram_optimization](./planogram_optimization/) | Predictive, Prescriptive | Decide integer facing counts per SKU to maximize predicted weekly demand under shelf capacity and category cardinality limits, where per-(SKU, facing_count) demand comes from a regression model. |
 | [retail_markdown](./retail_markdown/) | Prescriptive | Set discount levels across weeks to maximize revenue while clearing inventory. |
 | [retail_planning](./retail_planning/) | Predictive, Prescriptive | Predict article sales and customer churn with GNNs, then optimize markdown pricing and inventory planning to maximize revenue and minimize costs. |
@@ -90,14 +90,14 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 | Template | Reasoners | Description |
 | --- | --- | --- |
 | [demand_planning_temporal](./demand_planning_temporal/) | Prescriptive | Plan weekly production and inventory across sites over a date-filtered planning horizon to minimize total cost while meeting demand. |
-| [humanitarian-aid-supply-chain](./humanitarian-aid-supply-chain/) | Graph | Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies. |
+| [humanitarian-aid-supply-chain](./humanitarian-aid-supply-chain/) | Graph | Analyze a humanitarian aid supply-chain network with PageRank and weighted degree centrality to optimize resource distribution. |
 | [network_flow_planning](./network_flow_planning/) | Prescriptive | Plan a multi-tier distribution flow that decides which fulfillment centers to open and how much to ship on every lane to satisfy customer demand at minimum cost. |
-| [shipment_compliance](./shipment_compliance/) | Rules-based | Define derived business rules for shipment compliance, sourcing risk, and demand escalation. |
+| [shipment_compliance](./shipment_compliance/) | Rules-based | Derived classifications for shipment compliance, sourcing risk, and demand escalation. |
 | [supplier_reliability](./supplier_reliability/) | Prescriptive | Select suppliers to meet product demand at minimum cost, with sensitivity marginals and supplier-disruption scenario analysis. |
-| [supply_chain_resilience](./supply_chain_resilience/) | Graph, Rules-based, Prescriptive | A multi-reasoner template that chains blast-radius reachability, graph analysis, rules-based classification, and prescriptive optimization to build a risk-adjusted minimum-cost network flow for supply chain routing. |
+| [supply_chain_resilience](./supply_chain_resilience/) | Graph, Rules-based, Prescriptive | Chain blast-radius reachability, network analysis, and rule-based risk classification into a risk-adjusted minimum-cost network flow for supply-chain routing. |
 | [supply_chain_transport](./supply_chain_transport/) | Prescriptive | Minimize inventory holding and transport costs with TL/LTL mode selection. |
 | [traveling_salesman](./traveling_salesman/) | Prescriptive | Find the shortest route visiting all cities exactly once using the MTZ formulation. |
-| [warehouse_allocation](./warehouse_allocation/) | Graph, Prescriptive | Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs. |
+| [warehouse_allocation](./warehouse_allocation/) | Graph, Prescriptive | Allocate inventory across a distribution network using centrality, weakly-connected components, and bridge-route detection to prioritize critical hubs. |
 
 </details>
 
@@ -108,12 +108,12 @@ Templates are grouped by industry. Expand an industry to see its templates, the
 | --- | --- | --- |
 | [cell_tower_coverage](./cell_tower_coverage/) | Prescriptive | Select candidate cell tower sites and assign demand zones to maximize covered population under budget, tower-count, and capacity limits. |
 | [cicd_runner_allocation](./cicd_runner_allocation/) | Prescriptive | Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels and conflict analysis to diagnose an infeasible outage. |
-| [datacenter_compute_allocation](./datacenter_compute_allocation/) | Predictive, Graph, Rules-based, Prescriptive | Multi-reasoner template (chain follow-up to energy_grid_planning): heterogeneous-graph GNN classification of per-workload utilization probability, hardware-compatibility rules, dependency PageRank, and 24-cell scenario MIP for inside-the-fence GPU allocation across hyperscaler campuses. |
-| [memory_supply_allocation](./memory_supply_allocation/) | Predictive, Rules-based, Prescriptive, Graph | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
+| [datacenter_compute_allocation](./datacenter_compute_allocation/) | Predictive, Graph, Rules-based, Prescriptive | Inside-the-fence GPU allocation across hyperscaler campuses, a chain follow-up to energy_grid_planning: GNN-predicted per-workload utilization, hardware-compatibility rules, dependency PageRank, and a 24-cell scenario MIP. |
+| [memory_supply_allocation](./memory_supply_allocation/) | Predictive, Rules-based, Prescriptive, Graph | Monthly rolling-horizon allocation of constrained memory-chip supply across customers with supplier dependencies, named foundries, and raw-material inputs: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades. |
 | [pod_placement](./pod_placement/) | Prescriptive | Assign pods to nodes in a Kubernetes-style cluster subject to per-node CPU / memory / GPU bin-packing, pairwise tenant anti-affinity, deployment co-location affinity, failure-domain spread, gang-placement atomicity, and topology rack-clique rules. Pure CSP via MiniZinc / Chuffed. |
 | [sprint_scheduling](./sprint_scheduling/) | Prescriptive | Assign backlog issues to developers across sprints, minimizing weighted completion time while respecting capacity and skill constraints. |
-| [subscriber_retention](./subscriber_retention/) | Graph, Predictive | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns. |
-| [telco_network_recovery](./telco_network_recovery/) | Predictive, Rules-based, Graph, Prescriptive | Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology. |
+| [subscriber_retention](./subscriber_retention/) | Graph, Predictive | Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph plus aggregate-derived call-volume features feed a regression GNN that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment. |
+| [telco_network_recovery](./telco_network_recovery/) | Predictive, Rules-based, Graph, Prescriptive | Tower-upgrade planning on a shared telco ontology: an equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, and customer-impact analysis (revenue × churn, with PageRank). |
 | [test_data_generation](./test_data_generation/) | Prescriptive | Determine optimal row counts for test database tables satisfying schema and referential integrity constraints. |
 
 </details>
diff --git a/v1/commercial_underwriting/README.md b/v1/commercial_underwriting/README.md
index 9812d83f..0724a5e2 100644
--- a/v1/commercial_underwriting/README.md
+++ b/v1/commercial_underwriting/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Commercial Underwriting"
-description: "Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage)."
+description: "Eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage)."
 featured: false
 experience_level: intermediate
 industry: "Financial Services"
diff --git a/v1/datacenter_compute_allocation/README.md b/v1/datacenter_compute_allocation/README.md
index 21601008..b7ceecf3 100644
--- a/v1/datacenter_compute_allocation/README.md
+++ b/v1/datacenter_compute_allocation/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Datacenter Compute Allocation"
-description: "Multi-reasoner template (chain follow-up to energy_grid_planning): heterogeneous-graph GNN classification of per-workload utilization probability, hardware-compatibility rules, dependency PageRank, and 24-cell scenario MIP for inside-the-fence GPU allocation across hyperscaler campuses."
+description: "Inside-the-fence GPU allocation across hyperscaler campuses, a chain follow-up to energy_grid_planning: GNN-predicted per-workload utilization, hardware-compatibility rules, dependency PageRank, and a 24-cell scenario MIP."
 featured: false
 private: true
 experience_level: advanced
diff --git a/v1/demand_forecasting/README.md b/v1/demand_forecasting/README.md
index ae37d58e..1247028a 100644
--- a/v1/demand_forecasting/README.md
+++ b/v1/demand_forecasting/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Demand Forecasting"
-description: "Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail knowledge graph: sales transactions linked to stores, items, and item families so the GNN propagates signal through the store and product hierarchies."
+description: "Forecast next-period unit sales per (store, item, day) with a regression GNN over a heterogeneous retail graph linking sales to stores, items, and item families."
 featured: false
 experience_level: advanced
 industry: "Retail & Consumer"
diff --git a/v1/disease-outbreak-prevention/README.md b/v1/disease-outbreak-prevention/README.md
index 3f9037e1..9ef7832e 100644
--- a/v1/disease-outbreak-prevention/README.md
+++ b/v1/disease-outbreak-prevention/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Disease Outbreak Prevention"
-description: "Use weighted degree centrality to identify the highest-risk healthcare facilities in a public health network, considering both connection volume and intensity, to prioritize resource deployment during disease outbreaks."
+description: "Rank the highest-risk facilities in a public health network by weighted degree centrality (connection volume and intensity) to prioritize resource deployment during outbreaks."
 experience_level: intermediate
 industry: "Healthcare & Life Sciences"
 featured: true
diff --git a/v1/energy_grid_planning/README.md b/v1/energy_grid_planning/README.md
index e6880fdf..262291ec 100644
--- a/v1/energy_grid_planning/README.md
+++ b/v1/energy_grid_planning/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Energy Grid Planning"
-description: "Multi-reasoner template: demand forecasting, grid vulnerability analysis, compliance rules, and multi-objective optimization for AI data center interconnection planning on the ERCOT (Texas) grid."
+description: "AI data center interconnection planning on the ERCOT (Texas) grid: demand forecasting, grid-vulnerability analysis, compliance rules, and multi-objective optimization."
 featured: true
 experience_level: intermediate
 industry: "Energy & Utilities"
diff --git a/v1/financial_index_replication/README.md b/v1/financial_index_replication/README.md
index c8114833..c589115d 100644
--- a/v1/financial_index_replication/README.md
+++ b/v1/financial_index_replication/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Financial Index Replication"
-description: "Prescriptive optimization template for selecting a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark."
+description: "Select a sparse 20-stock replication basket and weights that track an S&P 500-like benchmark."
 featured: false
 experience_level: intermediate
 industry: "Financial Services"
diff --git a/v1/fraud-detection/README.md b/v1/fraud-detection/README.md
index a95d7b6f..6f7531bc 100644
--- a/v1/fraud-detection/README.md
+++ b/v1/fraud-detection/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Fraud Detection"
-description: "Multi-reasoner transaction-fraud pipeline: account PageRank (Graph) + high-volume account flags (Rules) feed a GNN binary classifier (Predictive) whose per-transaction scores drive a knapsack investigator-budget MILP (Prescriptive)."
+description: "Transaction-fraud pipeline: account PageRank and high-volume account flags feed a GNN binary classifier whose per-transaction scores drive a knapsack investigator-budget MILP."
 featured: true
 experience_level: advanced
 industry: "Financial Services"
diff --git a/v1/humanitarian-aid-supply-chain/README.md b/v1/humanitarian-aid-supply-chain/README.md
index d2ba7383..2973d4fa 100644
--- a/v1/humanitarian-aid-supply-chain/README.md
+++ b/v1/humanitarian-aid-supply-chain/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Humanitarian Aid Supply Chain Network"
-description: "Use graph reasoning to analyze a humanitarian aid supply chain network with PageRank and Weighted Degree Centrality to optimize resource distribution strategies."
+description: "Analyze a humanitarian aid supply-chain network with PageRank and weighted degree centrality to optimize resource distribution."
 experience_level: intermediate
 industry: "Supply Chain & Logistics"
 reasoning_types:
diff --git a/v1/memory_supply_allocation/README.md b/v1/memory_supply_allocation/README.md
index 8b514159..447fc09b 100644
--- a/v1/memory_supply_allocation/README.md
+++ b/v1/memory_supply_allocation/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Memory Supply Allocation"
-description: "Monthly rolling-horizon allocation of constrained memory-chip supply across customers with strategic supplier dependencies, named foundries, and raw-material inputs. Four-reasoner chain: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades."
+description: "Monthly rolling-horizon allocation of constrained memory-chip supply across customers with supplier dependencies, named foundries, and raw-material inputs: predicted supplier capability feeds the optimization, customer-customer paths surface single points of failure, and two what-if scenarios trace supplier-offline and input-shortage cascades."
 featured: false
 experience_level: intermediate
 industry: "Technology & Telecom"
diff --git a/v1/patient_cohort_recruitment/README.md b/v1/patient_cohort_recruitment/README.md
index 1366b8c1..b587d21c 100644
--- a/v1/patient_cohort_recruitment/README.md
+++ b/v1/patient_cohort_recruitment/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Patient Cohort Recruitment"
-description: "Build a clinical-research cohort over a patient knowledge graph: a Graph reasoner closes a kinase-pathway sub-ontology, relational rules lift the closure to per-patient eligibility and coverage facts, and a CSP solver picks K patients whose joint coverage spans enough distinct genes, therapies, and adverse events for the analysis to generalize."
+description: "Build a clinical-research cohort over a patient knowledge graph: close a kinase-pathway sub-ontology, lift the closure to per-patient eligibility and coverage facts, then pick K patients whose joint coverage spans enough distinct genes, therapies, and adverse events to generalize."
 featured: false
 experience_level: intermediate
 industry: "Healthcare & Life Sciences"
diff --git a/v1/portfolio_balancing/README.md b/v1/portfolio_balancing/README.md
index 342a3ae0..4dc647a6 100644
--- a/v1/portfolio_balancing/README.md
+++ b/v1/portfolio_balancing/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Portfolio Balancing"
-description: "Multi-reasoner template: rules-based compliance, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test."
+description: "Compliance screening, covariance clustering, and bi-objective Markowitz optimization with a crisis-regime stress test."
 featured: false
 experience_level: intermediate
 industry: "Financial Services"
diff --git a/v1/product_configurator/README.md b/v1/product_configurator/README.md
index bbe8ae4d..27219700 100644
--- a/v1/product_configurator/README.md
+++ b/v1/product_configurator/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Product Configurator"
-description: "Enumerate every feasible build of a configurable product using a CSP solver in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling."
+description: "Enumerate every feasible build of a configurable product in multi-solution mode: one option per slot subject to feature-model rules, regional regulations, and a price ceiling."
 featured: false
 experience_level: intermediate
 industry: "Manufacturing"
diff --git a/v1/shipment_compliance/README.md b/v1/shipment_compliance/README.md
index 28a081be..f7ec50c1 100644
--- a/v1/shipment_compliance/README.md
+++ b/v1/shipment_compliance/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Shipment Compliance"
-description: "Define derived business rules for shipment compliance, sourcing risk, and demand escalation."
+description: "Derived classifications for shipment compliance, sourcing risk, and demand escalation."
 featured: false
 experience_level: beginner
 industry: "Supply Chain & Logistics"
diff --git a/v1/smoker_status_prediction/README.md b/v1/smoker_status_prediction/README.md
index 24806c5d..ad6db0e4 100644
--- a/v1/smoker_status_prediction/README.md
+++ b/v1/smoker_status_prediction/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Smoker Status Prediction"
-description: "Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections, using a Graph Neural Network."
+description: "Predict whether a person is a smoker from demographic and medical attributes plus a network of social connections."
 featured: false
 experience_level: intermediate
 industry: "Healthcare & Life Sciences"
diff --git a/v1/subscriber_retention/README.md b/v1/subscriber_retention/README.md
index 56e68f78..433a1b77 100644
--- a/v1/subscriber_retention/README.md
+++ b/v1/subscriber_retention/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Subscriber Retention"
-description: "Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph (Graph) plus aggregate-derived call-volume features feed a regression GNN (Predictive) that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment for retention campaigns."
+description: "Telco churn-risk scoring: PageRank over a Subscriber→Subscriber call graph plus aggregate-derived call-volume features feed a regression GNN that scores per-subscriber churn risk, then surfaces the highest-risk subscribers per segment."
 featured: false
 experience_level: advanced
 industry: "Technology & Telecom"
diff --git a/v1/supply_chain_resilience/README.md b/v1/supply_chain_resilience/README.md
index bafcfbd1..fade38c4 100644
--- a/v1/supply_chain_resilience/README.md
+++ b/v1/supply_chain_resilience/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Supply Chain Resilience"
-description: "A multi-reasoner template that chains blast-radius reachability, graph analysis, rules-based classification, and prescriptive optimization to build a risk-adjusted minimum-cost network flow for supply chain routing."
+description: "Chain blast-radius reachability, network analysis, and rule-based risk classification into a risk-adjusted minimum-cost network flow for supply-chain routing."
 featured: false
 experience_level: intermediate
 industry: "Supply Chain & Logistics"
diff --git a/v1/synthetic_eligibility_records/README.md b/v1/synthetic_eligibility_records/README.md
index 0504e044..720df510 100644
--- a/v1/synthetic_eligibility_records/README.md
+++ b/v1/synthetic_eligibility_records/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Synthetic Eligibility Records"
-description: "Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution."
+description: "Generate K distinct, internally consistent member eligibility records per solve in multi-solution mode: each satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution."
 featured: false
 experience_level: intermediate
 industry: "Healthcare & Life Sciences"
diff --git a/v1/synthetic_order_lifecycle/README.md b/v1/synthetic_order_lifecycle/README.md
index 4ed22565..1f0eb4cd 100644
--- a/v1/synthetic_order_lifecycle/README.md
+++ b/v1/synthetic_order_lifecycle/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Synthetic Order Lifecycle"
-description: "Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver."
+description: "Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules."
 featured: false
 experience_level: intermediate
 industry: "Financial Services"
diff --git a/v1/telco_network_recovery/README.md b/v1/telco_network_recovery/README.md
index 5c0f8953..0d570922 100644
--- a/v1/telco_network_recovery/README.md
+++ b/v1/telco_network_recovery/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Telco Network Recovery"
-description: "Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, customer-impact analysis (revenue × churn, with PageRank alongside), and tower-upgrade optimization on a shared telco ontology."
+description: "Tower-upgrade planning on a shared telco ontology: an equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, and customer-impact analysis (revenue × churn, with PageRank)."
 featured: false
 experience_level: advanced
 industry: "Technology & Telecom"
diff --git a/v1/underwriting_audit/README.md b/v1/underwriting_audit/README.md
index f7915b20..0b43e20f 100644
--- a/v1/underwriting_audit/README.md
+++ b/v1/underwriting_audit/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Underwriting Audit"
-description: "Audit an underwriting ruleset against a catalog of properties. For each property, the solver either proves the property holds (PASS) or returns K distinct counterexample applicants who falsify it (FAIL). Multi-property batch audit, CSP solver in multi-solution mode."
+description: "Audit an underwriting ruleset against a catalog of properties. For each, either prove it holds (PASS) or return K distinct counterexample applicants that falsify it (FAIL). Multi-property batch audit in multi-solution mode."
 featured: false
 experience_level: advanced
 industry: "Financial Services"
diff --git a/v1/warehouse_allocation/README.md b/v1/warehouse_allocation/README.md
index 7176a1b3..0cede1de 100644
--- a/v1/warehouse_allocation/README.md
+++ b/v1/warehouse_allocation/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Warehouse Allocation"
-description: "Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs."
+description: "Allocate inventory across a distribution network using centrality, weakly-connected components, and bridge-route detection to prioritize critical hubs."
 featured: false
 experience_level: intermediate
 industry: "Supply Chain & Logistics"
diff --git a/v1/wildlife-conservation-network/README.md b/v1/wildlife-conservation-network/README.md
index 6b5bbb75..cdca2746 100644
--- a/v1/wildlife-conservation-network/README.md
+++ b/v1/wildlife-conservation-network/README.md
@@ -1,6 +1,6 @@
 ---
 title: "Wildlife Conservation Network"
-description: "Use the Louvain community detection algorithm and degree centrality analysis to identify collaboration clusters among wildlife conservation organizations, helping optimize resource sharing and identify key coordination hubs."
+description: "Identify collaboration clusters among wildlife-conservation organizations with Louvain community detection and degree centrality, surfacing key coordination hubs for resource sharing."
 experience_level: beginner
 industry: "Cross-Industry"
 reasoning_types:

From 8eb3b793fb6ae0b35647631d8b5cd5c9a886b9a1 Mon Sep 17 00:00:00 2001
From: cafzal <cameron.afzal@gmail.com>
Date: Tue, 9 Jun 2026 08:55:56 -0700
Subject: [PATCH 3/3] bom-reachability: quote industry value for frontmatter
 consistency

---
 v1/bom-reachability/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/v1/bom-reachability/README.md b/v1/bom-reachability/README.md
index e410194d..c1576ce0 100644
--- a/v1/bom-reachability/README.md
+++ b/v1/bom-reachability/README.md
@@ -2,7 +2,7 @@
 title: "BOM Reachability"
 description: "Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks."
 experience_level: intermediate
-industry: Manufacturing
+industry: "Manufacturing"
 featured: false
 reasoning_types:
   - Graph