100%

Doc Sync + Review Gates

Goal

Sync the doc surfaces (new intel_repo/CLAUDE.md calibration markers; intelligence.md / impl-hygiene.md cross-refs) and run the close-out review gates. Scope-aware: the deliverables are skill + script tooling, so generic third-party code review is tooling-scope-exempt (CLAUDE.md §Hygiene/Coding Rules Scope); validation comes from the dogfood hygiene run (exercise the new tier on itself) + plan review + plan_corpus check — all clean before close.

HISTORY

  • 2026-06-16 — Tooling-scope exemption on the generic code-review gate (w-00945a8b): the seam-detection deliverables are .claude/skills/impl-hygiene-review/ + scripts/impl_hygiene_review_runtime/ (skill/script tooling). CLAUDE.md §Hygiene/Coding Rules Scope marks tooling exempt from third-party code review and bans it as over-application on a skill/script change. The new-tier validation is delivered by the dogfood hygiene run (w-a21cd65d) + plan review + plan_corpus check (w-8edc1f84) instead. User-authorized exemption (selected the Recommended disposition when the plan-vs-CLAUDE.md scope conflict surfaced).

Implementation Sketch

Doc sync keeps the threshold markers + Graph-First query map discoverable; the review gates are the named-skill close-out checkboxes /continue-roadmap foreground-dispatches.

Spec References

.claude/rules/intelligence.md; .claude/rules/impl-hygiene.md; intel_repo/CLAUDE.md.

Work Items

  • Sync intel_repo/CLAUDE.md (calibration markers) + .claude/rules/{intelligence,impl-hygiene}.md cross-refs via /sync-claude
  • Third-party code-review gate — TOOLING-SCOPE EXEMPT (per CLAUDE.md §Hygiene/Coding Rules Scope): the seam-detection deliverables are skill + script tooling (.claude/skills/impl-hygiene-review/, scripts/impl_hygiene_review_runtime/), for which generic third-party code review is banned over-application. New-tier validation is delivered instead by the dogfood hygiene run (w-a21cd65d, exercises the new graph tier end-to-end) + plan review + plan_corpus check (w-8edc1f84).
  • Run /impl-hygiene-review (dogfood the new graph tier) and resolve findings
  • Run /review-plan on this plan and python -m scripts.plan_corpus check clean