100%

Generator + review-catalog view

Goal

Author the json -> impl-hygiene.md generator (the full review catalog view), mirroring the render.py -> status.md precedent: a READ-ONLY GENERATED banner, deterministic output (no timestamps in the rule view), and STABLE section anchors so the ~45 existing impl-hygiene.md §Finding Categories / §<section> citations across skills and rules keep resolving.

Implementation Sketch

Author generator.py:render_rules_md() emitting the full impl-hygiene.md from the JSON: ## Finding Categories block (every category + subcats in stable order) + every guidance ## section. Banner mirrors render.py # READ-ONLY GENERATED SNAPSHOT. Determinism: two renders byte-identical (no wall-clock). Anchor stability: grep the repo for impl-hygiene.md § citations and assert every cited anchor exists in the generated output. Regenerate impl-hygiene.md from JSON and confirm the regex parser still yields the full token set.

Spec References

scripts/plan_corpus/render.py:1334-1475 (render_status_report banner+write precedent), :1287-1298 (timestamp-skip determinism guard); citation inventory via grep -rn 'impl-hygiene.md §' .claude/.

Work Items

  • Author generator.py:render_rules_md() (full catalog + guidance sections, READ-ONLY banner, deterministic).
  • Anchor-stability test: every repo citation impl-hygiene.md §X resolves to a heading in the generated view.
  • Determinism test: two render_rules_md() calls are byte-identical; regenerated impl-hygiene.md parses to the full token set.

Success Criteria

  • [sc-54b1b2d9] Generated impl-hygiene.md is deterministic and every cited section anchor resolves. (probe: pytest scripts/impl_hygiene_rules_runtime/tests/test_generator.py -q; expect: passed)

Fresh intel (regenerated)

{ “schema_version”: 1, “target”: { “kind”: “plan-section”, “ref”: “impl-hygiene-rules-as-data/s-1103ccdd” }, “generated_at”: “2026-06-21T05:11:23.664325+00:00”, “graph_state”: { “head_sha”: “b0bd51a8”, “last_code_import_at”: “2026-06-21T05:06:49.759Z”, “embedding_stale”: false, “insights_stale”: false, “cpg_stale”: false }, “surfaces”: {}, “summary”: “intel-package[plan-section:impl-hygiene-rules-as-data/s-1103ccdd] agent-authored dossier”, “degraded”: false, “dossier”: { “objective_symbols”: [], “tiers”: {}, “agent_authored”: true, “difficulty”: { “class”: “routine”, “research_online”: false, “research_mode”: “auto”, “signals”: [], “plan_dir”: “/home/eric/projects/ori_lang/plans/impl-hygiene-rules-as-data” } } }

(full dossier: generator-and-review-view—s-1103ccdd.intel.json)