Skip to content

Update address-review command to use sequential numbering#2656

Merged
justin808 merged 1 commit intomasterfrom
jg/address-review-sequential-list
Mar 17, 2026
Merged

Update address-review command to use sequential numbering#2656
justin808 merged 1 commit intomasterfrom
jg/address-review-sequential-list

Conversation

@justin808
Copy link
Copy Markdown
Member

@justin808 justin808 commented Mar 17, 2026

Summary

Updated the address-review command's triage presentation to use a single sequential numbering system across all categories (MUST-FIX, DISCUSS, SKIPPED). This makes it easier for users to reference specific items when directing which comments to address.

Pull Request checklist

  • Documentation updated (command documentation)
  • [~] Add/update test to cover these changes (N/A - documentation-only)
  • [~] Update CHANGELOG file (N/A - documentation-only)

Note

Low Risk
Documentation-only change that adjusts the output formatting guidance for triage lists; no runtime or data-handling code is affected.

Overview
Updates the address-review command documentation to require a single sequential numbering scheme across MUST-FIX, DISCUSS, and SKIPPED triage sections, so each item has a unique reference number (instead of restarting numbering per category).

Written by Cursor Bugbot for commit bf21d73. Configure here.

Summary by CodeRabbit

  • Documentation
    • Updated triage results presentation format to use sequential global numbering for improved clarity and easier reference across all categories.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Mar 17, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a8d2266c-5d09-4d64-b47b-8f5f97822463

📥 Commits

Reviewing files that changed from the base of the PR and between f6e44f1 and bf21d73.

📒 Files selected for processing (1)
  • .claude/commands/address-review.md

Walkthrough

The pull request modifies the address-review instruction file to implement global sequential numbering for presenting triage results. This ensures each item receives a unique reference number across all categories rather than restarting numbering per category, affecting only the presentation format.

Changes

Cohort / File(s) Summary
Presentation Format Update
.claude/commands/address-review.md
Added instruction to use sequential global numbering (1, 2, 3, ...) across all triage categories for consistent item referencing in output presentation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

A rabbit hops through numbered lines,
Sequential, clear, by grand design,
No more restarts, just one true flow,
Each item gleams with unique glow! 🐰✨

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch jg/address-review-sequential-list
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@justin808 justin808 merged commit 9b70db6 into master Mar 17, 2026
7 of 8 checks passed
@justin808 justin808 deleted the jg/address-review-sequential-list branch March 17, 2026 02:16
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Mar 17, 2026

Review: Update address-review command to use sequential numbering

This is a clean, minimal documentation change. The single added line is well-placed and unambiguous.

Observations:

  • The new instruction at line 98 is consistent with the existing example output (lines 168–178), which already demonstrates sequential numbering across all categories (1–5 spanning MUST-FIX, DISCUSS, and SKIPPED). This is good — the instruction now explicitly documents the behavior the example already implied.
  • No code, logic, or security surface is affected — this is a pure documentation update to an AI command prompt.
  • The phrasing "Do not restart numbering at 1 for each category" leaves no ambiguity for the LLM following this command.

No issues found. The change improves usability by ensuring each item has a globally unique reference number across all triage categories.

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Mar 17, 2026

Greptile Summary

This PR adds a single clarifying instruction to the address-review command's triage presentation step, explicitly requiring that all triage items share a single sequential number sequence across MUST-FIX, DISCUSS, and SKIPPED categories rather than restarting numbering per category.

  • The example output block (lines 164–180) already illustrated this exact sequential numbering pattern (1., 2., 3., 4., 5. spanning all three categories), so the instruction and the example are fully consistent.
  • The change is documentation-only and has no effect on production code.
  • No issues were found in the change.

Confidence Score: 5/5

  • This PR is safe to merge — it is a one-line documentation clarification with no production code impact.
  • The change is a single added instruction line in a markdown command file, and it is consistent with the already-present example output that already demonstrated sequential numbering. There are no logic changes, no code changes, and no risk of regressions.
  • No files require special attention.

Important Files Changed

Filename Overview
.claude/commands/address-review.md Adds one instruction line to Step 6 explicitly requiring sequential numbering across all triage categories; the existing example output already demonstrated this pattern, so the change is consistent and complete.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A([User runs /address-review]) --> B[Step 1: Detect repo via gh repo view]
    B --> C[Step 2: Parse PR number / URL / fragment]
    C --> D{Input type?}
    D -->|issuecomment| E[Fetch issue comment]
    D -->|pullrequestreview| F[Fetch review comments for review ID]
    D -->|PR number only| G[Fetch all PR review comments]
    E & F & G --> H[Step 3: Filter - skip replies, deduplicate bots]
    H --> I[Step 4: Triage each comment]
    I --> J{Category?}
    J -->|MUST-FIX| K[Add to TodoList]
    J -->|DISCUSS| L[Queue for user decision]
    J -->|SKIPPED| M[Note reason]
    K & L & M --> N["Step 6: Present with SINGLE sequential numbers\n(1, 2, 3, … across all categories)"]
    N --> O[Wait for user direction]
    O --> P[Step 7: Address selected items]
    P --> Q[Post reply to original comment]
    Q --> R{Concern resolved?}
    R -->|Yes| S[Resolve GraphQL thread]
    R -->|No| T[Leave thread open]
