Files
claude-config/docs/comprehension-history.md
T

352 KiB

Comprehension history

2026-10-04T18:28:07Z, PR #215 merged at 5baedb5

Seat Navigation Locality Shape Self-sufficiency Overall
Mean 7.38 6.63 7.00 6.88 6.88

2026-10-08T12:50:49Z, PR #224 at a58a0a8

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 7 6.5 7
Mid A 7.5 7 7 7 7
Maintainability senior 7.5 6.5 7 6.5 7
Inherited architect 7.5 7 7 7 7
Mean 7.38 6.75 7.00 6.75 7.00

Junior A, hardest first:

  • skills/larv-review/SKILL.md:77 "Architecture": Ratchet, the history move, Fresh, Suspended
  • skills/larv-review/SKILL.md:51 "Round cap", with "Re-entry"
  • bin/loop_claude/cycle/judge_reply.py:90 verdict_from, cycle/judge.py:31 run_judge, cycle/states.py:69 transition
  • bin/loop_claude/cycle/states.py:9 the quoted_answers counter
  • bin/loop_claude/cycle/archive.py:14 archive
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/loop/reload.py:50 exec_if_edited
  • CLAUDE.md:22 (Todo items), with bin/rank_todo.py:235 check_citations

Mid A, hardest first:

  • skills/larv-review/SKILL.md:86 "Architecture"
  • bin/loop_claude/cycle/states.py:69 transition, with cycle/run.py:55 step
  • bin/loop_claude/cycle/worker.py:41 worker_args
  • bin/loop_claude/cycle/judge.py:31 run_judge
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/cycle/archive.py:14 archive
  • bin/rank_todo.py:161 rank, :408 rank_details
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:77 "Architecture"
  • skills/larv-review/SKILL.md:56 "Round cap" → "Count"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES
  • bin/loop_claude/cycle/states.py:69 transition, with cycle/run.py:104 question_for
  • bin/loop_claude/cycle/archive.py:14 archive
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/loop/reload.py:50 exec_if_edited
  • bin/rank_todo.py:161 rank, :408 rank_details

Inherited architect, would restructure first:

  • skills/larv-review/SKILL.md:51 "Round cap" and :77 "Architecture"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES
  • bin/ flat folder: tools, shared modules and repo checks
  • bin/loop_claude/project/checkout.py:32 read_utf8
  • bin/loop_claude/loop/main.py:127 remaining, cycle/run.py:96 ruling

2026-10-08T13:03:40Z, PR #224 at 9ea4f0a

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 7 6 6.5
Mid A 7 6.5 7 6.5 7
Maintainability senior 7 6.5 7 6.5 6.5
Inherited architect 7 6.5 7 7 7
Mean 7.00 6.50 7.00 6.50 6.75

Junior A, hardest first:

  • skills/larv-review/SKILL.md:77 "Architecture", with :51 "Round cap"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, :90 verdict_from
  • bin/loop_claude/cycle/archive.py:14 archive
  • bin/loop_claude/loop/reload.py:50 exec_if_edited
  • bin/rank_todo.py:187 read_scoring, :408 rank_details
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/cycle/run.py:69 work
  • bin/loop-claude:7 the sys.path insert

Mid A, hardest first:

  • skills/larv-review/SKILL.md:86 "Architecture"
  • skills/larv-review/SKILL.md:51 "Round cap" → "Count"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES
  • bin/loop_claude/cycle/archive.py:14 archive
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/rank_todo.py:408 rank_details
  • bin/loop_claude/cycle/states.py:69 transition
  • bin/loop_claude/loop/reload.py:50 exec_if_edited

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:51 "Round cap", with :77 "Architecture"
  • bin/loop_claude/cycle/states.py:69 transition
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, cycle/judge.py:31 run_judge
  • bin/loop_claude/cycle/archive.py:14 archive
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/rank_todo.py:408 rank_details
  • bin/loop_claude/loop/reload.py:50 exec_if_edited
  • bin/loop_claude/loop/main.py:1 the --help docstring

Inherited architect, would restructure first:

  • bin/loop_claude/cycle/judge.py:53 judge_prompt and judge_reply.py:12 JUDGE_RULES: one home for the judge's prompt
  • bin/ flat folder: shared modules and tests
  • skills/larv-review/SKILL.md:27 §3: bold labels to addressable headings
  • bin/loop_claude/loop/main.py:5 --help and cycle/retry.py:40: numbers restating constants
  • bin/loop_claude/project/checkout.py:32 read_utf8
  • agents/stability-reviewer.md:3, agents/systems-architect.md:3: house style
  • workflow-bench/bench.py:26: not runnable from the repo

2026-10-08T14:28:39Z, PR #225 at 13d8b16

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 7 6 6.5
Mid A 7 6.5 7 6 6.5
Maintainability senior 7.5 7 7.5 7 7
Inherited architect 7 6.5 6.5 7 7
Mean 7.13 6.50 7.00 6.50 6.75

Junior A, hardest first:

  • skills/larv-review/SKILL.md:79 "Architecture": Floor, Ratchet, Fresh, Suspended, and the history paragraph at :95
  • skills/larv-review/SKILL.md:53 "Round cap", with :64 "Re-entry"
  • bin/loop_claude/cycle/judge.py:31 run_judge, with grounded, verbatim and plain
  • bin/loop_claude/cycle/states.py:69 transition, with cycle/run.py:55 step and :104 question_for
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/cycle/archive.py:28 archive, with copy_for and finished_chunks
  • bin/reading_cost.py:145 measure, with bin/shell_reads.py:52 segments and :67 operands
  • bin/rank_todo.py:408 rank_details

Mid A, hardest first:

  • skills/larv-review/SKILL.md:53 "Round cap", with "History", "Ratchet", "Fresh" and "Suspended"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, with QUOTE_SOURCES, ANSWER_DESTINATIONS and ANSWERS_RECORDED
  • bin/loop_claude/cycle/states.py:69 transition
  • bin/loop_claude/cycle/archive.py:28 archive, with finished_chunks and FINISHED_AT
  • bin/reading_cost.py:145 measure, with located, relative and commit_time
  • bin/shell_reads.py:67 operands
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/rank_todo.py:408 rank_details

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:79 "Architecture"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, with cycle/worker.py:41 worker_args
  • bin/loop_claude/cycle/judge.py:31 run_judge
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/cycle/archive.py:17 FINISHED_AT, with finished_chunks and cycle/run.py:110 close
  • bin/reading_cost.py:145 measure, with located
  • bin/shell_reads.py:67 operands
  • bin/rank_todo.py:408 rank_details, with read_scoring

Inherited architect, would restructure first:

  • skills/larv-review/SKILL.md:53 "Round cap", and :88 "Architecture" from History to Suspended
  • bin/loop_claude/cycle/archive.py:109 finished_chunks, with bin/reading_cost.py:106 located and bin/loop_claude/project/checkout.py:7 checkout_root
  • bin/ flat folder: tools, shared modules and tests
  • bin/loop_claude/project/checkout.py:32 read_utf8, claude_code/transcript.py:27 render, judge_reply.py:87 Verdict beside states.py:24 ruling
  • bin/loop_claude/loop/main.py:9 the recorded-answers rule, beside judge_reply.py:11 ANSWERS_RECORDED

2026-10-08T15:54:46Z, PR #225 at 1fc91a5

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6.5 6 6.5
Mid A 7 6.5 7 6.5 7
Maintainability senior 7.5 6.5 7 6.5 7
Inherited architect 7 6 6.5 7 6.5
Mean 7.13 6.25 6.75 6.50 6.75

Junior A, hardest first:

  • skills/larv-review/SKILL.md:53 "Round cap", through "Re-entry", "Fresh" and "Suspended"
  • bin/loop_claude/cycle/states.py:69 transition, with cycle/run.py:55 step
  • bin/reading_cost.py:180 measure
  • bin/reading_cost.py:242 readings_of, with :171 unheld and :236 figure
  • bin/loop_claude/cycle/judge.py:31 run_judge
  • bin/loop_claude/transcript_archive.py:29 archive, with copy_for and finished_chunks
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES
  • bin/rank_todo.py:408 rank_details

Mid A, hardest first:

  • skills/larv-review/SKILL.md:53 "Round cap", with "Architecture" from Floor to Suspended
  • bin/loop_claude/cycle/judge.py:31 run_judge
  • bin/loop_claude/cycle/states.py:69 transition
  • bin/reading_cost.py:180 measure, and :242 readings_of
  • bin/loop_claude/transcript_archive.py:29 archive, :95 copy_for and :110 finished_chunks
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/loop_claude/loop/reload.py:50 exec_if_edited
  • bin/rank_todo.py:408 rank_details

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:79 "Architecture"
  • skills/larv-review/SKILL.md:95 the move of an old entry's scores into the history
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES
  • bin/loop_claude/cycle/judge.py:31 run_judge
  • bin/reading_cost.py:180 measure, and :242 readings_of
  • bin/loop_claude/transcript_archive.py:18 FINISHED_AT, with finished_chunks and cycle/run.py:110 close
  • bin/reading_cost.py:141 located, beside bin/loop_claude/project/checkout.py:7 checkout_root
  • bin/shell_reads.py:52 segments, and :67 operands

Inherited architect, would restructure first:

  • bin/ by kind: tools, shared modules and tests
  • bin/loop_claude/transcript_archive.py:110 finished_chunks, read by bin/reading_cost.py through four loop_claude modules
  • docs/comprehension-history.md, written by bin/reading_cost.py:242 and by skills/larv-review/SKILL.md:92's prose
  • skills/larv-review/SKILL.md:53 "Round cap"
  • bin/loop_claude/cycle/judge_reply.py:87 Verdict beside states.py ruling, and project/checkout.py:32 read_utf8

2026-10-08T17:29:52Z, PR #225 at 8c9bf09

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 7 6.5 6.5
Mid A 7 7 7 6.5 7
Maintainability senior 7.5 6.5 7 7 7
Inherited architect 7.5 7 7 7.5 7
Mean 7.25 6.75 7.00 6.88 6.88

Junior A, hardest first:

  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, with Reply and verdict_from
  • bin/loop_claude/cycle/judge.py:31 run_judge, with grounded, verbatim and plain
  • bin/loop_claude/cycle/states.py:69 transition
  • bin/loop_claude/transcript_archive.py:30 archive, copy_for and finished_chunks
  • bin/reading_cost/measure.py:27 measure, with bin/reading_cost/main.py:113 located
  • skills/larv-review/SKILL.md:95 the old entry's scores, and :108 "Fresh"
  • bin/reading_cost/shell_reads.py:21 shell_reads, with operands, segments and shell_lines
  • bin/loop_claude/claude_code/entries.py:28 written_by_human

Mid A, hardest first:

  • skills/larv-review/SKILL.md:53 "Round cap", through "Architecture", "Fresh" and "Suspended"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, and :90 verdict_from
  • bin/loop_claude/cycle/states.py:69 transition, with cycle/run.py:35 run_cycle and :104 question_for
  • bin/loop_claude/transcript_archive.py:30 archive, copy_for and finished_chunks
  • bin/loop_claude/claude_code/entries.py:28 written_by_human
  • bin/reading_cost/figures.py:34 readings_of
  • bin/reading_cost/shell_reads.py:52 segments, and :67 operands
  • bin/reading_cost/main.py:113 located, beside bin/loop_claude/project/checkout.py:7 checkout_root

Maintainability senior, hardest first:

  • bin/loop_claude/transcript_archive.py:30 archive, and :111 finished_chunks
  • bin/reading_cost/figures.py:34 readings_of
  • bin/reading_cost/shell_reads.py:52 segments, and :67 operands
  • bin/loop_claude/cycle/judge.py:31 run_judge
  • bin/reading_cost/main.py:113 located, and measure.py:21 Checkout
  • skills/larv-review/SKILL.md:53 "Round cap", and :108 "Fresh" and "Suspended"
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES
  • bin/rank_todo.py:408 rank_details

Inherited architect, would restructure first:

  • bin/loop_claude/claude_code/ and the read side of bin/loop_claude/transcript_archive.py, into a package both tools import
  • skills/larv-review/SKILL.md:58 "Count", with a checker
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES, beside judge.py:53 judge_prompt
  • bin/loop_claude/project/checkout.py:7 checkout_root and bin/reading_cost/main.py:113 located, and checkout.py:32 read_utf8
  • bin/failure.py, bin/file_writes.py and bin/markdown_sections.py, into one package

2026-10-08T18:37:21Z, PR #228 at 2682668, against 8c9bf09

Ruling: worse

Seat Vote
Mid A worse
Inherited architect worse

Mid A, decided by:

  • skills/larv-review/SKILL.md:91 "Paired ruling": the base, its fallbacks, a two-stage vote and a tie rule in one paragraph
  • skills/comprehension-panel/scoring-run.md:1 and :67 "Paired ruling": one file name over two kinds of prompt
  • skills/comprehension-panel/SKILL.md:102 "The paired ruling": the procedure spread over three files
  • skills/larv-review/SKILL.md:89 "Architecture": the comprehension check, paired ruling, scoring run, ratchet and floor to hold at once
  • skills/larv-review/SKILL.md:105 "History": two record shapes in one bullet
  • skills/larv-review/SKILL.md:66 "Re-entry", better: "Rerun" names its mechanism

Inherited architect, decided by:

  • skills/larv-review/SKILL.md:89 "Architecture": two mechanisms, each with its own trigger and seats, and a three-way rule for the base
  • skills/larv-review/SKILL.md:105 "History": two entry shapes, and which commit of a paired entry is the next base
  • CHANGELOG.md:5 against :11, :16, :19: two accounts of what blocks a merge
  • CLAUDE.md:37 and :40 "Quality": "comprehension check" undefined, and one sentence packing the floor and the ruling
  • skills/comprehension-panel/scoring-run.md:1 "Paired ruling": the name no longer says what is inside
  • AGENTS.md:15: the new decision title packs both mechanisms and the vote rule
  • skills/larv-review/SKILL.md:35 and :64 "Re-entry", better: a rerun traces from the table alone

2026-10-08T18:46:12Z, PR #228 at fbe753e, against c7333c0

Ruling: same

Seat Vote
Mid A worse
Inherited architect better
Maintainability senior same
Junior A worse

Mid A, decided by:

  • skills/larv-review/SKILL.md:89 "Architecture": two kinds of run under one umbrella, each with its own trigger, and a vote rule to work through by example
  • skills/larv-review/SKILL.md:93 "Base": the comparison point found by how earlier chunks appended to the history
  • skills/larv-review/SKILL.md:35 the Architecture row: a forward reference to the scoring run's trigger
  • CLAUDE.md:37 and :40 "Quality": one concept under several names, and "the last measured commit" undefined
  • skills/comprehension-panel/SKILL.md:102 "The paired ruling": who votes is left to the caller
  • skills/comprehension-panel/seat-prompts.md:1, better: the name tells the truth, and {forbidden} serves both briefs
  • skills/larv-review/SKILL.md:64 "Re-entry", better: the rerun rule is explicit

Inherited architect, decided by:

  • skills/larv-review/SKILL.md:64 "Re-entry", better: why a pass ran a fourth time is answered in one paragraph
  • skills/larv-review/SKILL.md:33 the pass table, better: each pass's rule for fixes sits in its own Trigger cell
  • skills/larv-review/SKILL.md:37 and :123 "Security", better: when each security pass runs
  • skills/larv-review/SKILL.md:93 "Base": base selection depends at a distance on the wording of a line in the history format
  • skills/larv-review/SKILL.md:35 the Architecture row: a pointer 60 lines down
  • skills/larv-review/SKILL.md:95 "Ruling": the vote margin worked out by hand
  • CLAUDE.md:37 and AGENTS.md:16: one concept, three names

Maintainability senior, decided by:

  • skills/larv-review/SKILL.md:89 "Paired ruling": the base defined by an action, and the vote arithmetic
  • skills/larv-review/SKILL.md:35 and :97: a forward reference, though one definition
  • skills/larv-review/SKILL.md:64 "Re-entry", better: deterministic reruns
  • skills/larv-review/SKILL.md:59 "Later rounds", better: every rerun reviews only its diff
  • skills/comprehension-panel/seat-prompts.md:3, better: the briefs cannot drift apart
  • AGENTS.md:35 "Scoring run": the heading no longer matches its use
  • CLAUDE.md:40: "last measured commit" defined only in larv-review

Junior A, decided by:

  • skills/larv-review/SKILL.md:91 "Paired ruling": the base, the escalation and the vote rule in three rereads
  • skills/larv-review/SKILL.md:35 the Architecture row: a forward reference to a two-condition rule
  • skills/larv-review/SKILL.md:35, :51, :89, CLAUDE.md:37: four names for the comprehension machinery
  • skills/larv-review/SKILL.md:36 the Full scan and Security rows: read together now
  • skills/comprehension-panel/seat-prompts.md:8: placeholders nesting placeholders

2026-10-08T18:57:27Z, PR #228 at 50249b1, against 12d6d75

Ruling: worse

Seat Vote
Mid A worse
Inherited architect worse

Mid A, decided by:

  • skills/larv-review/SKILL.md:93 "Base": a git log command, a two-way condition, a forward reference to the history's format and two fallbacks
  • skills/larv-review/SKILL.md:89 "Architecture": two kinds of run, four sub-bullets and a vote rule; the section's fan-out roughly doubled
  • skills/larv-review/SKILL.md:35, :98 and :120: one trigger written out three times
  • CLAUDE.md:40 "Quality": "the last commit the panel scored or ruled better" reads two ways
  • AGENTS.md:35 "Scoring run": the heading no longer names what it feeds
  • CHANGELOG.md:5: ten sentences in one entry
  • skills/larv-review/SKILL.md:66 "Re-entry", :37 and :124 "Security", skills/comprehension-panel/seat-prompts.md:7, better

Inherited architect, decided by:

  • skills/larv-review/SKILL.md:93 "Base": finding the base at 3am takes git archaeology across merge commits
  • CHANGELOG.md:5 against skills/larv-review/SKILL.md:93 and :107: only the changelog says a ruling of same leaves the base, so a chunk may be told to fix places it never touched
  • skills/larv-review/SKILL.md:95 "Seats" and :96 "Ruling": the vote table built in the head
  • CLAUDE.md:40 "Quality": a folded noun phrase in the charter
  • skills/larv-review/SKILL.md:35, :98 and :120: the trigger three times, and seven concepts where there were three
  • AGENTS.md:35 "Scoring run": the heading not renamed with the file
  • skills/larv-review/SKILL.md:64 "Re-entry" and :40 the Prose row, :37 and :124 "Security", better

2026-10-08T19:48:05Z, PR #229 at 8a2dbd7, against 12d6d75

Ruling: worse

Seat Vote
Mid A worse
Inherited architect worse

Mid A, decided by:

  • skills/larv-review/SKILL.md:93 "Paired ruling" → "Base": the base found by a prose git log search with two fallbacks
  • skills/larv-review/SKILL.md:95 "Seats" and "Ruling": vote arithmetic written as prose, with no example
  • skills/larv-review/SKILL.md:89 "Architecture": two kinds of run, each with its own trigger, seats and block
  • CLAUDE.md:40 "Quality": a clause folded into a noun phrase
  • bin/metric_bench/places.py:7 RUN, SEAT_PLACES, PLACE and :30 scoring_runs: a second reader of a format defined only in prose, linked from neither side

Inherited architect, decided by:

  • skills/larv-review/SKILL.md:93 "Paired ruling" → "Base": "worse than what?" means running the base search in your head
  • skills/larv-review/SKILL.md:95 "Seats" and "Ruling": a two-stage panel and vote arithmetic with nothing to run or test it
  • skills/larv-review/SKILL.md:35, :98 "Scoring run" and :120 "Suspended": the scoring run's trigger written out in four places
  • skills/larv-review/SKILL.md:36 the Full scan and Security rows: each row's trigger depends on the other
  • bin/metric_bench/places.py:7 RUN, SEAT_PLACES, PLACE: a regex reader of the history linked from neither side
  • bin/metric_bench/places.py:59 resolved: a result that depends on the place resolved before it
  • bin/metric_bench/python_units.py:69 Cognitive: nesting bookkeeping spread over its methods

2026-10-08T21:14:15Z, PR #229 at 5cc37dd, against 12d6d75

Ruling: worse

Seat Vote
Mid A worse
Inherited architect worse

Mid A, decided by:

  • skills/larv-review/SKILL.md:93 "Paired ruling" → "Base": a rule over git history, a git log command and two fallbacks to hold at once
  • CLAUDE.md:40 "Quality": a garden-path sentence read three times
  • skills/larv-review/SKILL.md:89 "Architecture": two kinds of run, each with its own trigger, meeting "Fresh", "Suspended" and "Round cap"
  • bin/metric_bench/places.py:60 resolved: order-dependent, readable only with the history format in mind
  • bin/metric_bench/main.py:43 main, better: the shape of bin/reading_cost/main.py, one for one
  • skills/larv-review/SKILL.md:111 "History", better: the format and its reader name each other

Inherited architect, decided by:

  • skills/larv-review/SKILL.md:93 "Paired ruling" → "Base": the ratchet's outcome rests on state spread across many past commits
  • skills/larv-review/SKILL.md:89 "Architecture": one mechanism became two, with different triggers and blocks
  • CLAUDE.md:40 "Quality": a clause folded into a noun phrase
  • bin/metric_bench/places.py:7 RUN, SEAT_PLACES, PLACE and :60 resolved: a regex reader of a prose format, and a historical quirk to know first
  • AGENTS.md:35 "Scoring run": the section's name no longer covers its use by paired rulings
  • skills/larv-review/SKILL.md:64 "Re-entry", better: which passes a fix reruns is explicit

2026-10-08T23:12:17Z, PR #231 at 53ed515, against 12d6d75

Ruling: better

Seat Vote
Mid A better
Inherited architect better

Mid A, decided by:

  • bin/larv_review/rules.py:64 round_counts, with :10 CAP and bin/larv_review/main.py:118 round_count, better: a fourth round leads cold to one named function, where the base had only skills/larv-review/SKILL.md:58 "Count" to carry out by hand
  • bin/larv_review/main.py:1 the module docstring, better: the base, round count, trigger, vote rule and seats file are written beside the code that carries them out
  • bin/larv_review/rules.py:41 ruling and :27 votes, better: the vote rule is a short pure function, changeable without the skill text in mind
  • bin/larv_review/git.py:4 the import of HistoryChange from rules, with :50 history_changes: the git layer takes its result type from the rules module, so the direction among the three modules is not obvious
  • bin/larv_review/history.py:85 resolved and :56 scoring_runs: they serve only metric-bench, so old-history path logic sits in the review tool's module
  • bin/metric_bench/main.py:143 git against bin/larv_review/git.py:9 git: two private git runners with different error handling
  • bin/larv_review/rules.py:106 scoring_run_due: the densest new unit, two plans, shipped IDs and a flag held at once
  • skills/larv-review/SKILL.md:93 "Paired ruling" and :100 "Scoring run": more vocabulary, though each mechanical step now names a subcommand

Inherited architect, decided by:

  • bin/larv_review/rules.py:64 round_counts, with bin/larv_review/main.py:118 round_count, better: the 3am question leads to round-count and one pure function, where the base's skills/larv-review/SKILL.md:58 "Count" was prose to carry out against git log
  • bin/larv_review/rules.py:106 scoring_run_due, better: the trigger is a checkable function that prints its reason, though dense in its and/or binding and set arithmetic
  • bin/larv_review/main.py:1 the module docstring, better: the history format and ratchet have one tested home; skills/larv-review/SKILL.md:42 now points at --help for the rules
  • bin/larv_review/history.py:85 resolved, :56 scoring_runs and :61 seat_places: a parser only metric-bench uses, under the review tool's name; where it rots first
  • bin/larv_review/git.py:4 the import of HistoryChange from rules, and bin/metric_bench/main.py:143 git: a reversed dependency and two git runners
  • bin/larv_review/seats.py:7 SCORING_SEATS and SEAT_LINE, with bin/larv_review/rules.py:11 FIRST_SEATS: seat names spelled in four places
  • bin/larv_review/main.py:164 record and bin/larv_review/history.py:52 entries: positional regex groups that need HEADING open beside them

2026-10-08T23:40:09Z, PR #231 at efed78b, against 12d6d75

Ruling: worse

Seat Vote
Mid A worse
Inherited architect worse

Mid A, decided by:

  • bin/larv_review/rules.py:105 scoring_run_due: set arithmetic over two plans, an earliest release and a landed flag built in git.py, with or and and unparenthesised, where the base's trigger was one clause at skills/larv-review/SKILL.md:35
  • bin/larv_review/rules.py:66 measured_commit and :82 base: the base comes from diffing the history around each merged change, held with history.py entries and git.py history_changes at once
  • bin/larv_review/rules.py:16 votes and :34 ruling, with bin/larv_review/seats.py:16 FIRST_SEATS: fixed seat order, a split, a lead of two and a placeless vote stacked, where skills/larv-review/SKILL.md:93 only points at --help
  • bin/larv_review/main.py:220 read_seats: named.group(3, 4) depends on HEADING's group positions in bin/larv_review/history.py:13
  • bin/larv_review/history.py:95 resolved and :66 scoring_runs: used only by bin/metric_bench/main.py:40, so metric-bench reaches into another tool's package
  • bin/larv_review/rules.py:57 round_counts, better: the round count is a small named function where the base had prose at skills/larv-review/SKILL.md:58
  • bin/larv_review/history.py:129 ruling_entry, better: the history's format has one owner in code

Inherited architect, decided by:

  • bin/larv_review/rules.py:105 scoring_run_due: set arithmetic whose inputs are built in three other files, where the base's trigger was one table cell at skills/larv-review/SKILL.md:35
  • bin/larv_review/rules.py:66 measured_commit and :82 base: against is None doubles as the type tag of bin/larv_review/history.py:30 Entry; the hardest unit at 3am
  • bin/larv_review/main.py:220 read_seats, with bin/larv_review/history.py:111 heading: a raw re.Match whose groups another file reads by position
  • bin/larv_review/seats.py:10 MEAN, with bin/larv_review/history.py:111 heading: a fake seat standing for a legacy import, threaded through every scoring path
  • bin/larv_review/history.py:95 resolved and :66 scoring_runs: metric-bench's legacy path rules inside larv-review's package, and two git helpers at bin/metric_bench/main.py:143 and bin/larv_review/git.py:10
  • bin/larv_review/main.py:1 the module docstring, with bin/larv_review/rules.py:83 base: the base rule stated in several places in different words
  • bin/larv_review/rules.py:57 round_counts, better: the fourth-round symptom leads to a tested function

2026-10-08T23:48:44Z, PR #231 at c1133ed, against 12d6d75

Ruling: same

Seat Vote
Mid A better
Inherited architect worse
Maintainability senior better
Junior A worse

Mid A, decided by:

  • bin/larv_review/rules.py:57 round_counts, with bin/larv_review/main.py:141 round_count, better: the fourth-round symptom leads to a short function, where the base had only skills/larv-review/SKILL.md:58 "Count"
  • bin/larv_review/main.py:1 the module docstring, better: each rule stated once beside the code that enforces it, where the base had skills/larv-review/SKILL.md:92 "History"
  • bin/larv_review/history.py:12 HEADING, :58 entries and :128 entry_text, better: the history is read and written in one module
  • bin/larv_review/main.py:195 record_scoring, with bin/larv_review/seats.py:37 report and bin/larv_review/history.py:93 heading: the moved Mean path threads through three files
  • bin/larv_review/rules.py:105 scoring_run_due, :119 emptied and :66 measured_commit: dense rules that lean on long docstrings
  • bin/metric_bench/main.py:38 and bin/larv_review/git.py:5: imports across packages

Inherited architect, decided by:

  • bin/metric_bench/main.py:38 and bin/metric_bench/bench.py:7, with bin/larv_review/history.py:22 Place and :69 seat_places: metric-bench reads its input through larv-review's history module
  • bin/larv_review/rules.py:66 measured_commit, :82 base and bin/larv_review/main.py:124 ruling_base: three fallbacks to hold at once, where the base's ratchet was one sentence at skills/larv-review/SKILL.md:100
  • bin/larv_review/rules.py:105 scoring_run_due and :119 emptied, with bin/larv_review/git.py:88 landed_since_release: the trigger spread over three files and the help
  • bin/larv_review/rules.py:7 the imports, with bin/rank_todo.py:386 parse_row: rank_todo is now a library for larv-review too
  • bin/larv_review/seats.py:30 Report and :37 report, and bin/metric_bench/python_units.py:20 measured: names that cost a re-read
  • bin/larv_review/rules.py:57 round_counts, better: the 3am question answerable in code

Maintainability senior, decided by:

  • bin/larv_review/rules.py:57 round_counts, with bin/larv_review/main.py:141 round_count, better: the 3am symptom lands on a tested unit, where the base had skills/larv-review/SKILL.md:58 "Count"
  • bin/larv_review/main.py:1 the module docstring, better: the base search, round count, trigger and seats file stated once, where the base had skills/larv-review/SKILL.md:92 "History" and :100 "Ratchet"
  • bin/larv_review/rules.py:66 measured_commit, with bin/larv_review/git.py:66 history_changes: the costliest new unit to hold
  • bin/larv_review/rules.py:105 scoring_run_due and :119 emptied: exact and checkable, but read twice
  • bin/larv_review/rules.py:1 the module: six concerns, and votes depends on PLACE from bin/larv_review/history.py:14
  • bin/larv_review/main.py:195 record_scoring: two inputs threaded through sentinels

Junior A, decided by:

  • bin/larv_review/main.py:195 record_scoring, with bin/larv_review/seats.py:44 report and bin/larv_review/history.py:93 heading: two modes woven through one function and three files
  • bin/larv_review/rules.py:105 scoring_run_due, with :119 emptied: needs the release rules from CLAUDE.md and bin/larv_review/git.py:88 landed_since_release
  • bin/larv_review/rules.py:66 measured_commit: or and and mixed without parentheses, and a new concept to learn first
  • bin/larv_review/git.py:5 and bin/metric_bench/main.py:38: the git layer depends on the history type, and metric-bench on larv-review's package
  • bin/larv_review/main.py:1 the module docstring: one home, but a wall of rules leaning on terms defined elsewhere
  • bin/larv_review/rules.py:16 votes: a seat protocol reconstructed only from skills/larv-review/SKILL.md:97

2026-10-09T08:54:36Z, PR #232 at 2c6e063, against 12d6d75

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same same better better
Inherited architect better worse same better better

Mid A, decided by:

  • bin/larv_review/main.py:146 round_count: Navigation, better: the fourth-round symptom leads to a named unit, where the base had only skills/larv-review/SKILL.md:58 "Count"
  • bin/larv_review/rules.py:42 ruling, :52 fallen and :128 scoring_run_due: Self-sufficiency, better: vote arithmetic and the scoring trigger are pure functions with docstrings, where the base had prose alone
  • README.md:68 "Tools": Navigation, better: the README names larv-review and metric-bench
  • bin/larv_review/main.py:1 the module docstring: Self-sufficiency, better, with a cost: Split, Fell, Ratchet and the moved Mean line arrive in long sentences
  • bin/larv_review/history.py:96 heading: Locality, against: two flags with DATED and HEADING, traced through bin/larv_review/seats.py:38 report and bin/larv_review/main.py:207 record_scoring
  • bin/larv_review/history.py:18 SEAT_PLACES, :114 ruling_entry and :125 scoring_entry: Locality, against: writers and parser must agree on label strings
  • bin/larv_review/rules.py:1 the module: Shape, against: one vague name over five concerns
  • bin/metric_bench/bench.py:87 resolved and bin/metric_bench/main.py:38: Shape and Locality, against: metric-bench depends on larv-review's history parser

Inherited architect, decided by:

  • bin/larv_review/main.py:146 round_count: Navigation: the 3am question lands on a function, where the base had skills/larv-review/SKILL.md:58 "Count"
  • bin/larv_review/rules.py:89 measured_commit and :105 base: Self-sufficiency: the ratchet's base is executable, where the base had skills/larv-review/SKILL.md:100
  • bin/larv_review/history.py:60 entries, :114 ruling_entry and :125 scoring_entry: Self-sufficiency and Navigation: the history's format is a regex plus writers, where the base had skills/larv-review/SKILL.md:92
  • bin/larv_review/main.py:207 record_scoring, with bin/larv_review/seats.py:45 report and bin/larv_review/history.py:96 heading: Locality: the moved Mean case threads through three modules
  • bin/larv_review/rules.py:57 pending_fall, called from bin/larv_review/main.py:179 and :224: Locality: commands depend on state an earlier command appended to the history; history[1] hides it at the call site
  • bin/metric_bench/main.py:38 and bin/metric_bench/bench.py:7: Locality: metric-bench parses the history with larv-review's entries, and keeps its own git() at bin/metric_bench/main.py:143
  • bin/larv_review/rules.py:1 the module: Shape: a grab-bag name
  • bin/larv_review/git.py:56 file_at and bin/larv_review/main.py:247 history_text: Locality: two histories, the default branch's and the checkout's
  • skills/larv-review/SKILL.md:97 "Seats": Self-sufficiency, against the skill: it needs the tool's help open beside it
  • bin/rank_todo.py:386 parse_row: Shape, a small gain

2026-10-09T09:35:29Z, PR #232 at 6a8bbcf, against 12d6d75

Ruling: same

Fell: Locality, Shape

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better worse same better better
Inherited architect better worse worse same worse
Maintainability senior better worse worse better same
Junior A better worse worse better worse

Mid A, decided by:

  • Navigation, Self-sufficiency, Overall: bin/larv_review/rules.py:118 round_counts, with bin/larv_review/main.py:155 round_count: the fourth-round symptom leads from the README's Tools list to a named, tested function, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Self-sufficiency, Overall: bin/larv_review/history.py:117 ruling_entry and :130 scoring_entry: the history format is produced by code and checked by a regex, where the base had skills/larv-review/SKILL.md:92 "History"
  • Locality: bin/larv_review/main.py:234 record_scoring: five conditionals on given.moved_mean weave a one-off migration into the main scoring path
  • Locality: bin/metric_bench/main.py:38 and bin/larv_review/history.py:31 Entry: places are parsed in larv_review but used only by metric_bench; bin/metric_bench/bench.py:87 resolved copes with old paths
  • Locality: bin/larv_review/main.py:1 the module docstring: rules compressed into one dense block; the fall, Ratchet and Still standing chain reaches across bin/larv_review/rules.py:95 fall_outcome, :76 standing_ratchet and bin/larv_review/main.py:164 needs_scoring_run
  • Navigation: README.md:66 "Tools": lists larv-review and metric-bench; skills/larv-review/SKILL.md:46 points at --help
  • Shape: bin/larv_review/rules.py:155 plan_items and :169 scoring_run_due: a catch-all module, offset by the clean package split and the truthful skills/comprehension-panel/seat-prompts.md:1 name

Inherited architect, decided by:

  • Locality: bin/larv_review/main.py:234 record_scoring: whether a run is allowed and whether the floor blocks depend on the plan diff, a pending fall read from the history, and moved_mean, checked five times in 25 lines
  • Locality: bin/larv_review/rules.py:71 pending_fall and :76 standing_ratchet: commands talk only through the history file, so the outcome depends on the order they ran in
  • Locality, Shape: bin/larv_review/rules.py:127 measured_commit: re-parses the history around every merged change and applies a two-clause rule; where it rots first
  • Shape: bin/larv_review/rules.py:1 the module: vote counting, round counting, base search, plan parsing and release emptying under a name that says as little as utils; HistoryChange defined in history but built in bin/larv_review/git.py:66 history_changes
  • Shape: bin/metric_bench/main.py:38: a second tool no review runs, depending on larv_review's history parser; bin/ gains two packages
  • Shape: bin/metric_bench/bench.py:87 resolved: a shim for old path formats
  • Navigation: bin/larv_review/rules.py:118 round_counts and bin/larv_review/main.py:155 round_count: the 3am symptom lands on a named command, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Navigation: README.md:66 "Tools": lists every tool
  • Navigation: skills/comprehension-panel/seat-prompts.md:1: a truthful name
  • Self-sufficiency: bin/larv_review/main.py:1 the module docstring and skills/larv-review/SKILL.md:93 "Paired ruling": the code explains itself, but the skill's ratchet text needs the docstring open beside it; ruled same

Maintainability senior, decided by:

  • Locality: bin/larv_review/main.py:234 record_scoring: tests given.moved_mean five times, each branch tied to chunk_history, due_reasons and pending_fall
  • Locality: bin/larv_review/rules.py:71 pending_fall: its docstring holds only because bin/larv_review/history.py:62 entries gives scoring runs an empty fell; the Fell, Ratchet and Still standing chain spans four files
  • Locality, Shape: bin/metric_bench/main.py:38 main: metric-bench imports larv_review's history internals; bin/metric_bench/main.py:143 git repeats bin/larv_review/git.py:10 git
  • Shape: bin/larv_review/rules.py:35 counted: a function and a parameter share the name; the module name says nothing of its contents
  • Shape: bin/larv_review/main.py:177 due_reasons: main holds commands plus I/O helpers, and the vocabulary grew to seven concepts
  • Navigation: README.md:66 "Tools": every tool listed with its --help
  • Self-sufficiency, Navigation: bin/larv_review/rules.py:118 round_counts: the round count, vote count and trigger state their rules in code, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Self-sufficiency: bin/larv_review/main.py:1 the module docstring: an 80-line block of every rule at once, partly cancelling the gain

Junior A, decided by:

  • Locality, Overall: bin/larv_review/main.py:234 record_scoring: the moved-Mean case is checked five times and decides four things
  • Locality, Overall: bin/larv_review/rules.py:76 standing_ratchet and :71 pending_fall: a merge block depends on state earlier commands wrote into the history
  • Locality, Shape: bin/larv_review/rules.py:127 measured_commit: walks every merged change's history; restated at bin/larv_review/main.py:11, the hardest sentence in the repo
  • Shape: bin/larv_review/rules.py:1 the module: a grab-bag name beside truthfully named siblings
  • Shape: bin/larv_review/seats.py:31 Report: the field read looks like a verb; said, counted, given and found at bin/larv_review/main.py:217 record_ruling need tracing
  • Shape: bin/metric_bench/main.py:38: the history format is a contract between two tool packages
  • Navigation, Self-sufficiency: bin/larv_review/rules.py:118 round_counts: the 3am question lands on one named function, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Navigation: README.md:66 "Tools": the README lists larv-review and metric-bench
  • Self-sufficiency: bin/larv_review/history.py:62 entries and :117 ruling_entry: the history format is enforced in code; the skill needs --help open beside it

2026-10-09T09:46:21Z, PR #232 at 324d650, against 12d6d75

Ruling: same

Fell: Locality

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better worse worse better same
Inherited architect better worse worse better better
Maintainability senior better worse same better better
Junior A better worse same same same

Mid A, decided by:

  • Navigation, Self-sufficiency: bin/larv_review/rules.py:125 round_counts: the fourth-round symptom leads to a named function and CAP, where the base had prose at skills/larv-review/SKILL.md:58 "Count"
  • Navigation: README.md:70 "Tools": names larv-review and metric-bench and the rules each holds
  • Locality: bin/larv_review/main.py:238 record_scoring: its result depends on which entry is newest in the history; the whole fall, scoring run, Ratchet, Still standing sequence must be held
  • Locality: bin/larv_review/rules.py:71 pending_fall and :83 standing_ratchet: the verdict depends on entry order in a file no single function shows
  • Locality, Shape: bin/metric_bench/bench.py:7 and bin/metric_bench/main.py:38: metric-bench depends on larv-review's history parser and keeps its own git at bin/metric_bench/main.py:143
  • Shape: bin/larv_review/rules.py:16 votes through :176 scoring_run_due: one module named rules holds four concepts
  • Shape: bin/larv_review/rules.py:35 counted and bin/larv_review/history.py:68 entries: one name over two things
  • Self-sufficiency: bin/larv_review/seats.py:38 report and bin/larv_review/history.py:99 heading: the seats file and history entry shapes are enforced in code

Inherited architect, decided by:

  • Navigation, Self-sufficiency, Overall: bin/larv_review/rules.py:125 round_counts, with bin/larv_review/main.py:159 round_count: the 3am question leads to one tested function, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Navigation, Overall: README.md:70 "Tools": one hop from a symptom to a file
  • Locality: bin/larv_review/main.py:238 record_scoring: four helpers over four sources; why fell is empty here and not at bin/larv_review/main.py:168 is stated nowhere at the call
  • Locality: bin/larv_review/rules.py:83 standing_ratchet with bin/larv_review/history.py:12 RATCHET: state passes between commands through a markdown file's wording
  • Locality, Shape: bin/larv_review/rules.py:176 scoring_run_due and :192 emptied: the due rule packs five conditions
  • Shape: bin/larv_review/rules.py:1 the module: one name over many concepts
  • Shape: bin/metric_bench/main.py:38 and bin/metric_bench/bench.py:7: the history format has no home of its own; bin/larv_review/git.py:7 HISTORY sits in a module named for git
  • Self-sufficiency: bin/larv_review/main.py:1 the module docstring: dense, but it ships with the code and states every rule

Maintainability senior, decided by:

  • Navigation, Self-sufficiency, Overall: bin/larv_review/rules.py:125 round_counts, with bin/larv_review/main.py:159 round_count: the rule is one small tested function, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Navigation: README.md:66 "Tools": lists both tools with a pointer to each --help
  • Self-sufficiency: bin/larv_review/rules.py:35 counted, :50 ruling and :60 fallen: each rule stated in a docstring and enforced beside it, where the base had skills/larv-review/SKILL.md:100 "Ratchet"
  • Locality: bin/larv_review/main.py:238 record_scoring: due_reasons with an empty fall, then pending_fall separately; four places to hold
  • Locality: bin/larv_review/rules.py:71 pending_fall and :83 standing_ratchet: order dependence between commands through a file
  • Locality, Shape: bin/larv_review/seats.py:38 report, bin/larv_review/history.py:99 heading and bin/larv_review/main.py:267 record_moved_mean: a one-time migration threaded through three modules
  • Shape: bin/metric_bench/main.py:38 and bin/metric_bench/bench.py:7: a second tool depends on the first one's parser; Entry.places at bin/larv_review/history.py:40 exists only for it
  • Shape: bin/larv_review/rules.py:176 scoring_run_due: a grab-bag module, offset by the truer skills/comprehension-panel/seat-prompts.md:1 name
  • Self-sufficiency: bin/larv_review/main.py:11 the ruling-base paragraph: took three reads, resolved only by bin/larv_review/rules.py:134 measured_commit

Junior A, decided by:

  • Navigation: bin/larv_review/rules.py:125 round_counts: the symptom leads to the round-count command, where the base had skills/larv-review/SKILL.md:58 "Count"
  • Navigation: README.md:68 "Tools": names both tools; skills/larv-review/SKILL.md:46 points at the same tool
  • Locality: bin/larv_review/main.py:238 record_scoring: whether the run blocks, ratchets or fails depends on three outside sources
  • Locality: bin/larv_review/rules.py:134 measured_commit: the base depends on what each past merged change added, by heading time
  • Locality: bin/metric_bench/main.py:38 entries, Entry: a second tool parses the history through larv-review's internals
  • Shape: bin/larv_review/rules.py:176 scoring_run_due: a catch-all module, offset by the clean split and the truer skills/comprehension-panel/seat-prompts.md:1
  • Self-sufficiency: skills/larv-review/SKILL.md:98 "Ruling": the skill needs bin/larv_review/main.py:1 open beside it, offset by rules now in code

2026-10-09T09:47:25Z, PR #232 at 324d650

Ratchet: the paired ruling counts as worse, as Locality fell and Locality is 6.50, under the floor of 7.0.

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6.5 6 6.5
Mid A 7 7 6.5 6.5 7
Maintainability senior 7.5 6.5 7 7 7
Inherited architect 7 6.5 6.5 7 7
Mean 7.13 6.50 6.63 6.63 6.88

Junior A, hardest first:

  • bin/larv_review/main.py:238 record_scoring: due_reasons with an empty fall means "reasons besides a fall", stated only at bin/larv_review/rules.py:93 floor_verdict
  • bin/larv_review/main.py:1 the module docstring: 80 lines of interlocking rules that never say why
  • bin/larv_review/rules.py:134 measured_commit: not (last and last.fell) is true with no ruling at all
  • bin/larv_review/rules.py:16 votes, with :35 counted and :40 names_a_place: the counting rule spans three files
  • bin/larv_review/history.py:62 entries and :75 seat_places: the parser and writer share a format by eye
  • bin/loop_claude/cycle/judge.py:31 run_judge: five outcomes, the spec a prompt string
  • bin/loop_claude/transcript_archive.py:30 archive: reading-cost parses its outcome text
  • bin/metric_bench/bench.py:87 resolved: order-dependent legacy shim

Mid A, hardest first:

  • bin/larv_review/main.py:238 record_scoring: six exits; due_reasons with an empty fall list on purpose
  • bin/larv_review/rules.py:134 measured_commit: states what, never why
  • bin/larv_review/rules.py:176 scoring_run_due: five inputs in one dense sentence
  • bin/loop_claude/cycle/judge.py:31 run_judge: two text checks against two texts
  • bin/loop_claude/transcript_archive.py:30 archive: a prose format that is a contract with another tool
  • bin/loop_claude/cycle/states.py:69 transition: case order decides behaviour
  • bin/larv_review/rules.py:16 votes: parse also enforces the ruling protocol; counted shadowed
  • bin/loop_claude/claude_code/entries.py:45 string_by_human: heuristics on who wrote an entry

Maintainability senior, hardest first:

  • bin/larv_review/main.py:238 record_scoring: ten lines, six ideas; due_reasons's third argument means different things to its two callers
  • bin/larv_review/rules.py:134 measured_commit: the no-ruling case deduced only from the help
  • bin/larv_review/rules.py:176 scoring_run_due: a 70-word docstring and a second document open
  • bin/larv_review/rules.py:16 votes: Overall's rule hidden in DIMENSIONS[-1]; None means split
  • bin/larv_review/history.py:62 entries: eight positional arguments counted against a regex
  • bin/larv_review/history.py:99 heading: a one-off migration threaded through three files
  • bin/metric_bench/bench.py:87 resolved: depends on earlier bullets' order
  • bin/loop_claude/cycle/states.py:69 transition: case order, resolved by comments

Inherited architect, would restructure first:

  • bin/loop_claude/transcript_archive.py:111 finished_chunks, bin/reading_cost/archive.py:10 project_archive and bin/loop_claude/claude_code/entries.py:5 parse_entry: lift the shared formats out of loop_claude
  • bin/larv_review/rules.py:125 round_counts and :176 scoring_run_due: split rules into rounds, ruling, base and scoring
  • bin/loop_claude/cycle/judge_reply.py:12 JUDGE_RULES and bin/loop_claude/cycle/worker.py:41 worker_args: give the prompt text one home
  • bin/failure.py:5 Failure, bin/file_writes.py:21 replace_file and bin/markdown_sections.py:6 sections: tidy the bin root
  • bin/larv_review/git.py:10 git, bin/metric_bench/main.py:143 git and bin/reading_cost/main.py:113 located: one git runner
  • bin/loop_claude/project/checkout.py:32 read_utf8: a generic reader under a lying name
  • bin/larv_review/main.py:101 main: an if/elif dispatch where the next command lands

2026-10-09T12:31:47Z, PR #234 at b1913ed, against 2157f59

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better same better better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Navigation: bin/transcript_archive/outcomes.py:4 FINISHED_AT and finished: one module now writes and parses the outcome lines, which bin/loop_claude/cycle/run.py:83 built inline and another file parsed
  • Locality, Navigation: bin/reading_cost/main.py:35 imports: reading-cost depends only on the shared transcript_archive, no longer on loop-claude's internals
  • Locality: bin/loop_claude/paths.py:15 paths_from: no longer reads the environment; LOOP_CLAUDE_TRANSCRIPTS has one home in bin/transcript_archive/location.py:5 project_archive
  • Navigation, Self-sufficiency: README.md:77 "Tools": states the import root, the shared packages and where tests live
  • Self-sufficiency: bin/transcript_archive/write.py:13 archive: states the archive's layout at the write
  • Shape: bin/loop_claude/loop/main.py:86 run_loop: imports project_key, which names the session and the models entry, from the archive package; bin/loop_claude/cycle/worker.py:7 takes quoted from the archive's outcomes
  • Shape: bin/loop_claude/cycle/judge.py:15 JUDGE_RULES: judge_reply merged in, 183 lines

Inherited architect, decided by:

  • Navigation, Shape: bin/reading_cost/main.py:35 main: imports one shared package named for what it holds, in place of loop-claude's private packages
  • Locality, Self-sufficiency: bin/transcript_archive/outcomes.py:10 finished: the outcome texts sit beside FINISHED_AT, the regex that reads them back
  • Shape: bin/claude_code/session.py:21 session_named: the Claude Code package depends on nothing in loop-claude
  • Locality: bin/loop_claude/cycle/judge.py:15 JUDGE_RULES and :93 verdict_from: in one file with run_judge
  • Locality: bin/loop_claude/cycle/states.py:75 transition: the cap no longer depends on case order
  • Navigation, Self-sufficiency: README.md:77 "Tools": states the layout and puts each test beside its package
  • Self-sufficiency: bin/loop_claude/cycle/run.py:34 Cycle.unfinished_evidence: the name says what remaining needed a comment for
  • Shape: bin/loop_claude/loop/main.py:86 run_loop, bin/loop_claude/cycle/worker.py:7 worker_args and bin/host_env.py:5 host_env: small seams against the decoupling

2026-10-09T12:32:00Z, PR #234 at b1913ed

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6.5 6 6.5
Mid A 7 6 6.5 6 6.5
Maintainability senior 7 6.5 7 6.5 7
Inherited architect 7 6.5 6 6.5 6.5
Mean 7.00 6.25 6.50 6.25 6.63

Junior A, hardest first:

  • skills/larv-review/SKILL.md:55 "Round cap": the counting rule spread across Round cap, Re-entry, Fresh and Suspended
  • bin/larv_review/main.py:197 record_ruling: split, fell, refuse and stand branches; ruling returns None for a split and fallen reuses it
  • bin/larv_review/scoring.py:54 scoring_run_due: why the next-release fallback holds is stated nowhere
  • bin/larv_review/base.py:14 measured_commit: mechanics without purpose
  • bin/loop_claude/cycle/judge.py:126 run_judge: the prompt assembled from records.py constants; two texts, two matchers
  • bin/reading_cost/measure.py:21 Checkout: root and top read as synonyms

Mid A, hardest first:

  • bin/larv_review/main.py:197 record_ruling: said and counted, None as split, three fall steps
  • bin/comprehension_history.py:74 entries: the history format is defined only by its writer
  • bin/loop_claude/cycle/judge.py:126 run_judge: elided evidence fails, a misquoted answer becomes an interrupt
  • bin/larv_review/scoring.py:54 scoring_run_due: one dense sentence over two plans; the module also parses the plan
  • bin/larv_review/base.py:14 measured_commit: the why lives in the help and the skill
  • bin/loop_claude/cycle/states.py:69 transition: quoted_answers threaded through three states and two files

Maintainability senior, hardest first:

  • bin/larv_review/main.py:197 record_ruling: said and count, ruled reassigned, a silent fall-through; ruling's None means two things
  • bin/larv_review/base.py:14 measured_commit: a three-step fallback across three files, ordered by an ISO string unsaid
  • bin/comprehension_history.py:74 entries: the format is never stated in one place
  • bin/loop_claude/cycle/judge.py:15 JUDGE_RULES: the prompt interpolates four constants from another module
  • bin/larv_review/scoring.py:54 scoring_run_due: five inputs; scoring also parses the plan
  • bin/rank_todo.py:416 rank_details: regex surgery in a script larv-review imports as a library

Inherited architect, would restructure first:

  • bin/loop_claude/project/records.py:6 QUOTE_SOURCES: prompt fragments spliced into the judge, worker and interrupt texts
  • bin/transcript_archive/location.py:10 project_key: the project's identity filed under the archive
  • bin/host_env.py:5 host_env: a test helper among the production modules
  • bin/larv_review/rounds.py:8 round_counts: only counts; the cap lives in the skill
  • bin/larv_review/base.py:1 the module: the ruling base, named like a base class
  • bin/larv_review/scoring.py:6 imports: one tool imports another tool's internals from bin/rank_todo.py
  • bin/loop_claude/loop/main.py:1 the docstring: restates constants it cannot keep true

2026-10-09T12:46:51Z, PR #234 at dde06fc, against 2157f59

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Navigation, Locality, Shape: bin/transcript_archive/location.py:7 project_archive: the archive's location lives in one shared package, where reading-cost reached into loop-claude's internals
  • Locality, Shape, Self-sufficiency: bin/loop_claude/cycle/run.py:83 worker_start: worker_args builds only flags and each prompt is a named function in bin/loop_claude/cycle/prompts.py:41
  • Locality, Self-sufficiency: bin/transcript_archive/outcomes.py:10 finished: the outcomes format's writer and reader sit in one file
  • Shape: bin/larv_review/ruling.py:42 split: ruling no longer returns None for a split
  • Shape, Locality: bin/larv_review/main.py:204 record_ruling: two plain checks in place of fall_step's strings; plan logic in bin/larv_review/plan.py:5
  • Navigation: README.md:77 "Tools": states the import root and the shared packages
  • Self-sufficiency: bin/comprehension_history.py:74 entries: a worked example of an entry above the parser
  • Self-sufficiency, Shape: bin/metric_bench/bench.py:88 tracked_places: the rename garbled the docstring
  • Locality: bin/loop_claude/cycle/prompts.py:60 quoted: duplicates bin/transcript_archive/outcomes.py:31 quoted

Inherited architect, decided by:

  • Navigation, Locality: bin/transcript_archive/outcomes.py:10 finished: every outcome line and FINISHED_AT sit in one module
  • Navigation, Locality: bin/reading_cost/main.py:35 imports: reading-cost no longer reaches into loop-claude's internals
  • Navigation, Self-sufficiency: README.md:77 "Tools": the layout is stated
  • Shape, Locality: bin/todo_table.py:27 items: the table format is its own module, not a CLI script used as a library
  • Shape: bin/larv_review/plan.py:5 scoring_run_due: the plan trigger with its why, apart from the floor arithmetic
  • Locality, Shape: bin/larv_review/ruling.py:42 split: split, ruling and lead are separate
  • Locality, Shape: bin/loop_claude/cycle/prompts.py:41 fresh: every prompt text in one module
  • Shape: bin/comprehension_history.py:67 ScoringRun: one name no longer covers two concepts
  • Self-sufficiency: bin/larv_review/main.py:5 the help: defines the ratchet, the paired ruling and the scoring run first
  • Locality: bin/loop_claude/cycle/states.py:75 transition: the past-the-cap case has its own guard
  • Shape: bin/metric_bench/bench.py:87 tracked_places: the docstring reads worse after the rename

2026-10-09T12:46:51Z, PR #234 at dde06fc

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 6 6 6
Mid A 7.5 6.5 7 6.5 7
Maintainability senior 7 6.5 7 7 7
Inherited architect 7 6.5 6.5 7 7
Mean 7.13 6.50 6.63 6.63 6.75

Junior A, hardest first:

  • bin/larv_review/main.py:204 record_ruling: six outcomes, said against count, [-1] meaning Overall
  • bin/larv_review/ruling.py:8 votes: a parser that also enforces the seat-count rule
  • bin/larv_review/ruling_base.py:14 measured_commit: the docstring explains only after the code confused
  • bin/larv_review/plan.py:5 scoring_run_due: four ideas at once; emptied traced by hand
  • bin/metric_bench/bench.py:87 tracked_places: a garbled docstring
  • bin/loop_claude/cycle/states.py:69 transition: the quoted-answer cap across three files

Mid A, hardest first:

  • skills/larv-review/SKILL.md:55 "Round cap": four subsections pointing at each other
  • bin/larv_review/main.py:204 record_ruling: five outcomes; the duplicate check in two places
  • bin/loop_claude/cycle/judge.py:95 run_judge: many endings, two quote checks
  • bin/loop_claude/cycle/states.py:69 transition: the cap counter rides through three states
  • bin/larv_review/ruling_base.py:14 measured_commit: needs the history format and first-parent semantics
  • bin/reading_cost/measure.py:27 measure: string-compared timestamps and approximate shell parsing

Maintainability senior, hardest first:

  • bin/larv_review/main.py:204 record_ruling: five outcomes, competing local names
  • skills/larv-review/SKILL.md:55 "Round cap": a chain of cross-references
  • bin/comprehension_history.py:103 seat_places: depends unsaid on sections dropping blank lines
  • bin/larv_review/plan.py:5 scoring_run_due: four inputs; the rule restated in the help
  • bin/larv_review/ruling_base.py:14 measured_commit: why same is safe needs the skill
  • bin/metric_bench/bench.py:87 tracked_places: a garbled docstring

Inherited architect, would restructure first:

  • bin/larv_review/rounds.py:12 round_counts: the round cap lives in prose; a mis-cased title escapes the count
  • bin/loop_claude/cycle/judge.py:17 Reply: the judge contract spread over four files
  • bin/loop_claude/project/checkout.py:28 read_utf8: a generic reader under the checkout's name
  • bin/test_env.py:5 isolated_env: test support named like a test
  • bin/larv_review/git.py:6 imports: the git adapter depends on a domain type
  • bin/loop_claude/cycle/prompts.py:60 quoted: two copies, with STAMP and the git runner also duplicated

2026-10-09T12:53:41Z, PR #234 at b346a35, against 2157f59

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Navigation, Locality: bin/reading_cost/main.py:35 main: the archive reader and location come from a shared package, not loop-claude's internals
  • Locality, Shape: bin/loop_claude/cycle/run.py:83 worker_start: picks one of three named prompts for a four-argument worker_args
  • Navigation, Shape: bin/loop_claude/cycle/prompts.py:1 the module: the texts the worker and the human see sit together
  • Locality, Shape: bin/larv_review/main.py:204 record_ruling: plain checks with split, lead and overall
  • Navigation, Shape: bin/larv_review/ruling_base.py:4 measured_commit: a truthful module name; HistoryChange beside the format
  • Navigation, Locality: bin/todo_table.py:27 items: the table parser is shared, not reached into a CLI script
  • Navigation, Self-sufficiency: README.md:77 "Tools": states the layout
  • Self-sufficiency: bin/comprehension_history.py:82 entries: a worked example above the parser
  • Shape: bin/reading_cost/measure.py:20 Checkout: fields say which root keys the archive
  • Locality: bin/loop_claude/cycle/states.py:75 transition: the past-the-cap case has its own guard

Inherited architect, decided by:

  • Locality, Shape: bin/transcript_archive/location.py:7 project_archive: both tools import one shared package
  • Navigation, Locality: bin/transcript_archive/outcomes.py:10 finished: the outcome line sits beside the regex that reads it back
  • Locality, Shape: bin/loop_claude/cycle/run.py:83 worker_start: worker_args takes the finished prompt
  • Shape: bin/larv_review/git.py:5 imports: the git helper no longer depends on the base search
  • Shape, Self-sufficiency: bin/larv_review/plan.py:5 scoring_run_due: its own module, saying why each trigger exists
  • Self-sufficiency, Locality: bin/larv_review/ruling.py:27 overall and :47 split: no None meaning split, no bare index
  • Navigation: bin/reading_cost/measure.py:20 Checkout: the fields name which root
  • Self-sufficiency: bin/comprehension_history.py:82 entries: a worked example
  • Navigation: README.md:77 "Tools": the import root and the tests' place
  • Shape: bin/larv_review/main.py:234 recorded_ruling: eight positional parameters, a step back
  • Self-sufficiency: bin/loop_claude/cycle/prompts.py:29 quoted: a second copy

2026-10-09T12:53:41Z, PR #234 at b346a35

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 7 6 6.5
Mid A 7.5 7 7 6.5 7
Maintainability senior 7.5 7 7 7 7
Inherited architect 7.5 7 6.5 7 7
Mean 7.38 6.75 6.88 6.63 6.88

Junior A, hardest first:

  • skills/larv-review/SKILL.md:55 "Round cap": rules pointing at each other; Fresh mixes five things
  • bin/larv_review/main.py:204 record_ruling: five exits; the counting rule in bin/larv_review/ruling.py:32 counted
  • bin/larv_review/ruling_base.py:4 measured_commit: a set difference of headings per change
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: a prompt built from constants in three files; two quote checks
  • bin/comprehension_history.py:95 entries: two label regexes tied to the writer's wording
  • bin/reading_cost/shell_reads.py:52 segments: heuristic shell parsing

Mid A, hardest first:

  • bin/larv_review/main.py:204 record_ruling: five branches across four modules
  • bin/larv_review/ruling_base.py:4 measured_commit: reread three times to trust it
  • bin/loop_claude/cycle/judge.py:127 run_judge: two quote checks with opposite policies
  • bin/loop_claude/cycle/states.py:69 transition: the quoted-answer counter through three states
  • bin/comprehension_history.py:95 entries: Markdown parsed back into records
  • bin/metric_bench/bench.py:87 tracked_places: order-dependent legacy resolution

Maintainability senior, hardest first:

  • bin/larv_review/main.py:204 record_ruling: six exits; fresh=False hides a skipped check
  • bin/larv_review/ruling_base.py:4 measured_commit: why needs the skill
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: assembled across three files
  • bin/comprehension_history.py:95 entries: the format defined by example and regexes
  • bin/loop_claude/cycle/states.py:69 transition: the counter survives an interrupt
  • bin/reading_cost/shell_reads.py:52 segments: opaque on what it misses

Inherited architect, would restructure first:

  • bin/larv_review/rounds.py:8 round_counts: the cap lives in prose; the tool only reports
  • bin/larv_review/main.py:204 record_ruling: the record commands in a 326-line main
  • bin/larv_review/git.py:8 git: four git wrappers, one archive key computed two ways
  • bin/loop_claude/cycle/prompts.py:29 quoted: duplicated, as is STAMP
  • bin/larv_review/ruling_base.py:24 base: a name that reads as a base class

2026-10-09T13:04:47Z, PR #234 at b2a277b, against 2157f59

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Navigation: bin/transcript_archive/location.py:7 project_archive: the archive's writer and readers share one package; outcome strings sit beside the regex that reads them
  • Locality, Shape: bin/loop_claude/cycle/run.py:83 worker_start: picks the prompt in three lines; worker_args only builds argv
  • Shape, Navigation: bin/larv_review/main.py:100 main: only dispatch; recording and plan reading have their own modules
  • Locality, Navigation: bin/todo_table.py:27 items: table parsing shared, not reached into a tool script
  • Shape: bin/larv_review/ruling.py:47 split: split, lead and overall each say what they compute
  • Shape, Self-sufficiency: bin/reading_cost/measure.py:20 Checkout: fields name which root
  • Locality: bin/claude_code/session.py:21 session_named: the adapter takes only a name and a folder
  • Navigation: README.md:77 "Tools": names the import root and where tests live
  • Self-sufficiency: bin/larv_review/main.py:5 the help: explains the ruling, ratchet, scoring run and floor first

Inherited architect, decided by:

  • Locality, Navigation: bin/transcript_archive/location.py:7 project_archive: location, writer and reader are peers both tools import
  • Locality: bin/transcript_archive/outcomes.py:6 FINISHED: the format and its parser in one module
  • Shape, Navigation: bin/larv_review/plan.py:8 scoring_run_due: the plan trigger has its own file; scoring.py holds only the floor
  • Shape: bin/larv_review/record.py:14 record_ruling: recording is one module, its guards inline
  • Locality, Self-sufficiency: bin/loop_claude/cycle/worker.py:40 worker_args: takes a ready prompt; the texts are named functions
  • Shape: bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: the judge is one file
  • Locality: bin/loop_claude/paths.py:15 paths_from: the env override is read in one place
  • Self-sufficiency: bin/comprehension_history.py:81 entries: a worked example above the parser
  • Navigation, Self-sufficiency: README.md:77 "Tools": the layout is stated and checked
  • Locality: bin/larv_review/ruling.py:52 ruling: returns same for a split, so only split guards it

2026-10-09T13:04:48Z, PR #234 at b2a277b

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 7 6 6.5
Mid A 7.5 6.5 7 6.5 6.5
Maintainability senior 7.5 6.5 7 6.5 7
Inherited architect 7.5 7 6.5 7 7
Mean 7.38 6.50 6.88 6.50 6.75

Junior A, hardest first:

  • bin/larv_review/record.py:14 record_ruling: seven exits; the terms only in the help and the skill
  • bin/larv_review/ruling_base.py:4 measured_commit: diffs heading sets per change
  • bin/comprehension_history.py:94 entries: regex groups used by position
  • bin/larv_review/ruling.py:32 counted: the counting rule stated in the help, not here
  • bin/loop_claude/cycle/states.py:69 transition: the cap counter across three files
  • bin/loop_claude/cycle/judge.py:127 run_judge: two quote checks with different rules

Mid A, hardest first:

  • skills/larv-review/SKILL.md:82 "Architecture": conditions with exceptions; Fresh took three rereads
  • bin/larv_review/record.py:14 record_ruling: six outcomes across five modules
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: one sentence takes three files
  • bin/larv_review/ruling_base.py:4 measured_commit: the fallback chain over two files
  • bin/larv_review/plan.py:8 scoring_run_due: release sets held at once
  • bin/comprehension_history.py:94 entries: the format pinned in three places

Maintainability senior, hardest first:

  • bin/larv_review/record.py:14 record_ruling: five exits; the rule spread over five modules
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: instructions stitched from three modules
  • bin/larv_review/plan.py:8 scoring_run_due: five inputs; the docstring restates the help
  • bin/larv_review/ruling_base.py:4 measured_commit: opaque without its docstring
  • bin/larv_review/seats.py:17 SeatsFile: read is a noun; locals rename one pair two ways
  • bin/comprehension_history.py:110 seat_places: a line-state parser two tools depend on

Inherited architect, would restructure first:

  • bin/larv_review/rounds.py:4 PASSES: the cap is the skill's; the pass list has two homes
  • bin/comprehension_history.py:149 ruling_entry: reader, writer and seat registry in one root module
  • bin/larv_review/record.py:67 read_fall_scores: a parameter named votes holds a heading
  • bin/larv_review/git.py:8 git: four ways to run git; the archive key's root differs between tools
  • bin/larv_review/record.py:14 record_ruling: branches on worse, fell, scores file and split at once

2026-10-09T13:23:40Z, PR #234 at 7e13778, against 2157f59

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Navigation, Shape: bin/larv_review/record.py:14 record_ruling: recording, dispatch and plan reading each in a file named for it
  • Shape, Navigation: bin/larv_review/plan.py:8 scoring_run_due: file names tell the truth; todo parsing in bin/todo_table.py:27 items
  • Navigation, Shape: bin/transcript_archive/location.py:7 project_archive: both tools share top-level packages, not another tool's internals
  • Locality: bin/loop_claude/cycle/run.py:83 worker_start: a prompt changes without reading the argument plumbing
  • Locality: bin/loop_claude/cycle/states.py:75 transition: the past-the-cap case has its own guard
  • Locality: bin/transcript_archive/location.py:7 project_archive: the env override resolved in one place
  • Self-sufficiency: bin/larv_review/main.py:1 the help: defines seats, the ruling, the ratchet and the floor first
  • Shape, Self-sufficiency: bin/reading_cost/measure.py:20 Checkout: fields say which root keys the archive

Inherited architect, decided by:

  • Locality, Navigation: bin/transcript_archive/outcomes.py:6 FINISHED: outcome lines written and parsed in one file
  • Locality, Shape: bin/transcript_archive/location.py:7 project_archive: reading-cost no longer reaches into loop-claude
  • Navigation, Locality: bin/loop_claude/cycle/judge.py:94 verdict_from: the 3am question lands in one file
  • Shape, Navigation: bin/larv_review/main.py:102 main: dispatch only
  • Locality, Shape: bin/todo_table.py:27 items: larv-review imports no tool's internals
  • Locality: bin/larv_review/record.py:32 record_ruling: the fall handling reads in place
  • Locality, Shape: bin/loop_claude/cycle/run.py:83 worker_start: the start chosen at the call site
  • Shape: bin/reading_cost/measure.py:20 Checkout: names that say which root
  • Self-sufficiency: bin/comprehension_history.py:81 entries: a sample entry above the parser
  • Locality: bin/loop_claude/cycle/states.py:75 transition: no case-order dependence

2026-10-09T13:23:40Z, PR #234 at 7e13778

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7.5 7 7 6.5 7
Mid A 7 6.5 7 6.5 6.5
Maintainability senior 7 6.5 7 6 6.5
Inherited architect 7 6.5 6 7 6.5
Mean 7.13 6.63 6.75 6.50 6.63

Junior A, hardest first:

  • bin/larv_review/record.py:14 record_ruling: four outcomes, two parallel vote dicts
  • bin/larv_review/ruling.py:32 counted: an asymmetric rule; PLACE in another file
  • bin/metric_bench/python_units.py:86 score: needs a paper outside the repo
  • bin/comprehension_history.py:94 entries: leans on sections dropping blank lines
  • bin/loop_claude/cycle/judge.py:127 run_judge: two quote checks against two texts
  • skills/larv-review/SKILL.md:55 "Round cap": sections pointing at each other

Mid A, hardest first:

  • bin/larv_review/record.py:14 record_ruling: five outcomes; read as a noun
  • bin/comprehension_history.py:110 seat_places: depends unsaid on sections dropping blank lines
  • bin/larv_review/ruling_base.py:4 measured_commit: several ideas held at once
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: decision logic in English
  • bin/claude_code/entries.py:28 written_by_human: heuristics over the transcript shape
  • bin/loop_claude/loop/reload.py:50 exec_if_edited: any tool's edit reloads the loop

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:82 "Architecture": six interlocking conditions
  • bin/larv_review/record.py:14 record_ruling: two checks run twice; the rule whole only in the help
  • bin/comprehension_history.py:94 entries: a format shared by three tools by string convention
  • bin/larv_review/plan.py:8 scoring_run_due: three things combined in "work has landed"
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: behaviour in prose, post-filtered three ways
  • bin/rank_todo.py:357 rank_details: rebuilds the file by slicing

Inherited architect, would restructure first:

  • bin/larv_review/rounds.py:8 round_counts: the cap is prose in the skill
  • bin/larv_review/record.py:14 record_ruling: an if-chain with prints interleaved
  • bin/larv_review/scoring.py:8 fall_ruling: a ruling rule in the scoring module
  • bin/claude_code/trust.py:10 trust: effects in a package documented as shapes
  • bin/larv_review/git.py:8 git: git run five ways

2026-10-12T21:36:23Z, PR #241 at 7cf4f54, against 4cc9953

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse same same
Inherited architect same worse same same same

Mid A, decided by:

  • Shape: bin/rule_hook/rules.py:140 file_breaches: four rules in one function, picked by file-name tests, each a comprehension of three or four conditions
  • Shape: bin/rule_hook/rules.py:86 git_commit: a hand-written git argument parser with two index-juggling loops and a nested loop that moves at
  • Shape: bin/rule_hook/main.py:1 module docstring: it and RULES each describe the six rules in their own words, as do CLAUDE.md, CHANGELOG.md and README.md
  • Shape: bin/rule_hook/main.py:93 checked_call: returns a 3-tuple or None, and its name hides that it replays a MultiEdit's edits

Inherited architect, decided by:

  • Locality: skills/larv-review/SKILL.md:58 "Opt-out": an opted-out chunk skips a scoring run larv-review needs-scoring-run still calls due, and "End" adds a third kind of run
  • Locality: bin/rule_hook/main.py:76 main: logs each granted override before it knows whether another rule still blocks the call, into an unversioned log keyed by branch name and never pruned
  • Locality: bin/rule_hook/main.py:115 todo_breaches: the hook imports rank_todo.check_failures, so editing rank_todo's messages changes what blocks a commit, while README calls rank_todo.py a tool of one file; the rule's logic sits in main.py, apart from the other rules in rules.py

2026-10-12T22:10:36Z, PR #241 at 7598584, against 4cc9953

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse same same
Inherited architect same worse same same same

Mid A, decided by:

  • Shape: bin/rule_hook/rules.py:8 RULES: the module holds the rule table, override parsing and git command-line parsing, while git.py only runs git
  • Shape: bin/rule_hook/override_log.py:82 logged: builds an Entry though it reads as a yes/no check; holds is an ancestry test and what says little
  • Shape: bin/rule_hook/main.py:66 main: passes verdict two bare booleans
  • Locality: bin/shell_command.py:20 simple_commands: shorter reading-cost parsing, against a parser change for the hook moving reading-cost figures; the two cancel
  • Locality: bin/rule_hook/main.py:99 bash_breaches: parses the command's commits twice

Inherited architect, decided by:

  • Locality: bin/shell_command.py:31 segments: one grown parser serves reading-cost and the hook, so tightening it for one moves the other
  • Locality: bin/rule_hook/override_log.py:36 this_chunks: chunk membership rests on reflog expiry and a default-branch guess, with three failures in one nested ternary at line 96
  • Locality: bin/rule_hook/main.py:82 answer: resolve-then-write order carried by one comment, and Breach.directory set deep in rules.py decides which log gets a line
  • Locality: bin/rule_hook/rules.py:108 git_subcommand: a second answer to "is this a git commit" beside measure.py's COMMIT regex
  • Locality: bin/rule_hook/todo_check.py:7 import rank_todo: a change to rank_todo's check changes what the hook blocks

2026-10-12T22:43:27Z, PR #242 at 63b0759, against 4cc9953

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same better better better
Inherited architect better same same same better

Mid A, decided by:

  • Shape, Navigation: bin/shell_command.py:20 simple_commands: splitting a shell command and tracking each cd is one module named for what it holds, where shell_reads.py spread it over three helpers
  • Shape: bin/reading_cost/measure.py:7 measure imports: resolved comes from shell_command, no longer from a module named for shell reads
  • Self-sufficiency, Navigation: bin/rule_hook/main.py:1 module docstring: each rule's holds and checked build --help, so a blocked commit leads to one authority
  • Navigation: CLAUDE.md:50 "Topic rules": each topic's rules have their own file and the section says which loads with what, where the old charter was one 167-line wall
  • Shape: bin/rule_hook/rules.py:108 git_subcommand: git argument parsing sits in rules, while git.py only runs git
  • Locality: bin/loop_claude/project/records.py:14 read_records: the rules folder is spelled twice, as HUMAN_RULES_DIR and as claude_md.parent / "rules"
  • Shape: bin/rule_hook/todo_check.py:7 import rank_todo: one tool imports another tool's script, though the README states it

Inherited architect, decided by:

  • Navigation, Overall: CLAUDE.md:50 "Topic rules": each topic has a file named for it and scoped by paths:, indexed in four lines, so a rule is one step from its question
  • Navigation: bin/shell_command.py:20 simple_commands: command splitting has one obvious home, used by the hook and by reading-cost
  • Locality: bin/shell_command.py:31 segments: the shared parser means a change for the hook moves reading-cost's figures, and nothing at reading_cost/ says so
  • Shape: bin/rule_hook/rules.py:108 git_subcommand: a module named rules parses git's command line, and Breach.directory carries the override log's concern
  • Shape, Locality: bin/rule_hook/override_log.py:96 print_overrides: a chained ternary of four outcomes beside this_chunks, whose reflog rule needs both comments held at once
  • Locality: bin/rule_hook/main.py:82 answer: resolve-before-write holds only by the loops' arrangement, stated in one comment
  • Self-sufficiency: bin/rule_hook/main.py:1 module docstring: the rules print from RULES, while CLAUDE.md:67 now sends a charter reader to rules.py for the pinning rule
  • Locality: bin/rule_hook/todo_check.py:10 todo_breaches: a change to rank_todo's output reaches a hook that can block every commit

2026-10-12T22:56:19Z, PR #242 at f351e14, against 4cc9953

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse same same
Inherited architect same same same same same

Mid A, decided by:

  • Shape: bin/rule_hook/rules.py:99 commits: a file named for the rule table parses git's command line, while git.py only runs git
  • Shape: bin/rule_hook/override_log.py:82 logged: builds an Entry and logs nothing; holds is an is-ancestor test and this_chunks needs two comments
  • Shape: bin/shell_command.py:20 simple_commands: shell lexing moved out of shell_reads.py, which now holds only what counts as a read

Inherited architect, decided by:

  • Locality, Shape: bin/shell_command.py:20 simple_commands: one shared lexer, though a fix for the hook shifts reading-cost's figures unseen
  • Locality, Shape: bin/rule_hook/rules.py:108 git_subcommand: a second definition of a commit beside measure.py's COMMIT regex, in a module that also holds the rule table and verdict
  • Locality: bin/rule_hook/override_log.py:86 print_overrides: a four-way chained conditional beside this_chunks' reflog rule
  • Locality: skills/larv-review/SKILL.md:56 "Opt-out": a third skip mechanism to cross-check beside "Precedent, then ask" and "Suspended"
  • Navigation, Self-sufficiency: bin/rule_hook/main.py:46 main: a blocked call leads cold to the rule, its text and the override syntax
  • Self-sufficiency, Navigation: CLAUDE.md:50 "Topic rules": each topic's rules are found by file name, while CLAUDE.md:67 sends a reader to rules.py for the pinning rule's full text

2026-10-12T23:45:13Z, PR #245 at b568522, against 4cc9953

Ruling: worse

Fell: Navigation, Locality. Under the floor of 7.0: Locality 6.88, so the same ruling counts as worse.

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse same same same
Inherited architect worse worse same same worse
Maintainability senior worse worse same same worse
Junior A worse same same same same
Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 6.5 6.5 6.5
Mid A 7.5 7 7 6.5 7
Maintainability senior 7.5 7 7 7 7
Inherited architect 7.5 7 6.5 7 7
Mean 7.38 6.88 6.75 6.75 6.88

Mid A, decided by:

  • Locality: agents/prose-reviewer.md:9 "The bar": the prose bar now combines CLAUDE.md → "Prose", the standards files and path-matched rules/ files, and prose.md splits one concept across two files
  • Locality: bin/loop_claude/project/records.py:11 HUMAN_RULE_NAMES: what the judge reads depends on the files in two folders, and QUOTE_SOURCES slices the tuple to word it
  • Overall, Shape: bin/shell_command.py:20 simple_commands: shell_reads drops its own lexer for a shared module, at the cost of denser regexes
  • Shape: bin/rule_hook/rules.py:99 commits: git argument parsing sits in a module named for the rule registry
  • Self-sufficiency: bin/rule_hook/main.py:1 module docstring: each rule carries its own text and --help is generated from it
  • Navigation: CLAUDE.md:36 "Topic rules": a router to rules/, and the standards are a third home for instructions, balanced by README's rule-hook entry

Inherited architect, decided by:

  • Navigation, Locality: CLAUDE.md:21 "Prose": each priority is split between CLAUDE.md and skills/larv-review/standards/prose.md, and nothing in CLAUDE.md points to the second
  • Navigation: agents/prose-reviewer.md:9 "The bar": the bar is a three-way split, the worst place to go from a flag to the rule that fired
  • Locality: bin/loop_claude/project/records.py:10 HUMAN_RULE_DIRS: the judge globs one skill's internal folder, and moving it silently empties the records
  • Locality: bin/loop_claude/cycle/prompts.py:5 QUOTE_SOURCES: a tuple sliced with [:-1] and [-1] to place an "or", worked out across two modules
  • Locality, Shape: bin/shell_command.py:20 simple_commands: lexing moved out of shell_reads into a shared module, the change's clearest gain
  • Shape: bin/rule_hook/rules.py:108 git_subcommand: git command parsing sits in rules.py while git.py only runs git
  • Navigation: README.md:75 "Tools": the new tool is easy to find cold, and --help renders each rule
  • Locality: bin/rule_hook/override_log.py:96 print_overrides: a three-level conditional expression, and "this chunk" needs reflog semantics

Maintainability senior, decided by:

  • Navigation, Locality: skills/larv-review/standards/prose.md:3 "Prose, in detail": it expands CLAUDE.md's priorities by number, so it reads only with CLAUDE.md open, and a change to a priority edits two files
  • Navigation: CLAUDE.md:36 "Topic rules": the router lists only rules/, so finding where comments or "A false claim is a bug" live needs README line 3 or the Vocabulary
  • Locality: skills/larv-review/standards/quality.md:7 "Quality": each standard points at two or three other files, and CLAUDE.md:50 paraphrases the README rule without pointing to it
  • Locality: bin/loop_claude/project/records.py:9 HUMAN_RULE_NAMES: a derived tuple sliced by position feeds three prompts, and the folder list must match hand-kept copies in CLAUDE.md and AGENTS.md
  • Locality: bin/shell_command.py:31 segments: reading-cost and rule-hook share one parser, so a fix for the hook moves the reading-cost figures
  • Navigation: bin/rule_hook/main.py:1 module docstring: from a blocked commit to the rule is easy through --help and RULES

Junior A, decided by:

  • Navigation: CLAUDE.md:36 "Topic rules": the moved rules are not routed from here, and nothing in CLAUDE.md points to standards/quality.md
  • Navigation: skills/larv-review/standards/prose.md:3 "Prose, in detail": one rule lives in two files, and a reader must know the second exists
  • Navigation: agents/prose-reviewer.md:9 "The bar": working out which documents bind a review takes a small search

Junior A, hardest first:

  • skills/larv-review/SKILL.md:64 "Round cap": with "Re-entry" and "Fresh", four sections held at once to count a round
  • bin/larv_review/record.py:14 record_ruling: four exits, its terms defined in three other files
  • bin/rule_hook/override_log.py:36 this_chunks: reflog semantics, and a three-way conditional at :96
  • bin/shell_command.py:31 segments: dense regexes and a redirect flag, output unpredictable by reading
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: the judge's prompt assembled from three files
  • bin/larv_review/plan.py:8 scoring_run_due: set arithmetic over four inputs

Mid A, hardest first:

  • bin/larv_review/record.py:14 record_ruling: four outcomes, the counting rule only in the help
  • skills/larv-review/SKILL.md:64 "Round cap": interlocking with "Re-entry" and "Fresh"
  • bin/loop_claude/cycle/judge.py:127 run_judge: two mismatches handled two ways; QUOTE_SOURCES slices a tuple
  • bin/loop_claude/cycle/states.py:69 transition: a counter threaded through three states
  • bin/rule_hook/override_log.py:86 print_overrides: three chained conditionals
  • bin/larv_review/ruling_base.py:4 measured_commit: rests on the docstring and the help

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:91 "Architecture": six conditions held at once, and the no-rescore file list only in prose
  • bin/larv_review/record.py:14 record_ruling: five modules open at once
  • bin/larv_review/ruling_base.py:4 measured_commit: why same does not move the base, on a second read
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: what the judge accepts spans three files nothing checks agree
  • bin/rule_hook/override_log.py:36 this_chunks: reflog membership; two default_branch functions differ
  • bin/rank_todo.py:374 rank_details: regex surgery on markdown

Inherited architect, would restructure first:

  • bin/loop_claude/project/records.py:16 read_records: a missing rule folder is skipped silently
  • bin/rule_hook/override_log.py:110 default_branch: a second default-branch rule, unlike larv-review's
  • bin/loop_claude/loop/main.py:16 module docstring: --help restates the retry constants as prose
  • bin/larv_review/rounds.py:4 PASSES: the round cap and rescores live in the skill's prose
  • bin/comprehension_history.py:42 Entry: one name over five concepts across the repo

2026-10-13T05:52:26Z, PR #245 at f6d5ea7, against 4cc9953

Ruling: worse

Fell: Shape. Under the floor of 7.0: Shape 6.75, so the same ruling counts as worse.

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse same same
Inherited architect same worse worse same worse
Maintainability senior same worse same same same
Junior A better same worse same same
Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 7 6 6.5
Mid A 7.5 6.5 7 6.5 7
Maintainability senior 7.5 7 6.5 6.5 7
Inherited architect 7 6.5 6.5 7.5 7
Mean 7.25 6.63 6.75 6.63 6.88

Mid A, decided by:

  • Shape: bin/rule_hook/rules.py:108 git_subcommand: a module named for the rule catalogue also parses git arguments, override markers and verdicts
  • Shape: bin/rule_hook/override_log.py:96 print_overrides: three chained conditional expressions decide whether the reflog is readable
  • Shape: bin/rule_hook/rules.py:73 Verdict: two unrelated Verdict types, and logged, existing and holds do not say what they compute
  • Shape: bin/loop_claude/project/records.py:11 HUMAN_RULE_NAMES: a nested comprehension where one constant stood, though either keeps the prompt readable
  • Shape: bin/shell_command.py:20 simple_commands: a flat shell_reads over a denser shared lexer, a small net change

Inherited architect, decided by:

  • Shape: bin/rule_hook/rules.py:108 git_subcommand: rules.py mixes six jobs while git.py only runs git, and reading_cost/measure.py:9 COMMIT is a second commit check
  • Locality: CLAUDE.md:21 "Prose": the worker's core and skills/larv-review/standards/prose.md are two copies that word the contrastive tail differently
  • Locality: bin/loop_claude/project/records.py:10 HUMAN_RULE_DIRS: the judge hard-codes larv-review's folder, and a test imports the constant back out
  • Locality, Shape: bin/rule_hook/override_log.py:86 print_overrides: a three-deep conditional, reflog semantics in a docstring, and the git-dir lookup done again
  • Shape: bin/rule_hook/main.py:82 answer: a two-phase pass and an unnamed 3-tuple from breaches_of
  • Locality, Shape: skills/larv-review/SKILL.md:56 "Opt-out": a third skip mechanism, three sections held at once

Maintainability senior, decided by:

  • Locality: CLAUDE.md:21 "Prose": the prose rules exist twice, and CLAUDE.md:30 words the contrastive tail differently from skills/larv-review/standards/prose.md:13
  • Locality: rules/decisions.md:9 "Decisions": the decision rule is split between a worker file and skills/larv-review/standards/comments.md:9 "Where a choice goes"
  • Locality: bin/rule_hook/override_log.py:110 default_branch: a second default-branch rule and git runner, unlike larv-review's
  • Locality: bin/loop_claude/project/records.py:10 HUMAN_RULE_DIRS: one folder list feeds the judge, the quote sources and a test, and loop/main.py spells it out by hand
  • Locality: bin/rank_todo.py:114 check_failures: copies the read, rank and compare flow main still runs
  • Locality: bin/rule_hook/rules.py:99 commits: computed on two paths for one command

Junior A, decided by:

  • Navigation: CLAUDE.md:38 "Topic rules": a short router to one small file per topic
  • Navigation: README.md:75 "Tools": names rule-hook and what runs it
  • Shape: bin/rule_hook/rules.py:108 git_subcommand: the rule table's file also parses git arguments, Dockerfiles and ignore files
  • Shape: bin/rule_hook/override_log.py:96 print_overrides: three failure cases in one chained conditional
  • Shape: bin/rule_hook/main.py:38 imports: the entry point pulls from six modules
  • Navigation: bin/shell_command.py:20 simple_commands: shell tokenizing has one home

Junior A, hardest first:

  • bin/larv_review/record.py:14 record_ruling: five files held at once, four outcomes
  • bin/rule_hook/override_log.py:36 this_chunks: reflog semantics and a three-level conditional at :96
  • skills/larv-review/SKILL.md:64 "Round cap": rules pointing at each other, exceptions on exceptions
  • bin/loop_claude/cycle/judge.py:127 run_judge: two quote checks with different tolerance
  • bin/shell_command.py:31 segments: heredoc and comment regexes and a redirect flag at once
  • bin/larv_review/plan.py:8 scoring_run_due: plan before and after, shipped IDs and tag state

Mid A, hardest first:

  • skills/larv-review/SKILL.md:64 "Round cap": a dozen interlocking conditions simulated in the head
  • bin/larv_review/record.py:14 record_ruling: branch order carries meaning, terms defined only in the skills
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: the prompt assembled from three files
  • bin/comprehension_history.py:110 seat_places: a parser with a flag reset by any unindented line
  • bin/rule_hook/override_log.py:86 print_overrides: reflog semantics and a chained conditional
  • bin/shell_command.py:31 segments: regex-heavy, no inline samples

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:29 "Passes": a rule engine in prose, its mechanised half unmarked
  • bin/larv_review/record.py:14 record_ruling: four exits over two parallel vote maps
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: the judge's contract built across three files
  • bin/rule_hook/override_log.py:86 print_overrides: reflog membership and a three-level conditional
  • bin/shell_command.py:31 segments: five concerns in one pass, two tools depend on it
  • bin/transcript_archive/write.py:13 archive: one invariant held across three files

Inherited architect, would restructure first:

  • bin/larv_review/rounds.py:8 round_counts: the round cap is enforced only by prose across five places
  • bin/larv_review/git.py:21 default_branch: one of two default-branch rules and five git runners
  • bin/loop_claude/loop/main.py:8 module docstring: the rule-folder list hand-written in four places
  • bin/rule_hook/rules.py:73 Verdict: one name over three concepts, like Entry and ruling
  • bin/rule_hook/rules.py:108 git_subcommand: a second commit detector beside reading_cost/measure.py:9 COMMIT

2026-10-13T06:49:43Z, PR #245 at a796bb3, against 4cc9953

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same same same same
Inherited architect same worse better same same

Mid A, decided by:

  • Locality: bin/git_command.py:16 commits: one shared parser replaces reading-cost's lexer and regex, at the cost of a parser shared with rule-hook
  • Locality, Self-sufficiency: skills/larv-review/standards/prose.md:3 "Prose": a full copy beside CLAUDE.md's core, against small single-topic files
  • Navigation: CLAUDE.md:38 "Topic rules": three homes for a rule, all listed in the README map
  • Shape: bin/rule_hook/git.py:11 git: a bounded package, but rule_hook/git.py beside git_command.py and some vague names

Inherited architect, decided by:

  • Locality: CLAUDE.md:21 "Prose": two spellings of the prose rules, already worded differently
  • Locality: agents/prose-reviewer.md:9 "The bar": the bar is assembled from three sources and path globs
  • Locality: bin/loop_claude/project/records.py:16 read_records: any file added to the rule folders lengthens the judge's records
  • Locality: bin/rule_hook/override_log.py:36 this_chunks: reflog, default branch and logged branch held at once
  • Shape: bin/reading_cost/measure.py:43 commit_time: reading-cost and rule-hook share one parser, one concept with one implementation
  • Shape: bin/rank_todo.py:114 check_failures: --check pulled out so rule-hook reuses it

2026-10-13T09:29:12Z, PR #254 at 2284780, against 4cc9953

Ruling: worse

Fell: Locality. Under the floor of 7.0: Locality 6.50, so the same ruling counts as worse.

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse same same same
Inherited architect same worse same same same
Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6.5 6.5 6.5 6.5
Mid A 7.5 7 7 6.5 7
Maintainability senior 7.5 6.5 6.5 7 7
Inherited architect 7 6 6 6.5 6.5
Mean 7.25 6.50 6.50 6.63 6.75

Mid A, decided by:

  • Locality: bin/todo_table.py:62 parse_row: a C-less row gets a blank cell spliced in by position, and whether a table without C is valid is decided in three files that disagree on purpose
  • Locality: bin/loop_claude/project/records.py:9 HUMAN_RULE_DIRS: the judge's rule-file text is now built from tuples across three modules and an unnamed repo check
  • Locality: bin/rule_hook/override_log.py:118 default_branch: reuses the name of larv_review/git.py's default_branch with a different contract

Inherited architect, decided by:

  • Locality: bin/score_outcomes/outcomes.py:6 round_findings: the round-commit title is a contract held in SKILL.md prose, ROUND and FINDINGS; a slightly different title silently reads as findings unknown
  • Locality: bin/todo_table.py:62 parse_row: the rule for the pre-C table is spread over todo_table, rank_todo and larv_review/plan, which disagree on purpose
  • Locality: bin/rule_hook/override_log.py:36 this_chunks: which overrides belong to the chunk depends on reflog and ancestry state the code does not hold
  • Locality, Shape: bin/score_outcomes/main.py:41 imports: one tool reaches into another tool's package for its git helpers

Junior A, hardest first:

  • bin/score_outcomes/outcomes.py:42 guesses: a second todo-table parser beside todo_table.items
  • bin/larv_review/git.py:8 git: one of four look-alike git wrappers with different contracts

Mid A, hardest first:

  • bin/score_outcomes/outcomes.py:9 FINDINGS: round titles parsed in rounds.py, here and prose in SKILL.md
  • bin/score_outcomes/outcomes.py:21 Outcome: one of three unrelated Outcomes

Maintainability senior, hardest first:

  • bin/score_outcomes/outcomes.py:42 guesses: a third items-table parser with its own cell splitter
  • bin/score_outcomes/main.py:93 measure: decisions threaded between git calls

Inherited architect, would restructure first:

  • bin/score_outcomes/outcomes.py:9 FINDINGS: the round-title grammar lives in SKILL.md, ROUND and here
  • bin/larv_review/git.py:21 default_branch: one of two default_branchs and five git runners

2026-10-13T10:03:42Z, PR #254 at 5b6c497, against 4cc9953

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse same same
Inherited architect same worse same same same

Mid A, decided by:

  • Shape: bin/git_repo.py:8 git: four modules carry "git" in their path, and two define a git with different signatures
  • Shape: bin/todo_table.py:30 items: one name now covers three outcomes and two header shapes, each caller reading None differently

Inherited architect, decided by:

  • Locality: bin/todo_table.py:30 items: accepts a table without C that rank_todo.py read_scoring rejects, and render_item relies on that rejection having run first
  • Locality: bin/larv_review/plan.py:46 plan_reasons: items(before) or [] turns None into an empty list and relies on a Failure being truthy
  • Locality: bin/loop_claude/project/records.py:10 HUMAN_RULE_DIRS: the judge reads every file in two folders, shrinking the transcript it sees
  • Locality: bin/loop_claude/cycle/judge.py:41 JUDGE_RULES: the judge's rule text is built across three files
  • Locality: bin/rule_hook/override_log.py:36 this_chunks: which overrides list depends on reflog, branch name and default-branch state

2026-10-13T10:23:39Z, PR #255 at 459df0a, against 4cc9953

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect same better same worse better

Mid A, decided by:

  • Locality, Overall: skills/larv-review/SKILL.md:99 "Comprehension check": the check is one self-contained subsection that runs once in §5 and blocks nothing; at 4cc9953 Ratchet, Floor, Fell, Fresh, Rescore and the round cap referred to each other
  • Locality: bin/larv_review/record.py:14 record_ruling: one straight path now; at 4cc9953 it branched four ways on a fall and a scores file, with read_fall_scores, refuse_recorded and fall_ruling to follow
  • Locality: bin/reading_cost/measure.py:43 commit_time: finds the worker's first commit through the shared git_command.commits parser rule-hook uses, in place of its own regex and tokenizer

Inherited architect, decided by:

  • Locality, Overall: skills/larv-review/SKILL.md:99 "Comprehension check": runs once, blocks nothing, under its own heading; at 4cc9953 it forced cross-references into Round cap, Later rounds and No rerun
  • Locality: bin/larv_review/record.py:14 record_ruling: reads one votes file and appends one ruling; at 4cc9953 a two-call state machine with Fell: and a second file
  • Locality: bin/reading_cost/measure.py:43 commit_time: one parse of a command shared with rule-hook, in place of a regex and a separate lexer
  • Self-sufficiency: bin/larv_review/ruling_base.py:7 measured_commit: the docstring still calls the base the ratchet's base and speaks of falls nothing in the code defines
  • Self-sufficiency: bin/comprehension_history.py:43 Entry: docstrings and the places help describe the scores a fall called into a ruling, which needs the project's history open to parse
  • Self-sufficiency: AGENTS.md:5 decision titles: one says a project under the floor is fixed at the lowest dimension, others that the check blocks nothing, so a reader cannot tell whether Floor: means stop
  • Self-sufficiency: skills/larv-review/standards/quality.md:6 quality bar: points at §3 "Architecture" for the comprehension check, which now has its own subsection
  • Locality: bin/rule_hook/override_log.py:118 local_default_branch: a second default-branch resolver beside bin/git_repo.py:21 default_branch, neither naming the other

2026-10-13T14:48:28Z, PR #255 at a12b685, against 4cc9953

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect same better same same better

Mid A, decided by:

  • Locality, Overall: skills/larv-review/SKILL.md:101 "Comprehension check": runs once in §5, reports no findings and blocks nothing; at 4cc9953 "Fresh" tied it into the passes, and "Round cap", "Re-entry" and "Suspended" pointed back to it
  • Locality, Overall: bin/larv_review/record.py:14 record_ruling: parse, count, split or rule, append; at 4cc9953 it branched on the scores file and a fall, through read_fall_scores and fall_ruling in three modules
  • Locality: bin/larv_review/ruling_base.py:4 measured_commit: the newest change adding any entry reads on its own; at 4cc9953 base depended on a better ruling, heading times and a first_ruling fallback
  • Locality: bin/reading_cost/shell_reads.py:21 shell_reads: shell parsing moved to bin/shell_command.py:20 simple_commands, shared with rule-hook

Inherited architect, decided by:

  • Locality, Overall: bin/larv_review/record.py:14 record_ruling: runs in a straight line with no mode flag on read_seats; at 4cc9953 four branches on a fall and a scores file
  • Locality, Overall: bin/larv_review/ruling_base.py:4 measured_commit: one loop, and show_ruling_base no longer reads the history; at 4cc9953 a two-step lookup through first_ruling
  • Locality, Overall: skills/larv-review/SKILL.md:101 "Comprehension check": runs once, blocks nothing, no pass; at 4cc9953 "Fresh" made a prose fix in §3 change what §5 must do
  • Locality: bin/comprehension_history.py:126 worse_votes: recovers votes by re-parsing table rows by cell count, relying on the votes table coming first, which matters only for legacy rulings
  • Locality: bin/rule_hook/git.py:11 git: same name as bin/git_repo.py:8 git with a different contract, beside two more git-named units

2026-10-13T15:24:20Z, PR #257 at d471377

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6 6 6
Mid A 7 7 6.5 6.5 6.5
Maintainability senior 7 6.5 6.5 7.5 7
Inherited architect 7 7 6 6.5 6.5
Mean 7.00 6.63 6.25 6.63 6.50

Junior A, hardest first:

  • skills/larv-review/SKILL.md:63 "Round cap" and :74 "Re-entry": seven interlocking rules on reruns, caps and exceptions, each pointing elsewhere; what a fix to a stability 🟡 that touches a comment reruns stayed unclear
  • bin/comprehension_history.py:106 latest_places: a 70-word docstring, an index rule resting on a pre-PR #255 history quirk, and worse_votes keeping the first row by setdefault
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES and :127 run_judge: behaviour in a prose prompt, and three text normalisations held at once
  • bin/rule_hook/override_log.py:36 this_chunks: reflog and branch-name rules that need git knowledge
  • bin/shell_command.py:31 segments: dense regexes and a second lexing path for unbalanced quotes
  • bin/loop_claude/cycle/states.py:69 transition: the quoted-answers counter threads through three states
  • bin/larv_review/plan.py:9 scoring_run_due: "landed", "next release" and "emptied" mix two plans
  • bin/transcript_archive/write.py:13 archive: three invariants on folder naming and write order

Mid A, hardest first:

  • skills/larv-review/SKILL.md:63 "Round cap": about 30 interlocking rules across the trigger table, the fix clauses, the cap and later rounds; only the count is enforced in code
  • bin/comprehension_history.py:106 latest_places: parses its own markdown by label regexes, resting on table order and a legacy case
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: the prompt is assembled from constants in three modules
  • bin/rule_hook/override_log.py:36 this_chunks: reflog semantics trusted, not verifiable by reading
  • bin/shell_command.py:31 segments: a hand-rolled tokenizer two unrelated tools depend on
  • bin/larv_review/ruling.py:8 votes: the vote-counting rule spread over four modules and an 80-line help, with a ruling decision inside a parser
  • bin/rank_todo.py:378 rank_details: regex split and string splicing whose newline round-trip needs running to trust
  • bin/transcript_archive/write.py:13 archive: the why lives in loop_claude/loop/main.py's docstring

Maintainability senior, hardest first:

  • skills/larv-review/SKILL.md:63 "Round cap" and :74 "Re-entry": a state machine written as prose, re-derived on each read
  • bin/comprehension_history.py:106 latest_places: dense comprehensions, a seat name recovered by splitting a label, and table-order dependence
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES and :127 run_judge: one prompt spliced from three files, and two misquotes treated differently
  • bin/rule_hook/override_log.py:36 this_chunks: four branches over reflog behaviour
  • bin/reading_cost/measure.py:27 measure: timestamps compared as strings with the format assumption unstated
  • bin/rule_hook/rules.py:49 OVERRIDE: a lazy reason with a lookahead and a suffix strip, explained nowhere in the code
  • bin/larv_review/plan.py:9 scoring_run_due: the "work has landed" rule, written three times
  • bin/loop_claude/loop/reload.py:50 exec_if_edited: editing any bin/**/*.py re-execs a running loop

Inherited architect, would restructure first:

  • bin/round_titles.py:5 PASSES: repeats the pass table at skills/larv-review/SKILL.md:33 with no check tying them, and omits the auto-reviewer
  • skills/larv-review/SKILL.md:71 "Cap": the round cap is prose; no code stops a fourth round, so the 3am path takes 20 to 40 minutes
  • bin/git_repo.py:8 git: one of five git runners with four signatures
  • bin/larv_review/git.py:6 history_changes: a module named git that holds history logic
  • bin/reading_cost/measure.py:16 Reading: "places" also names comprehension places, and "record" and "outcome" each carry three meanings
  • bin/loop_claude/cycle/judge.py:16 JUDGE_RULES: says "the agent" where the code says "worker", and restates the working loop unchecked
  • bin/loop_claude/loop/reload.py:38 fingerprint: covers every bin/**/*.py, so editing statusline.py reloads the loop

2026-10-14T21:34:44Z, PR #262 at f52228d, against e17168e

Ruling: worse

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A worse worse worse same worse
Inherited architect worse worse worse same worse

Mid A, decided by:

  • Locality, Overall: bin/loop_claude/routing.py:10 ROUTED: a chunk's rung survives a rerun only as prose that Rung.__str__ and Route.__str__ write and a regex in another package parses back; rewording one string, or a new outcome kind, silently breaks resume three files away
  • Locality, Shape: bin/loop_claude/loop/main.py:164 routed: run_loop now threads a Route through LoopRun with two lazy lambdas, and following one step-up means holding stepped, the judge's bundled, after_verdict and archive_step together
  • Locality: bin/loop_claude/loop/reload.py:41 decoded_as: the flat key and type check became a recursive decoder, and the comment above LoopRun still says a field change stops a running loop
  • Navigation: bin/model_routing/ladder.py:1 LADDER: routing is split across two modules named for routing plus five helpers in main.py, and README → Tools still says bin/'s shared modules serve more than one tool
  • Shape: bin/loop_claude/cycle/judge.py:54 Reply.bundled: the name says neither R + C nor highest, and kept and routed make a reader open their bodies

Inherited architect, decided by:

  • Locality, Navigation: bin/loop_claude/routing.py:10 ROUTED: a string contract spread over four files, Rung.__str__, Route.__str__, NAMES_A_WORKER and the regex; a reword makes route_from return None and the chunk routes afresh with no error
  • Shape, Navigation: bin/loop_claude/loop/main.py:129 run_loop: once a flat sequence, it now threads an anchor, a route, a before and after pair and two lambdas, and its imports grew from 13 modules to 21
  • Shape: bin/loop_claude/loop/main.py:180 archive_step: archive is a function and a Path, and project_archive a function and a parameter, a few lines apart
  • Locality, Shape: bin/loop_claude/loop/reload.py:41 decoded_as: a recursive decoder with a sentinel, and the comment above LoopRun half-contradicts the one inside it
  • Shape: bin/loop_claude/routing.py:59 stepped: does two jobs, raising to a bundled item's rung and counting towards a one-rung step, and its name covers only the second

2026-10-14T22:22:01Z, PR #264 at 17e1ebe, against 8f7b0c5

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse same same same
Inherited architect same worse same same same

Mid A, decided by:

  • Locality: bin/loop_claude/cycle/prompts.py:27 off_the_projects_rung: the prompt text now depends on how the worker's rung compares with the project's through highest, and why a chunk with no item needs no note rests on first_route in another module
  • Locality: bin/loop_claude/routing.py:54 kept and :59 stepped: the two now use different floors, so confirming a route below the project's rung survives a reload means checking routed in loop/main.py against both
  • Locality: bin/loop_claude/cycle/run.py:36 Cycle.anchor: a second rung travels beside route into every prompt call, each with its None case

Inherited architect, decided by:

  • Locality: CLAUDE.md:55 "Working with the codebase": which model a subagent gets now spans this prose rule, prompts.py's off_the_projects_rung and ladder.py's Rung.agent_args; that reviewers above the project's rung inherit the worker's rung is said in neither file
  • Locality: bin/model_routing/ladder.py:16 Rung.agent_args: the family name comes from self.model.split('-')[1], tying the ladder's ids to the Agent tool's vocabulary with nothing checking it
  • Locality: bin/loop_claude/routing.py:54 kept and :59 stepped: whether a rerun resumes now depends on the R + C the archived route line holds, and the order of the checks is more to hold

2026-10-14T23:10:29Z, PR #265 at ac41116, against 8bc0d88

Ruling: worse

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse worse same worse
Inherited architect worse worse worse worse worse

Mid A, decided by:

  • Locality: bin/loop_claude/loop/main.py:186 run_loop: every cycle now ends with a cross-project check that counts every project's cycles, takes a lock and may hand the terminal to a claude in ~/.claude, so the loop no longer reads alone
  • Locality: bin/loop_claude/loop/routing_check.py:26 new_calls and bin/routing_figures/archive.py:59 last_measured: whether a measurement is due is read back by regex from the markdown render writes, so rewording it silently breaks due; the raised-calls file's lifecycle ends in a manual rule in AGENTS.md
  • Locality: bin/routing_figures/measure.py:130 spend: repeats reading_cost/measure.py tokens_in's dedupe-by-message rule, adding output tokens, so a counting change has two places to land
  • Shape: bin/routing_figures/measure.py:74 measured: dense single expressions building Reports and a six-argument ChunkFigures, and nested comprehensions in render
  • Shape: bin/routing_figures/measure.py:43 Reports: searches holds characters of tool results, not a count of searches; generic names calls, due, add, totals, kept

Inherited architect, decided by:

  • Locality, Self-sufficiency: bin/loop_claude/loop/routing_check.py:46 raise_calls: how a routing call is raised, deduplicated and retired is split across the code, the prompt and a working rule in AGENTS.md about cited stamps and a hand-appended Reset
  • Locality: bin/routing_figures/measure.py:193 calls and bin/routing_figures/archive.py:124 raised: a call's identity is its English sentence, and the measured cycle is read back from rendered markdown, so the report's prose is load-bearing state
  • Locality: bin/loop_claude/loop/main.py:186 run_loop: each project's loop now runs a cross-project step holding a lock and scanning the whole archive, so one loop depends on what other loops wrote
  • Shape: bin/routing_figures/measure.py:74 measured: one 234-line module holds six concerns, and measured, Measured and measure_archive sit side by side; kept and calls each name two things
  • Navigation: bin/model_routing/route.py:11 Route: moved out of loop_claude while still carrying loop-only state, so "routing" now spans five places
  • Self-sufficiency: bin/routing_figures/measure.py:130 spend: the docstring says it counts as tokens_in does, but it adds output tokens

2026-10-15T07:36:58Z, PR #266 at 6cc3ded, against 8412a48

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect better same same same better

Mid A, decided by:

  • Locality: bin/transcript_archive/location.py:9 FILE_SUFFIX, with outcomes_of and transcript_of: the one place that maps a transcript copy to its outcomes file and back, where the base wrote the suffix and the inverse step out in write.py, read.py and routing_figures/archive.py
  • Locality: bin/transcript_archive/read.py:31 archived_outcomes and chunk_outcomes: replace the raw globs routing_figures made, so it no longer knows the archive's folder depth
  • Locality: bin/transcript_archive/outcomes.py:6 TASK, INTERRUPTED, ANSWERED, TASK_AT, ANY_VERDICT_AT: writer and readers share one set of constants, so the outcomes format reads and changes in one file
  • Locality: bin/loop_claude/routing.py:36 item_rung: kept and judge_rung share one named helper where the base held the rule in an inline conditional
  • Locality: bin/loop_claude/cycle/judge.py:127 judge_once and judge_args: one judge run and its flags stand alone, so the replay reuses them without copying

Inherited architect, decided by:

  • Navigation, Overall: bin/transcript_archive/outcomes.py:22 JUDGE, interrupted, answered: each archived verdict carries a Judge: line, so a reader paged about a wrong ruling reads which rung judged it from the outcomes file
  • Navigation, Locality, Overall: bin/transcript_archive/location.py:9 FILE_SUFFIX, outcomes_of, transcript_of, with bin/transcript_archive/read.py:31 archived_outcomes: the archive layout lives in one module, though archived_outcomes still derives the key from path.parent.parent
  • Locality: bin/judge_replay/main.py:124 first_reply: re-implements the loop's retry count beside retried, two places that can drift
  • Locality: bin/project_key.py:9 checkout_of: a guessing inverse of project_key that maps a project archived from /x to ~/code/x when that folder exists, silently
  • Shape: bin/judge_replay/main.py:31 imports: one launcher reaching into five loop_claude internals, balanced by judge, judge_once and judge_args in bin/loop_claude/cycle/judge.py:123 now three units with truthful names
  • Locality: bin/loop_claude/routing.py:51 judge_rung: derives its own anchor from the judge model while Cycle.anchor is the worker's, so "anchor" means two rungs in one cycle when the models differ
  • Self-sufficiency: bin/loop_claude/routing.py:54 judge_rung docstring: points into the plan at item 136, and JUDGE_REPLAYED and REFERENCE_EFFORT rest on a past replay and a past settings value the code cannot show

2026-10-15T14:08:19Z, PR #273 at f13447f, against b281392

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same better same same
Inherited architect same worse same same same

Mid A, decided by:

  • Shape: bin/model_routing/ladder.py:52 floored: names the rule "the rung R + C picks, never below the project's rung" beside picked, for two callers, where the base built it inline in judge_rung from highest and item_rung

Inherited architect, decided by:

  • Locality: rules/todo-items.md:9 "Plan only on the project's rung or above": the planning rule spans the rule file, CLAUDE.md:55, bin/subagent_rung/main.py's help and ladder.floored, with no one file holding it whole
  • Locality: bin/loop_claude/cycle/prompts.py:34 off_the_projects_rung: the prompt spells out another tool's command line, subagent-rung --plan, with nothing tying the two, and its docstring points to routing.first_route in another module
  • Locality: bin/loop_claude/routing.py:61 judge_rung: reads in one line and drops the two-way reference with item_rung, but writes the no-item branch a second time
  • Shape, Self-sufficiency: bin/model_routing/ladder.py:52 floored: a truthfully named helper, offset by bin/subagent_rung/main.py:23 agent_args's boolean planning and position-sensitive --plan parsing

2026-10-15T14:39:39Z, PR #274 at 1431cc6, against 2190ec8

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same same worse same
Inherited architect same worse worse worse worse
Maintainability senior same worse same worse worse
Junior A same same same worse same

Mid A, decided by:

  • Self-sufficiency: bin/routing_figures/measure.py:106 escalations: the figures count escalations by a bare trigger number, and only the prose list in CLAUDE.md says what each number is
  • Self-sufficiency: bin/loop_claude/routing.py:43 escalation_rungs: the docstring explains the cap by naming who set it, a reason only to someone who knows the decision

Inherited architect, decided by:

  • Locality: bin/loop_claude/cycle/prompts.py:44 escalation: the marker's <n>: format is typed in the prompt and again in measure.py's regex, and a mismatch makes the figures print None with no error
  • Locality: bin/loop_claude/routing.py:43 escalation_rungs: the upper bound counts from item_rung and the lower from route.rung, so a step-up shrinks or empties the window, explained only by naming who set it
  • Locality, Shape: bin/loop_claude/cycle/prompts.py:46 escalation: the past-the-cap branch is a third case the docstring omits, and prompts.py now imports policy from loop_claude.routing
  • Shape: bin/model_routing/route.py:8 ESCALATION_MARKER: the module is about a chunk's Route as archived, but the marker belongs to the subagent-prompt contract
  • Shape, Self-sufficiency: CLAUDE.md:60 "Working with the codebase": "escalation" already named the reviewer-to-reviewer 🔀 handoff in skills/larv-review/SKILL.md:80, and now also names handing a task one rung up
  • Self-sufficiency: bin/routing_figures/measure.py:258 triggers: routing-figures.md prints trigger 2: 3, and no code names what each number means

Maintainability senior, decided by:

  • Locality: bin/loop_claude/cycle/prompts.py:40 escalation: when the sentence appears is split between its own top-rung guard and escalation_rungs's empty slice in another module
  • Locality: bin/loop_claude/cycle/prompts.py:19 fresh: one plain conditional became a nested one with an lstrip, and routed_by also appends the sentence, so both paths need tracing to rule out a double
  • Self-sufficiency, Locality: bin/routing_figures/measure.py:106 escalations: counts bare trigger numbers that only CLAUDE.md's numbered list defines
  • Self-sufficiency: bin/loop_claude/routing.py:43 escalation_rungs: the cap's base is explained by who set it, and the slice takes decoding

Junior A, decided by:

  • Self-sufficiency: bin/routing_figures/measure.py:23 ESCALATION: trigger numbers mean something only in CLAUDE.md:60's list, and renumbering it would silently change old figures
  • Self-sufficiency, Shape: CLAUDE.md:60 "Working with the codebase": "trigger" now names an escalation condition as well as the review-pass condition Vocabulary defines
  • Self-sufficiency, Locality: bin/loop_claude/cycle/prompts.py:40 escalation: the past-the-cap branch is missing from the docstring, and the off-ladder guard differs from escalation_rungs's

2026-10-15T19:39:18Z, PR #276 at f643a14, against eb23048

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse worse same worse
Inherited architect same same worse better same
Maintainability senior same same worse same same
Junior A same same worse same same

Mid A, decided by:

  • Shape, Locality: bin/rung_replay/search.py:44 replayed: generic over Case, Item and Reply with a reproduced callback returning a list of items, worked through held, aim and got; for the judge the list is only [kind] or [], so the reader decodes an abstraction built for two consumers before following one
  • Locality: bin/judge_replay/replay.py:70 report: rebuilds the unreproduced verdicts by calling reproduced again on replay.on_reference, so it is right only while main.py passes that same function to replayed
  • Shape: bin/stability_replay/main.py:83 main: found names a Round, a set[int] and a list in one file, and one call packs the reference, the candidates, a closure over codes and an inline lambda
  • Shape: bin/rung_replay/command.py:14 project_rung_or_exit: returns Rung | int, the int an exit code, so each caller tests isinstance(anchor, int)

Inherited architect, decided by:

  • Shape: bin/rung_replay/search.py:44 replayed: generic over its type variables, so a reader works out what reproduced returns before the search reads; it was a concrete comparison of kinds
  • Shape: bin/judge_replay/replay.py:65 reproduced: returns a list of zero or one kinds where a yes or no would do, to fit the generic shape
  • Shape: bin/stability_replay/main.py:83 main: found is a Round in one lambda and a set[int] in the next, and an accumulator list elsewhere in the file
  • Self-sufficiency: bin/rung_replay/search.py:52 replayed: the docstring says why the search goes down from the highest rung and stops at the first miss, which the cheapest-first search assumed unsaid
  • Self-sufficiency: bin/stability_replay/main.py:120 code_of: says what it guesses and what a wrong guess costs, so no record is needed beside it

Maintainability senior, decided by:

  • Shape: bin/rung_replay/search.py:44 replayed: generic as Replay[Case, Item, Reply] with a reproduced callback returning a list, which judge-replay fits only with a list of one or none and stability-replay with an inline adapter; following one report line takes three files and the generics
  • Shape: bin/stability_replay/main.py:66 main: one file walks the archive, rebuilds the reviewed commits from two git logs, clones, reviews and matches, with long lines packing the replayed call, a nested conditional over first_reply and a starred conditional checkout command

Junior A, decided by:

  • Shape: bin/rung_replay/search.py:37 Replay: the search is generic over three type parameters with two callbacks and a label, so a reader works out what Item and Reply are for each caller before the loop makes sense
  • Shape: bin/judge_replay/replay.py:65 reproduced: returns [kind] or [] only to fit the generic shape, and report rebuilds the unreproduced list by calling it again
  • Shape: bin/rung_replay/command.py:1 command: the name says little, and the module mixes argument parsing, a models-file lookup, rung arithmetic and stderr exits

2026-10-15T20:33:16Z, PR #278 at 0f71e33, against ddb86cb

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same better better
Inherited architect same same worse better same
Maintainability senior same same worse better same
Junior A same same same better better

Mid A, decided by:

  • Locality: bin/loop_claude/routing.py:38 kept_rung: one rule now raises a route's rung to item_rung for both kept and stepped, where the base handled the off-ladder case in two places with two different targets
  • Locality, Self-sufficiency: bin/loop_claude/routing.py:55 escalation_cap: the escalation step and the prompt's offered rungs share one named cap, whose docstring gives the reason it counts from item_rung instead of naming who set it
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:149 run_judge: a docstring lists the three quotes, what each is checked against and what a misquote does, where the base had one comment covering only the quoted answer
  • Self-sufficiency: bin/loop_claude/routing.py:63 stepped: the docstring says why it takes the verdict's fields and not the verdict, an import cycle through prompts

Inherited architect, decided by:

  • Shape: bin/loop_claude/routing.py:63 stepped: the starting rung now takes three helper hops, taken_in, kept_rung, highest, where the base had two inline lines, and the off-ladder handling is said only in kept_rung's docstring
  • Shape: bin/loop_claude/routing.py:78 taken_in: used once, its name does not say what it returns, and kept(route, anchor) and kept_rung(anchor, route) take their arguments in different orders
  • Self-sufficiency: bin/loop_claude/routing.py:55 escalation_cap: the cap's reason is now in the code, and it is computed once for escalation_rungs and stepped
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:149 run_judge: the docstring lists all three quote checks and why no misquote but the evidence's is a failure, which answers the 3am question without opening anything else
  • Self-sufficiency: bin/loop_claude/routing.py:66 stepped: the docstring explains the import cycle that keeps the verdict type out of routing

Maintainability senior, decided by:

  • Self-sufficiency: bin/loop_claude/cycle/judge.py:149 run_judge: the docstring lists the three quote checks, what each is checked against and what a misquote does, where the base had one comment covering only the answer
  • Self-sufficiency: bin/loop_claude/routing.py:63 stepped: the docstring states the import cycle that keeps the verdict type out, and escalation_cap says why the cap counts from item_rung
  • Shape: bin/loop_claude/routing.py:11 ESCALATION_CAP: differs only in case from escalation_cap at :55, an int against a function returning a Rung, and its comment ends in a stray "yes,."
  • Shape: bin/loop_claude/routing.py:78 taken_in: stepped no longer reads top to bottom; it chases taken_in, kept_rung, item_rung and picked, and the off-ladder rule lives only in kept_rung's docstring

Junior A, decided by:

  • Self-sufficiency, Overall: bin/loop_claude/cycle/judge.py:149 run_judge: the docstring lists the three quote checks, how strictly each is checked and what a misquote does, where the base made the reader work out why grounded and verbatim differ
  • Self-sufficiency: bin/loop_claude/routing.py:55 escalation_cap: the limit is its own named function whose docstring says why it counts from item_rung, and stepped names counted_out and escalates

2026-10-15T21:39:57Z, PR #280 at 9af5ee7, against 545f3c3

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect same same worse same same
Maintainability senior same better same same same
Junior A same better same same better

Mid A, decided by:

  • Locality, Overall: bin/todo_table.py:64 items_table: reads the items table once and takes each cell by column name, where the base needed a second header constant that items, read_scoring and read_items each had to know
  • Locality, Overall: bin/todo_table.py:81 waiting: names the rule for skipping an item once, used by routed_item, where the base wrote it inline
  • Locality: bin/loop_claude/routing.py:84 judge_rung: calls item_rung, so the judge's and the worker's rung share one definition

Inherited architect, decided by:

  • Shape: bin/rank_todo.py:311 place: five parameters, recursion, a set rebuilt per call, and a name that hides that it also finds loops and prunes blocked_by
  • Locality: bin/rank_todo.py:194 rank: the rule that a blocker that left the table no longer counts is worked out here, in place and in todo_table.waiting
  • Locality: bin/rank_todo.py:274 read_items: the Blocked by checks are spread over parse_row, read_items, blockers_first and place
  • Locality, Shape: bin/todo_table.py:64 items_table: cells read by column name, with the C check beside the column, where the base split the header text by position
  • Locality: bin/loop_claude/routing.py:16 routed_item: asks the pure waiting, where the base leaned on an order rank_todo kept
  • Shape: bin/rank_todo.py:187 rank: the two-line header replacement keeps found.start right only because header and divider are two lines, and the module's fan-out grows past 25 functions

Maintainability senior, decided by:

  • Locality: bin/todo_table.py:107 parse_row: reads each cell by the column name in the table's own header, where the base found the table by exact header strings kept in mind across two modules
  • Locality: bin/rank_todo.py:247 read_items: the C and unknown-column checks sit where the table is read, where the base checked raw lines in the formula reader
  • Locality: bin/rank_todo.py:311 place: a partial offset; dropping a blocker that left the table happens in place, blockers_first and rank, and place threads five parameters
  • Locality: bin/loop_claude/routing.py:16 routed_item: defers to the named, order-free todo_table.waiting, where the base leaned on rank_todo's order

Junior A, decided by:

  • Locality, Overall: bin/todo_table.py:64 items_table: one function finds the table, checks repeated and missing columns, and rows are read by column name, where the base kept two header variants in step
  • Locality: bin/rank_todo.py:247 read_items: the table's shape checks sit where the table is read, where the base rejected a table in the scoring reader
  • Locality: bin/loop_claude/routing.py:16 routed_item: the waiting rule is one named function, todo_table.waiting
  • Locality: bin/loop_claude/routing.py:84 judge_rung: builds the judge's rung from item_rung, one definition fewer to keep in step
  • Locality: bin/rank_todo.py:311 place: the counterweight; a two-stage ranking with a five-parameter recursion, and the dropped-blocker rule written three times

2026-10-15T21:39:57Z, PR #280 at 9af5ee7

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6 6 6
Mid A 7 6.5 6.5 6 6.5
Maintainability senior 7 6 6 7 6.5
Inherited architect 7 7 6 7 6.5
Mean 7.00 6.38 6.13 6.50 6.38

Junior A, hardest first:

  • bin/loop_claude/routing.py:64 stepped: six one-line helpers held at once to learn the next cycle's rung, each docstring defined by the others
  • bin/loop_claude/cycle/prompts.py:40 escalation: the worker's prompt glued from space-led fragments over several cases, with no example of the final string
  • bin/comprehension_history.py:106 latest_places: hand-shaped markdown read back by regexes, an in-a-list flag and history from before PR #255
  • bin/loop_claude/cycle/judge.py:149 run_judge: three quote checks with three consequences, and a JUDGE_RULES prose wall built from constants in other modules
  • bin/transcript_archive/outcomes.py:53 workers: a chunk resumes its rung by regex-parsing archive prose, with the verdict strings repeated by hand
  • bin/routing_figures/measure.py:77 measured: timestamps cut to 19 characters, tools carried between iterations, totals into four counters
  • bin/stability_replay/rounds.py:70 reviewed_path: guesses a removed worktree from absolute paths with a first-prefix-gone rule
  • bin/rank_todo.py:311 place: recursive placement with a loop-detecting path and a placed set rebuilt per call

Mid A, hardest first:

  • bin/loop_claude/routing.py:64 stepped: five functions pick a rung from four reference points, and the why is a pointer to the decision log
  • bin/loop_claude/cycle/prompts.py:40 escalation: conditional f-string fragments relying on leading spaces and lstrip, output unknowable from the code
  • bin/transcript_archive/outcomes.py:53 workers: resume rests on a parsed Worker line, and NAMES_A_WORKER repeats the verdicts as literals
  • bin/comprehension_history.py:106 latest_places: a five-clause docstring, table-order dependence and an implicit line state machine
  • skills/larv-review/SKILL.md:63 "Round cap": the fourth-round rule lives in cross-referenced prose that no code enforces
  • bin/routing_figures/measure.py:77 measured: dense one-liners and a timestamp format assumed silently in rung_at
  • bin/rule_hook/override_log.py:36 this_chunks: which overrides belong to the chunk rests on reflog semantics
  • bin/rank_todo.py:311 place: recursive blocker placement with a loop-detecting path, resolved after one reread

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:64 stepped: seven functions over three inputs, and the never-down and two-above rules emerge only from their composition
  • bin/loop_claude/cycle/prompts.py:29 off_the_projects_rung: prompt fragments and rung arithmetic over three branches in each of three functions
  • bin/loop_claude/loop/main.py:1 "loop-claude --help": a 120-line contract, the only end-to-end routing story, with no pointers to the modules it maps onto
  • skills/larv-review/SKILL.md:63 "Round cap": which passes rerun after a fix spans the pass table, the fix clauses and the cap
  • bin/model_routing/ladder.py:19 Rung.__str__: the archive's rung format is written and parsed across four files, and a reworded string breaks resume
  • bin/routing_figures/measure.py:77 measured: tokens charged to the previous message's tools, and timestamps cut to compare with stamps
  • bin/shell_command.py:31 segments: a hand-rolled splitter whose words after a redirect target open a new segment
  • bin/comprehension_history.py:106 latest_places: a four-clause docstring, a seat name split from a label and a votes table assumed first

Inherited architect, would restructure first:

  • bin/round_titles.py:4 CAP: the round cap lives here for its regex's other readers, and no program enforces it; SKILL.md "Round cap" does in prose
  • bin/loop_claude/effects.py:18 Effects: the process shell, Stop and the models-file reader that three other tools reach into loop_claude for
  • bin/git_repo.py:8 git: one of seven ways to run git, alongside metric_bench/main.py:150, stability_replay/main.py:202 and reading_cost/main.py:114
  • bin/score_outcomes/outcomes.py:156 outcomes_of: shares its name and module name with transcript_archive's, with a different meaning
  • bin/loop_claude/routing.py:28 first_route: the parameter anchor means the project's rung, re-glossed in nearly every docstring
  • bin/model_routing/ladder.py:19 Rung.__str__: parsed back to resume routing, so a wording change silently re-routes chunks
  • bin/loop_claude/cycle/prompts.py:25 routed_by: the routing policy stated a third time, beside main.py's help and routing.py's logic

2026-10-16T02:11:33Z, PR #283 at 7570af6, against 9aa0d4b

Ruling: worse

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse same same worse
Inherited architect same worse worse same worse

Mid A, decided by:

  • Locality, Overall: bin/rank_todo.py:502 score: the score depends on the table's shape, branched on a string through goal_term, with the same old-versus-new check in notes, read_scoring and parse_item
  • Locality: bin/rank_todo.py:94 Scoring: weights means different things by shape, so a reader of scoring.weights must check scoring.shape first
  • Locality: bin/todo_table.py:17 Moves: an old-shape Goals cell is stored as moves with distance None, so score falls back with (by or 0), and parse_cited takes an unused id_

Inherited architect, decided by:

  • Locality: bin/rank_todo.py:502 score: reading one score needs the shape, decided elsewhere; weights holds two things by shape and (by or 0) holds only because parse_cited returns None moves
  • Locality, Shape: bin/rank_todo.py:301 unknown_columns: the old-shape path is checked at six sites across rank_todo.py with its own reader and writer in todo_table.py, and nothing ties them together for whoever retires it
  • Shape: bin/todo_table.py:16 Moves: the name lies for old-shape rows, and the goals cell is parsed by a callable stored on a dataclass
  • Locality: bin/todo_table.py:41 parse_moves: the rules for a Moves cell are split between parse_moves and rank_todo.py's parse_item

2026-10-16T05:16:12Z, PR #295 at 7ea23b1, against 1bff4ac

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same better better better
Inherited architect better same better same better

Mid A, decided by:

  • Shape, Overall: skills/larv-review/SKILL.md:36 Principles: the principles audit is a pass of its own, with its own row and trigger, so the exceptions the base needed for it are gone
  • Self-sufficiency, Shape: bin/model_routing/ladder.py:87 review_rung: the rule that a reviewer runs on the higher rung is named, where the base wrote highest inline twice
  • Self-sufficiency: bin/model_routing/ladder.py:42 Rung.parse: the spelling of a rung and its parser now sit beside __str__, where the base repeated the pattern in route.py
  • Locality: bin/rule_hook/reviewer_rung.py:11 REVIEWERS: a list read from the disk at import, a hidden dependency that pulls towards worse

Inherited architect, decided by:

  • Shape, Overall: skills/larv-review/SKILL.md:36 Principles: a pass of its own, with none of the base's exceptions to carry
  • Navigation: docs/decisions.md:239 routing: a chunk's worker runs on the rung its item picks…: the routing entry is split into titled entries, so a symptom leads to a heading
  • Shape: bin/model_routing/ladder.py:87 review_rung: one named rule that the worker's prompt and the hook share
  • Locality: bin/rule_hook/reviewer_rung.py:13 SEAT: the hook recognises a launch by a sentence in two markdown files, so rewording either turns the check off without a failure

2026-10-16T16:33:58Z, PR #296 at 50b9daa, against d1b0fe3

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse better same same
Inherited architect same worse better same same

Mid A, decided by:

  • Locality: bin/loop_claude/loop/reload.py:38 decoded_as: looks up a RETIRED attribute and a static fits by name on whatever class it decodes, beside a second sentinel, so a rule on one class steers a generic module and only a comment says so
  • Locality: bin/model_routing/route.py:11 route_from: two parsers of one archived line, and Route.__post_init__ trusts that callers ran levels_fit first
  • Locality: bin/rule_hook/reviewer_rung.py:25 reviewer_breaches: the required rung comes from a third environment variable, with a fallback to the old formula for a worker an older loop-claude started
  • Locality: bin/rank_todo.py:570 parse_item: a function named parse also computes R and writes it into the item's scores
  • Shape: bin/model_routing/ladder.py:62 worker_rung: worker, planning and review rungs are named for whom they serve, and plain step dicts replace the scan over band pairs
  • Shape, Self-sufficiency: bin/loop_claude/cycle/prompts.py:26 review_launches: one mapping gives each review's rung, and the docstring shows the sentence it renders
  • Shape: bin/todo_table.py:23 Shape: grew from 4 fields to 7, and score_outcomes/outcomes.py's report does two jobs

Inherited architect, decided by:

  • Locality: bin/loop_claude/loop/reload.py:43 decoded_as: a second sentinel and two class hooks found by name through getattr, so a dropped route at 3am depends on rules spread across two files and held by convention
  • Locality: bin/model_routing/ladder.py:73 worker_rung: raises KeyError for an L off its scale, safe only through guards in judge.py's verdict_from and Route.__post_init__
  • Locality: bin/rule_hook/reviewer_rung.py:26 reviewer_breaches: the reviewers' rung is worked out in loop-claude and reaches the hook through a third variable, beside an inline fallback restating the old rule
  • Shape: bin/loop_claude/cycle/prompts.py:26 review_launches: review_rungs is the one source the prompts, the worker's environment and the hook read, and the docstring shows the sentence produced
  • Shape: bin/model_routing/ladder.py:63 WORKER_STEPS: two small dicts with intent-revealing names replace the band tuple, and lowest_worker_rung replaces a magic constant
  • Shape: bin/todo_table.py:21 Shape: names optional, risk_columns and derived as fields where C was hard-coded, though its seven-argument constructors take counting
  • Shape: bin/model_routing/route.py:16 ArchivedWorker: the file doubles, almost all of it for old R + C archive lines
  • Self-sufficiency: bin/score_outcomes/outcomes.py:37 SHOWN: its comment says C shows on any item scored before L, E and I, though only a table with A, G and Goals keeps it

2026-10-16T18:11:57Z, PR #298 at 3f8f30a, against 2c67b4f

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect same same same same same
Maintainability senior same same same same same
Junior A same better same same better

Mid A, decided by:

  • Locality, Overall: bin/score_outcomes/main.py:86 report_text: main only fetches the inputs and sets the exit code, and the report's sections are built apart from the git and fetch code

Junior A, decided by:

  • Locality, Overall: bin/score_outcomes/main.py:86 report_text: the report is one pure function that states its section order and no longer writes R into the caller's dict, so one section changes without tracing the print order through main

2026-10-16T22:13:23Z, PR #301 at 2057d8f, against 11b9ec3

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse better same
Inherited architect better worse worse better same

Mid A, decided by:

  • Shape: bin/model_routing/route.py:69 Route.taking_in: sits beside routing.taken_in, a near-identical name on another axis, a Rung picked by L against a Route holding an E + I, and after_verdict chains both
  • Shape: bin/loop_claude/cycle/judge.py:59 Reply: bundled_escape_and_impact beside bundled, which means the bundled L, so one name of each pair spells its axis and the other hides it
  • Shape: bin/model_routing/route.py:12 ROUTED: two small regexes became one dense one with optional levels, a retired R + C branch and a taken-in suffix, though route_from reads simpler
  • Self-sufficiency: bin/loop_claude/routing.py:84 judge_rung: the rule now lives in Route.reviewed_on, which every consumer calls, in place of a pointer to a plan item
  • Self-sufficiency: workflow-bench/review_git.py:1 module docstring: states in place what it allows and why, where the bench skipped every permission check with no explanation

Inherited architect, decided by:

  • Locality, Shape: bin/loop_claude/loop/main.py:227 after_verdict: one taken-in item updates the route in two places, stepped through taken_in and the chained taking_in, with "bundled" a third word for the same idea
  • Locality: bin/model_routing/route.py:73 Route.reviewed_on: escape_and_impact no longer picks the reviewers, so a caller reading the field in place of reviewed_on() gets a quietly low rung
  • Shape, Locality: bin/model_routing/route.py:12 ROUTED: one dense regex with nested optional groups, and levels_fit accepts more taken-in E + I than taking_in keeps
  • Shape: bin/loop_claude/loop/main.py:231 archive_step: a "Stepped up" outcome is written when only the reviewers' E + I rose, so the outcome's name no longer tells what happened
  • Navigation, Self-sufficiency: bin/loop_claude/cycle/run.py:122 keep_rejection: a loop that exits 1 after a rejected judge reply now leads to the archived reply, named like keep_answer
  • Self-sufficiency, Navigation: workflow-bench/review_git.py:1 module docstring: explains the rule syntax and what the wrapper checks inline
  • Self-sufficiency: bin/loop_claude/routing.py:84 judge_rung: points to reviewed_on in place of a plan item

2026-10-17T01:10:16Z, PR #302 at f566d1c, against 46b79e7

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same worse same same
Inherited architect same worse worse same worse
Maintainability senior better same same same same
Junior A same worse worse same worse

Mid A, decided by:

  • Navigation: bin/loop_claude/loop/main.py:26 __doc__: loop-claude's help names bin/chunk-preflight, says it runs before routing and points to prompts.preflight_facts, so the worker's starting facts lead straight to the file and function
  • Navigation: bin/todo_table.py:229 chunk_item: the next chunk's item is picked in one named function both routing and chunk-preflight use, where 46b79e7 wrote it out inside routed_item
  • Navigation: bin/chunk_preflight/main.py:94 preflight: the tool splits into main (effects), gathered (data and pure choices) and facts (wording), so a wrong printed line leads to facts.py and a wrong worktree choice to gathered.worktree_add
  • Shape: bin/todo_table.py:212 standing: the items-table parser now also holds release policy (LastCut, CHANGELOG counting, a five-state standing, bundling), so its name no longer tells the truth, and the min(... named | {earliest} ...) test is the densest reading in the change
  • Shape: bin/git_repo.py:74 default_plan: the git wrapper imports the plan model and builds a LastCut, so a low-level module depends on a higher-level one

Inherited architect, decided by:

  • Locality: bin/loop_claude/loop/main.py:217 run_loop: routing must run after the chunk-preflight subprocess, reading the plan as its fetch left it; only a comment guards that order, and a resumed session skips the preflight, where 46b79e7 read the working tree's todo.md in place
  • Locality: bin/chunk_preflight/main.py:94 preflight: some git calls take the checkout explicitly and others rely on the process's working directory, so seeing that they hit one repo needs how loop-claude launches the tool
  • Locality, Shape: bin/git_repo.py:65 DefaultPlan: the git plumbing module now knows todo.md and CHANGELOG.md and imports the plan model, so its name no longer says what it holds
  • Shape, Locality: bin/todo_table.py:212 standing: the table parser has taken on release policy that depends on todo.md texts back to the last tag; picking the routed item now runs through four modules, and the key test only makes sense beside the three-line Standing comment
  • Locality: bin/loop_claude/cycle/run.py:28 Cycle.facts: the first prompt names the chunk's item twice, from routing and from the preflight's facts, which agree only because both call chunk_item and nothing lands on origin between the two reads
  • Shape: bin/chunk_preflight/gathered.py:1 gathered: it mixes dataclasses with plan, worktree, forge and path decisions, and facts.py is the renderer, so two names say less than they hold

Maintainability senior, decided by:

  • Navigation: bin/loop_claude/loop/main.py:26 __doc__: the new paragraph says the preflight runs before routing and names bin/chunk_preflight/ and prompts.preflight_facts, and the routing paragraph names todo_table.chunk_item, so why the worker was told X or routed to item N lands on the right file from --help
  • Navigation: README.md:85 "Tools": the new tool gets one line pointing to its --help, and the import paragraph says loop_claude runs it as a separate process
  • Navigation: bin/todo_table.py:229 chunk_item: one function picks for routing and the preflight, where 46b79e7's routed_item held its own copy, so a wrong-item symptom leads to one unit

Junior A, decided by:

  • Locality: bin/loop_claude/loop/main.py:217 run_loop: routing works only after the preflight, since fetched_plan never fetches and counts on the preflight's fetch, which only a comment says; at 46b79e7 plan_item read the working tree's todo.md wherever it ran
  • Locality, Shape: bin/git_repo.py:65 DefaultPlan: the git module imports LastCut from todo_table and builds the plan pick's inputs, so its name and docstring no longer cover what it holds
  • Shape, Locality: bin/todo_table.py:199 landed: it counts ## Unreleased entries first while larv_review/git.py's landed_since_release counts commits only, two meanings of "work has landed"
  • Shape, Locality: bin/todo_table.py:212 standing: the table parser grew from 247 to 346 lines and now decides how a release stands through a five-valued literal whose three-line comment must be decoded first, where 46b79e7's routed_item stated the pick in six lines
  • Locality: bin/chunk_preflight/main.py:30 __doc__: the preflight runs reading-cost in the new worktree, and larv-review's step now depends on whether the prompt shows that, so one action is split across a tool, a prompt and a skill
  • Shape: bin/chunk_preflight/gathered.py:1 gathered: the name covers the data but not the pure choices it also holds, and main.py imports 12 names from it on one line

2026-10-17T19:35:31Z, PR #303 at 85cbd6b, against 712dabd

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same same same same
Inherited architect same worse same same same

Inherited architect, decided by:

  • Locality: bin/comprehension_history.py:106 latest_places: one max over the entries became three dependent steps, and the rerun at rule in SKILL.md is needed to see why the start point moved
  • Locality: skills/larv-review/SKILL.md:118 "Second run" and bin/larv_review/plan.py:22 scoring_run_due: the second run keys on the exact wording of a reason string, with no test or import linking the two
  • Locality: bin/larv_review/agreement.py:10 overall_cells: the last cell means overall only through table_rows' first-row-wins rule and the pre-#232 Vote table, described at comprehension_history.py:82
  • Locality: bin/larv_review/main.py:81 __doc__: the help hard-codes 10 pairs where MIN_PAIRS holds the number

2026-10-17T22:03:15Z, PR #308 at 023380f, against 59344de

Ruling: worse

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse same same worse
Inherited architect same worse worse same worse

Mid A, decided by:

  • Locality, Overall: bin/loop_claude/cycle/run.py:43 Cycle.stepped_from and escalated: the cycle carries route state outside its state machine, which escalated rewrites before every transition, keeping stepped_from only through HumanTyped, so ask, keep_answer and worker_start trust the event before them
  • Locality: bin/loop_claude/cycle/run.py:156 unspent: whether a verdict keeps its escalation depends on escalation_spent, set by an earlier ruling of the cycle; escalation now spans escalated, unspent and loop/main.py's step from concluded.route
  • Locality: bin/loop_claude/cycle/prompts.py:132 typed / typed_answer: the typed answer is written into a prompt and parsed back out of the transcript, and render takes a callback the generic claude_code module cannot make sense of alone

Inherited architect, decided by:

  • Locality, Overall: bin/loop_claude/cycle/run.py:71 escalated: the route now also changes inside a cycle, through two fields kept out of the state machine; "why did the worker resume on this rung" spans escalated, unspent, routing.stepped_by_ruling, after_verdict and two archive-the-step sites
  • Locality: bin/loop_claude/cycle/prompts.py:138 TYPED_HERE / typed_answer: the resume prompt doubles as a data channel back to the judge, resting on typed's layout, the blank-line partition and put_question returning one line, in three modules linked only by a comment
  • Shape: bin/loop_claude/routing.py:80 stepped_from: returns the stepped route, while Cycle.stepped_from holds the route before the step; escalated is likewise a function, a bool parameter and a local string
  • Shape: bin/loop_claude/cycle/judge.py:95 Interrupt: shares escalation and bundled with Unfinished in the opposite positional order, and both are built positionally

2026-10-18T07:20:58Z, PR #310 at 1d8dd33, against fdd48bb

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same same same same
Inherited architect same same same same same

Mid A, decided by:

  • Navigation: bin/review_folder.py:5 REPORTS: the review folder's path is one constant in a module named for it, imported by make_review_folder, report_breaches and reviewed_in, so where reports go and who enforces it is found from one name

Inherited architect, decided by:

  • Locality: bin/todo_table.py:216 renamed: one function now holds the renamed-never-finished rule that named_releases and plan.py's emptied both call, where a comment kept two files in step by hand
  • Locality: bin/todo_table.py:205 named_releases: now a fold whose answer depends on the texts' order, fixed far away by --reverse in git_repo.py's todos_since and enforced by nothing
  • Locality, Self-sufficiency: bin/stability_replay/main.py:183 reviewed_in: three chained replaces that must run in a fixed order, and the copy placed under REPORTS for a reason that lives only in reviewer_report.py
  • Shape: bin/stability_replay/main.py:175 reviewed_in: seven positional parameters with clone and reports adjacent strings, and REPORTS meaning the root, its realpath and one round's copy in three files
  • Locality: bin/review_folder.py:5 REPORTS: the path is spelled again in settings.json, SKILL.md, CLAUDE.md and larv-review's help, and only the Python reads the constant

2026-10-18T07:59:13Z, PR #312 at 6694d54, against e074b8b

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same (voted better, no place naming Navigation) better same same better
Inherited architect better better same better better

Mid A, decided by:

  • Locality, Overall: bin/todo_table.py:223 renames: one explicit ## Renamed line in one text replaces a rename inferred from two plan snapshots
  • Locality: bin/todo_table.py:209 named_releases: an unparseable mark fails the result only in the newest text, an order dependence to keep in mind

Inherited architect, decided by:

  • Locality, Overall: bin/todo_table.py:223 renames: the answer sits in the file read, where renamed replayed the plan's history
  • Locality: bin/larv_review/plan.py:27 emptied: renamed is a parameter, no hidden second derivation
  • Navigation, Self-sufficiency: bin/chunk_preflight/gathered.py:100 planned: the stop names the fix and where it goes

2026-10-18T09:10:02Z, PR #316 at 3eb3217, against 6e0fda4

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Locality, Shape: bin/chunk_pick.py:92 chunk_item: returns one of five dataclasses, each carrying its release, where 6e0fda4's (Standing, Item | None) tuple made planned recompute the earliest release; the pick lives in one module named for it
  • Shape, Navigation: bin/git_repo.py:1 git_repo: the git wrapper no longer imports the plan model or builds todo.md objects; default_plan and todos_since sit beside the logic that reads them
  • Shape, Locality: bin/chunk_pick.py:97 standing: names first_named and states the rule plainly, where 6e0fda4's min(... named | {earliest} ...) had to be decoded
  • Shape: bin/chunk_preflight/choices.py:1 choices: the pure decisions left gathered.py, so each module's name tells what it holds
  • Locality, Navigation: bin/todo_table.py:269 version: one release formatter beside release_of, where 6e0fda4 had three
  • Shape: bin/chunk_pick.py:118 unreleased_changes: with committed_since_release, the names say what is counted, where "landed" hid it

Inherited architect, decided by:

  • Navigation, Locality: bin/chunk_pick.py:97 standing: "preflight says a release is ready to cut and it isn't" now lands in one module, where 6e0fda4 spread it over a table parser, a git wrapper importing it, and the preflight's wording
  • Locality, Shape: bin/chunk_preflight/choices.py:24 planned: each pick variant carries its release, so the messages read straight off it, where 6e0fda4 paired a recomputed earliest with a string by hand
  • Shape: bin/chunk_preflight/gathered.py:1 gathered: data only, with the choices in choices.py, though facts.py imports PULLS_LIST from the decision module
  • Shape: bin/chunk_pick.py:118 unreleased_changes: with committed_since_release and one version, the names say what they count

2026-10-18T12:16:18Z, PR #321 at 862137b, against 0462980

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse better better same
Inherited architect same worse better better better
Maintainability senior same better better better better
Junior A same worse same better same

Mid A, decided by:

  • Locality: bin/loop_claude/cycle/judge.py:153 escalation_mark: "one trigger buys one step" was one flag and one function in run.py's unspent; now a mark across cycles read through Route.escalated_at, entries_read stamped late by judge_once, None versus 0, STEP_LINE, Grounds.since_step and the routing steps, over three modules
  • Locality: bin/loop_claude/cycle/judge.py:216 quotes_checked: turns a QuotedAnswer into an Interrupt without entries_read, correct only because judge_once stamps after run_judge, which nothing here says
  • Locality: bin/model_routing/route.py:12 ROUTED: the mark survives only by round-tripping through Route.__str__, so rewording one fragment resets it to 0 at a distance
  • Shape, Self-sufficiency: bin/model_routing/route.py:13 ROUTED: a verbose regex with each group naming the __str__ fragment it reads, in place of one dense line
  • Shape: bin/loop_claude/cycle/judge.py:143 Grounds: one named tuple whose fields document their own checks, in place of loose strings and a docstring list
  • Shape: bin/loop_claude/routing.py:84 one_rung_up: no longer shares its name with Cycle.stepped_from, which means the route before the step
  • Self-sufficiency: bin/loop_claude/cycle/prompts.py:87 escalation: the docstring shows the full sentences it renders for a concrete rung

Inherited architect, decided by:

  • Locality: bin/loop_claude/cycle/judge.py:185 judge_once: "one trigger buys one step" runs through five units in four modules and outlives the run via the archive line, with three "nothing" values for one idea: 0 for no mark, None for no escalation, None for never stamped
  • Locality: bin/loop_claude/cycle/judge.py:219 quotes_checked: builds an Interrupt without entries_read, safe only because the stamp comes later; swapped, the escalation is silently dropped
  • Shape, Self-sufficiency: bin/loop_claude/cycle/judge.py:143 Grounds: each checked text is a named field with its rule and penalty beside it, so the judge-rejection path reads easier
  • Shape: bin/loop_claude/routing.py:84 one_rung_up: the name says what it does, and its escalated_at parameter shows it moves the mark, where stepped_from clashed with Cycle.stepped_from
  • Locality, Shape: bin/loop_claude/cycle/run.py:69 escalated: Cycle lost the cycle-scoped escalation_spent and rule no longer filters through unspent, so run.py reads on its own
  • Self-sufficiency: bin/model_routing/route.py:13 ROUTED: each group labelled by the fragment it reads, with a warning that a reword resets the mark
  • Self-sufficiency: bin/loop_claude/cycle/prompts.py:88 escalation: the docstring shows the rendered text for one concrete route
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:61 STEP_LINE: defined beside the slicing that inserts it, with the entries-only-grow assumption written on Route.escalated_at

Maintainability senior, decided by:

  • Locality: bin/model_routing/route.py:66 Route.escalated_at: one persisted mark that holds across cycles replaces a cycle-scoped flag and a filter in rule that rewrote the judge's verdict outside the judge
  • Locality: bin/loop_claude/routing.py:76 stepped_by_ruling: "no escalation, no step" now lives in routing, so run.py's escalated reads straighter; offset in part by judge_once stamping entries_read after quotes_checked rebuilds an Interrupt, an order that matters
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:143 Grounds: each checked text a named field with its own comment, in place of two positional strings and a docstring list
  • Self-sufficiency: bin/model_routing/route.py:13 ROUTED: each group commented with the Route.__str__ fragment it reads back
  • Self-sufficiency: bin/loop_claude/cycle/prompts.py:87 escalation: the docstring quotes the sentences it produces, and the body joins whole parts in place of space-led fragments
  • Shape: bin/loop_claude/routing.py:84 one_rung_up: renamed from stepped_from, which meant the opposite of Cycle.stepped_from beside it

Junior A, decided by:

  • Locality: bin/model_routing/route.py:66 Route.escalated_at: "one trigger buys one step" moved from one file's cycle-local flag and unspent filter to a mark threaded through six files
  • Locality: bin/loop_claude/cycle/judge.py:189 judge_once: stamps entries_read after the run, an unstamped None silently steps nothing, and "none" is 0 on the route but None in stepped and stepped_by_ruling
  • Self-sufficiency: bin/model_routing/route.py:13 ROUTED: a verbose pattern whose groups name the fragments they read, in place of one dense line
  • Self-sufficiency, Shape: bin/loop_claude/cycle/judge.py:143 Grounds: each field documents what must quote it and what a misquote does, though judge and judge_once grow to nine positional parameters
  • Shape: bin/loop_claude/routing.py:84 one_rung_up: removes the name it shared with Cycle.stepped_from, which meant the opposite
  • Self-sufficiency: bin/loop_claude/cycle/prompts.py:87 escalation: a worked example of the exact sentences, as its neighbours already had

2026-10-18T16:57:38Z, PR #322 at 49e86fd, against 2911d3f

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same better same better
Inherited architect same worse better same same
Maintainability senior same better worse same same
Junior A better better same same better

Mid A, decided by:

  • Navigation, Shape: bin/review_replay/main.py:1 review_replay: the tool takes any pass and its name says so, with REVIEWERS listing the passes and the usage printing them, where the old name pointed at stability alone
  • Shape: bin/review_replay/main.py:208 reviewed_in: copy, rewrite, clone and run are each a named step with a docstring, where bin/stability_replay/main.py:175 did all four in one body; codes_found takes the left-out loop out of main
  • Locality: bin/rule_hook/reviewer_rung.py:18 reviewer_breaches: asks review_rungs(...)[kind] directly, without the older loop-claude fallback or the filesystem glob
  • Locality: bin/loop_claude/cycle/prompts.py:72 taken_in_launches: compares whole review_rungs dicts, right only because of a condition inside ladder.review_rungs that a comment states
  • Locality: bin/model_routing/ladder.py:71 REPLAYED: an empty table that review_rungs, lowered, shared_launches and reruns all branch on, so a reader follows a path no data drives
  • Shape: bin/rule_hook/reviewer_report.py:10 REVIEWERS: a frozenset of agent files, while ladder.py's REVIEWERS is a dict from pass to agent; one name for two shapes
  • Shape: bin/loop_claude/cycle/prompts.py:43 review_launches: fan-out grows by four units and "each reviewer" becomes a magic key, but stays bounded with docstring examples

Inherited architect, decided by:

  • Locality: bin/loop_claude/cycle/prompts.py:43 review_launches: one launch sentence now needs REVIEWS' per-pass rows, shared_launches skipping them for an "each reviewer" key, and lowered putting them back, where the base was one loop over three rows
  • Locality: bin/loop_claude/cycle/prompts.py:78 taken_in_launches: compares the whole review_rungs dict, correct only by a rule enforced in ladder.review_rungs
  • Locality: bin/model_routing/ladder.py:71 REPLAYED: a hand-edited table, empty today, that overrides a pass's rung below the worker's under a combined E + I and worker condition; a second source of truth
  • Shape: bin/review_replay/main.py:208 reviewed_in: split into copy_reports, redirected and clone_reviewed, each with a docstring; codes_found and pass_and_model take inline loops and lambdas out of main
  • Shape: bin/rung_replay/command.py:16 arguments_or_exit: argument parsing is no longer hard-wired to one model, and down_from(top, floor) makes judge-replay's floor show at its call site
  • Shape: bin/rule_hook/reviewer_report.py:10 REVIEWERS: shares its name with ladder.py's hand-kept dict of a different shape

Maintainability senior, decided by:

  • Shape: bin/loop_claude/cycle/prompts.py:14 REVIEWS: six rows built from REVIEWERS, a separate "each reviewer" entry, a kind not in REVIEWERS filter and a lowered list re-joined in two places, all serving an empty REPLAYED
  • Shape: bin/model_routing/ladder.py:69 REVIEWERS: two modules on one rule-hook call path each hold a REVIEWERS of a different type and meaning, where the base had one
  • Shape: bin/model_routing/ladder.py:104 review_rungs: fans out to every pass then overlays REPLAYED under a condition only a dense docstring paragraph explains; taken_in_launches compares whole dicts
  • Locality: bin/review_replay/main.py:208 reviewed_in: copy, rewrite and clone are named units, and the lambdas passed to replayed are named functions
  • Locality: bin/rung_replay/command.py:35 down_from: takes the floor as an argument, so each caller states its own floor where the base hid judge-replay's policy in the shared helper

Junior A, decided by:

  • Locality: bin/rule_hook/reviewer_rung.py:24 reviewer_breaches: the required rung comes straight from review_rungs, the function the prompts use, where the base passed it through an environment variable and a fallback
  • Locality: bin/rule_hook/reviewer_report.py:10 REVIEWERS: report confinement reads agents/ itself, no longer importing its set from a module about rungs
  • Locality, Shape: bin/review_replay/main.py:208 reviewed_in: four jobs and seven arguments became named units with docstrings, and main's loop and lambdas are named
  • Navigation: README.md:113: the import map now names every reader of model_routing/ and what rung_replay/ holds, and the tool's name leads to it for any pass
  • Shape: bin/loop_claude/cycle/prompts.py:57 shared_launches: five helpers, a made-up "each reviewer" key and paths an empty REPLAYED never runs, against ReviewKind naming the real passes

2026-10-18T19:59:26Z, PR #324 at c713910, against e6223f7

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse better same same
Inherited architect same worse better same same

Mid A, decided by:

  • Locality: bin/larv_review/record.py:56 rerank: recording a scoring run now also rewrites the checkout's todo.md and can exit 1 on items under the bar, so changing record-scoring needs rank_todo.rank_file's whole contract, where the base only appended to the history
  • Locality: bin/rank_todo.py:338 weigh: an item's score now depends on docs/comprehension-history.md's newest scored commit and on a ## review opt-out: title in docs/decisions.md, so scores and --check can change without anyone editing todo.md or README.md
  • Shape: bin/rank_todo.py:315 ranked_goals: the base's inline three-way weights branch in read_scoring is a named weigh, with the code-health and void rules in ranked_goals, each easier alone, at the cost of three similar names weigh, goal_weights and parse_weights
  • Shape: bin/rank_todo.py:623 cited_goals_failure: the base's parse_item mixed goal checks with writing R, and main inlined read, rank, write and print; each is now a unit with one purpose, and rank_file is reusable
  • Shape: bin/comprehension_history.py:130 newest_scored: the base's index arithmetic in latest_places is a named helper latest_overall shares, and overall_cells and FLOOR moved to the module that parses the table they read

Inherited architect, decided by:

  • Locality: bin/rank_todo.py:196 read_all: ranking now also depends on the newest scoring run in docs/comprehension-history.md, so a passing --check can fail with nobody touching todo.md, and nothing at the call site shows that a history append moves code health's weight
  • Locality: bin/larv_review/record.py:56 rerank: recording a scoring run now writes todo.md through rank_todo.rank_file, which prints its notes to stderr, and the message pointing at "the lines above" reads right only if rank_file printed first
  • Locality: bin/rank_todo.py:106 OPTED_OUT: ranking now matches a docs/decisions.md title spelled in larv-review's SKILL.md → "Opt-out", so rewording that heading silently changes whether rank_todo refuses a plan
  • Locality: bin/loop_claude/cycle/prompts.py:17 AFTER_CODE_HEALTH: the caveat that code health ranks first unless the README voids it is repeated in prose across about eight files, so one change to the shared goal edits all of them
  • Shape: bin/comprehension_history.py:130 newest_scored: replaces the base's index juggling in latest_places with two truthfully named predicates serving latest_places and latest_overall
  • Shape: bin/comprehension_history.py:145 overall_cells: FLOOR and overall_cells now have one home next to DIMENSIONS, and agreement's inline sort became the named scoring_runs
  • Shape: bin/rank_todo.py:332 weigh: weigh, cited_goals_failure and rank_file are pulled out of read_scoring, parse_item and main, each doing one thing

2026-10-18T19:59:40Z, PR #324 at c713910

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6.5 6
Mid A 7 5.5 6 6.5 6
Maintainability senior 7 6 6.5 6.5 6.5
Inherited architect 7 6 6 7 6.5
Mean 7.00 5.75 6.13 6.63 6.25

Junior A, hardest first:

  • bin/model_routing/route.py:66 Route.escalated_at: the escalation mark lives in six units across four files, with judge_once stamping entries_read, escalation_mark, stepped and judge_prompt's STEP_LINE held at once
  • bin/loop_claude/loop/main.py:1 "loop-claude --help": a 164-line docstring is the loop's real spec, its routing paragraphs packing every rule into one block that routed and after_verdict need open
  • bin/loop_claude/cycle/prompts.py:46 review_launches: prompt sentences assembled from rung comparisons over replay-lowered passes, the project's rung, the top rung and higher E + I
  • bin/model_routing/route.py:13 ROUTED: stored state persisted as prose and parsed back by regexes in four places, so rewording one string silently changes routing
  • bin/rank_todo.py:568 score: a 660-line file carrying two table shapes, with OLD_SHAPE forks in scoring, weights, goal parsing and column checks
  • bin/chunk_pick.py:97 standing: five inputs become five outcomes, and chunk_pick.Finished shares its name with judge.Finished
  • bin/review_replay/rounds.py:73 reviewed_path: rebuilds the code a past reviewer read from prompt text and author times, a heuristic
  • bin/comprehension_history.py:159 scored: legacy formats from before PR #255 and #232 leak into the reading

Mid A, hardest first:

  • bin/loop_claude/routing.py:64 stepped: seven small functions, each defined through another, with six inputs held at once to predict one rung, and an import cycle shaping the signature
  • bin/loop_claude/loop/main.py:259 after_verdict: the 164-line docstring is the only full map of routing, and after_verdict chains it all in one expression
  • bin/loop_claude/cycle/run.py:45 Cycle.stepped_from: the route changes outside the state machine, cleared on every event but HumanTyped, so it outlives exactly one hop
  • bin/loop_claude/cycle/judge.py:216 quotes_checked: three bodies of text to check quotes against, fuzzy matching, and three ways a failed check is handled
  • bin/loop_claude/cycle/prompts.py:46 review_launches: fragments that each start with a space, so no whole prompt is visible without running it in your head
  • bin/model_routing/route.py:13 ROUTED: a saved string format parsed back by a verbose regex that still accepts an older format
  • bin/rank_todo.py:568 score: two table shapes share every path, the goal term W in one and V in the other
  • bin/loop_claude/loop/reload.py:43 decoded_as: a generic decoder with two sentinels and a duck-typed fits hook defined on Route

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:64 stepped: four things held at once, the unfinished count, the taken-in L, the escalation cap from item_rung and the mark threaded through judge.py's escalation_mark, STEP_LINE and Grounds.since_step
  • bin/model_routing/route.py:86 Route.__str__: the route written as English and parsed back by ROUTED and outcomes.workers, so a sentence's wording is a storage schema shared by four tools
  • bin/loop_claude/loop/main.py:1 "loop-claude --help": a 160-line spec whose routing paragraph carries about 15 rules, re-describing what routing.py, ladder.py and retry.py enforce
  • bin/loop_claude/cycle/prompts.py:46 review_launches: each sentence built conditionally with a leading-space convention, and taken_in_launches scanning every higher E + I
  • bin/loop_claude/cycle/judge.py:216 quotes_checked: three grounds with three failure consequences, and the demotion to an interrupt loses release_ready
  • bin/review_replay/rounds.py:73 reviewed_path: guesses which removed worktree a reviewer read, and redirected depends on the order of its replacements
  • bin/comprehension_history.py:150 scoring_runs: near-synonyms scored and scoring_runs differ only on a ruling from before PR #255
  • bin/rank_todo.py:332 weigh: the goal term is W or V by shape, so every scoring path asks which shape

Inherited architect, would restructure first:

  • bin/round_titles.py:4 CAP: no program loops the reviewers; the cap lives in SKILL.md prose and the code only counts rounds and prints a note
  • bin/git_command.py:16 commits: parses git commit messages for rule-hook while git_repo.py, rule_hook/git.py, larv_review/git.py and Effects.git each run git, and git_repo bypasses Effects
  • bin/transcript_archive/outcomes.py:39 outcomes: shares its name with score_outcomes/outcomes.py, which measures finished chunks instead
  • bin/loop_claude/routing.py:64 stepped: routing has four homes, ladder.py, route.py, routing.py and routing_check with routing_figures, and prompts.py restates the ladder as sentences
  • bin/rank_todo.py:196 read_all: a 658-line library as well as a tool, imported by rule_hook and larv_review, and now reading four documents, so a todo.md commit in any project depends on its comprehension history
  • bin/loop_claude/cycle/judge.py:68 Reply.bundled: the taken-in L is also called bundled, and the project's rung is also called anchor
  • bin/chunk_pick.py:97 standing: "next release" is computed two ways, here and in larv_review/plan.py's scoring_run_due, which may diverge after a rename

2026-10-18T19:59:40Z, PR #324 rerun at c713910

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6.5 6 6
Mid A 7.5 6 6.5 7 6.5
Maintainability senior 7.5 6 6.5 6.5 6.5
Inherited architect 6.5 6 5.5 6.5 6
Mean 7.13 5.88 6.25 6.50 6.25

Junior A, hardest first:

  • bin/loop_claude/cycle/prompts.py:46 review_launches: the worker's English instructions built from how the worker's, the project's, the reviewers' and any replay-lowered rung relate, with ladder.review_rungs, REPLAYED and escalation_rungs open at once
  • bin/loop_claude/routing.py:64 stepped: seven small functions defined through each other, bundled learned only from judge.Reply, and escalated_at both an argument and a Route field with different meanings
  • bin/model_routing/route.py:13 ROUTED: routing state lives as English sentences in outcomes.md, read back by a regex, with the newest file by mtime deciding
  • bin/loop_claude/loop/main.py:1 "loop-claude --help": about 160 lines and the only full account of routing, step-ups, the archive layout, reloads and the routing figures in one unbroken paragraph
  • bin/loop_claude/cycle/run.py:69 escalated: stepped_from must survive a HumanTyped event and reset on every other, and archive_stepped writes one outcome or two depending on it
  • bin/loop_claude/cycle/judge.py:216 quotes_checked: three quote checks follow different rules, and an escalation that fails is silently dropped
  • bin/chunk_pick.py:97 standing: two separate notions of the next release and of work having landed, here and in larv_review/plan.py's scoring_run_due
  • bin/rank_todo.py:332 weigh: old-shape support forks behaviour throughout a 659-line file

Mid A, hardest first:

  • bin/model_routing/route.py:66 Route.escalated_at: the escalation mark is one concept spread over five files, the entry count, the injected step line, a double quote check and the cap from item_rung held at once
  • bin/loop_claude/cycle/run.py:69 escalated: state outside the state machine, cleared on every event but HumanTyped and read by ask, keep_answer and archive_stepped, depending on its order before transition
  • bin/loop_claude/cycle/prompts.py:46 review_launches: routing policy and English wording interleaved, much of the branching serving an empty REPLAYED
  • bin/loop_claude/loop/main.py:210 run_loop: the route passed as lazy thunks and re-derived every cycle, with an anchor-is-None branch in three places
  • bin/model_routing/route.py:86 Route.__str__: the archive's human-readable lines are what reruns, the routing figures and the replays parse back
  • bin/comprehension_history.py:150 scoring_runs: two near-identical predicates differing only for a ruling from before PR #255
  • bin/rank_todo.py:568 score: every rule exists twice for the old table shape
  • bin/review_replay/main.py:149 code_of: rebuilds which worktree a reviewer read by the first missing directory among its prompt's paths

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:64 stepped: seven one-line rung functions each defined by the others, four inputs held together, and an import cycle steering the interface
  • bin/loop_claude/cycle/judge.py:153 escalation_mark: the escalation mark spread over route.py, judge.py's Grounds and judge_prompt and run.py's escalated, and no single place states that one trigger buys one step
  • bin/loop_claude/cycle/prompts.py:46 review_launches: which conditional sentences reach which prompt means tracing fresh, routed_by, resumed, rungs_held and stepped_to
  • bin/loop_claude/loop/main.py:1 "loop-claude --help": the routing paragraph is one block covering the ladder, the judge, replays, rule-hook's variables, step rules, archive lines and legacy R + C
  • bin/model_routing/route.py:13 ROUTED: routing state survives restarts as English sentences parsed back by regex, a hidden contract across three packages
  • bin/rank_todo.py:218 rank: every stage branches on the old table shape, about half a 660-line file read and then discarded
  • bin/comprehension_history.py:130 newest_scored: four near-identical names over two concepts, split by a legacy case only the docstrings explain
  • bin/chunk_pick.py:97 standing: five inputs, three of which may be Failure, produce five outcomes, the order of the Failure checks carrying meaning

Inherited architect, would restructure first:

  • bin/round_titles.py:5 PASSES: the pass list lives in four places, PASSES, ladder.ReviewedPass, REVIEWERS and SKILL.md's table, kept in sync by hand
  • bin/rule_hook/rules.py:55 round-title-counts: no program blocks a fourth review round; rule-hook checks only the counts inside a round's title
  • bin/git_repo.py:8 git: bin/'s root holds about 43 entries, with 13 loose modules such as git_repo, git_command, chunk_pick and todo_table not grouped by purpose
  • bin/loop_claude/cycle/judge.py:68 Reply.bundled: the taken-in L and E + I are bundled in the judge's reply and taken in on Route and in routing.taken_in
  • bin/model_routing/route.py:86 Route.__str__: the archive's text format is written in two modules and parsed back by ROUTED, routing_figures, reading_cost, score_outcomes and judge_replay
  • bin/todo_table.py:89 OLD_SHAPE: the old todo.md shape is the largest dead weight in rank_todo.py

2026-10-21T18:16:09Z, PR #333 at 7c7a398, against fda48ac

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Shape: bin/git_repo.py:22 git: now the one git runner, with a guarded flag and GUARD_SETTINGS giving each transport its own line and saying why, where four more wrappers each had their own failure text and decoding
  • Shape, Locality: bin/loop_claude/effects.py:16 Git: the effect returns str | Failure like everywhere else, removing checkout.py's try/except OSError and returncode handling
  • Shape: bin/rule_hook/git.py:7 git: a dense one-line GUARDS comprehension became a thin call with guarded=True whose docstring says why
  • Self-sufficiency: bin/rule_hook/rules.py:64 OVERRIDE: the new comment explains the lazy reason, the lookahead and the stripped -->
  • Self-sufficiency: CLAUDE.md:108 "Vocabulary": now defines judge's records, paired ruling, place, scoring run and seat
  • Self-sufficiency: bin/metric_bench/main.py:114 run_scores: a small pull the other way, the comment cites plan item 204

Inherited architect, decided by:

  • Navigation, Shape, Overall: bin/git_repo.py:22 git: four places that started git with differently worded errors now go through one function, and the hardening is one named list instead of a one-line comprehension
  • Locality, Shape: bin/loop_claude/effects.py:16 Git: Effects.git returns str | Failure, so checkout.py and review_replay drop their own exception and returncode conventions
  • Locality: bin/metric_bench/main.py:112 run_scores: what the tool does on bad input is stated in its help, not hidden in a private wrapper's errors="replace"
  • Self-sufficiency: CLAUDE.md:105 "Vocabulary": defines the comprehension terms the charter used without defining, and rules.py's OVERRIDE gains its explanation
  • Self-sufficiency: bin/metric_bench/main.py:114 run_scores: a small cost, "item 204's" points to a plan item a code reader can't resolve
  • Locality: bin/rule_hook/git.py:7 git: a small cost, the guards no longer sit beside the hook that needs them, though both docstrings say why

2026-10-21T20:20:12Z, PR #335 at 33645b0, against dec19c5

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same better same better
Inherited architect better same better same better

Mid A, decided by:

  • Navigation, Shape: skills/larv-review/SKILL.md:73 "Re-entry": one table now answers which passes a fix reruns, where five Trigger cells and three bullets did, with a worked example under it
  • Shape: skills/larv-review/SKILL.md:86 "What a round reviews": the round-2 scope left "Round cap", which now holds only counting and capping, as its name promises
  • Locality: bin/settings_filter.py:12 cleaned: hidden state, since the stored and the working file differ and a per-clone git setting turns the filter on, with an ordering rule for Update; it balances the Re-entry table's gain
  • Self-sufficiency: bin/settings_filter.py:2 module docstring: the tool explains itself, but the steps to run it live in README and AGENTS.md

Inherited architect, decided by:

  • Navigation, Shape: skills/larv-review/SKILL.md:73 "Re-entry": "which passes does this fix rerun" is answered in one table where it was split between Trigger-cell clauses and a Rerun bullet
  • Shape: skills/larv-review/SKILL.md:31 pass table's Trigger column: each cell now says only when the pass first runs
  • Navigation: skills/larv-review/SKILL.md:86 "What a round reviews": a named paragraph beside Re-entry, where a reader asking what round 2 looked at searches
  • Locality: .gitattributes:1 the settings filter: committed behaviour depends on an untracked per-machine git setting, and README's Install and Update steps work only in order
  • Self-sufficiency: bin/settings_filter.py:2 module docstring: the script stands alone, but cannot say it is inert unless Install's git config line ran

2026-10-22T18:56:17Z, PR #354 at 7042a75, against 6f58a0e5c2

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better same better better
Inherited architect better better same better better

Mid A, decided by:

  • Navigation, Locality: bin/review_passes.py:7 PASS_AGENTS: the pass names lived in two files, one of them the routing ladder where nobody would look; one module named for its contents holds both now
  • Navigation, Self-sufficiency: bin/loop_claude/loop/main.py:53 Routing: the worker's rung: the 70-line routing paragraph is now headed parts a reader jumps to
  • Navigation, Self-sufficiency: bin/transcript_archive/__init__.py:1 "transcript_archive": the archive's file layout sits with the code that writes it, in place of loop-claude's help
  • Locality: bin/larv_review/plan.py:32 landed_towards: the next release is asked of chunk_pick, so the rule is written once
  • Self-sufficiency: bin/shell_command.py:33 segments: the new docstring lists each shell form it does not parse
  • Self-sufficiency: bin/git_repo.py:3 "git_repo": the module docstring says every tool starts git through it

Inherited architect, decided by:

  • Navigation, Locality: bin/review_passes.py:7 PASS_AGENTS: two unlinked pass lists became one table in a module named for it, so adding a pass is a single edit
  • Locality: bin/larv_review/plan.py:32 landed_towards: it reuses chunk_pick's rule in place of its own, so the scoring-run trigger and chunk-preflight cannot disagree about the next release
  • Locality: bin/larv_review/ruling.py:38 surplus: the surplus-seat check is a named predicate called where the ruling is recorded, not hidden in votes
  • Navigation: bin/loop_claude/loop/main.py:53 Routing: the worker's rung: seven headed sections replace one 50-line routing paragraph
  • Self-sufficiency: bin/shell_command.py:33 segments: the docstring answers why rule-hook missed a git call
  • Self-sufficiency: bin/rule_hook/override_log.py:36 this_chunks: the case list maps each commit shape to its one-line return
  • Self-sufficiency: bin/larv_review/main.py:34 "larv-review --help": the help no longer states when work has landed, and points to plan.py instead
  • Locality: bin/score_outcomes/main.py:134 read_outcomes: whether a commit joins the chunk above depends on the previous iteration's state, with a positional Chunk tuple
  • Locality: bin/todo_table.py:137 NoItemsTable: every caller must test it before Failure, and swapping the checks silently changes the message

2026-10-22T20:32:06Z, PR #357 at 3f8e175, against 64023b5

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Shape: bin/loop_claude/routing.py:67 after_unfinished: takes the verdict itself and owns the whole route after an unfinished verdict, where stepped took loose ints, explained an import-cycle workaround and left taking_in to the caller
  • Locality, Navigation: bin/loop_claude/loop/main.py:251 run_loop: routed returns a Route and after_verdict takes Concluded, so the off-ladder None and the ended/before juggling are gone and archive_step compares two records in one pass
  • Navigation, Shape: bin/loop_claude/verdicts.py:1 "verdicts": the verdict types left the long cycle/judge.py for a small module whose docstring says why it sits outside cycle/
  • Shape: bin/loop_claude/cycle/judge.py:69 Reply.highest_likelihood_taken_in: bundled gave no hint it carries an L; the new name does, and the verdicts are built by keyword
  • Navigation, Shape: bin/chunk_pick.py:50 ReadyToCut: no longer clashes with the judge's Finished
  • Shape: bin/chunk_pick.py:109 next_release: replaces the five-argument standing and is shared with larv_review's landed_towards; Upcoming.is_earliest needs its comment
  • Locality: bin/model_routing/route.py:74 Route.record: a typed JSON record replaces the prose that ROUTED parsed back, at the cost of a second, labelled read path

Inherited architect, decided by:

  • Locality, Shape: bin/loop_claude/routing.py:67 after_unfinished: takes the Unfinished verdict and does all the next route's work, the E + I intake included, where stepped took loose ints because of an import cycle
  • Locality: bin/loop_claude/loop/main.py:274 after_verdict: one call replaces the base's order-sensitive ended copy and before unpacking, and archive_step names both routes outright
  • Shape: bin/loop_claude/cycle/judge.py:122 verdict_from: verdicts built by keyword where positional calls met differing field orders, and bundled renamed to what it holds
  • Navigation, Shape: bin/chunk_pick.py:50 ReadyToCut: ends the two-Finished clash, and next_release splits the five-argument standing
  • Self-sufficiency, Locality: bin/model_routing/route.py:13 Record: the archived worker line is a typed JSON record the outcome writers alone accept, with a warning that renaming a field orphans records; the legacy regex is unannotated and R + C lines fall through rung_at as text without a docstring saying so
  • Navigation, Self-sufficiency: bin/loop_claude/verdicts.py:1 "verdicts": its own module, with field comments stating what entries_read=None means
  • Self-sufficiency: bin/todo_table.py:205 ships_alone: the R above 5 rule is one named function, where the base held it only in the charter

2026-10-23T02:05:49Z, PR #359 at 72a63c5, against 545ab3a

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Shape, Overall: bin/model_routing/review_choice.py:21 chosen: the choice of each review's rung has one home, returned as a ReviewChoice; before, three functions in prompts.py each worked it out
  • Locality, Shape: bin/loop_claude/cycle/prompts.py:62 review_launches: the sentence builders return lists of sentences and one join adds the spaces, where each fragment had to start with a space
  • Shape: bin/loop_claude/routing.py:331 first_route: the parameter anchor is now called project, so docstrings no longer explain it
  • Navigation, Self-sufficiency: bin/loop_claude/routing.py:1 "module docstring": it lists the unit for each routing phase, where the base pointed to docs/decisions.md
  • Navigation: bin/loop_claude/loop/main.py:54 "loop-claude --help": about 90 lines of routing text are one paragraph that names the file for each concern
  • Self-sufficiency, Navigation: bin/loop_claude/cycle/prompts.py:1 "module docstring": new, says which function makes which sentence group and where each lands
  • Locality: bin/model_routing/ladder.py:113 replay_applies: the condition for when a replay applies is a named function shared by review_rungs and chosen

Inherited architect, decided by:

  • Locality, Shape, Overall: bin/loop_claude/cycle/prompts.py:55 review_launches: the choice is made once in chosen and the prompt code turns it into lists of sentences; the base called review_rungs again in three functions
  • Shape: bin/loop_claude/cycle/prompts.py:17 EACH_REVIEWER: the REVIEWS table of wording and kind pairs, filtered in two places, is gone
  • Navigation, Self-sufficiency: bin/loop_claude/routing.py:1 "module docstring": a four-line map of Start, Rerun, Step-up and Judge naming the function for each, in place of about 90 lines of routing prose in the help
  • Navigation: bin/loop_claude/loop/main.py:54 "loop-claude --help": the routing paragraph names a file for each concern
  • Navigation: bin/loop_claude/cycle/prompts.py:1 "module docstring": says which function builds which part of each prompt
  • Shape, Locality: bin/model_routing/ladder.py:113 replay_applies: the replay condition has one name, shared by review_rungs and chosen
  • Shape: bin/loop_claude/cycle/run.py:41 Cycle.project: the rename from anchor removes the repeated explanation

2026-10-23T03:24:42Z, PR #361 at 6f98a18, against 39dd51b

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Shape: bin/loop_claude/cycle/run.py:61 run_cycle: the step-up rides on Ruled and the states as a StepUp passed to work, ask, keep_answer, worker_start and archive_stepped, where the base's Cycle.stepped_from was hidden state that escalated() cleared on every event but HumanTyped
  • Navigation, Self-sufficiency: bin/loop_claude/escalation_mark.py:1 escalation_mark: the mark's rule, once spread over judge.py, verdicts.py, Route.escalated_at's comment and after_unfinished's docstring, sits in one file whose docstring lists Stamp, Step, Show and Check by function
  • Shape: bin/loop_claude/escalation_mark.py:37 moved_to: says what it returns, where the base's verdicts.escalation_mark was named after the concept; Escalating replaces the repeated union
  • Shape, Locality: bin/loop_claude/cycle/judge.py:164 quotes_checked: shrinks to calls into escalation_mark, so judge.py holds only the judge's own logic, and verbatim and plain sit beside render
  • Self-sufficiency: bin/round_titles.py:6 CAP: a bare constant in the base now says what it caps and which two consumers use it

Inherited architect, decided by:

  • Locality, Shape: bin/loop_claude/cycle/run.py:61 run_cycle: a StepUp travels through Ruled, Interrupting and Working and drops on /talk in one visible case, where the base's escalated() cleared Cycle.stepped_from by an order-dependent rule; the base's hardest place improved most
  • Navigation, Self-sufficiency: bin/loop_claude/escalation_mark.py:1 escalation_mark: from "the worker was stepped up twice" a reader reaches the right unit in one hop, with four labelled steps each naming its function
  • Shape: bin/loop_claude/verdicts.py:50 Escalating: the base's escalation_mark function returned where the mark would move; now the module carries the concept's name, moved_to says what it returns, and the type has one name
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:70 Reply.escalation: the comment points at code that explains the rule rather than at docs/decisions.md
  • Navigation: bin/round_titles.py:6 CAP: names the decision, rule-hook's round-cap and larv-review round-count, so a fourth-round page leads to the code that enforces the cap

2026-10-23T09:16:16Z, PR #367 at 5a56fff040, against dcbdc970a6

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better same better same better
Inherited architect better same better better better

Mid A, decided by:

  • Navigation, Shape: bin/larv_review/history_changes.py:6 history_changes: named by its job where git.py named only that it calls git, and the merge-commit rule has its own unit in history_change
  • Navigation, Shape: bin/larv_review/history_commands.py:100 show_places: the module's name now fits all six entry points, where record.py also held commands that record nothing
  • Shape: bin/model_routing/route.py:13 WorkerLine: Record, Route.record and RECORD_FIELDS clashed with three other meanings of record; the new names match the Worker: line
  • Shape: bin/score_outcomes/results.py:24 Result: no longer collides with the archive's outcomes, at the cost of a comment explaining why the tool still says outcome
  • Shape: bin/judge_replay/replay.py:19 archived_kind: says it holds the archived verdict kind, where on_record read like a flag

Inherited architect, decided by:

  • Shape, Self-sufficiency: bin/model_routing/route.py:13 WorkerLine: says the value is the JSON on the Worker: line that ends each outcome, where Record overlapped the document sense and the verb
  • Navigation, Shape: bin/larv_review/history_changes.py:6 history_changes: a ruling-base symptom now leads to a file named for its one job, and the first-parent rule sits in one small unit
  • Navigation: bin/larv_review/history_commands.py:16 record_ruling: imported from a file named for the history commands it serves, not the overloaded record
  • Shape: bin/rule_hook/rules.py:91 Checked: no longer reuses outcome and verdict, two words the project uses for archive entries and judge verdicts
  • Shape, Self-sufficiency: bin/reading_cost/measure.py:13 Reading: files no longer borrows the seats' place, and the docstring says what both fields count
  • Shape: bin/judge_replay/replay.py:24 Case.archived_kind: says it is the kind the archive gave the verdict
  • Self-sufficiency: bin/score_outcomes/results.py:22 Result: a reader translates between result in the code and outcome in the tool's name and report, a small cost the comment explains

2026-10-23T09:51:07Z, PR #368 at 5e7e364, against 4a0ba59

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better better same better
Inherited architect same better better better better

Mid A, decided by:

  • Locality, Shape: bin/score_outcomes/results.py:40 MEDIANS: reads result.findings.red from the named Findings type where the base read result.findings[0] and sent the reader to round_findings to learn index 0 means 🔴
  • Locality, Shape: bin/score_outcomes/results.py:138 at_least: the lower-bound rule and its reason now live in one named function that render and misreads share, with counted beside it
  • Shape, Locality: bin/round_titles.py:45 title_counts: one parse of a round title's counts where the base matched FINDINGS separately in each caller; lacks_counts now also means inconsistent counts, a small cost

Inherited architect, decided by:

  • Shape, Self-sufficiency: bin/score_outcomes/results.py:33 Result.findings: a named Findings type in place of a bare tuple[int, int], so each use reads .red or .yellow with no docstring open
  • Locality: bin/round_titles.py:45 title_counts: one function parses the counts after a round title's colon, so a change to the title format happens in one place
  • Locality: bin/score_outcomes/results.py:143 counted: render and misreads share one spelling of a chunk's findings, so the two output paths cannot drift apart
  • Shape: bin/round_titles.py:34 lacks_counts: the name now also covers a misread count above 🔴 plus 🟡, which a reader chasing a refusal learns only from the body; a cost that doesn't outweigh the gains

2026-10-23T09:51:56Z, PR #366 at e05c54a, against 4a0ba59

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same worse same same
Inherited architect same same worse same same

Mid A, decided by:

  • Shape: bin/rule_hook/rules.py:103 heavy: about 50 lines of command-word parsing sit in the module that holds the rule table, while rules of similar weight have their own modules; line 126 picks docker's index by a nested conditional

Inherited architect, decided by:

  • Shape: bin/rule_hook/rules.py:103 heavy: argv parsing for docker and mutation tools joins the rule registry, breaking the pattern of a sibling module per non-trivial rule, and rules.py now mixes registry, file checks and a shell parser
  • Shape: bin/rule_hook/rules.py:126 heavy: a conditional nested in another decides where docker sits in the words, which a 3am reader unpicks by hand

2026-10-23T12:49:21Z, PR #370 at 686c1dc, against 64d4386

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Locality: bin/rule_hook/heavy_command.py:1 heavy_command: the file name and docstring lead a cold reader to the code that decides the run-heavy rule, which sat in the middle of rules.py:103-150 before
  • Shape: bin/rule_hook/rules.py:8 rules: the file drops from 256 to 207 lines and reaches the heavy-command logic through one import
  • Shape, Locality: bin/rule_hook/heavy_command.py:28 heavy: docker's position is two named steps, reachable and docker_at, where a nested conditional stood at rules.py:126

Inherited architect, decided by:

  • Navigation, Shape: bin/rule_hook/heavy_command.py:1 heavy_command: a file name in the rule_hook/ listing points straight at the unit, which the base buried in the 256-line rules.py:103-150
  • Locality: bin/rule_hook/heavy_command.py:27 heavy: the rule "past a launcher docker can come anywhere, otherwise only first" reads from two plain lines, where the base held a nested conditional
  • Locality, Shape: bin/rule_hook/heavy_command.py:5 LAUNCHERS: the tables sit beside their only consumer, so extending them needs no search for other readers

2026-10-23T23:00:27Z, PR #372 at 899e8ed, against d1733a2

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better better same better
Inherited architect worse better same same same
Maintainability senior same better better same better
Junior A same better better same better

Mid A, decided by:

  • Locality, Shape: bin/shell_command.py:102 launched: one place finds the tool a command runs past its launchers, where heavy held launched, reachable, docker_at and a MUTATORS special case at once
  • Shape, Locality: bin/rule_hook/heavy_command.py:12 heavy: two cases and one early exit, with run-heavy read as a launcher instead of a stray word
  • Shape, Navigation: bin/docker_command.py:1 docker_command: named by what it holds and serving both docker rules, but at bin's root while only rule_hook reads it, against README's map
  • Locality: bin/docker_command.py:54 helped: unlimited leans on helpers defined below it, and helped finds the subcommand by its first occurrence

Inherited architect, decided by:

  • Locality: bin/rule_hook/heavy_command.py:12 heavy: four lines on launched and docker_subcommand, though LAUNCHERS now changes both docker rules together
  • Navigation: bin/docker_command.py:1 docker_command: README says root modules serve more than one tool, yet it serves only rule_hook, so a reader looks in rule_hook/ first
  • Locality: bin/docker_command.py:32 unlimited: the docstring states that the container's own arguments are read, and why python -m pytest is no limit
  • Shape: bin/shell_command.py:1 shell_command: the module now does two things, parsing and launcher reading, which only rule_hook uses

Maintainability senior, decided by:

  • Locality, Shape: bin/shell_command.py:102 launched: one function, returning a Launch, finds the tool past its launchers, where heavy did it inline with index arithmetic
  • Locality, Shape: bin/rule_hook/heavy_command.py:12 heavy: one branch, docker or a mutation tool, with the module no longer holding general shell and docker parsing
  • Shape: bin/docker_command.py:1 docker_command: README says root modules serve more than one tool, yet only rule_hook imports it
  • Shape: bin/docker_command.py:32 unlimited: the entry point sits between helpers, and unlimited and unlimited_container differ by an unstated input
  • Locality: bin/docker_command.py:54 helped: reads --help by position while heavy's LIGHT_FLAGS reads it anywhere, and neither says whether that is meant

Junior A, decided by:

  • Locality, Shape: bin/shell_command.py:102 launched: the steps that find a command's tool past its launchers live in one function both rules share
  • Shape, Locality: bin/rule_hook/heavy_command.py:12 heavy: from 13 lines mixing three parsings to 8 with a clear docker-or-mutator branch
  • Shape: bin/docker_command.py:1 docker_command: a truthful name and docstring, though it sits at bin's root rather than beside rule_hook's rules
  • Locality: bin/rule_hook/rules.py:140 command_breaches: the new rule plugs in beside run-heavy as one parallel if

2026-10-24T09:53:49Z, PR #373 at 3ac8c79, against eb7b506

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse same better same
Inherited architect same worse worse same worse
Maintainability senior same worse worse same worse
Junior A same worse same same same

Mid A, decided by:

  • Locality: bin/rule_hook/rules.py:154 unlimited_container: rule-hook now encodes how run-heavy's docker puts itself on PATH, joined to it by a one-line comment
  • Locality: bin/run_heavy/main.py:65 capping: a stand-in docker on PATH and RUN_HEAVY_MEMORY make a container's limits depend on the environment, though the help spells it out
  • Self-sufficiency: bin/docker_command.py:24 size: named predicates replace a negative-lookahead regex, and swap_limit says what -1 and 0 mean
  • Self-sufficiency: bin/docker_command.py:52 subcommand_at: positions replace a first-match lookup that took an option's value for the subcommand
  • Shape: bin/docker_command.py:84 capped: the module grows from 5 functions to 13, and one line packs four conditional limit lists

Inherited architect, decided by:

  • Locality, Shape: bin/rule_hook/rules.py:154 unlimited_container: index arithmetic finds the words before docker, and the rule encodes how another package's PATH shim works
  • Locality: bin/rule_hook/rules.py:165 resets_path: reads as a guess about launchers rather than a model of them
  • Locality: bin/run_heavy/main.py:65 capping: whether a docker run gets limits depends on PATH order and a variable an ancestor set
  • Shape: bin/docker_command.py:39 unset_swap: named unset though -1 is unlimited, beside a generic zero, in a module that now reads and rewrites commands
  • Shape: bin/docker_command.py:24 size: replaces a hard negative-lookahead regex, offsetting in part

Maintainability senior, decided by:

  • Locality: bin/rule_hook/rules.py:154 unlimited_container: repeats how run-heavy's PATH trick works, so a change to run-heavy silently changes the rule, and the index arithmetic takes a second read
  • Locality: bin/machine_load/memory.py:20 Memory.slot_share: tuning the worker threshold ROOM_SHARE now also changes every capped container's memory, while its comment names only the worker
  • Locality: bin/run_heavy/main.py:65 capping: the share reaches the docker shim through an environment variable and a PATH entry, hidden state between two processes
  • Shape: bin/docker_command.py:24 size: the module grows to 13 functions that read and rewrite commands, with predicates named as nouns
  • Shape: bin/docker_command.py:84 capped: one line crosses the two limits' values over and needs the docstring

Junior A, decided by:

  • Locality: bin/rule_hook/rules.py:154 unlimited_container: rule-hook copies run-heavy's PATH trick, and nothing in run_heavy points back to it
  • Locality: bin/run_heavy/main.py:65 capping: one process sets RUN_HEAVY_MEMORY and PATH, and another reads them, so a docker run spans two processes

2026-10-28T01:47:11Z, PR #371 at 51faf71, against 3bde9cd

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same same same same
Inherited architect same same same same same

Mid A, decided by:

  • Locality, Overall: bin/loop_claude/loop/reload.py:28 LoopRun.unfinished_run: its name is one word from Route.unfinished, and the two reset at different times
  • Locality: bin/loop_claude/loop/main.py:214 closed_cycle: the order of archiving the step-up before the limit is checked has to be known, and the or fallback contradicts the comment above it
  • Shape: bin/loop_claude/cycle/worker.py:15 AUTO_COMPACT_WINDOW: the constant named for the window holds the environment variable's name
  • Self-sufficiency: bin/loop_claude/loop/main.py:151 UNFINISHED_LIMIT: the number rests on archive evidence the reader can't see
  • Navigation: bin/loop_claude/cycle/run.py:82 archived_stop: a loop-level stop goes through a cycle-level helper

Inherited architect, decided by:

  • Locality, Overall: bin/loop_claude/loop/main.py:214 closed_cycle: the order of its steps is easy to break, and the or fallback contradicts the comment above it
  • Locality: bin/loop_claude/loop/reload.py:28 LoopRun.unfinished_run: a rerun sets it to 0 only through the dataclass default, which the call site at loop_run_from doesn't say
  • Navigation: bin/loop_claude/cycle/judge.py:150 run_judge: the path from a rejected verdict to exit 1 crosses three files, and only some misquotes count
  • Navigation, Shape: bin/round_titles.py:8 CAP: the fourth-round cap lives in a module named for commit titles
  • Self-sufficiency: bin/loop_claude/loop/main.py:1 module docstring: the exit list maps a code to a cause, but no bullet links to the unit that raises it

2026-10-28T11:36:42Z, PR #386 at 722dd5e, against 243a9d8

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same same same same
Inherited architect same worse better same same

Inherited architect, decided by:

  • Locality: bin/routing_figures/measure.py:155 costed: one message's dollars now depend on every message from the same model in the chunk and on the worker's last cost-state entry, so pricing one message means holding the whole chunk's split
  • Locality: bin/routing_figures/measure.py:125 measured: the one-line lacking= count is explained only in the ChunkFigures docstring and in basis
  • Shape: bin/routing_figures/measure.py:85 Message: named fields replace unnamed (at, tools, spent) tuples and six positional arguments
  • Shape: bin/routing_figures/prices.py:33 listed: list-price arithmetic gets its own small module with a name that fits

2026-10-28T16:23:54Z, PR #387 at 0447f2e, against cde7720

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse worse same worse
Inherited architect same worse same same same
Maintainability senior same worse same same same
Junior A same worse same same worse

Mid A, decided by:

  • Locality, Shape, Overall: bin/rule_hook/main.py:117 read_breaches: the repeat-read rule's file and transcript reads sit in main.py, apart from its logic in repeat_read.py, unlike the other rules, so changing the rule needs both files open
  • Locality: bin/rule_hook/repeat_read.py:72 shown_lines: whether a Read is checked turns on a text comparison of the mtime with transcript stamps, which holds only while main.modified formats the mtime as Claude Code stamps entries
  • Locality: bin/rule_hook/repeat_read.py:29 repeat_breaches: needs lines read one past the last shown line, a promise main.py's caller keeps with nothing enforcing it
  • Shape: bin/rule_hook/repeat_read.py:87 results_on: returns unnamed four-part tuples that callers unpack by position
  • Shape: bin/rule_hook/repeat_read.py:103 written: returns a path, while written in main.py names the text that may carry an override marker
  • Locality: bin/rule_hook/main.py:84 breaches_of: a Bash call now also reads the transcript and the file system through read_breaches
  • Shape: bin/claude_code/entries.py:100 ToolResult: tool-result parsing has one named home, which shrinks measure.py's results to one line

Inherited architect, decided by:

  • Locality: bin/rule_hook/main.py:117 read_breaches: the rule's I/O sits in main.py and its logic in repeat_read.py, with two contracts across the seam, the mtime stamp's format and reading one line past the last shown, that only docstrings in the other file state
  • Locality: bin/rule_hook/repeat_read.py:72 shown_lines: asker switches on a Read-only cut-off whose reason lies in a comment and the rule text, the order-dependent part of the rule
  • Shape: bin/rule_hook/repeat_read.py:87 results_on: untyped positional tuples and dense conditionals at :46 and :105, offset by the shared ToolResult parser in bin/claude_code/entries.py:100 and measure.py's dropped duplicate

Maintainability senior, decided by:

  • Locality: bin/rule_hook/main.py:117 read_breaches: the rule's I/O sits in main.py and its logic in repeat_read.py; the count max(shown) + 1 at :126 sets what an open-ended cat means in the other file
  • Locality: bin/rule_hook/repeat_read.py:72 shown_lines: changed > touched compares stamps as text, which holds only while modified in main.py formats the mtime as the transcript does; changed and asker made it the slowest unit to read
  • Locality, Shape: bin/claude_code/entries.py:107 tool_result: one named parser replaces measure.py's private result_text, though measure.py:142 agent_calls still reads part.get("id") itself

Junior A, decided by:

  • Overall, Locality: bin/rule_hook/main.py:117 read_breaches: the rule's entry point, stat and file reads sit in main.py while its logic sits in repeat_read.py, so changing the rule needs both files
  • Locality: bin/rule_hook/repeat_read.py:29 repeat_breaches: needs lines through one past the last shown and a mtime formatted as a transcript stamp, both set up by main.py
  • Locality, Shape: bin/routing_figures/measure.py:205 results: one line over the shared tool_result, where cde7720 held a private copy of the parsing
  • Shape: bin/rule_hook/repeat_read.py:87 results_on: an unnamed four-field tuple unpacked by position, and written names a path here but the override text in main.py

2026-10-28T17:21:57Z, PR #390 at 3ef4790, against 47a4075

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better same same better
Inherited architect same better same better better

Mid A, decided by:

  • Navigation, Locality, Overall: bin/rule_hook/round_cap.py:8 round_cap_breaches: a refusal by round-cap is traced to a module named after the rule, wired like todo_check.py, where the base mixed it into command_breaches
  • Locality, Overall: bin/git_repo.py:81 branch_titles: round-count and the hook read the branch's round titles through one function, so they agree by construction
  • Locality: bin/rule_hook/override_log.py:104 print_overrides: the second definition of the default branch, local_default_branch, is gone

Inherited architect, decided by:

  • Locality, Self-sufficiency, Overall: bin/git_repo.py:81 branch_titles: the hook and round-count now count rounds one way, with first parents, where the base's two rules disagreed
  • Locality, Overall: bin/rule_hook/override_log.py:104 print_overrides: one default-branch lookup instead of a quietly different local one
  • Self-sufficiency, Overall: bin/rule_hook/round_cap.py:24 earlier_titles: the docstring states both fail-open cases, and the refusal names the counted commits and both ways out
  • Self-sufficiency: skills/larv-review/SKILL.md:78 "Cap": the ask, yes, one-more-round loop is gone, though the bullet now packs four ideas
  • Locality: bin/git_repo.py:63 default_ref: guarded=True means both safe git options and never asking origin, kept at each call site; where it rots first
  • Locality: bin/rule_hook/main.py:113 bash_breaches: round-cap sits apart from its sibling round-title-counts in command_breaches, a split no comment states

2026-10-28T17:54:03Z, PR #391 at f1d749e, against 9014fd0

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect better better same same better

Mid A, decided by:

  • Locality, Overall: bin/loop_claude/effects.py:93 say: every message goes through one function that adds the time, picks stderr or stdout and always flushes; before, each call site chose its own stream and flush, so the order of stdout and stderr lines depended on hidden buffering
  • Locality: bin/claude_code/trust.py:10 trust: reports through a note callable the caller passes, so the call shows where its output goes
  • Locality: bin/transcript_archive/write.py:14 archive: same, but its default note silently drops the transcript: … line for a caller that leaves it out
  • Self-sufficiency: bin/loop_claude/effects.py:40 Effects.local_time: the new comment gives the format and why it is local time
  • Self-sufficiency: bin/loop_claude/loop/main.py:289 plan_item: the new comment sends a cold reader to the plan, and "one injected effect" is unclear beside say
  • Shape: bin/loop_claude/cycle/run.py:85 archived_stop: the same lambda text: say(text, effects) is written out five times and archive grows to six parameters

Inherited architect, decided by:

  • Navigation, Locality, Overall: bin/loop_claude/effects.py:93 say: about 30 print calls over nine files, disagreeing on flushing and streams, now go through one function whose docstring states the contract
  • Locality: bin/claude_code/trust.py:10 trust: wrote to sys.stderr itself before; now takes a note callback, so the caller decides where its words go
  • Locality: bin/transcript_archive/write.py:14 archive: the same change, but its silent default note drops the transcript: <path> line for a new caller without a word
  • Shape: bin/loop_claude/cycle/run.py:85 archived_stop: the same lambda is copied seven times across run.py, loop/main.py and cycle/interrupt.py, which roughly cancels the cleaner output path
  • Self-sufficiency: bin/loop_claude/loop/main.py:289 plan_item: its comment sends the reader to the plan and reads oddly now that every message goes through say

2026-10-28T21:50:16Z, PR #392 at 6e12ee9, against 77bc635

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Locality, Shape: bin/branch_chunks/cut.py:59 cut_branch: the older score_outcomes/main.py cut the branch with index arithmetic over raw log lines, each chunk a (short, short, int, Landing) tuple read as chunks[-1][2], with three helpers agreeing on hash slices; the newer typed Commit, Span and Branch dataclasses make one pure cut, the landing rule sits in its own landing, and both tools share it
  • Navigation: README.md:128 the import-root paragraph: the older packed every package-to-package dependency into one long paragraph; the newer gives each package a bullet, sorted by name, so going from a package to what it serves and imports is one scan
  • Shape, Locality: bin/branch_chunks/read.py:7 branch_chunks: every git call sits in this short shell while cut.py and fixes.py stay pure, and fixes.py's docstring says what fixed later means before any code; the two tools only see BranchChunk.fixed_by
  • Shape: bin/round_titles.py:34 rounds_past_first: the older computed rounds past the first in two places, one mixed into title extraction; the newer has one helper, and measure.py:229 commit_titles does only what its name says
  • Locality, Shape: bin/loop_claude/effects.py:31 Effects.git: uses git_repo.Git instead of a narrower local protocol, so one definition says what a git runner is; a small cost is that git_repo.Git and git_repo.Run are two neighbouring types for something that runs git
  • Self-sufficiency: bin/routing_figures/measure.py:336 fixes_per_chunk: its comment says "A mean, where item 247 named the median", which only reads fully with todo.md open; the new docstrings in fixes.py and score_outcomes/main.py:27 explain later fixes in place, and the two balance

Inherited architect, decided by:

  • Shape, Locality: bin/branch_chunks/cut.py:59 cut_branch: the older chunk_log returned a positional tuple read by index; the newer Commit, Span and Branch are frozen dataclasses with named fields, and landing and label are small functions each readable and changeable alone
  • Shape: bin/score_outcomes/results.py:40 results_of: the older took six positional arguments its caller built from rev-range strings such as f"{first}^1..{first}^2"; the newer takes one BranchChunk and the numstat, and read_results is a short loop without rev-range arithmetic
  • Navigation, Locality: bin/routing_figures/measure.py:229 commit_titles: the older wrote the rounds-past-first sum twice, once mixed with reading the transcript; the newer has one definition in round_titles used by both tools, and reading titles is its own unit
  • Navigation: README.md:128 the module list: the older described the module dependencies in one run-on paragraph; the newer gives one bullet per module, including branch_chunks/ naming who uses it
  • Shape: bin/routing_figures/measure.py:257 totals: the older built Figures from eight positional arguments; the newer passes them by keyword, which matters now that it gained unmatched and unread
  • Locality: bin/git_repo.py:48 Git: the protocol moved out of loop_claude/effects.py into git_repo, and default_ref and branch_chunks take the runner as an injected run, so the guarded and timed path reads at the call site
  • Locality: bin/branch_chunks/fixes.py:50 with_fixes: branch.owner[commit] > change.chunk means a later chunk fixed an earlier one only because chunks are ordered newest first, which only Branch's and chunk_log's docstrings state; not enough to move the ruling
  • Self-sufficiency: bin/routing_figures/measure.py:336 fixes_per_chunk: explains its choice by pointing to "item 247" in the plan, while later_fixes_of and fixes.py's docstring state their rules in full, so it is mixed

2026-10-29T00:40:36Z, PR #394 at bbb33f5, against b743228

Ruling: worse

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse worse same worse
Inherited architect same worse worse same worse

Mid A, decided by:

  • Locality, Overall: bin/loop_claude/cycle/interrupt.py:36 put_question, with bin/loop_claude/cycle/interrupt.py:90 talk: the ask is published in put_question, whose finally leaves it listed on a Talk, and talk's own finally removes it one state later; changing either means following the ask's lifecycle across both and the Talking state, where at the base each did one local thing
  • Locality, Shape: bin/loop_claude/cycle/interrupt.py:98 opened: its call to shown is also the go-ahead claim_talk (bin/loop_claude/waiting.py:192) polls for, so a function named for showing a question is one step of a handshake between two processes; only the comment above it and waiting.py's docstring warn
  • Shape: bin/loop_claude/loop/routing_check.py:7 raise_calls: the imports now reach into cycle.interrupt for claude_args, shown and withdrawn plus the waiting types, and it builds an Ask whose session is its own id
  • Shape: bin/loop_claude/effects.py:12 the import of Answer: the low-level effects module, and states.py, now depend on the domain module waiting.py for their types
  • Shape, Self-sufficiency: bin/loop_claude/cycle/states.py:12 TypedAnswer: its docstring still says typed at loop-claude's terminal, though an answer from loop-inbox becomes one too, and Talking lost its docstring; minor, outweighed by waiting.py's docstring
  • Shape: bin/loop_claude/cycle/interrupt.py:22 WorkerSession: bundles the base's seven loose talk arguments and six hand_over arguments, which reads better and keeps Shape only mildly worse
  • Navigation: README.md:102 the loop-inbox entry: the new tool is signposted from the README, loop-claude --help and loop-inbox --help, so a symptom crosses more files but each is named where you would look

Inherited architect, decided by:

  • Locality: bin/loop_claude/cycle/interrupt.py:36 put_question, with bin/loop_claude/cycle/interrupt.py:90 talk: on a Talk the ask's file stays up while the answer passes through run.ask, TalkChosen, transition and Talking, and talk's finally takes it down; to be sure it is always removed, a reader holds the state machine across three files
  • Locality: bin/loop_claude/waiting.py:192 claim_talk: loop-inbox waits 5 s for OpenInInbox, which the loop shows only after five units in three other files, so step 2 of the protocol is spread out and the timeout rests on that path staying quick
  • Locality: bin/loop_claude/cycle/interrupt.py:78 shown: confirming its docstring's failure path, loop-inbox gives up and the loop stops, takes four steps across two processes and two files
  • Shape: bin/loop_inbox/main.py:39 the import of hand_over: interrupt.py under cycle/ now also holds hand_over, claude_args, shown and withdrawn, which routing_check and loop-inbox import, so its name and folder no longer say who depends on it, while waiting.py holds only the raw publish and withdraw
  • Shape: bin/loop_claude/cycle/states.py:12 TypedAnswer: its docstring still says typed at loop-claude's terminal; Talking lost its docstring, and states.py and effects.py:12 now import from the inbox's file format
  • Locality: bin/loop_claude/cycle/run.py:102 step, the Talking branch: WorkerSession gathers the base's seven loose arguments and claude_command builds the resume command in one place, a smaller gain outweighed by the above
  • Self-sufficiency: bin/loop_claude/waiting.py:1 the module docstring: documents the file protocol in three numbered steps, so nothing new needs a document beside it; the cost is how far apart the pieces are

2026-10-29T00:46:50Z, PR #394 at bbb33f5

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6.5 6 6
Mid A 7 5.5 6.5 6 6
Maintainability senior 6 5 6 5.5 5.5
Inherited architect 7 6 5.5 7.5 6.5
Mean 6.75 5.50 6.13 6.25 6.00

Junior A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: four interacting rules, with helpers in ladder.py, route.py and escalation_mark.py, so predicting one rung means holding the rung, the unfinished count, the mark, the cap and taking_in at once
  • bin/loop_claude/cycle/prompts.py:55 review_launches: English instructions assembled from routing state and review_choice.chosen, whose order matters and whose result only the docstring examples show
  • bin/loop_claude/loop/reload.py:45 decoded_as: a generic recursive decoder with REJECTED and RETIRED sentinels and an unstated fits convention, where a small mistake breaks the reload's hand-over of state
  • bin/loop_claude/cycle/judge.py:150 run_judge: a misquote ends three different ways, with a verdict precedence only the comments in Grounds resolve
  • bin/rank_todo.py:410 blockers_first: recursive blocker placement with loop detection, and every scoring function branches on the old and new table shapes
  • bin/chunk_pick.py:11 LastCut: fields typed with Failure put errors inside the data, and the renamed-release rule lives only in named_releases
  • skills/larv-review/SKILL.md:72 "Round cap": dense rules held together by cross-references, so one question took four files
  • bin/rule_hook/rules.py:160 unlimited_container: a PATH heuristic about run-heavy decides whether a container is capped

Mid A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: one rule raises, steps once, caps, moves the escalation mark and takes in E + I, readable only with routing.py, escalation_mark.py, route.py and ladder.py open together
  • bin/loop_claude/cycle/run.py:167 ask: which rung a step-up is charged to travels as a StepUp inside the states, action at a distance the comments at 145 and 170 resolve twice
  • bin/loop_claude/loop/reload.py:45 decoded_as: a recursive reflective decoder with sentinels and a duck-typed fits, whose consequence is spelled out only on LoopRun
  • bin/rank_todo.py:428 place: recursive blocker placement, with the old and new table shapes running through read_scoring, weigh, score and cited_goals_failure
  • bin/comprehension_history.py:207 labelled_bullets: a stateful line parser whose branches serve formats from before PR #232 and #255
  • bin/loop_claude/cycle/judge.py:164 quotes_checked: a misquoted reply ends three ways, plus grounded's ellipsis matching, found only by tracing each caller
  • bin/model_routing/route.py:84 route_from: reads three spellings of one value, and nothing says when the legacy form can go
  • bin/review_replay/main.py:234 redirected: rewrites archived prompt paths where order matters, and guesses a round's commit from author times

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: five rung concepts, each defined elsewhere, plus the unfinished counter, a mark counted in transcript entries and taking_in, replayed by hand on examples
  • bin/loop_claude/loop/reload.py:45 decoded_as: generic reflection machinery inside a domain package; nothing says when a field becomes RETIRED instead of REJECTED
  • bin/rank_todo.py:410 blockers_first: two table shapes side by side, recursive placement, and weight rules stated together only in the module docstring
  • bin/chunk_pick.py:166 named_releases: the next release derived from every todo.md since the tag minus renames, clearer in chunk-preflight's help than at its home
  • bin/comprehension_history.py:130 newest_scored: prefix-matched commits, regex headings whose differences matter, and legacy carve-outs citing PR numbers instead of the old shapes
  • bin/loop_claude/cycle/run.py:190 archive_stepped: the route update runs in a channel beside the states, so what changes the route has two answers, here and in loop/main.py's after_verdict
  • bin/loop_claude/cycle/prompts.py:55 review_launches: which sentences reach a worker's prompt depends on a dozen small functions, and no whole prompt is visible
  • bin/rule_hook/rules.py:312 unlimited_container: slice arithmetic on words, and resets_path counts -i and -u whatever launcher they follow

Inherited architect, would restructure first:

  • bin/round_titles.py:8 CAP: the round cap lives in a module named for commit titles, and nothing says a third reviewer launch is left unguarded on purpose
  • bin/loop_claude/routing.py:76 after_unfinished: the step-up policy is split from model_routing/ and spread over about six files, so why a worker is on rung X takes two packages
  • bin/loop_claude/loop/main.py:169 run_loop: about twelve steps per cycle and an import fan-in of about 20 modules from 8 packages
  • bin/loop_claude/waiting.py:76 Typed: one name over three concepts, with transcript.py's Typed and states.py's TypedAnswer
  • bin/rung_replay/search.py:1 the imports: replay tools reach into loop_claude.cycle.retry and loop_claude.effects, so loop_claude is also the shared headless-claude library
  • bin/loop_claude/cycle/judge.py:64 Reply: a new verdict field touches Reply, verdicts.py, states.py, routing.py, Route and the outcomes archive
  • README.md:129 the module map: lists only cross-package imports, leaving the 18 root modules of bin/ without an index

2026-10-29T00:51:59Z, PR #394 rerun at bbb33f5

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6.5 6 6.5
Mid A 7 5.5 6 6 6
Maintainability senior 6.5 5.5 6.5 6 6
Inherited architect 7 6.5 6 7.5 6.5
Mean 6.88 5.88 6.25 6.38 6.25

Junior A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: four rules meet in one expression, so one call means holding item_rung, ESCALATION_CAP, UNFINISHED_PER_STEP and the mark's entries_read while jumping to ladder.py and escalation_mark.py
  • bin/comprehension_history.py:97 entries: the module parses its own markdown output, old formats are keyed only to PR numbers, and scored against scoring_runs differ in a way the code doesn't name
  • bin/loop_claude/cycle/run.py:167 ask: which route each archived line names before and after a step-up, with the cycle replaced inside run_cycle; the comments at 61, 145 and 170 resolve it
  • skills/larv-review/SKILL.md:31 "Passes": dense rules pointing out to CLAUDE.md, rules/, the standards and --help, with the re-entry table and the round cap held together
  • bin/rule_hook/round_cap.py:24 earlier_titles: returns an empty list when git fails, so a git failure turns the round cap off without saying so
  • bin/rank_todo.py:568 score: both table shapes run through the whole 659-line file, and only rules/todo-items.md says what C, A and G mean
  • bin/loop_claude/loop/reload.py:45 decoded_as: recursive type decoding with sentinels and a duck-typed fits hook, so a hot reload depends on dataclasses in other files
  • bin/routing_figures/measure.py:174 costed: recorded costs scaled across list prices and messages matched to a rung by timestamp, resolved by long docstrings

Mid A, hardest first:

  • bin/loop_claude/routing.py:263 after_unfinished: one condition needs rung, item rung, kept rung, L taken in, the escalation mark and the cap held at once, with rules/todo-items.md and the ladder open
  • bin/rank_todo.py:332 weigh: a 658-line file carries a legacy scoring model through almost every function, so each one asks which shape it is in
  • bin/loop_claude/escalation_mark.py:183 checked: part of the contract is a sentence spliced into the judge's schema text, so changing English changes behaviour
  • bin/loop_claude/cycle/judge.py:316 verdict_from: the verdict precedence is encoded twice, as the order of the ifs and in the QUOTE_RULES prose
  • bin/loop_claude/loop/main.py:169 run_loop: builds Cycle in one line of about 330 characters under 25 unordered imports, and plan_item defers to a todo.md item number
  • bin/routing_figures/measure.py:59 ChunkFigures: fields documented in one dense paragraph instead of beside each field, and render builds tables inline in one huge literal
  • skills/larv-review/SKILL.md:72 "Round cap": what counts as a round, the auto-reviewer exception and relaunches staying in their round took rereads beside round_titles.py and round_cap.py

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: one verdict raises the rung, moves the mark, resets or bumps the count and takes in E + I, with invariants in route.py, ladder.py and escalation_mark.py held open at once
  • bin/loop_claude/cycle/run.py:167 ask: the StepUp travels through the Working and Interrupting states while run_cycle swaps Cycle.route out of sight of these handlers
  • bin/rank_todo.py:568 score: the old table shape forks about eight functions, and the module docstring describes only the new shape
  • bin/loop_claude/cycle/prompts.py:55 review_launches: the worker's prompt is built from conditional fragments, so the text the worker reads appears only in docstring examples
  • bin/loop_claude/loop/reload.py:45 decoded_as: a generic recursive decoder with first-fit union matching, sentinels and a duck-typed fits, which every LoopRun field quietly depends on
  • bin/shell_command.py:44 segments: a hand-made state machine over shlex tokens tracks redirect targets, and a change's safety is unclear without the tests
  • bin/chunk_pick.py:109 next_release: LastCut fields typed str, None or Failure, and recovering renamed releases from todo.md's history is explained only in passing
  • bin/loop_claude/waiting.py:192 claim_talk: a handshake between processes with a timeout and a take-back, resolved by the module's three-step docstring

Inherited architect, would restructure first:

  • README.md:129 the module map: five domain modules sit at bin/'s root because two tools share them, so larv-review's rules spread over larv_review/, round_titles.py, review_passes.py, review_folder.py and comprehension_history.py
  • bin/git_command.py:17 commits: parses git commit out of shell words and doesn't run git, beside git_repo.py's git and rule_hook/git.py's guarded git
  • bin/rung_replay/search.py:1 the imports: replay tools reach into loop_claude.cycle.retry and loop_claude.effects, so loop_claude is also a shared library
  • bin/rule_hook/main.py:79 breaches_of: rules.py is both the RULES registry and the checker of about half the rules, while the other half have their own modules
  • bin/loop_claude/routing.py:76 after_unfinished: the step-up policy is spread over about six files across loop_claude and model_routing, where the next routing rule lands
  • bin/round_titles.py:8 CAP: enforced only on round commit titles, so a third reviewer launch is guarded by SKILL.md prose alone
  • bin/loop_claude/project/records.py:1 RECORD_FILES: "records" means the judge's records here and a tool-kept document in AGENTS.md
  • bin/loop_claude/loop/main.py:1 the module docstring: a 122-line contract restating README and SKILL.md, where drift will come from

2026-10-29T12:15:18Z, PR #394 at 9ebd06e, against b743228

Ruling: worse

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse better same worse
Inherited architect same worse same same worse

Mid A, decided by:

  • Locality: bin/loop_claude/cycle/interrupt.py:39 interrupt: where the base's put_question read one terminal line, it waits on the terminal and on an answer file another process writes, and hands a lambda wrapping claude_open to human_typed, so a change means holding the two-process protocol; its docstring is one long sentence over every branch
  • Locality, Shape: bin/loop_claude/waiting.py:202 claim_talk, with bin/loop_claude/waiting.py:221 make_way: /talk from loop-inbox is a three-step handshake across two processes, with a take-back on timeout; order dependence with no counterpart at the base, though the module docstring explains it
  • Shape: bin/loop_claude/cycle/interrupt.py:74 first_answer: OpenOnTerminal, an ask's state in loop-inbox's file, doubles as the return value for /talk and, at line 48, for a release ready to cut, so the name tells the truth about the file but not the control flow
  • Shape: bin/loop_claude/cycle/states.py:34 Interrupting: the state machine loses Talking and TalkChosen, so transition has one state and one event fewer
  • Shape: bin/loop_claude/hand_over.py:24 hand_over: opening claude on a terminal leaves cycle/interrupt.py for its own module, ending routing_check's sideways reach into the cycle, and ClaudeCommand replaces six loose arguments
  • Shape: bin/loop_inbox/inbox.py:59 pressed: the new tool splits into a pure core of screens and keys behind a curses shell, with names that say what they are

Inherited architect, decided by:

  • Locality, Overall: bin/loop_claude/waiting.py:202 claim_talk, with bin/loop_claude/waiting.py:221 make_way, bin/loop_claude/cycle/interrupt.py:77 claude_open and bin/loop_inbox/main.py:146 opened: /talk, one call in one process at the base, is a three-step handshake between two processes through a JSON file, over three files in two packages, resting on MAKE_WAY_SECONDS, a take-back after a timeout and pid liveness; the module docstring lays the steps out well
  • Locality: bin/loop_claude/effects.py:105 alive: whether an ask still counts, and whether the loop still waits on loop-inbox's claude, rests on a pid being alive, and nothing addresses pid reuse, a risk neither caller shows
  • Locality: bin/loop_claude/cycle/interrupt.py:39 interrupt, with bin/loop_claude/cycle/interrupt.py:94 human_typed: the base read straight down, put_question returning and the state machine stepping to Talking; now the wait sits inside listed, first_answer polls two sources, and the claude wait passes as a lambda; fewer states and hand_over's move out of cycle/ are real gains that don't offset it

2026-10-29T13:05:34Z, PR #394 at 9ebd06e

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6 6
Mid A 7 5.5 6.5 5.5 6
Maintainability senior 7.5 6 6.5 7 6.5
Inherited architect 7 6 6 7 6.5
Mean 7.13 5.75 6.25 6.38 6.25

Junior A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: five interacting rules in one function, each resting on terms defined in ladder.py, route.py, escalation_mark.py and the charter; the module docstring's outline says which branch, not why the order
  • bin/loop_claude/cycle/run.py:165 ask: the route before and after a step-up travel together, and seeing which one each archive line names meant tracing step_up through states.py; the comments at 61, 143 and 168 resolve it
  • bin/loop_claude/waiting.py:202 claim_talk, with bin/loop_claude/waiting.py:221 make_way and bin/loop_claude/cycle/interrupt.py:77 claude_open: a three-step handshake between two processes through files, polled against a deadline with liveness checks; the module docstring gives the order, but who writes which file needs both sides
  • bin/loop_claude/cycle/interrupt.py:39 interrupt: a one-sentence docstring over about six outcomes, with the body spread over first_answer, claude_open and human_typed; accurate but too dense for one read
  • bin/rank_todo.py:218 rank: about eight failure checks in sequence, and several functions branch on SHAPE versus OLD_SHAPE, a dual path explained only in todo_table.py
  • bin/loop_claude/cycle/judge.py:164 quotes_checked: quietly turns a misquoted answer into an Interrupt, and verdict_from's branch order decides the meaning
  • skills/larv-review/SKILL.md:72 "Round cap": a dense rulebook of passes, caps, re-entry and severities, part implemented in bin/larv_review and part followed by the agent; stayed too much to hold at once
  • bin/model_routing/route.py:84 route_from: an archived line is JSON or an older regex format, and renaming a field breaks archived lines, guarded only by a comment

Mid A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: kept_rung, item_rung, raised, a one-rung step and a cap check held at once, plus two step triggers and a moving escalation mark; the docstring's index and escalation_mark.py's four steps resolve it partly, after three rereads
  • bin/loop_claude/cycle/run.py:54 run_cycle: a step-up rides on state fields while run_cycle swaps Cycle.route on Ruled, HumanTalked drops it, and ran_on and archive_stepped decide which route a line names; the comments at 61, 143 and 168 explain it, read beside states.py
  • bin/loop_claude/loop/reload.py:45 decoded_as: a generic recursive decoder with REJECTED and RETIRED sentinels, duck-typed to Route through fits, which nothing at Route mentions
  • bin/rank_todo.py:332 weigh: OLD_SHAPE/SHAPE branches spread over weigh, score, cited_goals_failure and goal_weights instead of converted once at read time; why both exist is in todo_table.py
  • bin/loop_claude/cycle/interrupt.py:39 interrupt: a docstring of one sentence chain with four where/else turns, then a split across first_answer, claude_open, human_typed and the /talk handshake; waiting.py's module docstring resolves it
  • bin/loop_claude/cycle/judge.py:106 verdict_from: an implicit priority order and silent coercions, a misquote becoming an Interrupt and an off-scale L becoming 0
  • bin/rank_todo.py:428 place: recursive blocker placement with loop detection, fiddly by nature
  • skills/larv-review/SKILL.md:31 "3. Passes": dense rules pointing to CLAUDE.md, review-findings.md, standards/ and larv-review --help, not fully followed

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: one unit raises the rung to an item's L, steps on every second unfinished verdict or on an escalation below the cap, moves the mark and records E + I, with rules from ladder.py, route.py and escalation_mark.py; the docstring states the rule but each branch needed tracing by hand
  • bin/loop_claude/cycle/judge.py:96 Grounds: quotes from three sources, each misquote punished differently (Rejected, escalation dropped, answer turned to Interrupt), with the escalation half in escalation_mark.checked; each case commented, but the asymmetry is easy to break
  • bin/chunk_pick.py:109 next_release: the outcomes come from combining is_earliest with landed, and LastCut's X | Failure fields push failure handling into the data; subtle by nature, clear on a second read
  • bin/loop_claude/cycle/run.py:54 run_cycle: the route changes on Cycle at a Ruled step-up while step_up travels through the states, and ran_on versus cycle.route decides which rung each archive call charges; the comments at 61, 143 and 168 explain it, but the invariant spans two modules
  • bin/rank_todo.py:428 place: recursive placement with loop detection, with OLD_SHAPE threading through older_columns, parse_weights, goal_term and cited_goals_failure; whether the old shape is still live stayed unclear
  • bin/model_routing/route.py:84 route_from: layered backward compatibility (a JSON or legacy Worker line, reload's REJECTED and RETIRED sentinels and a fits found by name), so a change to Route's fields hits three decoders
  • bin/rule_hook/repeat_read.py:72 shown_lines: timestamps compared as text, tool calls paired with results by id and truncation markers handled, closely tied to the transcript format; the comments resolve it
  • skills/larv-review/SKILL.md:31 "3. Passes": dense cross-referenced rules, waves, reruns and the re-entry table not holdable in one read

Inherited architect, would restructure first:

  • bin/rule_hook/round_cap.py:8 round_cap_breaches: the round cap is split over round_titles.py, rule_hook/round_cap.py, larv_review/main.py and SKILL.md, and guards only Answer <pass> round commit titles, so a third reviewer run slips through on a launch without a round commit, a misspelled pass name or a slow git; nothing in the code says the cap is advisory at launch time
  • bin/loop_claude/cycle/judge.py:186 grounded: fuzzy quote matching against a transcript rendered in escalation_mark.py and normalised in claude_code/transcript.py, three modules that must stay in step; where it rots first
  • bin/round_titles.py:8 CAP: the bin/ root holds about 55 peers, with review mechanics, shell parsing, plan reading and plumbing side by side, the README grouping only part; the worst level
  • bin/git_command.py:17 commits: the name says it runs git, but it pulls commit messages from parsed shell words, beside git_repo.py, which runs git, and rule_hook/git.py, a third wrapper; three opens to sort out
  • bin/loop_claude/routing.py:76 after_unfinished: routing reaches over routing.py, model_routing, cycle/prompts.py and, through environment variables, rule_hook/reviewer_rung.py; hard because the policy is, and documented
  • bin/loop_claude/loop/main.py:1 module docstring: 120 lines of contract that restate CLAUDE.md's Vocabulary, AGENTS titles and the README's Tools, so a vocabulary change must land in four places
  • skills/larv-review/SKILL.md:31 "3. Passes": about twelve interacting concepts under one heading, the prose twin of the bin/ root
  • bin/loop_claude/cycle/states.py:88 transition: "ruling" names both the judge's ruling and the comprehension paired ruling, "project" a rung, a package and project_key, "chunk" three tools

2026-10-29T13:05:37Z, PR #394 rerun at 9ebd06e

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6 6
Mid A 7 6 6 5.5 6
Maintainability senior 7 6 7 6 6.5
Inherited architect 7 6.5 5.5 6.5 6
Mean 7.00 6.00 6.13 6.00 6.13

Junior A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: the unfinished count, a step every two verdicts, a two-rung cap, the escalation mark and the item's rung interact, unpredictable on one read; the docstring and rules/todo-items.md gave the words, the arithmetic only made sense after tracing loop/main.py
  • bin/loop_claude/escalation_mark.py:53 checked: the mark is an entry count that becomes a [step] line in the judge's prompt, which the grounding check in judge.py then relies on; one concept over three files, neither naming the other
  • bin/rank_todo.py:428 place: recursive placement with loop detection, and the OLD_SHAPE/SHAPE branches through weigh, goal_term, score, parse_weights and cited_goals_failure; the spec docstring explains why, the recursion stayed hard
  • bin/loop_claude/loop/reload.py:45 decoded_as: a recursive type-directed decoder with REJECTED and RETIRED sentinels and a duck-typed fits, generic machinery whose reason lives at exec_if_edited
  • bin/comprehension_history.py:150 scoring_runs: a near-twin of scored at 159 that a reader would mix up, with branches for formats from before PR #232 and #255 that need history the reader doesn't have
  • bin/model_routing/review_choice.py:21 chosen: many near-synonym ladder helpers and an opaque "higher" loop; the docstrings explain edge cases, not the shape
  • bin/rule_hook/repeat_read.py:72 shown_lines: timestamps compared as strings and truncation heuristics, correct only under assumptions not stated there
  • bin/loop_claude/loop/main.py:1 module docstring: about 120 lines of contract before any code, accurate but costly, citing a plan item the reader may not open

Mid A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: the kept rung, the item's rung, the cap, the mark's step and whether E + I was taken in, held at once, with meanings spread over routing.py, ladder.py, route.py and escalation_mark.py; no single place states the rule as a whole
  • bin/loop_claude/loop/reload.py:45 decoded_as: a generic recursive decoder signalling through REJECTED and RETIRED and duck-typing fits; why it exists is stated, which types reach fits took a grep
  • bin/rank_todo.py:332 weigh: both table shapes branch inside weigh, score and cited_goals_failure, so a scoring change must be made right in several places; nothing collects the shape logic
  • bin/routing_figures/measure.py:104 measured: many collaborators and a proportional cost scaling, a ChunkFigures docstring defining every field in one paragraph, and rung_at comparing timestamps as strings without saying why that holds
  • bin/loop_claude/cycle/prompts.py:55 review_launches: sentences that branch on route, project rung and taken-in state, a second copy of routing.py's rung rules in English; the worked examples help
  • bin/model_routing/route.py:84 route_from: JSON and legacy regex lines both parse, RETIRED covers removed rungs, and nothing says when a form may be dropped
  • bin/loop_claude/loop/main.py:1 module docstring: 120 lines of contract before the first import, which routed and closed_cycle only make sense against
  • bin/rule_hook/repeat_read.py:72 shown_lines: rebuilds which lines a Read showed from transcript results with truncation heuristics and string-compared timestamps; the module docstring mostly resolves it

Maintainability senior, hardest first:

  • bin/rank_todo.py:218 rank: the largest module, with every scoring step branching on OLD_SHAPE versus SHAPE and checks reaching into README.md and docs/decisions.md; the format docstring doesn't say why two shapes coexist
  • bin/loop_claude/routing.py:76 after_unfinished: three rules in one function, followed only with route.py, escalation_mark.py, verdicts.py and ladder.py open; the docstrings and escalation_mark's overview resolve it eventually
  • bin/loop_claude/loop/reload.py:45 decoded_as: calls kind.fits by naming convention, so Route.fits is action at a distance and a rename breaks the reload silently; the LoopRun comment warns about fields, not this hook
  • bin/chunk_pick.py:109 next_release: the earliest release after the tag depends on renames across historical todo.md texts; chunk_preflight restates the rule, the rename tracking stays subtle
  • bin/loop_claude/cycle/judge.py:150 run_judge: three kinds of ungrounded evidence end three ways, Rejected and retried, an Interrupt, or a silently dropped escalation; the Grounds comments resolve it
  • bin/model_routing/review_choice.py:21 chosen: the higher loop records the lowest E + I per rung, and its or clause needs replay_applies and reviewers_rung from ladder.py; one terse comment
  • bin/loop_claude/cycle/prompts.py:104 escalation: sentences assembled from ReviewChoice over three cases, the output described only by docstring examples
  • bin/rank_todo.py:428 place: recursive topological placement with path-based loop detection, traced by hand

Inherited architect, would restructure first:

  • bin/rule_hook/round_cap.py:24 earlier_titles: the round cap holds only at commit time, nothing refuses a third launch, and when git fails or no default branch is recorded it fails open; three files to establish that
  • bin/round_titles.py:8 CAP: the bin/ root holds about 60 entries, launchers, tool packages, shared modules and single-file tools at one level, told apart only by naming; the worst level
  • bin/loop_claude/effects.py:36 Effects: 18 callables in loop-claude's home, yet imported by review_replay, loop_inbox and routing_check, so the README's claim that shared code lives at the bin/ root doesn't hold, and every feature adds a field every sharer pays for
  • bin/git_command.py:17 commits: reads as "run a git command" but parses git commit out of shell words, one of three git modules
  • bin/rule_hook/rules.py:139 command_breaches: some checks sit here, others in their own modules joined by main.py's bash_breaches, so adding a rule needs a choice the code doesn't explain
  • bin/rule_hook/reviewer_report.py:10 REVIEWERS: a second source of truth for who is a reviewer, beside review_passes.py's table of the same name
  • bin/loop_claude/routing.py:76 after_unfinished: "routing" spans loop_claude/routing.py, model_routing, routing_check, routing_figures and rung_replay
  • bin/loop_claude/loop/main.py:169 run_loop: a fan-in of about 25 modules

2026-10-29T19:59:03Z, PR #397 at 1723469, against 77ab11e

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same worse better same same
Inherited architect same worse better same same

Mid A, decided by:

  • Locality: bin/loop_claude/loop/main.py:182 run_loop: the line after shown_running rebinds paths.waiting to listed.folder, a private unlisted folder when the lock can't be taken; interrupt and routing_check read paths.waiting with no way to see the swap
  • Locality: bin/loop_claude/waiting.py:123 listed: works only when the caller passes the folder running_loops.shown_running yields; in the base the ask carried its own liveness check
  • Locality: bin/loop_claude/cycle/prompts.py:72 review_launches: types out the "Markdown no agent follows" list by hand instead of deriving it from INSTRUCTION_FILES and INSTRUCTION_FOLDERS in bin/rule_hook/reviewer_rung.py:22
  • Shape: bin/loop_claude/verdicts.py:6 TakenIn: three loose fields on each verdict become one named value, and taken_in_from in bin/loop_claude/cycle/judge.py:139 takes the clamping out of verdict_from
  • Navigation, Self-sufficiency: bin/loop_claude/running_loops.py:1 module docstring: leads from "loop-inbox doesn't show my loop" to the mechanism as directly as the base's pointer to waiting.py; session_lock.py still sends the reader to docs/decisions.md for why lock files stay

Inherited architect, decided by:

  • Locality: bin/loop_claude/loop/main.py:182 run_loop: rebinds paths.waiting to listed.folder, a throwaway unlisted/<id> folder where another loop holds the lock; cycle/interrupt.py and loop/routing_check.py write questions to a folder they can't see was swapped, explained only at Listed.folder
  • Locality: bin/loop_claude/running_loops.py:3 module docstring: liveness moved from one Ask.pid field to a flock shared by session_lock.py, running_loops.py and waiting.py, and listed has a precondition stated only in its docstring
  • Locality: bin/loop_claude/cycle/prompts.py:72 review_launches: its "Markdown only" list repeats INSTRUCTION_FILES and INSTRUCTION_FOLDERS in bin/rule_hook/reviewer_rung.py:22 and the skill's "Markdown only" section, with nothing tying them together
  • Locality: bin/loop_claude/running_loops.py:83 locked_soon: the flock lapses for a moment when the reload execs into the edited script inside the with at bin/loop_claude/loop/main.py:185, and no comment says so; the nested ExitStack takes more than one read
  • Shape: bin/loop_claude/verdicts.py:6 TakenIn: one value replaces the highest_*_taken_in pair repeated across three verdicts, and taken_in_from checks the ranges in one place
  • Shape: bin/rule_hook/reviewer_rung.py:22 prose: the name hides "Markdown no agent follows", and markdown_only runs git inside a hook module that was pure
  • Navigation: bin/loop_claude/session_lock.py:1 module docstring: small, well-named modules lead to the protocol quickly, against liveness now spread over three files
  • Self-sufficiency: bin/loop_claude/session_lock.py:1 module docstring: a new pointer to docs/decisions.md, offset by the in-place explanations at Listed.folder and fetched_todo

2026-10-29T20:01:40Z, PR #397 at 1723469

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6 6
Mid A 7 6 6 6 6
Maintainability senior 7 6 6 6 6
Inherited architect 6.5 6 5.5 7 6
Mean 6.88 5.88 5.88 6.25 6.00

Junior A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: eight names held at once to follow one call; the docstring resolves it only after escalation_mark.py and rules/todo-items.md
  • bin/rank_todo.py:568 score: every scoring step branches on SHAPE against OLD_SHAPE, so each function reads twice; nothing says when OLD_SHAPE can go
  • bin/loop_claude/cycle/run.py:56 run_cycle: the route swaps on a step-up outside transition, and archive_stepped and ask touch it too, so where the rung changes has three answers
  • bin/loop_claude/loop/reload.py:47 decoded_as: a recursive reflection-based decoder with two sentinels and a duck-typed fits; the comments give the reason
  • bin/loop_claude/cycle/prompts.py:55 review_launches: six conditional sentences; checking one branch needs ladder.py's review_rungs and replay_applies
  • bin/loop_claude/cycle/judge.py:185 quotes_checked: the misquote rule splits across judge.py and escalation_mark.py, and grounded's fragment matching is subtle
  • bin/comprehension_history.py:164 worse_places: one nested comprehension to unroll by hand
  • skills/larv-review/SKILL.md:84 "Re-entry": a table plus exceptions across 🔴, 🟡, the cap and round 2

Mid A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: five near-synonymous rung helpers held at once, and one docstring sentence packs five rules; resolved only across escalation_mark.py, ladder.py and route.py
  • bin/loop_claude/cycle/run.py:169 ask: step_up threads through three states, and which route each archived line names matters only for routing_figures/measure.py's rung_at
  • bin/loop_claude/loop/reload.py:47 decoded_as: a recursive decoder with two sentinels and duck-typed hooks that Route defines far away
  • bin/rank_todo.py:428 place: recursive with loop detection, in the largest module, which keeps two table shapes side by side
  • bin/chunk_pick.py:109 next_release: Upcoming.landed is bool | Failure, and "landed" has four meanings across modules
  • bin/loop_claude/cycle/prompts.py:55 review_launches: six conditional sentence kinds coupled to the routing rules
  • bin/comprehension_history.py:159 scored: two look-alike predicates that differ on history formats named only by PR numbers
  • bin/loop_claude/loop/main.py:1 module docstring: about 120 lines, every sentence a rule, restated again by the units

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: four rules in one pass over four near-synonym callees; the docstring lists them, but they still had to be simulated by hand
  • bin/loop_claude/cycle/run.py:56 run_cycle: cycle.route is replaced inside the loop on a step-up, and a StepUp pair rides through the states so each archive line names the right rung
  • bin/loop_claude/loop/reload.py:47 decoded_as: a recursive decoder with sentinels and a duck-typed fits; nothing at the call site says which LoopRun fields survive a reload
  • bin/loop_claude/cycle/prompts.py:55 review_launches: sentences branch on ladder positions, so checking one means computing rungs by hand
  • bin/routing_figures/measure.py:104 measured: nine locals, timestamps matched as strings cut to the second, and price rescaling on one screen
  • bin/rank_todo.py:332 weigh: the OLD_SHAPE compatibility is spread across many functions rather than cut at the boundary
  • bin/comprehension_history.py:159 scored: differs from newest_scored only by a carve-out dated by a PR number
  • bin/loop_claude/cycle/judge.py:185 quotes_checked: three quotes checked against three texts, each misquote with its own outcome; the exit-1 path takes four files

Inherited architect, would restructure first:

  • README.md:129 module map: names bin/'s 18 root modules only as a group, at a level of about 50 entries
  • bin/round_titles.py:8 CAP: the round cap lives here and in bin/rule_hook/round_cap.py:8, not in larv_review/, and nothing says it counts commit titles rather than launches
  • bin/loop_claude/routing.py:76 after_unfinished: step-up and escalation logic spans about eight files, from cycle/run.py to loop/main.py's stepped_route
  • bin/loop_claude/running_loops.py:1 module docstring: the inbox file protocol sits inside loop_claude though loop-inbox imports it
  • bin/rule_hook/git.py:7 git: shadows bin/git_repo.py:26 git, and reviewer_rung.py imports and calls both
  • bin/rung_replay/search.py:17 Item: TypeVars named Item and Reply collide with todo_table.Item and judge.py's Reply
  • bin/branch_chunks/cut.py:22 Commit: a second Commit dataclass with other fields than bin/git_command.py:10's

2026-10-29T20:02:43Z, PR #397 rerun at 1723469

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 5.5 6
Mid A 7 6 6.5 6.5 6.5
Maintainability senior 6.5 5 6 5 5.5
Inherited architect 6.5 6 5.5 7 6
Mean 6.75 5.63 6.00 6.00 6.00

Junior A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: several conditions combine and hand off to six near-synonym rung helpers; the why sits behind docs/decisions.md
  • bin/loop_claude/loop/reload.py:47 decoded_as: a recursive decoder with sentinels and an unwritten fits convention, followed only by tracing one call by hand
  • bin/routing_figures/measure.py:104 measured: many jobs in one function, coupled to costed and a long comprehension in render
  • bin/comprehension_history.py:130 newest_scored: a Markdown file parsed as a database, with back-compat notes dated by PR numbers
  • bin/chunk_pick.py:166 named_releases: "release" is split across chunk_pick, todo_table and larv_review/plan.py
  • bin/rank_todo.py:428 place: recursive, with OLD_SHAPE threaded through a 658-line file whose help text is the format spec
  • bin/loop_claude/cycle/judge.py:185 quotes_checked: quote checks layered across three functions and escalation_mark.py
  • bin/rule_hook/repeat_read.py:72 shown_lines: timestamps compared as text, and Read and Bash reads treated differently

Mid A, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: folds five rules into one function, and the cap it enforces is spread across five files
  • bin/loop_claude/loop/reload.py:47 decoded_as: a hand-written decoder with two sentinels, a union rule for RETIRED and a fits hook found by getattr; three passes to follow
  • bin/rank_todo.py:568 score: two table shapes run through scoring, weighing and validation, and nothing says which is leaving
  • bin/loop_claude/cycle/prompts.py:55 review_launches: six sentence groups from one ReviewChoice, with a replay branch that ladder.py's empty REPLAYED leaves without data
  • bin/loop_claude/waiting.py:212 claim_talk: the /talk handshake runs between two programs through files and a flock, with deadlines and a compensating ClaudeEnded
  • bin/rule_hook/repeat_read.py:72 shown_lines: pairs transcript tool calls with results by id and handles truncation markers of a transcript format written down nowhere
  • bin/chunk_pick.py:109 next_release: renamed releases, the history since the last tag and landed work; the rename handling stayed unresolved
  • bin/shell_command.py:44 segments: a heuristic token loop with a redirect-target flag; its docstring lists what it doesn't parse

Maintainability senior, hardest first:

  • bin/loop_claude/routing.py:76 after_unfinished: combines the unfinished count, the escalation cap and whether a step already happened, with inputs built in cycle/run.py; three files open at once
  • bin/loop_claude/cycle/prompts.py:55 review_launches: about six conditional sentence kinds, with no example output beside the function
  • bin/loop_claude/loop/main.py:173 run_loop: the line rebinding paths.waiting to listed.folder quietly points every later question at another folder, explained only at Listed.folder
  • bin/model_routing/ladder.py:97 review_rungs: the Markdown-only exception that lowers a reviewer lives only in bin/rule_hook/reviewer_rung.py:34, and REPLAYED is empty
  • bin/loop_claude/loop/reload.py:47 decoded_as: sentinels, a duck-typed fits and recursion over type hints; which archived shapes decode needs route.py too
  • bin/rank_todo.py:558 goal_term: OLD_SHAPE and SHAPE run through nearly every function, selected by the string "W" or "V"
  • bin/loop_claude/waiting.py:212 claim_talk: a three-step handshake over three files, resolved only by holding the whole protocol
  • bin/loop_claude/cycle/judge.py:207 grounded: a misquote is handled three ways by what was quoted, with no single table of the outcomes

Inherited architect, would restructure first:

  • README.md:129 module map: bin/'s root holds about 64 ungrouped entries, mixing review, plan and infrastructure modules
  • bin/rule_hook/round_cap.py:8 round_cap_breaches: the cap counts round commit titles, while a third reviewer launch is governed only by skills/larv-review/SKILL.md:76 "Round cap"
  • bin/round_titles.py:22 round_counts: any unknown pass name gets its own counter, so a misspelled pass never reaches the cap
  • bin/loop_claude/routing.py:76 after_unfinished: routing has four homes, from model_routing/ to loop/routing_check.py
  • bin/loop_claude/loop/main.py:256 after_verdict: the hub of about 25 imports that every routing or judge feature edits, with stepped_route on the same path
  • bin/loop_claude/stop.py:1 Stop: documented as loop-claude's exit, but rung_replay exits through it and imports cycle.retry too
  • bin/rank_todo.py:71 GOAL_STEP: a separable formula evaluator inside a 658-line, 39-function module
  • bin/chunk_pick.py:1 module docstring: beside bin/chunk_preflight/, the names don't say which does what

2026-11-04T22:52:35Z, PR #415 at 37a412b, against 7681c2b

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Shape: bin/loop_claude/loop/main.py:159 run_loop: reads as a short loop of next_cycle, run_cycle, closed_cycle and check_routing, where the base held routing, preflight, step-up archiving and the unfinished limit beside it; a symptom leads to chunk_start.py or close.py
  • Locality: bin/loop_claude/cycle/run.py:40 Cycle.questions: the questions folder is an explicit field, where the base rebound paths.waiting out of sight for every later reader
  • Locality, Shape: bin/loop_claude/cycle/run.py:191 archived_step: both step-up paths archive through one function and one StepUp, and next_route replaces the after_unfinished/after_ruling pair, denser but in one place
  • Navigation, Shape: bin/loop_claude/waiting/talk.py:1 talk: the 233-line waiting.py is split by role, so a /talk bug opens a 45-line file
  • Navigation: bin/release.py:1 release: every release pattern has one home, where the base spread them over chunk_pick, todo_table and git_repo
  • Locality: bin/release_standing.py:177 dated_cut: what is cut on an untagged branch is worked out again at four call sites, and LastCut.tag is None quietly means it may be cut by a CHANGELOG heading; weaker than the gains above
  • Shape: bin/release_standing.py:1 release_standing: the renamed module's docstring still opens "The next chunk's pick"

Inherited architect, decided by:

  • Navigation, Shape: bin/loop_claude/loop/main.py:186 next_cycle: run_loop reads as the cycle's outline, with a cycle's start in chunk_start.py and its close in close.py, each named for its phase, where the base held about 14 functions in 338 lines
  • Locality: bin/loop_claude/loop/main.py:166 run_loop: passes questions=listed.folder explicitly, where the base rebound paths.waiting for every later call
  • Locality: bin/loop_claude/cycle/run.py:141 rule: archives every interrupt or quoted answer once, as the judge rules, with states.to_the_human the one rule both the transition and the archive read, where the base archived in two places through ran_on
  • Locality, Shape: bin/loop_claude/hand_over.py:23 hand_over: opening claude has one side effect, no longer a hidden write of ~/.claude.json through trust.py
  • Navigation, Shape: bin/release.py:1 release: every release pattern lives in one module, and Release replaces the hand-written tuple
  • Navigation, Shape: bin/loop_claude/waiting/__init__.py:10 waiting: one 234-line module is four of 50 to 80 lines, each a role, at the cost of more imports in its two callers
  • Locality: bin/rule_hook/main.py:75 breaches_of: the repeat-read helpers moved beside their rule in repeat_read.py, so main.py only dispatches
  • Locality: bin/release_standing.py:177 dated_cut: whether a CHANGELOG heading counts as the cut is recomputed at four call sites and not kept in LastCut; worse here, outweighed by the places above, and where it rots first
  • Shape: bin/loop_claude/routing.py:84 next_route: fewer names to learn, a denser body to trace by hand; on balance the same

2026-11-08T18:43:52Z, PR #428 at 4ab3648, against 6e0ef22

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better better same better
Inherited architect same better better same better

Mid A, decided by:

  • Locality, Shape: bin/comprehension_history.py:127 entries: parses each entry once into vote_rows, score_rows, ruled_listings and scored_listings, where the older Entry kept a raw body that every consumer re-parsed under order rules ("the votes table comes first", "the first row wins")
  • Shape: bin/comprehension_history.py:168 newest_commit_runs: says what it returns, where the older newest_scored packed the same logic into one conditional comprehension, and scoring_runs with its caveat is gone
  • Locality: bin/rule_hook/rules.py:161 unlimited_container: asks finds_this_docker of the module beside run-heavy's docker, where the older version did index arithmetic on the words before docker and kept its own resets_path
  • Shape: bin/model_routing/route.py:81 route_from: reads one format, where the older version also kept a legacy regex and legacy_fields
  • Shape: bin/deploy_release/main.py:44 main: a thin dispatcher over deploy.py, cut.py and forge.py, each cohesive

Inherited architect, decided by:

  • Locality, Shape: bin/rule_hook/rules.py:166 unlimited_container: the PATH reasoning now sits in finds_this_docker and resets_path in bin/run_heavy/capped_docker.py:39 next to the docker it describes, and Launch carries word and before
  • Locality, Shape: bin/comprehension_history.py:127 entries: parses each entry once; worse_places reads listing.seat instead of splitting a label, and the tables stay separate so no ordering trap remains
  • Shape: bin/model_routing/route.py:81 route_from: the legacy worker-line format is gone, so one format is left to read and keep in sync
  • Shape: bin/review_replay/main.py:100 main: the old anchor variable is renamed project, matching the project's-rung vocabulary

2026-11-09T11:09:33Z, PR #453 at f213dfb, against 0b77d12

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Shape: README.md:133 bin/ import-root paragraph: the base left 15 shared modules loose beside the launchers; the head puts them in named packages that the README lists with who imports them.
  • Locality, Shape: bin/release_plan/ranking.py:60 rank_file: the base's rank_todo.py was imported as a library by two tools; the head's script is a thin shell, and item 274's weight_of at ranking.py:469 keeps its rule in one function.
  • Shape, Navigation: bin/routing_figures/chunk.py:62 chunk_figures: the base's one 367-line module is split into files named for what they hold.
  • Self-sufficiency, Locality: bin/claude_code/entries.py:18 Entry: the head parses each transcript line into a typed dataclass once, where the base passed raw dicts.
  • Locality: bin/loop_claude/cycle/judge.py:117 Brief: five positional arguments travel as one documented tuple, and the inline checks are named steps.

Inherited architect, decided by:

  • Navigation, Shape: bin/rank_todo.py:88 main: the 660-line script is a launcher and the logic lives in bin/release_plan/ranking.py:60 rank_file, whose callers the README names.
  • Navigation: README.md:132 bin/ import-root paragraph: 32 flat modules became named packages with a map of who reads each.
  • Shape, Locality: bin/routing_figures/chunk.py:62 chunk_figures: four concerns split into files with typed entries.
  • Locality: bin/routing_figures/state.py:45 due: the archive-root state has one owner.
  • Locality: bin/release_plan/ranking.py:469 weight_of: item 274's rule for a maintain point's weight sits in one function instead of two places.

2026-11-10T21:39:35Z, PR #467 at 05539e2, against 98b7bfd

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Locality: bin/loop_state/__init__.py:1 loop_state: the files loop-claude and loop-inbox share have their own package, whose docstring says a change there changes both tools
  • Navigation, Shape: bin/loop_effects/effects.py:1 Effects: the replay tools and the trials driver import loop_effects.effects, not a private-looking loop_claude.effects
  • Locality, Shape: bin/release_plan/ranking.py:1 ranking: blocker order, formula parser and disk I/O moved to named files, so one can change without the score weighting in view
  • Locality, Shape: bin/loop_claude/loop/this_loop.py:12 Loop: seven to nine positional arguments, two of them swappable strings, became one frozen value
  • Locality: bin/loop_claude/cycle/run.py:93 archived: five copies of the archive call became one named helper
  • Navigation: README.md:116 "bin/ map": the map follows the tools directly and testing has its own heading

Inherited architect, decided by:

  • Navigation, Locality: bin/loop_state/__init__.py:1 loop_state: an inbox symptom now lands in a package named for the shared state, not seven modules inside loop_claude/
  • Shape, Locality: bin/release_plan/ranking.py:56 rank: the 550-line module's I/O, formula and blocker order each have an obvious file
  • Locality, Shape: bin/loop_claude/routing.py:84 next_route: each verdict kind has its own function, and steps and below_cap name the two conditions
  • Locality: bin/model_routing/route.py:88 route_of: the archive line and the reload hand-over decode a Route through one decoder
  • Shape: bin/loop_claude/loop/main.py:66 next_cycle: signatures of seven or eight positional parameters shrink to (loop_run, loop)

2026-11-10T23:11:34Z, PR #473 at 13d1550

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6 6
Mid A 7 5.5 6 6.5 6
Maintainability senior 7 5.5 6 6 6
Inherited architect 7 5.5 6 7 6
Mean 7.00 5.50 6.00 6.38 6.00

Junior A, hardest first:

  • Locality, Shape: bin/loop_claude/routing.py:93 unfinished_route: the floor rung, the escalation mark, the unfinished count and the cap are held at once, with escalation_mark.py open beside it
  • Locality, Shape: bin/larv_review/plan.py:66 plan_reasons: eight failure branches mix git reads, file reads and logic, and a parameter named default receives a merge-base commit
  • Locality: bin/larv_review/owed.py:37 shortfall: whether one or two runs are owed hangs on the wording of an English sentence that SKILL.md also keys on
  • Shape: bin/loop_claude/cycle/run.py:59 run_cycle: four near-identical archive helpers and a route replaced partway through the loop
  • Shape: bin/release_plan/ranking.py:56 rank: nearly every function forks on the table's two shapes
  • Self-sufficiency: skills/larv-review/SKILL.md:147 "Scoring run": dense rule prose with many cross-references, three sections to rebuild one rule

Mid A, hardest first:

  • Locality, Shape: bin/larv_review/plan.py:66 plan_reasons: default holds a merge-base commit on one call path and after means the checkout's text, then its items
  • Locality: bin/loop_claude/routing.py:93 unfinished_route: six concepts meet in about twelve lines and need four modules open beside it
  • Locality: bin/larv_review/owed.py:37 shortfall: a rule keyed on the text of a sentence that plan.py builds, and scoring_runs defines a scoring run differently from Entry.scored
  • Locality: bin/loop_claude/cycle/judge.py:211 quotes_checked: a verdict is rewritten four times, half the behaviour in prompt prose and half in code
  • Shape: bin/release_plan/ranking.py:304 score: every function branches on the old and the current table shape

Maintainability senior, hardest first:

  • Locality, Shape: bin/larv_review/plan.py:66 plan_reasons: a merge-base commit enters the parameter named for the default branch, and its error text would print the commit as a branch
  • Locality: bin/larv_review/owed.py:37 shortfall: the one-run-or-two rule is spread over three files and a skill document
  • Locality, Shape: bin/loop_claude/routing.py:93 unfinished_route: the six inputs interlock and a wrong answer runs the worker on the wrong rung without failing
  • Locality: bin/model_routing/route.py:88 route_of: a route has two serializations, a flat archive line and a nested handover
  • Self-sufficiency: bin/larv_review/plan.py:66 plan_reasons: its docstring doesn't say the first argument may be a commit

Inherited architect, would restructure first:

  • Navigation, Shape: bin/larv_review/owed.py:10 owed_scoring_run: the name gives the merge gate's question, not the module's subject, and the scoring-run logic sits in three files whose imports read as circular
  • Locality: bin/larv_review/plan.py:14 EMPTIED_WORDS: prose and code share an exact string that SKILL.md keys on
  • Locality: bin/loop_claude/routing.py:93 unfinished_route: routing logic spreads over about eight places, so a new trigger touches five files in three packages
  • Shape: bin/rule_hook/rules.py:25 RULES: rules sit inline in one module while five others have a module each
  • Navigation: bin/ README.md:116 "bin/": 56 entries in one flat list, the worst fan-out level

2026-11-11T12:55:06Z, PR #475 at 52da15e

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6 6
Mid A 7.5 6 6.5 6.5 6.5
Maintainability senior 7 6 6.5 6 6.5
Inherited architect 7 6.5 6 7 6.5
Mean 7.13 6.00 6.25 6.38 6.38

Junior A, hardest first:

  • Locality, Shape: bin/loop_claude/routing.py:93 unfinished_route: the floor, the escalation cap, the escalation mark, the unfinished count and the taken-in E + I are held at once
  • Locality: bin/loop_claude/cycle/judge.py:211 quotes_checked: the judge's contract is split over prose constants, schema descriptions and post-hoc checks that change a verdict's type
  • Locality: bin/loop_claude/cycle/run.py:146 rule: archive order carries meaning across run_cycle and loop/close.py:18 closed_cycle
  • Shape: bin/release_plan/release_standing.py:145 next_release: tag, changelog, before-first-release and renamed branches meet in the is_earliest expression
  • Shape: bin/release_plan/ranking.py:56 rank: OLD_SHAPE and SHAPE forks run through nearly every function
  • Self-sufficiency: bin/loop_claude/cycle/prompts.py:59 review_launches: the worker's prompt is built from about ten conditional sentence builders
  • Locality: skills/larv-review/SKILL.md:76 "Round cap": the cap is enforced in four units in two places

Mid A, hardest first:

  • Locality, Shape: bin/loop_claude/routing.py:93 unfinished_route: five things applied in a fixed order across about six helpers; the reason for the floor and cap sits in the decision log
  • Locality: bin/loop_claude/cycle/run.py:146 rule: the order of ruling, rejection and step-up archive writes is stated piecemeal
  • Shape: bin/release_plan/ranking.py:315 weight_of: old-shape branches double the module, and the constants are magic until rules/todo-items.md is open
  • Shape: bin/release_plan/release_standing.py:145 next_release: a three-way boolean on line 167 with no comment for the None and nothing_cut case
  • Locality: bin/rule_hook/repeat_read.py:119 shown_lines: rebuilds which lines are in the agent's context from transcript entries
  • Locality: bin/loop_claude/cycle/judge.py:211 quotes_checked: half of the judge's rules are English constants edited in step with Python
  • Locality: bin/loop_claude/cycle/prompts.py:119 escalation: about 20 sentence builders restate the routing logic

Maintainability senior, hardest first:

  • Shape, Locality: bin/release_plan/release_standing.py:145 next_release: four fallbacks held at once, and is_earliest took three reads
  • Locality: bin/loop_claude/routing.py:93 unfinished_route: the escalation mark's meaning lives in escalation_mark.py, which has to stay open beside it
  • Locality: bin/loop_claude/cycle/judge.py:211 quotes_checked: a bad quote silently changes the verdict's type
  • Shape: bin/release_plan/ranking.py:304 score: every path forks on SHAPE versus OLD_SHAPE
  • Locality: bin/rule_hook/reviewer_rung.py:40 skill_breaches: three cases rest on assumptions made in another function
  • Locality: bin/loop_claude/cycle/run.py:146 rule: order-dependent archive writes that nothing enforces
  • Shape: bin/review_rules/comprehension_history.py:127 entries: a line-by-line parser that tolerates two legacy formats
  • Self-sufficiency: skills/larv-review/SKILL.md:76 "Round cap": dense cross-referencing rules, with the enforcing code in other modules

Inherited architect, would restructure first:

  • Navigation, Shape: README.md:116 bin/: 55 entries at one level, about 31 packages, the worst fan-out level
  • Locality: bin/larv_review/reviewer_header.py:49 unanswered_round: the round cap counts answer commits, so a worker that relaunches without committing gets the same round number, and the rule is split over SKILL.md and three modules
  • Locality, Shape: bin/loop_claude/routing.py:93 unfinished_route: seven counters and limits across five files, with field names frozen by the reload handover
  • Locality: bin/chunk_pr/main.py:42 forge: the forge helpers live in chunk_preflight and deploy_release, so a second forge needs edits in four packages
  • Shape: bin/records/__init__.py:1 records: one name for three concepts, as cut and Plan also name several
  • Locality: bin/loop_claude/cycle/run.py:86 archived: the archive helpers that loop/close.py imports sit in the cycle runner

2026-11-12T18:40:20Z, PR #510 at 62faf32

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 6.5 5 5.5 4.5 5.5
Mid A 7 6 6.5 5 6
Maintainability senior 7 6 6 5 6
Inherited architect 6.5 7.5 6 5.5 6.5
Mean 6.75 6.13 6.00 5.00 6.00

Junior A, hardest first:

  • Locality, Shape: bin/loop_claude/routing.py:84 next_route: item rung, floor, cap, escalation mark and unfinished count spread over four modules, and the reasons sit in the decision log
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: each check silently demotes the verdict's type, and INTERRUPT_RULES is policy held as a prompt string
  • Locality, Shape: bin/loop_claude/cycle/run.py:154 rule: one function reads, judges, archives and steps up in an order a comment alone states
  • Self-sufficiency: skills/larv-review/SKILL.md:35 "Passes": about 200 lines of nested conditions whose terms are defined at the end of CLAUDE.md
  • Shape: bin/larv_review/main.py:173 main: a 150-line docstring doubles as the spec of about 12 subcommands in one elif chain
  • Locality, Shape: bin/release_plan/ranking.py:304 score: two table shapes and a hidden comprehension-history input
  • Locality: bin/larv_review/scoring_setup.py:156 prepare_scoring: code parses two Markdown files, so a prose edit can break it

Mid A, hardest first:

  • Locality, Shape: bin/loop_claude/routing.py:84 next_route: rung, floor, cap, mark and unfinished count feed one choice across four files
  • Self-sufficiency: skills/larv-review/SKILL.md:76 "Round cap": a rule engine in English whose numbers are repeated in code, CLAUDE.md and --help
  • Locality: bin/loop_claude/cycle/prompts.py:61 review_launches: the worker's text is assembled from rung choices and has to be run in the head
  • Shape: bin/command_lines/shell_command.py:46 segments: a hand-written shell tokenizer whose regexes stay opaque
  • Locality: bin/rule_hook/repeat_read.py:119 shown_lines: depends on Claude Code's transcript format
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: five quote checks with different failure modes
  • Shape: bin/release_plan/release_standing.py:145 next_release: many tag, rename and changelog cases in a six-way union
  • Shape: reviewer-merge-trials/driver.py:1 driver: one-off scripts that break the repo's tab and naming conventions

Maintainability senior, hardest first:

  • Locality, Shape: bin/release_plan/release_standing.py:145 next_release: six cases held at once, Cut against cut, and a compound is_earliest condition
  • Shape: bin/release_plan/ranking.py:304 score: SHAPE against OLD_SHAPE threaded through nearly every function
  • Locality: bin/loop_claude/routing.py:84 next_route: rung arithmetic split with escalation_mark.py
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: each layer silently downgrades the verdict
  • Locality, Shape: bin/loop_claude/cycle/run.py:154 rule: order-dependent steps and a 17-field Cycle
  • Locality: bin/larv_review/main.py:173 main: the scoring-run rule is split over plan.py, unopened siblings and a wording match with SKILL.md
  • Self-sufficiency: skills/larv-review/SKILL.md:76 "Round cap": mechanical rules duplicated in three code places, so no copy is authoritative

Inherited architect, would restructure first:

  • Navigation, Shape: README.md:96 bin/: about 100 entries at one level, with the README's two lists as the only map
  • Locality: bin/review_rules/round_titles.py:1 ROUND: the commit-title protocol is parsed in five tools and written in SKILL.md
  • Shape: bin/release_plan/release_standing.py:41 Next: Next, Cut and LastCut each carry more than one meaning
  • Shape: bin/records/__init__.py:1 records: one name for two unrelated concepts, and "plan" and "ruling" also name several
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: the judge's rules are strings coupled to CLAUDE.md's text
  • Shape: bin/rule_hook/rules.py:127 check: round-cap rules sit beside unrelated pin rules in 13 rules
  • Self-sufficiency: bin/loop_claude/routing.py:84 next_route: the reasons cite decision titles the reader cannot see

2026-11-12T18:43:58Z, PR #510 rerun at fba48f3

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 6.5 5 5.5 4.5 5.5
Mid A 7 5.5 6.5 5 6
Maintainability senior 7 5.5 6 5 6
Inherited architect 7 6.5 6 5.5 6
Mean 6.88 5.63 6.00 5.00 5.88

Junior A, hardest first:

  • Self-sufficiency, Locality: skills/larv-review/SKILL.md:80 "Round cap": nested rules that point at CLAUDE.md, standards/, rules/ and decision titles, so three documents stay open at once
  • Locality, Shape: bin/loop_claude/routing.py:93 unfinished_route: floor, cap, mark and unfinished count interact across Route, Rung and escalation_mark
  • Locality: bin/release_plan/release_standing.py:145 next_release: no tag, dated headings, renames and named_releases meet in one function
  • Self-sufficiency, Shape: bin/release_plan/ranking.py:271 goal_weights: paragraph-long docstrings carry the rules, and the constants cite a decision log
  • Locality, Shape: bin/loop_claude/cycle/run.py:154 rule: one function with four near-identically named archive helpers beside it
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: ellipsis matching and a policy that only a misquoted evidence fails
  • Shape: bin/review_replay/main.py:225 code_of: guesses which code was reviewed from archive times and prompt text

Mid A, hardest first:

  • Locality, Shape: bin/release_plan/ranking.py:56 rank: every helper forks on SHAPE versus OLD_SHAPE
  • Locality, Shape: bin/release_plan/release_standing.py:145 next_release: three inputs and six Pick types
  • Locality: bin/loop_claude/routing.py:93 unfinished_route: the rule that a rung never falls spans several functions
  • Locality: bin/loop_claude/cycle/run.py:67 run_cycle: replaces cycle.route partway through its loop, out of sight of transition
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: each check silently demotes the verdict's type
  • Locality: bin/review_rules/comprehension_history.py:240 listings: a Markdown format parsed by regex and shared with larv_review and rank_todo
  • Locality: bin/rule_hook/repeat_read.py:119 shown_lines: rebuilds the agent's context from Claude Code transcripts
  • Self-sufficiency: skills/larv-review/SKILL.md:80 "Round cap": needs docs/decisions.md, rules/* and standards/* open beside it

Maintainability senior, hardest first:

  • Self-sufficiency, Locality: skills/larv-review/SKILL.md:35 "Passes": a process spec in which nothing marks which sentences code enforces, and where
  • Locality: bin/loop_claude/routing.py:93 unfinished_route: rung state shared with escalation_mark.py and model_routing/ladder.py
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: prompt strings are behaviour with no test-shaped boundary
  • Locality, Shape: bin/loop_claude/cycle/run.py:154 rule: the route lives in Cycle outside the state machine, and archive order is only commented
  • Shape: bin/release_plan/ranking.py:304 score: OLD_SHAPE exists only to read old history, and ranking reads a documentation file as data
  • Shape: bin/release_plan/release_standing.py:145 next_release: six Pick variants and layered tag cases
  • Locality: bin/larv_review/scoring_setup.py:65 score_bullets: parses SKILL.md's prose bullets and fails on a count change, so a prose edit is load-bearing

Inherited architect, would restructure first:

  • Locality: bin/review_rules/round_titles.py:59 past_cap: the round cap lives in four code places and in SKILL.md §3, and the hook counts commit titles, not launches
  • Shape, Locality: bin/release_plan/ranking.py:56 rank: OLD_SHAPE branches in six functions, and the module also parses goals and checks decision citations
  • Locality: bin/release_plan/release_standing.py:145 next_release: release standing is also read by larv_review/plan.py, chunk_preflight and loop_claude/routing.py
  • Navigation, Shape: README.md:96 bin/: about 85 entries at one level, with the launcher-to-package rule as the only map
  • Shape: bin/larv_review/main.py:173 main: a 145-line docstring doubles as help beside an elif chain
  • Shape: bin/rule_hook/rules.py:14 RuleName: a Literal that repeats the keys of RULES, as ReviewedPass repeats PASS_AGENTS
  • Self-sufficiency: bin/loop_claude/loop/chunk_start.py:83 fetched_plan: a comment cites a plan item that is deleted when finished

2026-11-12T19:51:29Z, PR #511 at 9a260d2, against 913accf

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better better better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Shape, Overall: bin/review_replay/main.py:75 main: the file is now CLI only, and each job sits in its own module under a docstring stating it; at 913accf one 359-line file mixed them
  • Locality, Shape, Overall: bin/larv_review/main.py:211 COMMANDS: one table row per subcommand feeds dispatch, usage and --help, where 913accf had a 12-arm if/elif chain and a hand-written usage string
  • Locality, Navigation: bin/transcript_archive/outcomes.py:63 spent_block: the Spent block's writer now sits beside its marker and kinds, not in another package
  • Locality: bin/claude_code/entries.py:148 messages: one reader groups assistant turns by message, where three callers each deduplicated by hand with different keep-first and keep-last rules
  • Shape, Self-sufficiency: bin/model_routing/prices.py:23 PRICES: the docstring states both uses of the price list and the comment says prices are archived as in force
  • Self-sufficiency, Locality: bin/larv_review/scoring_setup.py:52 score_bullets: picks anchors and dimensions by how each bullet opens, and the docstring says so; 913accf took them by position and count
  • Shape: bin/review_replay/omit_comparison.py:12 compared: returns the report and leaves printing to main, where 913accf printed, returned an exit code and needed a cast

Inherited architect, decided by:

  • Navigation, Shape, Overall: bin/review_replay/replay.py:1 replay: a failed clone or bad match leads to one file whose docstring names that job; main.py shrank from 359 to 114 lines of wiring
  • Locality, Shape: bin/claude_code/entries.py:148 messages: one reader groups a message's entries, and the keep-first versus keep-last trap the old comment warned about is gone
  • Navigation, Locality: bin/larv_review/main.py:211 COMMANDS: each subcommand's spelling, argument check and action sit in one row that usage and --help are built from
  • Locality: bin/transcript_archive/outcomes.py:63 spent_block: the writer sits beside the marker and parser, and the loop no longer depends on the measuring package for an archive format
  • Shape: bin/model_routing/prices.py:1 prices: the price list moved out of routing_figures once it gained a second reader, and its docstring states both uses

2026-11-12T20:22:47Z, PR #513 at d5a9576, against 0a26bcb

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same better same same better
Inherited architect same better better same better

Mid A, decided by:

  • Locality, Overall: bin/larv_review/scoring.py:10 is_floor_item: the rule for what makes a plan item a floor item lives in one named predicate that both callers use, where 0a26bcb wrote the same test out twice
  • Locality: bin/larv_review/plan.py:28 scoring_run_due: reads is_floor_item(item) and prints a floor item, so the trigger needs no knowledge of the tagline's format

Inherited architect, decided by:

  • Locality, Shape, Overall: bin/larv_review/scoring.py:10 is_floor_item: one named predicate that both scoring_run_due and floor_step call, where each spelled its own substring test at 0a26bcb
  • Shape: bin/larv_review/scoring.py:7 FLOOR_ITEM: the constant is now the tagline's opening phrase and matched as one, where it was a bare substring that any mention matched
  • Locality: bin/larv_review/plan.py:28 scoring_run_due: the reason line reads off the predicate, so the function no longer carries tagline matching

2026-11-12T20:40:16Z, PR #514 at bbd5630, against e705fd8

Ruling: same

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A same same same same same
Inherited architect same same same same same

2026-11-13T01:19:17Z, PR #520 at 8f03747

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 5.5 6
Mid A 6.5 5.5 6 5 6
Maintainability senior 7 6 6 6 6.5
Inherited architect 7 6 6 6.5 6.5
Mean 6.88 5.75 6.00 5.75 6.25

Junior A, hardest first:

  • Locality, Self-sufficiency: bin/loop_claude/routing.py:93 unfinished_route: five notions of rung plus the escalation mark and UNFINISHED_PER_STEP, with each step's reason in the decision log
  • Locality: bin/loop_claude/cycle/run.py:154 rule: stamps, annotates, steps up and archives in an order only the code states, with close.py archiving again
  • Locality, Shape: bin/release_plan/ranking.py:304 score: every function forks on SHAPE versus OLD_SHAPE, with no word on when the old one goes
  • Shape: bin/release_plan/release_standing.py:168 next_release: six Pick types and | Failure or | None fields in LastCut
  • Shape: bin/rule_hook/todo_check.py:22 todo_breaches: three config paths, and why the checkout's own script runs only under same_repo stays unclear
  • Shape: bin/loop_claude/loop/reload.py:220 decoded_route: one dense guard, and renaming a LoopRun field stops a running loop
  • Self-sufficiency: skills/larv-review/SKILL.md:82 "Round cap": needs CLAUDE.md, review-findings.md and the rules files open at once

Mid A, hardest first:

  • Locality, Self-sufficiency: bin/loop_claude/routing.py:93 unfinished_route: five rung notions across four helpers and the escalation mark, the cap's reason only in the decision log
  • Shape, Locality: bin/rule_hook/todo_check.py:22 todo_breaches: four paths, held() and located() answering similar questions differently, and changed hashing a blob by hand
  • Shape: bin/release_plan/release_standing.py:168 next_release: three-way LastCut fields whose None means different things per field
  • Locality: bin/release_plan/ranking.py:304 score: two table shapes branch through scoring, and the weights' reasons sit elsewhere
  • Locality: bin/loop_claude/cycle/judge.py:196 quotes_checked: six checks each turn the verdict into something different
  • Shape: bin/larv_review/plan.py:66 plan_reasons: several failing reads threaded through every branch, and ids=None means something only the callers say
  • Locality: bin/loop_claude/cycle/run.py:154 rule: a fixed order nothing enforces, and an 18-field Cycle passed everywhere
  • Self-sufficiency: bin/larv_review/main.py:1 help: about 150 lines of rules a reader needs before any handler

Maintainability senior, hardest first:

  • Locality, Self-sufficiency: bin/loop_claude/routing.py:93 unfinished_route: six things held at once, and why the rules combine sits behind the decision log
  • Shape: bin/rule_hook/todo_check.py:42 folder_breaches: four cases and a second fork in check_failures, and held neither says what it tells nor that config.top is the main checkout
  • Shape: bin/rule_hook/rules.py:82 todo-rank-check: one help sentence carries three conditions joined by "and"
  • Locality: bin/loop_claude/cycle/run.py:154 rule: archives twice in a set order, and stepped_to changes cycle.route outside the state machine
  • Locality, Self-sufficiency: bin/release_plan/ranking.py:160 weigh: two table formats, and constants whose reason is only "docs/decisions.md records the choice"
  • Shape: bin/rule_hook/main.py:116 bash_breaches: a 200-character return line joining four kinds of breach
  • Locality: bin/larv_review/main.py:1 help: the only full statement of needs-scoring-run and scoring-run-owed, implemented in other modules

Inherited architect, would restructure first:

  • Locality, Shape: bin/chunk_preflight/choices.py:80 forge_of: forge code split across chunk_preflight and deploy_release, which three tools reach into
  • Navigation: bin/records/__init__.py:1 records: file utilities share a name with the judge's records in loop_claude/project/records.py
  • Shape: README.md:3 dated experiments: five research and outreach folders at the root beside the working areas
  • Navigation, Shape: README.md:131 bin/: 66 entries at one level, navigable only through the README's prose map
  • Locality: bin/loop_claude/cycle/run.py:154 rule: rule, close and keep_rejection each archive and map a Failure to Stop(1)
  • Self-sufficiency: bin/rule_hook/round_cap.py:26 earlier_titles: fails open when git cannot list the branch's titles, so a mislabelled round passes

2026-11-13T01:23:02Z, PR #520 rerun at 8f03747

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 6.5 5 5.5 5 5.5
Mid A 7 5.5 6 5.5 6
Maintainability senior 7 6 6 6 6.5
Inherited architect 6.5 6 5.5 6 6
Mean 6.75 5.63 5.75 5.63 6.00

Junior A, hardest first:

  • Shape: bin/release_plan/release_standing.py:168 next_release: a before-first-release constant, cut and named releases, and str | None | Failure fields tracked to where each is checked
  • Locality, Self-sufficiency: bin/loop_claude/routing.py:93 unfinished_route: the escalation rule split across four files, five ideas in a few lines, and the reasons in the decision log
  • Shape: bin/rule_hook/todo_check.py:22 todo_breaches: three paths, the checkout's own script only under same_repo, and a blob hashed by hand
  • Locality: bin/loop_claude/cycle/run.py:67 run_cycle: changes cycle.route away from where the 17-field Cycle is built
  • Locality: bin/larv_review/owed.py:46 shortfall: logic hangs on the exact wording of a sentence SKILL.md also depends on
  • Shape: bin/rule_hook/committed_files.py:14 committed_file_breaches: a reversed-dict dedupe whose choice of copy no comment explains
  • Self-sufficiency: skills/larv-review/SKILL.md:82 "Round cap": every sentence points to another rule, and the code read easier than the prose
  • Shape: bin/release_plan/ranking.py:315 weight_of: old and new table shapes in five functions, and a docstring packing three rules into one sentence

Mid A, hardest first:

  • Locality, Self-sufficiency: bin/loop_claude/routing.py:93 unfinished_route: five things held for one step-up, and why the rules interact lives in the decision log
  • Locality: bin/loop_claude/cycle/run.py:154 rule: archives twice in an order that matters, repeated across run.py and close.py, and nothing guards it
  • Self-sufficiency: bin/release_plan/release_standing.py:168 next_release: BEFORE_FIRST_RELEASE and the earliest test need CLAUDE.md → "Working loop" open beside them
  • Shape: bin/release_plan/ranking.py:56 rank: each function reads as two algorithms interleaved, old shape and new
  • Self-sufficiency: bin/larv_review/plan.py:66 plan_reasons: the 155-line help and the code each state part of when a scoring run is due
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:21 INTERRUPT_RULES: behaviour held in prompt text and schema descriptions the code can't explain
  • Shape: bin/rule_hook/todo_check.py:22 todo_breaches: three branches, and a subprocess path I would not have guessed
  • Self-sufficiency: skills/larv-review/SKILL.md:82 "Round cap": dense rules pointing at each other, some at files out of reach

Maintainability senior, hardest first:

  • Shape, Self-sufficiency: bin/release_plan/release_standing.py:168 next_release: Failure in every LastCut field, a sentinel version and a nothing_cut flag worked through as truth tables
  • Locality: bin/loop_claude/routing.py:93 unfinished_route: five helpers and the escalation mark held at once, the rule kept in no one place
  • Shape: bin/release_plan/ranking.py:160 weigh: the legacy shape doubles every scoring function, and nothing says when it can go
  • Shape: bin/rule_hook/committed_files.py:14 committed_file_breaches: a double-reverse dedupe with no comment
  • Locality: bin/loop_claude/cycle/run.py:154 rule: five steps in a row, overlapping archive helpers, and an order that is the trap
  • Shape: bin/rule_hook/todo_check.py:42 folder_breaches: config.folder to changed but config.top to check_failures, right but a stop to confirm
  • Shape: bin/model_routing/route.py:28 levels_fit: two rules in one boolean, and route_of packs its type checks into one long line
  • Self-sufficiency: skills/larv-review/SKILL.md:82 "Round cap": dense bullets pointing elsewhere, reread before the code matched

Inherited architect, would restructure first:

  • Navigation, Shape: README.md:131 bin/: about 63 entries at one level, with the shared libraries told apart only by README prose
  • Locality, Shape: bin/chunk_preflight/choices.py:80 forge_of: forge identity and forge calls in two tool packages, so a second forge lands in three
  • Navigation: bin/records/__init__.py:1 records: a utility package named like the judge's records, and quote semantics in claude_code/transcript.py:85 verbatim
  • Locality: bin/loop_claude/cycle/run.py:94 archived: archive helpers in the cycle runner, which loop/close.py imports
  • Shape: README.md:3 trial folders: four finished experiments at the root beside the working areas
  • Locality: bin/rule_hook/rules.py:61 round-cap: the cap's wording spelled in SKILL.md, rules.py and round_titles.py
  • Self-sufficiency: bin/rule_hook/round_cap.py:26 earlier_titles: fails open on the unattended path when git cannot list the branch's titles

2026-11-13T02:49:59Z, PR #521 at ade48c57b5, against 6b7392adcb

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Shape, Navigation: bin/release_plan/goals_file.py:34 ranked_goals: the goals-file logic (Void handling, numbering, goal weights) has its own module, which the README names; at the base it sat in a nearly 400-line ranking.py, mixed with table parsing and scoring
  • Locality, Shape: bin/loop_claude/project/premises.py:9 read_premises: shares goals_file.section with the ranking, so a heading rule changes in one place; at the base it repeated the missing, repeated and empty checks
  • Navigation, Shape: bin/loop_claude/quotes.py:4 verbatim: the judge's quoting rule sits beside its only users; at the base it sat in the general transcript reader, where a reader hunting a misquote rejection would not look
  • Shape, Navigation: bin/text_files/markdown_text.py:1 text_files: the package name says what it does; at the base it was records, which in this domain means the judge's records and past panels' records
  • Locality: bin/larv_review/scoring_setup.py:169 prepare_scoring: home is passed in and reads go through one read helper that returns a Failure; against that the function grew longer, and prompt_parts builds the seat-prompts.md path twice
  • Locality: bin/release_plan/plan_file.py:10 rank_file: returns its report lines for the caller to print; at the base it printed to stderr itself
  • Locality: bin/review_rules/round_titles.py:12 OPENING: the round title's spelling sits above the regexes that parse it, so changing the format touches one place

Inherited architect, decided by:

  • Navigation, Shape: bin/release_plan/goals_file.py:24 section: the goals file's sections, numbering, void rule and weights have a module named for what it reads; at the base they sat inside a 400-line ranking module, mixed with table parsing
  • Locality: bin/loop_claude/project/premises.py:17 read_premises: loop-claude's premises and the ranking read ## Goals through one section; at the base each had its own checks, which could drift apart
  • Shape, Navigation: README.md:181 text_files/: the new name tells the truth about a package of Markdown sections, UTC stamps and atomic writes; records/ meant the decision log and the histories in this repo
  • Shape: bin/loop_claude/quotes.py:4 verbatim: loop-claude's quote-matching policy left the shared transcript parser, which now holds only transcript reading
  • Locality: bin/release_plan/plan_file.py:23 report_lines: the library returns lines and the caller decides; at the base rank_file printed to stderr as a hidden side effect
  • Locality: bin/review_rules/review_folder.py:17 made_review_folder: home is passed in from the command table, so each unit's inputs show in its signature; at the base Path.home() was read deep inside
  • Shape: bin/larv_review/scoring_setup.py:169 prepare_scoring: counts against the change: about 75 lines with a dozen early returns, and prompt_parts builds one path twice
  • Shape: bin/review_rules/round_titles.py:13 OPENING: the round-title spelling is written once next to the regexes that parse it

2026-11-15T21:26:29Z, PR #554 at bcb04e3

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 6.5 5 5.5 5 5.5
Mid A 7 6 6.5 6 6.5
Maintainability senior 7 5.5 6 6 6
Inherited architect 6.5 6 5.5 5.5 6
Mean 6.75 5.63 5.88 5.63 6.00

Junior A, hardest first:

  • Locality, Self-sufficiency: bin/loop_claude/routing.py:113 unfinished_route: five rung notions, two step-up counters and a seven-row verdict table at once, and the reasons in the decision log
  • Shape: bin/release_plan/release_standing.py:162 next_release: many edge-case branches and str | None | Failure threaded through every field of LastCut
  • Locality, Shape: bin/loop_claude/cycle/run.py:151 rule: judges, stamps, annotates, steps the rung up and archives, and no single unit owns the archive's order
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:22 INTERRUPT_RULES: policy partly in prompt text and partly in Python checks, with nothing saying which the code enforces
  • Locality: bin/loop_claude/loop/reload.py:95 exec_if_edited: an edit to any .py under bin/ makes a running loop re-exec, and a renamed LoopRun field breaks the reload
  • Shape: bin/model_routing/ladder.py:86 review_rung: a three-way rule whose docstring quotes a whole decision title
  • Self-sufficiency: bin/larv_review/main.py:1 module docstring: twelve subcommands' rules in about 155 lines of prose that cross-reference SKILL.md
  • Shape: bin/loop_claude/loop/chunk_start.py:24 fetched_todo: nearly the same plan read as fetched_plan, told apart only by a docstring

Mid A, hardest first:

  • Shape: bin/release_plan/release_standing.py:162 next_release: a three-state tag, BEFORE_FIRST_RELEASE, nothing_cut and is_earliest held at once, and comments that explain each branch alone
  • Locality: bin/loop_claude/routing.py:113 unfinished_route: five rungs, the escalation mark and the unfinished count feed one answer across three files
  • Locality, Shape: bin/chunk_pr/main.py:298 merged: a while loop around the queue turn, variables bound only on some paths, and no comment stating the loop's invariant
  • Shape: bin/chunk_preflight/main.py:128 preflight: lines 142-143 pack a conditional re-located and an eight-argument Gathered into two lines
  • Shape: bin/release_plan/ranking.py:48 rank: two table shapes branch through the whole module, and the defect rule sits far from where scores are read
  • Self-sufficiency: bin/larv_review/plan.py:77 plan_reasons: six inputs joined into one answer, and why each matters is in SKILL.md §3
  • Shape: bin/rule_hook/env_file.py:34 reaching: and and or mixed without parentheses, and four path spellings in a lookaround regex
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:197 quotes_checked: long prompt text inside the Reply field metadata mixes the prompt with the schema

Maintainability senior, hardest first:

  • Locality, Shape: bin/chunk_pr/main.py:298 merged: a while loop holding a queue turn, approval waits and a done set only on some paths, with no loop invariant stated
  • Locality, Self-sufficiency: bin/loop_claude/routing.py:113 unfinished_route: five rungs, the escalation count and the mark from another file, and each step's reason in the decision log
  • Locality, Self-sufficiency: skills/larv-review/SKILL.md:146 "Comprehension check": paragraphs of four or five conditions, each pointing to a hook, a CLI's help or another rule file
  • Shape: bin/release_plan/release_standing.py:162 next_release: three sources of a cut, the is_earliest expression and LastCut fields typed str | None | Failure
  • Shape: bin/release_plan/ranking.py:136 weigh: two live table shapes double every path, and Shape is built from positional tuples of callables
  • Locality, Shape: bin/loop_claude/cycle/run.py:151 rule: judges, stamps, archives and steps up, beside a 17-field Cycle passed around whole
  • Shape: bin/chunk_pr/main.py:438 remeasure: control flow inside chained isinstance(x, Failure) or … expressions, and finished unpacks five runs by position
  • Shape: bin/chunk_preflight/main.py:128 preflight: the whole fallback logic packed into lines 142-143

Inherited architect, would restructure first:

  • Navigation, Shape: README.md:193 the bin/ roles: about 70 flat entries under bin/, where only this list tells a tool from a library
  • Navigation, Shape: bin/larv_review/main.py:222 COMMANDS: the package named for the review mostly holds the comprehension check, and the review loop is prose in SKILL.md
  • Locality, Shape: bin/chunk_pr/main.py:384 levelled_and_finished: merges, finishes items, pushes, asks whether a scoring run is owed and remeasures under a name that gives two of the five
  • Locality: bin/chunk_pr/main.py:349 unplanned: matches the error text of todo-item show, as finished does, where plan_store reads the plan
  • Navigation: bin/rule_hook/round_cap.py:10 round_cap_breaches: the round cap is enforced in the hook, not in larv_review, where a reader looks first
  • Shape: bin/deploy_release/forge.py:1 module: the forge lives in deploy_release and in chunk_preflight.choices.forge_of, neither a home its name gives
  • Shape: bin/rule_hook/rules.py:26 RULES: the file is the registry and also four rules' checkers, so where a new rule goes is undecided
  • Self-sufficiency: bin/plan_store/stores.py:5 module docstring: cites plan items 365, 366 and 368 as part of the contract, as routing and ladder code cite decisions

2026-11-16T12:09:27Z, PR #560 at 55235a0

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6.5 6 6
Mid A 7.5 6.5 7 6.5 7
Maintainability senior 7 6 6.5 6 6.5
Inherited architect 7 6.5 6 6 6.5
Mean 7.13 6.13 6.50 6.13 6.50

Junior A, hardest first:

  • Locality: skills/larv-review/SKILL.md:90 "Re-entry": six rules held at once with the round cap, the release-review caps and the mechanical-answers exception, as dense prose rather than a decision table
  • Locality, Self-sufficiency: bin/release_plan/release_standing.py:176 next_release: three sources of the cut version and release names replayed from todo.md's history; is_earliest carries the meaning of "the plan is current" without naming it
  • Locality: bin/loop_claude/routing.py:116 unfinished_route: five rungs, a counter and an escalation mark from another module; the docstring table makes it tractable
  • Shape: bin/release_plan/ranking.py:239 score: the OLD_SHAPE and SHAPE split runs through every layer, and weight_of packs a three-way rule into one line
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:197 quotes_checked: six quote kinds each with its own fallback; INTERRUPT_RULES is behaviour the code cannot verify
  • Locality: bin/loop_claude/cycle/run.py:154 rule: the order of stamping, archiving and stepping matters across three functions
  • Shape: bin/loop_claude/cycle/prompts.py:66 review_launches: a prompt assembled from five helpers that may each return nothing

Mid A, hardest first:

  • Locality: bin/loop_claude/routing.py:116 unfinished_route: five interacting rungs, a counter and an escalation mark; the module table resolves it, the escalation-mark rule must stay open beside it
  • Locality: bin/release_plan/release_standing.py:176 next_release: four cut cases plus renamed releases; the order of the checks carries meaning the docstrings don't explain
  • Locality: bin/chunk_pr/main.py:298 merged: a loop around a flock with approval and comment checks and two exception exits; done assigned only under branches
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:197 quotes_checked: the prompt text at judge.py:22 is behaviour written as English
  • Shape: bin/release_plan/ranking.py:239 score: two table shapes double the branches, and weight_of's defect rule needs a second read
  • Self-sufficiency: bin/rule_hook/repeat_read.py:114 shown_lines: ISO-string time comparisons and harness behaviour nothing else lets a reader check
  • Locality: skills/larv-review/SKILL.md:82 "Round cap": Done, Cap and Re-entry cross-reference each other and point out to three other files
  • Shape: bin/chunk_pr/main.py:407 finished: five subprocess results destructured by position

Maintainability senior, hardest first:

  • Locality: bin/release_plan/release_standing.py:176 next_release: four regimes at once; carried reapplied in three places, one relying on zip keeping order
  • Locality: bin/release_plan/ranking.py:239 score: one Score depends on five inputs held in other files, and the two shapes fork every function
  • Locality: bin/loop_claude/routing.py:116 unfinished_route: rungs, a counter and a mark interact; the table resolves most of it
  • Locality: bin/loop_claude/loop/chunk_windows.py:107 start_chunks: about 40 lines under one flock that check the owner, split running from stopped, compute room, read the plan and filter, with local state tracked by hand
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:197 quotes_checked: behaviour split between English rules for a model and verbatim checks
  • Shape: bin/plan_store/jira_epic.py:356 revision_of: indexes an untyped tuple from scores at jira_epic.py:530
  • Locality: skills/larv-review/SKILL.md:82 "Round cap": dense rules with exceptions pointing to other sections and files
  • Self-sufficiency: bin/larv_review/main.py:1 the module docstring: the whole contract of ten subcommands in one block

Inherited architect, would restructure first:

  • Navigation, Shape: bin/release_plan/todo_table.py:1 the plan model: lives under release_plan/, while the plan is also in plan_store/, todo_item/, rank_todo.py and larv_review/plan.py, under three names
  • Locality: bin/review_rules/round_titles.py:63 past_cap: the round cap is split across this, rule_hook/round_cap.py:10, larv-review round-count and SKILL.md's "Round cap"
  • Shape: bin/release_plan/named_code.py:5 named_paths: nothing in the module is code
  • Shape: bin/loop_claude/verdicts.py:11 TakenIn.highest_likelihood: L is a likelihood in the field and a level in the prose
  • Shape: bin/loop_claude/loop/routing_check.py:20 the routing check: "routing" names four concepts across model_routing/, routing_figures/ and this module
  • Navigation: README.md:197 the bin/ package list: the 72-entry bin/ level has only the README's two lists as its index
  • Self-sufficiency: bin/review_rules/round_titles.py:7 CAP: the why is deferred to a decision-log title in a 200 KB file

2026-11-16T12:13:26Z, PR #560 rerun at 55235a0

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7.5 6 7 6.5 6.5
Mid A 7 5.5 6 5.5 6
Maintainability senior 8 6.5 7 7 7
Inherited architect 7 6.5 6 7 6.5
Mean 7.38 6.13 6.50 6.50 6.50

Junior A, hardest first:

  • Locality, Self-sufficiency: bin/release_plan/release_standing.py:176 next_release: five LastCut fields, a sentinel, renames and carried items at once; the is_earliest expression stayed opaque, and the full case table lives only in chunk-preflight's help
  • Locality: bin/loop_claude/routing.py:116 unfinished_route: the escalation mark spans escalation_mark.py, judge.py, verdicts.py, route.py and reload.py
  • Self-sufficiency: bin/rule_hook/folder_search.py:89 skips: mirrors rg's and ag's flag handling, which nothing in the repo lets a reader check
  • Shape: bin/release_plan/ranking.py:239 score: the old-shape branches run through every function of ranking
  • Locality: bin/loop_claude/cycle/judge.py:197 quotes_checked: the verdict changes shape in three places after the checks
  • Navigation: bin/larv_review/main.py:1 the help docstring: 155 lines of rules, with no pointer to the module that enforces each
  • Locality: bin/rule_hook/reviewer_rung.py:19 SEAT: a launch counts as a review by matching prompt sentences kept in Markdown
  • Locality: bin/loop_claude/loop/reload.py:97 exec_if_edited: a running loop re-executes itself on any edit and hands its state over as JSON

Mid A, hardest first:

  • Locality: bin/chunk_pr/main.py:298 merged: done bound only under some branches, and the approval wait is a fall-through rather than a named branch; levelled_and_finished returns a finish failure only after the push
  • Locality: bin/loop_claude/routing.py:116 unfinished_route: five rungs, a counter and a mark; only the module table makes the step line readable
  • Self-sufficiency: bin/release_plan/release_standing.py:176 next_release: three kinds of "none", and the reason carried rewrites releases is a dated call with no rule in the code
  • Shape: bin/release_plan/ranking.py:239 score: two table shapes through every function, and MAINTAIN_WEIGHT's reason in the decision log
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:197 quotes_checked: the judge's prompt is spread over field metadata, rule constants and a sentence from escalation_mark.py
  • Locality: skills/larv-review/SKILL.md:35 "§3. Passes": control flow as prose whose sub-sections point at each other, enforced only partly by code
  • Locality: bin/rule_hook/rules.py:26 RULES: each rule's spec is a paragraph apart from the module that implements it
  • Self-sufficiency: bin/larv_review/main.py:1 the module docstring: the only full spec of a dozen subcommands

Maintainability senior, hardest first:

  • Locality: bin/release_plan/release_standing.py:176 next_release: state from git history, a sentinel, and carried run twice, whose agreement must be checked by hand
  • Locality: bin/loop_claude/routing.py:116 unfinished_route: five rungs, a count and a mark; table cells need the steps docstring to parse
  • Shape: bin/release_plan/ranking.py:144 weigh: two table shapes through every step, and Scoring.weights means different things per shape
  • Shape: bin/plan_store/jira_epic.py:356 revision_of: indexes the untyped tuple scores returns by position
  • Locality: bin/loop_claude/loop/chunk_windows.py:107 start_chunks: a flock, running and dead windows, leaving, room, the restart of stopped windows, held items and a NoItem fallback in one function, with the limit applied again in may_start
  • Locality: bin/chunk_pr/main.py:298 merged: whether done is bound when read depends on three if ready branches lining up
  • Self-sufficiency: bin/loop_claude/cycle/judge.py:22 INTERRUPT_RULES: what the model is asked and what code checks need both files open
  • Self-sufficiency: bin/rule_hook/rules.py:44 RULES: the env-file-read spec is a 120-word string kept in step with code elsewhere

Inherited architect, would restructure first:

  • Locality, Shape: bin/plan_store/stores.py:1 the plan store: release_plan and plan_store import each other, and the goals file sits under release_plan
  • Shape: bin/larv_review/plan.py:22 scoring_run_due: the scoring-run trigger is spread over plan.py, owed.py, unmeasured.py and scoring.py, and plan.py isn't about the plan
  • Locality: bin/review_rules/round_titles.py:45 the round cap: constants, commit enforcement in rule_hook/round_cap.py:10, the launch refusal in larv_review/reviewer_header.py:73, the printout and SKILL.md's prose
  • Shape: bin/loop_claude/cycle/run.py:55 Cycle.todo: says todo.md where the plan may be a Jira epic, as fetched_todo and INTERRUPT_RULES do
  • Shape: bin/loop_claude/hand_over.py:23 hand_over: shares its name with the reload's handover of state in loop/reload.py:36 decode_handed
  • Locality: bin/loop_claude/loop/close.py:18 closed_cycle: a second "close" beside cycle/run.py:234 close
  • Navigation, Shape: README.md:197 the bin/ package list: 74 entries at one level with the README's list as the only index
  • Self-sufficiency: bin/loop_claude/loop/routing_check.py:1 the module docstring: names state.CYCLES_PER_CHECK without saying which module state is

2026-11-16T15:57:39Z, PR #562 at 31da587, against 64454f8

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better better better

Mid A, decided by:

  • Locality, Shape: bin/plan_store/stores.py:1 store: the 234-line module holding the protocol, the markdown backend, the Jira scoring and a deferred import of jira_epic is now a 40-line factory beside plans.py, todo_md.py and scoring.py, with no cycle to keep in mind
  • Locality: bin/record_store/stores.py:34 RecordStore.write: the Confluence store's hidden seen and kept file gave way to held() and write(text, over), so a save is followed without knowing the store's history
  • Navigation, Shape: bin/release_plan/next_chunk.py:57 planned: the next chunk's pick moved out of chunk-preflight's internals beside the release standing, and its Plan became NextChunk, no longer clashing with the store's Plan
  • Locality, Shape: bin/release_plan/release_standing.py:169 standing_of: the plan is weighed against the cut once, where carried, cut_version and named_releases ran in three places
  • Navigation, Shape: bin/atlassian/client.py:1 client: Confluence's auth no longer lives in the Jira plan backend
  • Navigation: bin/notifier/notify.py:10 BACKENDS: both DM backends sit in the notifier's folder
  • Shape: bin/rank_todo.py:119 main: one write path, through FilePlan.rank(), in place of plan_file.py's copy

Inherited architect, decided by:

  • Locality, Shape: bin/record_store/confluence_page.py:84 ConfluencePage.write: the concurrency check shows in the call signature, where it hung on which earlier read ran in which process
  • Shape, Locality: bin/repo_checks/test_package_cycles.py:13 package_imports: the deferred imports that hid the plan packages' cycles are gone, a neutral atlassian package holds the shared client, and a test enforces the rule
  • Navigation, Shape: bin/release_plan/next_chunk.py:57 planned: the pick no longer lives in one CLI's package, and its type is named NextChunk
  • Shape: bin/plan_store/stores.py:18 store: the store is split by purpose, and release_plan/ is no longer a grab bag
  • Locality: bin/release_plan/release_standing.py:169 standing_of: weighed once, with plan_is_current and pick_from naming what they do
  • Locality: bin/plan/todo_table.py:294 item_fields: one check of an item's cells for every backend
  • Locality: bin/plan_store/plans.py:57 no_item: the coupling between chunk-pr and todo-item's message has a name
  • Locality: bin/chunk_pr/main.py:130 step: the config is passed in once, where misfit shelled out to project-config twice
  • Shape: bin/project_config/settings.py:320 SCALARS: one row per one-value setting, where load handled each at four sites
  • Navigation, Self-sufficiency: bin/chunk_preflight/gathered.py:60 Gathered.plan: a stale pointer to choices.plan_name, with two more in next_chunk.py and the README, small next to the gains

2026-11-19T09:23:24Z, PR #633 at 81e8d8a1

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 6 6 5.5 6
Mid A 7 6 6.5 5.5 6.5
Maintainability senior 7.5 6.5 6.5 6.5 7
Inherited architect 7 7 6 6 6.5
Mean 7.13 6.38 6.25 5.88 6.50

Junior A, hardest first:

  • Locality: bin/do_epic/main.py:283 parked_through: one polling loop carries five mutable locals against a now of four types, and a nested conditional must be traced by hand
  • Locality: bin/do_epic/scheduler.py:136 start_chunks: four overlapping sets feed an elif chain whose arm order decides the outcome, under a lock with a second one inside
  • Self-sufficiency: skills/larv-review/SKILL.md:97 "Re-entry": dense rules held at once with the round cap, pointing out to other files
  • Locality, Self-sufficiency: bin/agent_cycle/routing.py:115 unfinished_route: five rungs, a counter and a mark live at once; the why of the caps is only in the decision log
  • Self-sufficiency: bin/agent_cycle/judge.py:235 quotes_checked: six quote checks each with its own fallback; the prompt constants are behaviour guarded by one comment
  • Locality: bin/loop_claude/loop/main.py:108 next_cycle: the order of steps carries meaning the code doesn't state
  • Locality: bin/chunk_pr/main.py:429 levelled_and_finished: order-dependent steps that comments state and nothing enforces
  • Self-sufficiency: bin/rule_hook/rules.py:27 RULES: a rule's only specification is one long sentence with nested unless clauses

Mid A, hardest first:

  • Locality: bin/agent_cycle/routing.py:115 unfinished_route: interacting rungs, a counter and an escalation mark; the module table resolves it
  • Self-sufficiency: bin/agent_cycle/judge.py:235 quotes_checked: the prompt text is behaviour written as English
  • Shape: bin/loop_claude/cycle/prompts.py:132 escalation: a prompt assembled from pieces that may each be empty
  • Locality: bin/agent_cycle/run.py:150 rule: the order of stamping, archiving and stepping matters across functions
  • Self-sufficiency: bin/rule_hook/rules.py:27 RULES: rule text doubles as specification and help
  • Shape: bin/rule_hook/endless_wait.py:93 self_match: long lines and a regex whose cases need a second read
  • Locality: bin/loop_claude/loop/chunk_windows.py:107 may_start: depends on state kept out of sight
  • Self-sufficiency: bin/larv_review/plan.py:80 plan_reasons: reasons whose meaning lives in the skill's text
  • Locality: bin/model_routing/route.py:42 Route: fields used as archive keys elsewhere; the unit this seat least wanted to modify

Maintainability senior, hardest first:

  • Locality: bin/do_epic/main.py:283 parked_through: five mutable locals in one polling loop, and an empty string that means "never parked"
  • Locality: bin/chunk_pr/main.py:429 levelled_and_finished: order-dependent steps, and a context manager that yields a Failure instead of raising
  • Locality, Shape: bin/do_epic/scheduler.py:136 start_chunks: overlapping sets and an elif chain under nested locks
  • Self-sufficiency: bin/agent_cycle/routing.py:115 unfinished_route: the why of the caps sits in the decision log
  • Self-sufficiency: bin/agent_cycle/judge.py:235 quotes_checked: fallbacks change the verdict's type without a signal at the call site
  • Self-sufficiency: bin/rule_hook/rules.py:27 RULES env-file-read: a 130-word sentence is the rule's only specification
  • Shape: bin/plan/ranking.py:239 score: two table shapes double the branches
  • Locality: bin/agent_cycle/run.py:240 close: closing steps whose order matters across the module

Inherited architect, would restructure first:

  • Shape: bin/ root: about 85 entries at once with no split between tools and libraries
  • Locality: bin/do_epic/main.py:11 imports: do_epic reaches into loop_claude's internals
  • Navigation: bin/loop_claude/cycle/ the folder: the name misleads after its code moved to agent_cycle
  • Navigation: bin/agent_cycle/verdicts.py:1 the module: names left from before the move
  • Shape: bin/agent_cycle/run.py:38 Cycle: the config, judge and project fields widen a 16-field value
  • Shape: bin/larv_review/reviewer_header.py:121 Launch: built positionally
  • Self-sufficiency: bin/larv_review/plan.py:25 the module: no docstring says what it holds

2026-11-19T09:27:43Z, PR #633 rerun at 81e8d8a1

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 6.5 5 6 4.5 5.5
Mid A 7 6 6.5 6 6.5
Maintainability senior 7 5.5 6 5.5 6
Inherited architect 6.5 6 5 5 5.5
Mean 6.75 5.63 5.88 5.25 5.88

Junior A, hardest first:

  • Locality, Self-sufficiency: bin/agent_cycle/routing.py:115 unfinished_route: five rungs, a count and the escalation mark held at once; the why sits in the decision log and escalation_mark.py checked must be open beside it
  • Self-sufficiency: bin/agent_cycle/judge.py:235 quotes_checked: six kinds of quote each fail differently, and half the behaviour is prompt text whose load-bearing sentences can't be told apart
  • Self-sufficiency: skills/larv-review/SKILL.md:97 "Re-entry": rules with exceptions to exceptions, cross-referencing other sections and files
  • Locality, Shape: bin/agent_cycle/run.py:150 rule: a 16-field Cycle, long one-line calls, and an archive-before-step-up order only reading order tells
  • Self-sufficiency: bin/rule_hook/rules.py:27 RULES: each rule is one enormous sentence, and its check lives in another module
  • Locality: bin/loop_claude/loop/chunk_windows.py:107 may_start: sets that depend on tmux and lock state out of sight, a lock a second program also takes
  • Locality: bin/loop_claude/loop/reload.py:69 decoded_route: renaming a field stops running loops, and nothing warns at the other end
  • Locality: bin/do_epic/main.py:118 run: argv parsed through interacting booleans, and imports of loop_claude internals

Mid A, hardest first:

  • Locality: bin/do_epic/main.py:283 parked_through: a polling loop holds four variables across three result types, a three-deep chained conditional, and on is None doubling as the first pass; the unit this seat least wanted to modify
  • Locality, Self-sufficiency: bin/agent_cycle/routing.py:115 unfinished_route: five rungs plus a count and a mark held together; the why is cited to the decision log
  • Locality: bin/do_epic/scheduler.py:136 start_chunks: four window sets feed a five-arm chain whose meaning changes with own, inside two nested flocks shared with loop-claude
  • Self-sufficiency: bin/agent_cycle/judge.py:235 quotes_checked: six quote kinds fail differently; much behaviour is an English prompt, and TASK_HEADING is silently an archive format
  • Locality: bin/project_config/settings.py:182 load: a 20-entry list of cross-setting rules, and an assert that depends on it being complete
  • Locality: bin/chunk_pr/main.py:429 levelled_and_finished: a load-bearing order and a short-circuit hidden in failed or run(...)
  • Self-sufficiency: bin/rule_hook/rules.py:27 RULES: each contract is a long English sentence, and nothing ties it to the checking code in eight sibling modules
  • Shape: bin/agent_cycle/stuck_workers.py:52 Watch.check: the condition at line 59 mixes or and and without parentheses over dicts mutated across ticks

Maintainability senior, hardest first:

  • Locality: bin/do_epic/main.py:283 parked_through: four mutable locals across iterations, a side effect correct only because on is reassigned later, and a crash-ordering invariant across three stores; the unit this seat least wanted to modify
  • Locality: bin/do_epic/scheduler.py:136 start_chunks: four overlapping sets from two stores feed a five-arm ladder, and a parked chunk silently restarts down the no-repo path
  • Locality: bin/loop_claude/loop/chunk_windows.py:107 may_start: depends on window names and options, dead flags, archived lines, a flock and predictions, with the schema in agent_cycle/tmux.py
  • Locality: bin/agent_cycle/routing.py:115 unfinished_route: five rungs plus a count and the mark; the table resolves it, the why is in the decision log
  • Locality: bin/chunk_pr/main.py:429 levelled_and_finished: a load-bearing order held together by one-liners where a Failure's truthiness carries the control flow
  • Shape: bin/agent_cycle/run.py:150 rule: archive-then-step-up order, several exits, and very long single-line expressions
  • Locality: bin/project_config/settings.py:182 load: one list encodes the whole validation matrix, whose interactions don't read
  • Self-sufficiency: bin/agent_cycle/judge.py:235 quotes_checked: six quote kinds with different fallbacks; INTERRUPT_RULES is behaviour no code can check

Inherited architect, would restructure first:

  • Locality, Self-sufficiency: skills/larv-review/SKILL.md:89 "Round cap": the cap is spread across three packages and this prose, and nothing in code counts a reviewer's launches
  • Locality: bin/do_epic/main.py:11 imports: do_epic reaches into eight loop_claude modules, over a wire format a renamed field breaks
  • Navigation: bin/loop_claude/cycle/ the folder: it holds prompts and chunk items while the cycle is agent_cycle
  • Shape: bin/agent_cycle/verdicts.py:1 the module: its docstring names a cycle. package that is now agent_cycle
  • Shape: bin/ root: about 80 entries with no grouping, indexed by one dense README paragraph
  • Navigation: bin/loop_state/paths.py:6 Paths: neither state nor loop-specific
  • Self-sufficiency: bin/larv_review/plan.py:25 scoring_run_due: the module holds the scoring-run trigger and has no docstring
  • Locality: bin/review_rules/review_passes.py:8 PASS_AGENTS: code constants that must match sentences in SKILL.md

2026-11-19T13:08:12Z, PR #634 at 914b8dc2, against aedc5ed3

Ruling: better

Seat Navigation Locality Shape Self-sufficiency Overall
Mid A better better better same better
Inherited architect better better better same better

Mid A, decided by:

  • Navigation, Shape, Overall: bin/do_epic/main.py:11 next_cycle: do-epic imports the shared chunk_driver instead of loop-claude's internals, so a do-epic routing symptom no longer leads into loop-claude's main.py
  • Shape, Locality: bin/chunk_driver/chunk_run.py:44 closed_cycle: takes the task as an argument, and do-epic runs on ChunkRun instead of a LoopRun filled with empty fields
  • Navigation, Shape: bin/chunk_driver/cycle_start.py:96 cycle_of: both entry points build a cycle through the same three steps, which the module docstring lists in order
  • Navigation: bin/forge/reviews.py:23 review_decision: one module reads a pull request's review state, where two tools each read part of it
  • Navigation: bin/atlassian/jira.py:1 module docstring: Jira search and transitions sit in the Atlassian package, not in the plan store
  • Locality: bin/wait_for/main.py:30 main: the clock is a visible parameter instead of a patched global

Inherited architect, decided by:

  • Navigation, Locality, Shape, Overall: bin/do_epic/main.py:410 next_cycle: calls the shared project_routing, announced_route and cycle_of, so how a cycle starts changes in one file, not in two kept in step
  • Locality: bin/do_epic/main.py:439 chunk_work: returns EpicReopened instead of handing chunks on from inside a getter
  • Shape, Locality: bin/chunk_driver/chunk_run.py:33 ChunkRun: holds only what do-epic needs; the Run protocol's use of __dataclass_fields__ is clever but commented
  • Navigation, Shape: bin/chunk_driver/claims.py:1 module docstring: the lock and the chunk flags sit in one module named for that job, and starting yields a Failure instead of raising
  • Locality, Navigation: bin/forge/reviews.py:23 review_decision: all review-state reading in forge/, each field shape-checked; three similar names cost a docstring read each
  • Locality: bin/chunk_driver/project/model_choice.py:28 overridden: the model override is one function, where it was spelled out twice

2026-11-19T22:33:15Z, PR #646 at a357cc7b

Seat Navigation Locality Shape Self-sufficiency Overall
Junior A 7 5.5 6 6 6
Mid A 7 6 6.5 6 6.5
Maintainability senior 7 6 6 6 6.5
Inherited architect 7 6.5 6 6 6.5
Mean 7.00 6.00 6.13 6.00 6.38

Junior A, hardest first:

  • Locality, Shape: bin/do_epic/main.py:287 parked_through: the three-step park and resume order, the told and finished flags and a raw string compare held at once; the docstring gives the order but not why the flags exist
  • Locality, Self-sufficiency: bin/agent_cycle/routing.py:115 unfinished_route: floor rung, escalation mark, cap and the count of unfinished verdicts meet in a dozen lines, and the reasons sit in the decision log
  • Shape: bin/agent_cycle/judge.py:237 quotes_checked: six checks each quietly turn one verdict type into another, and the call site doesn't show the result type
  • Locality: bin/do_epic/scheduler.py:144 start_chunks: four overlapping sets, a five-branch chain, a counter and nested locks shared with loop-claude
  • Shape: bin/agent_cycle/run.py:150 rule: runs the judge, stamps, annotates, steps up and orders the archive writes, beside four near-identical archive helpers
  • Locality: bin/agent_cycle/stuck_workers.py:52 Watch.check: mutates self.cpu and self.judged out of sight, and one condition mixes and and or without parentheses
  • Shape: bin/do_epic/gates.py:42 gate: a long ordered chain where a missing value means something different on each line
  • Locality: bin/loop_claude/loop/reload.py:36 decode_handed: pops legacy fields from a handover the old process wrote before it replaced itself; nothing enforces the coupling
  • Self-sufficiency: skills/larv-review/SKILL.md:89 "Round cap": three sections must be open at once to tell whether a fix reruns a pass
  • Self-sufficiency: bin/agent_cycle/verdicts.py:41 the comment: points to cycle.judge.re_ask_checked, a module path that doesn't exist

Mid A, hardest first:

  • Locality: bin/do_epic/main.py:354 resumed_news: a while True poll that carries said and shown across turns, with a nested-quote f-string; no comment says what holds when the loop exits
  • Locality, Self-sufficiency: bin/do_epic/main.py:287 parked_through: three steps whose correctness depends on each other; the reason for the order sits in the decision log
  • Locality: bin/do_epic/main.py:241 chunk_run: news, told, finished and the reopened-epic exit held across iterations
  • Locality: bin/do_epic/scheduler.py:144 start_chunks: a five-branch chain over four sets, counted under nested locks
  • Shape: bin/project_config/settings.py:187 load: about twenty comprehension clauses build one faults list, so finding what one setting requires means scanning all of them
  • Locality: bin/agent_cycle/routing.py:115 unfinished_route: five rung concepts at once, readable only with bin/model_routing/ladder.py open beside it
  • Shape: bin/chunk_pr/main.py:447 levelled_and_finished: checks whether a scoring run is owed, which its name doesn't suggest
  • Locality: bin/plan/ranking.py:239 score: the formula forks on the old and the new table shape, both live
  • Self-sufficiency: bin/larv_review/main.py:1 the module docstring: about 165 lines that restate what COMMANDS and the modules it calls enforce

Maintainability senior, hardest first:

  • Locality, Shape: bin/do_epic/main.py:287 parked_through: the told, finished and news interplay, the human-merge cases and the three-step order held at once, and no code enforces the order
  • Locality, Shape: bin/do_epic/main.py:354 resumed_news: a loop that mutates five locals and builds its message in a nested f-string, with no stated invariant
  • Locality: bin/agent_cycle/routing.py:115 unfinished_route: five rungs, an unfinished count, the escalation mark and the cap held together; each threshold's reason sits in the decision log
  • Shape, Self-sufficiency: bin/project_config/settings.py:187 load: about 20 comprehension expressions each encode a rule linking two settings; named predicates would make each rule findable
  • Shape, Locality: bin/chunk_pr/main.py:314 merged: the merge-queue loop with its flags, where a variable carries either a string or a Failure and each read must work out which
  • Locality: bin/plan/ranking.py:239 score: the old and new table shapes run through the whole module, so each change is checked against both
  • Locality: bin/larv_review/plan.py:21 Emptied: a str subclass whose type carries meaning, lost without warning by any code that rebuilds the string
  • Locality: bin/agent_cycle/judge.py:76 TASK_HEADING: an archive key, so rewording it breaks replays in another module, and only a comment warns
  • Self-sufficiency: skills/larv-review/SKILL.md:89 "Round cap": the review rules exist three times, here, in the help at bin/larv_review/main.py:1 and in rule-hook's code

Inherited architect, would restructure first:

  • Locality, Shape: bin/rule_hook/round_cap.py:10 round_cap_breaches: the round cap lives in four places across three packages, and none owns the whole invariant; rounds are counted from commit titles, never from launches
  • Navigation, Shape: README.md:225 "Packages under bin/": 84 entries listed alphabetically in dense prose, with no grouping by layer
  • Shape: bin/loop_claude/loop/reload.py:18 LoopRun: loop-claude's core run state defined in a module named for self-reloading
  • Shape: bin/agent_cycle/judge.py:116 Rejected: says loop-claude rejected the reply, in a module do-epic shares
  • Self-sufficiency: bin/agent_cycle/run.py:103 the comment: cites close.py, which doesn't exist
  • Self-sufficiency: bin/agent_cycle/verdicts.py:41 the comment: cites cycle.judge.re_ask_checked, a stale module path
  • Navigation: bin/chunk_driver/drivers.py:1 the module: "entry point" and "driver" name one concept, and Run, ChunkRun and LoopRun are one concept in three types
  • Navigation: bin/do_epic/status.py:1 the module: in no map, and the package's __init__.py is empty like 40 others
  • Locality: reviewer-merge-trials/driver.py:4 the imports: a frozen trial imports live code under bin/, so a refactor there breaks a record
  • Self-sufficiency: bin/agent_cycle/routing.py:92 the comment: one of 109 citations of the decision log that carry a unit's reason