Round 100: library registry helper DRY + cross-registry migration

Six-lens panel unanimous on HV–HZ: extract shared
assert_library_wide_unique_basenames, assert_registry_matches_library_glob,
and sorted_all_library_prompts helpers; migrate all *_library_registry.py
glob/unique guards; add test_prompt_library_registry_helpers_library_registry.py;
align test_prompt_cross_links.py and promotion contract with shared path helpers.
Governance synced to Round 100 (options A–HV); 702 pytest, ROUTE 100%.

Author: johnteee

README.md

@@ -21,7 +21,7 @@ Full library docs: [reflective-prompt-library/README.md](reflective-prompt-libra
 ## Governance
 
 - **Contributing:** [CONTRIBUTING.md](CONTRIBUTING.md) — quality gates, routing maintenance (R8–R12), `make all`
-- **Panel record:** [multi-agent-panel-consensus](reflective-prompt-library/plans/multi-agent-panel-consensus-2026-06-25.md) — six-lens Socratic consensus (Rounds 1–99)
+- **Panel record:** [multi-agent-panel-consensus](reflective-prompt-library/plans/multi-agent-panel-consensus-2026-06-25.md) — six-lens Socratic consensus (Rounds 1–100)
 - **Operator playbook:** [GLOSSARY.md](reflective-prompt-library/GLOSSARY.md) — Governance Maintenance Playbook
 
 The repository contains:

reflective-prompt-library/GLOSSARY.md

@@ -337,7 +337,7 @@ Curated top-of-cheatsheet summary of high-confusion routing traps (ROUTE-002 hol
 
 ## Governance Maintenance Playbook / 治理維護手冊
 
-Ongoing upkeep after panel close (Rounds 1–99). Not agent instructions — operator checklist.
+Ongoing upkeep after panel close (Rounds 1–100). Not agent instructions — operator checklist.
 
 **Operational test:** Before router tuning, add fresh ROUTE-002/003 holdout phrases; run `make all`; record decisions in `PROJECT_KNOWLEDGE.md` Decision Index when governance surface changes.
 
@@ -372,3 +372,4 @@ Ongoing upkeep after panel close (Rounds 1–99). Not agent instructions — ope
 29. When editing per-category `reference_workflow_skills` guards, use `assert_prompt_references_workflow_skill` in `prompt_eval_helpers.py` (preamble-scoped, not fenced templates); run `test_prompt_workflow_skill_reference_library_registry.py` plus per-category harness guards.
 30. When editing per-category eval_harness fixtures, keep `PROMPT_LIBRARY_REPO_ROOT` and `make_category_eval_harness_fixture` in `prompt_eval_helpers.py`; run `test_prompt_eval_harness_fixture_library_registry.py` plus per-category harness guards.
 31. When editing per-category `*_DIR` / `*_PROMPTS` tuples, use `category_prompt_dir` and `sorted_category_prompts` in `prompt_eval_helpers.py`; run `test_prompt_category_paths_library_registry.py` plus per-category harness guards.
+32. When editing cross-category library registries, use `assert_library_wide_unique_basenames`, `assert_registry_matches_library_glob`, and `sorted_all_library_prompts` in `prompt_eval_helpers.py`; run `test_prompt_library_registry_helpers_library_registry.py` plus per-registry glob/unique guards.

reflective-prompt-library/PROJECT_KNOWLEDGE.md

@@ -72,6 +72,7 @@ deferred promotions are recurrence-gated — see [panel backlog](plans/multi-age
 
 ## Decision Index
 
+- 2026-06-25 Round 100 panel — cross-category library registry helper DRY (`test_prompt_library_registry_helpers_library_registry.py`, `assert_library_wide_unique_basenames`, `assert_registry_matches_library_glob`, `sorted_all_library_prompts`; migrate all `*_library_registry.py` glob/unique guards) → [record](plans/multi-agent-panel-consensus-2026-06-25.md)
 - 2026-06-25 Round 99 panel — cross-category prompt path library registry (`test_prompt_category_paths_library_registry.py`, DRY `category_prompt_dir` / `sorted_category_prompts`; preamble-scoped `assert_prompt_references_workflow_skill`) → [record](plans/multi-agent-panel-consensus-2026-06-25.md)
 - 2026-06-25 Round 98 panel — cross-category eval_harness fixture library registry (`test_prompt_eval_harness_fixture_library_registry.py`, DRY `make_category_eval_harness_fixture`, `PROMPT_LIBRARY_REPO_ROOT`) → [record](plans/multi-agent-panel-consensus-2026-06-25.md)
 - 2026-06-25 Round 97 panel — cross-category workflow skill reference library registry (`test_prompt_workflow_skill_reference_library_registry.py`, DRY `assert_prompt_references_workflow_skill`) → [record](plans/multi-agent-panel-consensus-2026-06-25.md)

reflective-prompt-library/README.md

@@ -30,7 +30,7 @@ Pick **Strictness L1–L6** first (`skills/reflective-dispatch/SKILL.md`, [GLOSS
 
 ## Governance Panel Record
 
-Multi-agent Socratic consensus on project goals and the nine skills (Rounds 1–99, options A–HU) is recorded in [plans/multi-agent-panel-consensus-2026-06-25.md](plans/multi-agent-panel-consensus-2026-06-25.md). Run `make all` before claiming routing or governance changes are verified.
+Multi-agent Socratic consensus on project goals and the nine skills (Rounds 1–100, options A–HV) is recorded in [plans/multi-agent-panel-consensus-2026-06-25.md](plans/multi-agent-panel-consensus-2026-06-25.md). Run `make all` before claiming routing or governance changes are verified.
 
 ## Directory Map
 

reflective-prompt-library/plans/QUALITY_GATES_SUMMARY.md

@@ -314,7 +314,7 @@ ROUTE-002 measures unseen phrasing separately from ROUTE-001. Round 7 (2026-06-2
 2. **ROUTE-001/002/003 in CI** — 128 + 102 + 53 paraphrases at 100% consistency (seeded fixtures); `validate_route_fixture.py` gates minimum coverage
 3. **Governance validators** — links, lint, governance metadata, PROJECT_KNOWLEDGE, benchmark fixture, skill examples
 4. **Harness policy docs** — CONTRIBUTING, AGENTS, SKILL_INSTALLATION, maintenance playbook
-5. **Doc anti-drift** — `test_routing_contract.py`, cheatsheet parity tests, `test_readme_governance.py`, `test_thinking_prompts_eval_harness.py`, `test_engineering_prompts_eval_harness.py`, `test_prompt_cross_links.py`, `test_core_prompts_eval_harness.py`, `test_human_review_library_registry.py`, `test_prompt_skill_links_library_registry.py`, `test_prompt_contract_library_registry.py`, `test_prompt_primary_workflow_surface_library_registry.py`, `test_workflow_skill_coverage_library_registry.py`, `test_prompt_eval_harness_score_library_registry.py`, `test_prompt_workflow_skill_reference_library_registry.py`, `test_prompt_eval_harness_fixture_library_registry.py`, `test_prompt_category_paths_library_registry.py`, `test_agent_prompts_eval_harness.py`, `test_context_prompts_eval_harness.py`, `test_domain_prompts_eval_harness.py`, `test_repo_prompts_eval_harness.py`, `test_validate_governance.py`, `test_validate_links.py`, `test_lint_skills.py`, `test_skill_module_contract.py` (Escalation subsection + Trigger/Methods/Output/Never; 680+ pytest anti-drift suite in CI); reciprocal thinking-lens ↔ skill checks and `00-core` + composable `Primary workflow surface(s)` ↔ `*_SKILL_LINKS` parity in `test_prompt_cross_links.py` (including strict Primary workflow surfaces parity via `test_thinking_lens_primary_surfaces_match_consumer_graph`); Human Review + Escalation route-target guards in thinking/skill contract tests; composable `Primary workflow surface(s)` / Supporting-lens preamble guards and composable `## Human Review` preamble guards (route to `reflective-risk`) via `prompt_eval_helpers.assert_human_review_preamble` in `test_*_prompts_eval_harness.py`; frozen `*_HUMAN_REVIEW_REQUIRED` / `*_HUMAN_REVIEW_EXEMPT` set parity across all prompt categories (Round 90); library-wide contract heading registry (`PROMPT_CONTRACT_HEADINGS`, Round 93); workflow skill coverage registry (`*_COVER_WORKFLOW_SKILLS`, Round 95); eval_harness score floor registry (`PROMPT_EVAL_MIN_SCORE`, Round 96); workflow skill reference registry (`assert_prompt_references_workflow_skill`, Round 97); eval_harness fixture registry (`make_category_eval_harness_fixture`, Round 98); category path registry (`category_prompt_dir` / `sorted_category_prompts`, Round 99); workflow skill reference helper preamble-aligned (Round 99)
+5. **Doc anti-drift** — `test_routing_contract.py`, cheatsheet parity tests, `test_readme_governance.py`, `test_thinking_prompts_eval_harness.py`, `test_engineering_prompts_eval_harness.py`, `test_prompt_cross_links.py`, `test_core_prompts_eval_harness.py`, `test_human_review_library_registry.py`, `test_prompt_skill_links_library_registry.py`, `test_prompt_contract_library_registry.py`, `test_prompt_primary_workflow_surface_library_registry.py`, `test_workflow_skill_coverage_library_registry.py`, `test_prompt_eval_harness_score_library_registry.py`, `test_prompt_workflow_skill_reference_library_registry.py`, `test_prompt_eval_harness_fixture_library_registry.py`, `test_prompt_category_paths_library_registry.py`, `test_prompt_library_registry_helpers_library_registry.py`, `test_agent_prompts_eval_harness.py`, `test_context_prompts_eval_harness.py`, `test_domain_prompts_eval_harness.py`, `test_repo_prompts_eval_harness.py`, `test_validate_governance.py`, `test_validate_links.py`, `test_lint_skills.py`, `test_skill_module_contract.py` (Escalation subsection + Trigger/Methods/Output/Never; 690+ pytest anti-drift suite in CI); reciprocal thinking-lens ↔ skill checks and `00-core` + composable `Primary workflow surface(s)` ↔ `*_SKILL_LINKS` parity in `test_prompt_cross_links.py` (including strict Primary workflow surfaces parity via `test_thinking_lens_primary_surfaces_match_consumer_graph`); Human Review + Escalation route-target guards in thinking/skill contract tests; composable `Primary workflow surface(s)` / Supporting-lens preamble guards and composable `## Human Review` preamble guards (route to `reflective-risk`) via `prompt_eval_helpers.assert_human_review_preamble` in `test_*_prompts_eval_harness.py`; frozen `*_HUMAN_REVIEW_REQUIRED` / `*_HUMAN_REVIEW_EXEMPT` set parity across all prompt categories (Round 90); library-wide contract heading registry (`PROMPT_CONTRACT_HEADINGS`, Round 93); workflow skill coverage registry (`*_COVER_WORKFLOW_SKILLS`, Round 95); eval_harness score floor registry (`PROMPT_EVAL_MIN_SCORE`, Round 96); workflow skill reference registry (`assert_prompt_references_workflow_skill`, Round 97); eval_harness fixture registry (`make_category_eval_harness_fixture`, Round 98); category path registry (`category_prompt_dir` / `sorted_category_prompts`, Round 99); workflow skill reference helper preamble-aligned (Round 99); library registry helper DRY (`assert_library_wide_unique_basenames` / `assert_registry_matches_library_glob`, Round 100)
 
 ### Ongoing maintenance (not blockers)
 
@@ -384,4 +384,4 @@ Phase 1 quality-gate tooling and documentation are **complete**. Routing consist
 - ✅ Benchmark fixture gate plus optional manual benchmark runs
 - ✅ Research-backed design decisions
 
-The project is positioned to grow sustainably with quality discipline built in from the start. **No open implementation blockers** remain from panel Rounds 1–99; work is recurrence-gated maintenance per playbook. The next measurable quality target is **holdout expansion before router tuning** and optional manual baseline-vs-skill benchmark runs — not shipping new core skills without promotion evidence.
+The project is positioned to grow sustainably with quality discipline built in from the start. **No open implementation blockers** remain from panel Rounds 1–100; work is recurrence-gated maintenance per playbook. The next measurable quality target is **holdout expansion before router tuning** and optional manual baseline-vs-skill benchmark runs — not shipping new core skills without promotion evidence.

reflective-prompt-library/plans/multi-agent-panel-consensus-2026-06-25.md

@@ -3040,3 +3040,57 @@ User directive (repeat): review prompts, plans, skills, and Socratic/critical-th
 ---
 
 **Resealed 2026-06-25** after **Round 99** (options HQ–HU). Composable prompt category paths are now library-registry checked across all `00-core`–`06-repo` categories with shared `category_prompt_dir` / `sorted_category_prompts`; workflow skill reference guards are preamble-scoped as documented. Holdout expansion remains recurrence-gated maintenance.
+
+## Round 100 — cross-category library registry helper DRY (2026-06-25)
+
+**Options HV–HZ** | Six-lens panel (Opus, Codex, Gemini, Composer, Sakana, GLM)
+
+### Round 100 options
+
+| ID | Proposal | Verdict |
+| --- | --- | --- |
+| HV | DRY `assert_library_wide_unique_basenames` + `assert_registry_matches_library_glob` + `sorted_all_library_prompts` in `prompt_eval_helpers.py` | **Agree** |
+| HW | `test_prompt_library_registry_helpers_library_registry.py` — registry helper parity + module guard | **Agree** |
+| HX | Migrate all `*_library_registry.py` glob/unique guards + `test_prompt_cross_links.py` paths; GLOSSARY step 32 + governance sync | **Agree** |
+| HY | ROUTE holdout expansion | **Defer** |
+| HZ | Router / tenth skill / benchmark CI | **Reject** |
+
+### Round 100 verdict table
+
+| ID | Option | Verdict | Action |
+| --- | --- | --- | --- |
+| HV | Library registry helper DRY | **Agree** | `assert_library_wide_unique_basenames` + `assert_registry_matches_library_glob` |
+| HW | Registry helper library registry | **Agree** | `test_prompt_library_registry_helpers_library_registry.py` |
+| HX | Registry migration + playbook | **Agree** | DRY all `*_library_registry.py`; step 32 |
+| HY | Holdout expansion | **Defer** | maintenance |
+| HZ | Router/tenth skill/benchmark CI | **Reject** | no change |
+
+### Socratic rationale (Round 100)
+
+- **Opus:** Round 99 closed category path helpers; nine cross-category registry files still duplicated library-wide unique-basename and glob-parity loops with local `LIBRARY_ROOT` paths.
+- **Codex:** Shared `assert_registry_matches_library_glob` ensures every registry uses `sorted_category_prompts` semantics; `sorted_all_library_prompts` gives one canonical library-wide tuple.
+- **Gemini:** Deterministic helper extraction; no prompt content churn.
+- **Composer:** Mirrors R91–R99 registry pattern; one helper trio + one registry test file + migration sweep.
+- **Sakana:** Registry glob parity now falsifies if any module reintroduces ad-hoc `Path(__file__).parent` globs.
+- **GLM:** Playbook step 32 gives operators a single checklist line for library registry edits.
+
+**All roles agree.**
+
+## Implemented Changes (Round 100)
+
+- `plans/tests/prompt_eval_helpers.py`: `sorted_all_library_prompts`, `library_skills_dir`, `assert_library_wide_unique_basenames`, `assert_registry_matches_library_glob`
+- `plans/tests/test_*_library_registry.py`: DRY unique/glob guards via shared helpers; remove local `LIBRARY_ROOT`
+- `plans/tests/test_prompt_library_registry_helpers_library_registry.py`: cross-category registry helper registry
+- `plans/tests/test_prompt_cross_links.py`, `test_project_knowledge_promotion_contract.py`: shared `category_prompt_dir` / `library_skills_dir`
+- `GLOSSARY.md`: playbook Rounds 1–100; step 32 for library registry helper registry
+- `QUALITY_GATES_SUMMARY.md`: registry helper note; panel Rounds 1–100; 690+ pytest floor
+- `PROJECT_KNOWLEDGE.md`: Decision Index Round 100 entry
+- `README.md`, `reflective-prompt-library/README.md`, `test_readme_governance.py`: panel round 100 sync
+
+## Verification (Round 100)
+
+- `make all`: 702 pytest + ROUTE-001/002/003 100%
+
+---
+
+**Resealed 2026-06-25** after **Round 100** (options HV–HZ). Cross-category library registries now share `assert_library_wide_unique_basenames` and `assert_registry_matches_library_glob` with a library-wide helper registry guard. Holdout expansion remains recurrence-gated maintenance.

reflective-prompt-library/plans/tests/prompt_eval_helpers.py

@@ -39,6 +39,36 @@ def sorted_category_prompts(category: str) -> tuple[Path, ...]:
     """Return sorted markdown prompt paths for a library category."""
     return tuple(sorted(category_prompt_dir(category).glob("*.md")))
 
+
+def sorted_all_library_prompts() -> tuple[Path, ...]:
+    """Return every composable prompt path across all library categories."""
+    paths: list[Path] = []
+    for category in PROMPT_LIBRARY_CATEGORIES:
+        paths.extend(sorted_category_prompts(category))
+    return tuple(paths)
+
+
+def library_skills_dir() -> Path:
+    """Resolve the workflow skills directory under the prompt library root."""
+    return PROMPT_LIBRARY_ROOT / "skills"
+
+
+def assert_library_wide_unique_basenames(
+    prompt_paths: tuple[Path, ...] | list[Path],
+) -> None:
+    """Composable prompt basenames must be unique across all categories."""
+    basenames = [p.name for p in prompt_paths]
+    assert len(basenames) == len(frozenset(basenames)), (
+        "duplicate prompt basenames across categories"
+    )
+
+
+def assert_registry_matches_library_glob(
+    registry_paths: tuple[Path, ...] | list[Path],
+) -> None:
+    """Registry prompt tuples must match sorted_category_prompts across the library."""
+    assert sorted(sorted_all_library_prompts()) == sorted(registry_paths)
+
 CATEGORY_EVAL_HARNESS_FIXTURE_MARKER = "_from_category_eval_harness_fixture"
 
 

reflective-prompt-library/plans/tests/test_glossary_structure.py

@@ -32,8 +32,8 @@ def test_round_boundary_terms_present(glossary_text: str):
 
 def test_maintenance_playbook_references_round_99(glossary_text: str):
     playbook = glossary_text.split("## Governance Maintenance Playbook", 1)[1]
-    assert "Rounds 1–99" in playbook
-    assert "Rounds 1–98" not in playbook and "Rounds 1-91" not in playbook
+    assert "Rounds 1–100" in playbook
+    assert "Rounds 1–99" not in playbook and "Rounds 1-91" not in playbook
 
 
 
@@ -44,7 +44,7 @@ def test_maintenance_playbook_steps_on_separate_lines(glossary_text: str):
     assert re.search(r"guards\.\d+\.", playbook) is None, (
         "playbook steps merged without newline between numbers"
     )
-    for step in ("17.", "18.", "19.", "20.", "21.", "22.", "23.", "24.", "25.", "26.", "27.", "28.", "29.", "30.", "31."):
+    for step in ("17.", "18.", "19.", "20.", "21.", "22.", "23.", "24.", "25.", "26.", "27.", "28.", "29.", "30.", "31.", "32."):
         assert step in playbook
 
 

reflective-prompt-library/plans/tests/test_human_review_library_registry.py

@@ -10,6 +10,8 @@
 from prompt_eval_helpers import (  # noqa: E402
     PROMPT_LIBRARY_CATEGORIES,
     prompts_with_human_review,
+    assert_library_wide_unique_basenames,
+    assert_registry_matches_library_glob,
 )
 from test_agent_prompts_eval_harness import (  # noqa: E402
     AGENT_HUMAN_REVIEW_EXEMPT,
@@ -47,7 +49,6 @@
     THINKING_PROMPTS,
 )
 
-LIBRARY_ROOT = Path(__file__).parent.parent.parent
 
 HUMAN_REVIEW_CATEGORY_REGISTRY = (
     ("00-core", CORE_PROMPTS, CORE_HUMAN_REVIEW_REQUIRED, CORE_HUMAN_REVIEW_EXEMPT),
@@ -98,23 +99,13 @@ def test_human_review_registry_category_partition(
 
 
 def test_human_review_registry_library_wide_unique_filenames():
-    basenames: list[str] = []
-    for _category, prompts, _required, _exempt in HUMAN_REVIEW_CATEGORY_REGISTRY:
-        basenames.extend(p.name for p in prompts)
-    assert len(basenames) == len(frozenset(basenames)), (
-        "duplicate prompt basenames across categories"
-    )
+    registry_paths = [p for _category, prompts, _required, _exempt in HUMAN_REVIEW_CATEGORY_REGISTRY for p in prompts]
+    assert_library_wide_unique_basenames(registry_paths)
 
 
 def test_human_review_registry_matches_library_glob():
-    globbed: list[Path] = []
-    for category in PROMPT_LIBRARY_CATEGORIES:
-        globbed.extend(sorted((LIBRARY_ROOT / category).glob("*.md")))
-    registry_paths = [
-        p for _category, prompts, _required, _exempt in HUMAN_REVIEW_CATEGORY_REGISTRY
-        for p in prompts
-    ]
-    assert sorted(globbed) == sorted(registry_paths)
+    registry_paths = [p for _category, prompts, _required, _exempt in HUMAN_REVIEW_CATEGORY_REGISTRY for p in prompts]
+    assert_registry_matches_library_glob(registry_paths)
 
 
 def test_human_review_registry_required_union_matches_detection():

reflective-prompt-library/plans/tests/test_project_knowledge_promotion_contract.py

@@ -1,11 +1,17 @@
 """Regression checks for the project-knowledge promotion surface."""
 
+import sys
 from pathlib import Path
 
+sys.path.insert(0, str(Path(__file__).parent))
 
-LIBRARY_ROOT = Path(__file__).parent.parent.parent
-HANDOFF_SKILL = LIBRARY_ROOT / "skills" / "reflective-handoff-retro" / "SKILL.md"
-PROJECT_TEMPLATE = LIBRARY_ROOT / "06-repo" / "PROJECT_KNOWLEDGE.template.md"
+from prompt_eval_helpers import (  # noqa: E402
+    category_prompt_dir,
+    library_skills_dir,
+)
+
+HANDOFF_SKILL = library_skills_dir() / "reflective-handoff-retro" / "SKILL.md"
+PROJECT_TEMPLATE = category_prompt_dir("06-repo") / "PROJECT_KNOWLEDGE.template.md"
 
 
 def test_handoff_skill_exposes_complete_promotion_candidate_contract():