Loading

Last reviewed commit: bf21d73

justin808 added a commit that referenced this pull request Mar 17, 2026
Pull in rationale-reply UX improvements from shakapacker's
address-review command while preserving the sequential numbering
instruction unique to this repo.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
justin808 added a commit that referenced this pull request Mar 17, 2026
### Summary

Updated the address-review command's triage presentation to use a single
sequential numbering system across all categories (MUST-FIX, DISCUSS,
SKIPPED). This makes it easier for users to reference specific items
when directing which comments to address.

### Pull Request checklist

- [x] Documentation updated (command documentation)
- [~] Add/update test to cover these changes (N/A - documentation-only)
- [~] Update CHANGELOG file (N/A - documentation-only)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> <sup>[Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) is
generating a summary for commit
bf21d73. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
justin808 added a commit that referenced this pull request Mar 18, 2026
## Summary
- Syncs the `.claude/commands/address-review.md` command with the latest
version from shakacode/shakapacker
- Adds improved rationale-reply UX: after triage, explicitly offers to
post rationale replies for skipped/declined items (only when user
selects them)
- Preserves the sequential numbering instruction unique to this repo

Closes #2656

## Test plan
- [ ] Verify `/address-review` command works correctly with a PR that
has review comments
- [ ] Confirm triage output includes the "Optional: rationale replies"
prompt
- [ ] Confirm sequential numbering across categories still works

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk documentation-only change that adjusts the command’s
interaction guidance without affecting production code paths.
> 
> **Overview**
> Updates `.claude/commands/address-review.md` to add an explicit,
*opt-in* workflow for posting rationale replies on `SKIPPED` or declined
`DISCUSS` items after triage.
> 
> The triage prompt and examples now ask separately which items to
address vs. which items (if any) should receive rationale replies, and
clarify that the optional rationale line should only appear when
applicable.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
553cc35. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Enhanced rationale reply workflow: always offer optional rationale
replies for selected SKIPPED or declined items; rationales are posted
only with explicit user selection.
* Improved prompts and post-triage presentation clarifying which items
to address and which should receive rationale replies.
* **Documentation**
* Updated instructions and examples to show the optional rationale-reply
line only when applicable.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 <[email protected]>
@justin808 justin808 added the Metr-Pending Pending Metr tracking label Mar 18, 2026
justin808 added a commit that referenced this pull request Mar 25, 2026
## Summary

- Stamp `### [16.5.0.rc.0]` version header with today's date
- Add 10 new changelog entries for PRs merged since v16.4.0
- Fix incomplete PR 2818 entry (missing author link)

### New entries added

**Added:**
- `create-react-on-rails-app --pro` support (PR 2818)
- Global prerender env override `REACT_ON_RAILS_PRERENDER_OVERRIDE` (PR
2816)
- `react_on_rails:sync_versions` rake task (PR 2797)
- Pro/RSC setup checks in `react_on_rails:doctor` (PR 2674)

**Changed:**
- [Pro] Canonical env var for worker count is now
`RENDERER_WORKERS_COUNT` (PR 2611)

**Improved:**
- Smoother `create-react-on-rails-app` and install generator flows (PR
2650)
- Pro upgrade hint after install (PR 2642)

**Fixed:**
- Preserve runtime env vars across `Bundler.with_unbundled_env` (PR
2836)
- Fix doctor prerender check and ExecJS display for Pro/RSC apps (PR
2773)
- Fix doctor false positives for custom layouts (PR 2612)

### Skipped PRs (not user-visible)

Docs-only: #2845, #2842, #2826, #2830, #2820, #2809, #2803, #2785,
#2801, #2791, #2789, #2788, #2772, #2778, #2780, #2784, #2671, #2676,
#2662, #2657, #2669
CI/internal tooling: #2825, #2817, #2819, #2812, #2815, #2810, #2808,
#2807, #2634, #2798, #2761, #2760, #2658, #2639, #2667, #2656

## Test plan

- [x] Verified version header and diff links are correct
- [x] Verified all entries follow changelog formatting conventions
- [x] Verified file ends with newline
- [ ] After merge, run `rake release` to publish 16.5.0.rc.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Documentation-only change updating `CHANGELOG.md` with a new
`16.5.0.rc.0` section and compare links; no runtime code is modified.
> 
> **Overview**
> Adds a new `16.5.0.rc.0` (2026-03-25) section to `CHANGELOG.md`,
consolidating recent PR entries under **Added/Changed/Improved/Fixed**
and correcting the previously incomplete `--pro` CLI entry author
attribution.
> 
> Updates the bottom compare links so `[unreleased]` now compares from
`v16.5.0.rc.0` and adds a link definition for `[16.5.0.rc.0]`.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
481a71c. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes - v16.5.0.rc.0

* **New Features**
  * Added sync_versions task for streamlined version management
  * Expanded doctor checks for Pro and RSC support

* **Improvements**
  * Enhanced generator workflow and Pro upgrade guidance
  * Improved environment variable handling and preservation

* **Bug Fixes**
* Fixed detection issues with doctor tools and ExecJS/prerender
functionality

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
justin808 added a commit that referenced this pull request Mar 30, 2026
### Summary

Updated the address-review command's triage presentation to use a single
sequential numbering system across all categories (MUST-FIX, DISCUSS,
SKIPPED). This makes it easier for users to reference specific items
when directing which comments to address.

### Pull Request checklist

- [x] Documentation updated (command documentation)
- [~] Add/update test to cover these changes (N/A - documentation-only)
- [~] Update CHANGELOG file (N/A - documentation-only)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> <sup>[Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) is
generating a summary for commit
bf21d73. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
justin808 added a commit that referenced this pull request Mar 30, 2026
## Summary
- Syncs the `.claude/commands/address-review.md` command with the latest
version from shakacode/shakapacker
- Adds improved rationale-reply UX: after triage, explicitly offers to
post rationale replies for skipped/declined items (only when user
selects them)
- Preserves the sequential numbering instruction unique to this repo

Closes #2656

## Test plan
- [ ] Verify `/address-review` command works correctly with a PR that
has review comments
- [ ] Confirm triage output includes the "Optional: rationale replies"
prompt
- [ ] Confirm sequential numbering across categories still works

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk documentation-only change that adjusts the command’s
interaction guidance without affecting production code paths.
> 
> **Overview**
> Updates `.claude/commands/address-review.md` to add an explicit,
*opt-in* workflow for posting rationale replies on `SKIPPED` or declined
`DISCUSS` items after triage.
> 
> The triage prompt and examples now ask separately which items to
address vs. which items (if any) should receive rationale replies, and
clarify that the optional rationale line should only appear when
applicable.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
553cc35. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Enhanced rationale reply workflow: always offer optional rationale
replies for selected SKIPPED or declined items; rationales are posted
only with explicit user selection.
* Improved prompts and post-triage presentation clarifying which items
to address and which should receive rationale replies.
* **Documentation**
* Updated instructions and examples to show the optional rationale-reply
line only when applicable.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 <[email protected]>
justin808 added a commit that referenced this pull request Apr 6, 2026
### Summary

Updated the address-review command's triage presentation to use a single
sequential numbering system across all categories (MUST-FIX, DISCUSS,
SKIPPED). This makes it easier for users to reference specific items
when directing which comments to address.

### Pull Request checklist

- [x] Documentation updated (command documentation)
- [~] Add/update test to cover these changes (N/A - documentation-only)
- [~] Update CHANGELOG file (N/A - documentation-only)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> <sup>[Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) is
generating a summary for commit
bf21d73. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
justin808 added a commit that referenced this pull request Apr 6, 2026
## Summary
- Syncs the `.claude/commands/address-review.md` command with the latest
version from shakacode/shakapacker
- Adds improved rationale-reply UX: after triage, explicitly offers to
post rationale replies for skipped/declined items (only when user
selects them)
- Preserves the sequential numbering instruction unique to this repo

Closes #2656

## Test plan
- [ ] Verify `/address-review` command works correctly with a PR that
has review comments
- [ ] Confirm triage output includes the "Optional: rationale replies"
prompt
- [ ] Confirm sequential numbering across categories still works

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk documentation-only change that adjusts the command’s
interaction guidance without affecting production code paths.
> 
> **Overview**
> Updates `.claude/commands/address-review.md` to add an explicit,
*opt-in* workflow for posting rationale replies on `SKIPPED` or declined
`DISCUSS` items after triage.
> 
> The triage prompt and examples now ask separately which items to
address vs. which items (if any) should receive rationale replies, and
clarify that the optional rationale line should only appear when
applicable.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
553cc35. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Enhanced rationale reply workflow: always offer optional rationale
replies for selected SKIPPED or declined items; rationales are posted
only with explicit user selection.
* Improved prompts and post-triage presentation clarifying which items
to address and which should receive rationale replies.
* **Documentation**
* Updated instructions and examples to show the optional rationale-reply
line only when applicable.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Metr-Pending Pending Metr tracking

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant