docs(plans): flip workflow to one PR per session#149
Merged
Conversation
Retire the "batch all PRs in one session, sweep Codex review-by- review" pattern. Owner observation 2026-04-26: cramming multiple PRs into one session muddies context, degrades solution quality, and nets out slower than expected. New rule: each Claude session ships exactly one PR end-to-end — implement, verify, push, ride Codex iteration to 👍 in the same session, merge, stop. Cross-session parallelism via separate agents/worktrees stays fine. - 2026-04-25-comprehensive-polish-and-harden.md: rewrote the Workflow section, the "How to pick this up next session" checklist, and softened the parallel-batches sequencing blurb. - 2026-04-26-quality-automation-routines.md: clarified the one-PR-per-chunk rationale points at sessions/agents in parallel, not multiple PRs in one session. Memory updates landed in the user-private auto-memory store (outside repo); MEMORY.md index there now leads with feedback_one_pr_per_session.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3 tasks
Luis85
added a commit
that referenced
this pull request
Apr 26, 2026
## Summary Update `feedback_autonomous_merge_after_codex.md` to reflect two operational shifts already in practice: - **Project switched to squash-merge** post-PR #119. Every PR from #133 onward lands as a squash commit (`<type>: <subject> (#NNN)`). Previous `gh pr merge <n> --merge --delete-branch` recipe returns `enablePullRequestAutoMerge` GraphQL error. - **Post-squash topic branches need `-D`** for cleanup. The squash creates a NEW commit SHA, so the local topic branch is no longer an ancestor of develop and `git branch -d <topic>` fails. Also documents the `--auto` flag for cases where `gh pr merge` is fired while required checks are still mid-run. ## Files changed - `.claude/memory/feedback_autonomous_merge_after_codex.md` — `--merge` → `--squash`, `-d` → `-D`, plus the `--auto` note. ## Test plan - [x] `npm run verify` green locally (format:check + lint + typecheck + 588 tests + build + typedoc) - [x] No `src/**` changes — memory-doc only - [x] No changeset (per `CLAUDE.md`: docs/refactor/chore PRs skip changesets) ## Notes for review - This recipe was used end-to-end on PR #149 a few minutes before this PR — `--squash --delete-branch` with `--auto`-equivalent timing worked clean. - Rule violation flagged: this is a second PR opened in the same Claude session as #149. Owner explicitly requested it after #149 landed; cited as override of the new one-PR-per-session rule for a trivial single-file memory doc update.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Files changed
docs/plans/2026-04-25-comprehensive-polish-and-harden.md— rewrote the Workflow section + How to pick this up next session checklist; softened the Sequencing at a glance "parallel batches" blurb to read as cross-session parallelism.docs/plans/2026-04-26-quality-automation-routines.md— clarified the one-PR-per-chunk rationale points at sessions / agents in parallel, not multiple PRs inside one session.Test plan
npm run verifygreen locally (format:check + lint + typecheck + 588 tests + build + typedoc)src/**changes — docs-onlyCLAUDE.md: docs/refactor/chore PRs skip changesets)Notes for review
C:\Users\lum\.claude\projects\D--Projects-agent-library\memory\— those persist across Claude sessions but are outside the repo by design..claude/memory/directory has an unrelated preexisting dirty file ondevelop(squash-merge default note infeedback_autonomous_merge_after_codex.md) that is deliberately not bundled here — separate concern, separate session.docs/archive/plans/2026-04-24-polish-and-harden.mdstill references the retired batch workflow. Left untouched — it's history.