Skip to content

plan-reviewer: module-shape re-check, surface delegation, check-or-create review notes - #41

Merged
jasperboerhof merged 2 commits into
mainfrom
lift/plan-reviewer
Sep 2, 2026
Merged

jasperboerhof merged 2 commits into
mainfrom
lift/plan-reviewer

Conversation

@jasperboerhof

Copy link
Copy Markdown
Contributor

Why

Re-sync agents/plan-reviewer.md with kendo's .claude/agents/plan-reviewer.md as of 2026-07-27 (catalog-resync plan, row agents/plan-reviewer.md).

What

  • Step 2b (new): re-apply the module-shape lens with fresh eyes. For every new in-scope module, run the three shallow-detection tests against the proposed signature and compute an independent verdict. Disagreement with the author is a FAIL row; any Module-Shape FAIL caps the score at 6.
  • Step 2c: the existing architecture-test cross-check, renumbered.
  • Surface delegation: the ## Security & Cost Surface section is graded by surface-reviewer, not here. A missing section is mentioned once in Summary so the parent re-spawns surface-reviewer; it does not affect the convention score.
  • Step 6: check-or-create ## Review Notes, then append a ### Plan Review subsection. Never adds a second heading, never overwrites ### Surface Review (plan-time). Same protocol as surface-reviewer's Step 4, because both run in parallel.
  • Convention Scan table gains the Module Shape row; tool budget 25.
  • Kendo Repo Quick Reference section dropped entirely.
  • First commit normalises the file from CRLF to LF (it was the only CRLF file in the repo) so the lift commit diffs cleanly.

Generalised

  • ~/Code/kendo/CLAUDE.md list in Step 1 → the catalog's existing CLAUDE.md discovery step (unchanged).
  • ~/Code/kendo/backend/tests/Arch/*.php cats in the arch-test step → the catalog's existing generic discovery (unchanged).
  • .claude/skills/plan-feature/references/module-shape-lens.md cited by its consumer-relative path (matches how surface-reviewer cites its references).
  • "Authoritative kendo precedent: the 2026-04 split of GithubAppService" → "the vendor-app service split recorded under Calibration in module-shape-lens.md" (that calibration was generalised in PR plan-feature: lift citation pre-flight, surface gate, hypothesis interview, dual-reviewer Phase 5 #37).
  • "pass deptrac, arch tests, and DTO placement" → "pass layer rules, arch tests, and DTO placement".

Out of scope

  • model: stays opus (catalog) while kendo runs sonnet. Not in the row instructions; flagging for a decision.
  • The pre-existing Step 2c sentence listing "PHPStan, Pest Arch, ESLint custom rules, dependency-cruiser" as example arch-test tools is untouched catalog text.
  • README.md untouched.

Test plan

  • grep -rn -i 'kendo\|KD-[0-9]\|CRIT-\|script\.nl\|warroom\|war room\|phpstan\|knip' agents/plan-reviewer.md — one pre-existing hit: the generic tool list in Step 2c ("PHPStan, Pest Arch, ESLint custom rules, dependency-cruiser")
  • grep -rn 'acceptance-reviewer\|simplicity-reviewer\|silent-failure-hunter\|efficiency-hunter\|task-alignment-reviewer' agents/plan-reviewer.md — empty
  • git diff origin/main..HEAD~1 --ignore-all-space --stat is empty for the normalisation commit; content diff is 45+/7-

🤖 Generated with Claude Code

https://claude.ai/code/session_01UX7YHkAamvBe8Hh66f95b7

jasperboerhof and others added 2 commits September 2, 2026 19:44
The catalog copy was the only file in the repo with CRLF terminators.
Content unchanged; separated out so the lift commit diffs cleanly.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UX7YHkAamvBe8Hh66f95b7
…eate review notes

Lifted from kendo .claude/agents/plan-reviewer.md (2026-07-27):
- Step 2b re-applies the module-shape lens independently of the author's
  verdict; any Module-Shape FAIL caps the score at 6
- Surface analysis delegated to surface-reviewer (runs in parallel at
  plan-feature Phase 5); a missing section is reported, not scored
- Step 6 appends "### Plan Review" under a check-or-create "## Review Notes"
  heading, never overwriting surface-reviewer's sibling subsection
- Convention Scan table gains the Module Shape row; tool budget 25
- Kendo Repo Quick Reference section not carried over

Generalised: ~/Code/kendo paths became the catalog's existing CLAUDE.md
discovery and arch-test discovery steps; the GithubAppService precedent
cite became "the vendor-app service split recorded under Calibration in
module-shape-lens.md"; "pass deptrac" became "pass layer rules".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UX7YHkAamvBe8Hh66f95b7
@jasperboerhof jasperboerhof added the Agent Review Requested Ask an agent to review this PR label Sep 2, 2026
@jasperboerhof
jasperboerhof merged commit 44a1622 into main Sep 2, 2026
1 check passed
@jasperboerhof
jasperboerhof deleted the lift/plan-reviewer branch September 7, 2026 11:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Agent Review Requested Ask an agent to review this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant