Skip to content

Commit c0681bb

Browse files
alicodingclaude
andauthored
docs(rules): four primary-sourced session-conduct adoptions from the orchestration-practice research pass (#217)
Reviewer-finding triage, checked post-merge worktree verification (upstream cleanup defect class), the two named failure patterns (kitchen-sink, twice-corrected), and plan-to-disk over compaction reliance. Rejected with reasons recorded in the research record: AGENTS.md interop (no second tool), diagram token-efficiency claims (unverified), script-driven workflows (weaker than closed-world briefs). Claude-Session: https://claude.ai/code/session_01FW5GkkAG8du7tNdYLk2zSd Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent f044326 commit c0681bb

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

.claude/rules/delivery-discipline.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,30 @@ capabilities is goal 0076's audit, not ad-hoc.
7171
SHIPPED, not what was planned.
7272
- Nothing secret-shaped staged; a real commit message.
7373

74+
## Session conduct (adopted from primary-sourced practice, 2026-08-17 research pass)
75+
- **Reviewer findings get triaged, not chased**: a reviewer prompted
76+
to find gaps will report some even when the work is sound —
77+
act only on findings that affect correctness or stated
78+
requirements; the rest is recorded or dropped, never
79+
auto-implemented (over-engineering via review is a named failure
80+
mode in the tool's own docs).
81+
- **Post-merge worktree verification is a CHECKED step**: after an
82+
agent branch merges, confirm the worktree is actually removed
83+
(`git worktree list`) and HEAD sits on the intended branch — the
84+
tool's worktree cleanup has a confirmed upstream defect class
85+
(stale worktrees survive sessions; a leftover checkout makes a
86+
later merge silently no-op "Already up to date" against the wrong
87+
ref). Silent by design; verify, don't assume.
88+
- **Two named session failure patterns** (tool-docs-primary): the
89+
kitchen-sink session (unrelated tasks sharing one context — split
90+
them) and correcting the same thing twice (the third attempt is a
91+
restart-with-a-better-brief, not another correction).
92+
- **Long arcs write state to files, not context**: compaction is
93+
lossy by the tool's own docs — in-session progress that must
94+
survive belongs in the goal file / a plan file at every
95+
significant checkpoint, so a compaction or restart resumes from
96+
disk, not from what the summary preserved.
97+
7498
## Build-health visibility
7599
The ruleset (ADR-0034) already makes main unmergeable-red; confirm,
76100
don't re-enforce:

0 commit comments

Comments
 (0)