Skip to content

chore(pull-request skill): forward stack-related review comments as upstream issues - #3189

Merged
PierreBrisorgueil merged 3 commits into
masterfrom
chore/forward-stack-review-comments
Mar 7, 2026
Merged

chore(pull-request skill): forward stack-related review comments as upstream issues#3189
PierreBrisorgueil merged 3 commits into
masterfrom
chore/forward-stack-review-comments

Conversation

@PierreBrisorgueil

@PierreBrisorgueil PierreBrisorgueil commented Mar 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • What changed: Added a guardrail in section 6c of the pull-request skill instructing the agent to forward review comments on stack-originated files as upstream issues instead of fixing them downstream.
  • Why: During downstream stack update PRs, the AI was fixing issues in stack files locally instead of pushing them upstream where they belong.
  • Related issues: Closes chore(pull-request skill): forward stack-related review comments as upstream issues #3180

Scope

  • Module(s) impacted: .claude/skills/pull-request/
  • Cross-module impact: none
  • Risk level: low

Validation

  • npm run lint
  • npm test
  • Manual checks done (if applicable)

Guardrails check

  • No secrets or credentials introduced (.env*, secrets/**, keys, tokens)
  • No risky rename/move of core stack paths
  • Changes remain merge-friendly for downstream projects
  • Tests added or updated when behavior changed

Notes for reviewers

  • Security considerations: none
  • Mergeability considerations: Documentation-only change in skill file, fully merge-friendly.
  • Follow-up tasks (optional): none

Summary by CodeRabbit

  • Documentation
    • Updated pull request review guidelines to improve handling of actionable comments, including enhanced workflows for different file types.

Note: This is an internal process update with no direct end-user impact.

…pstream issues

Add guardrail in section 6c: when a review comment targets a file from
the upstream stack, create an issue on the stack repo instead of fixing
it downstream. Reply with a link to the issue and resolve the thread.

Closes #3180
@PierreBrisorgueil PierreBrisorgueil added the Chore release label Mar 6, 2026
@PierreBrisorgueil PierreBrisorgueil self-assigned this Mar 6, 2026
@PierreBrisorgueil PierreBrisorgueil added the Chore release label Mar 6, 2026
@coderabbitai

coderabbitai Bot commented Mar 6, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@PierreBrisorgueil has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 6 minutes and 30 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3451a0e2-851a-4299-9152-651e642c295a

📥 Commits

Reviewing files that changed from the base of the PR and between 7d296d1 and c903437.

📒 Files selected for processing (1)
  • .claude/skills/pull-request/SKILL.md
📝 Walkthrough

Walkthrough

The pull-request skill's guidance for handling actionable comments (section 6c) has been expanded to differentiate between stack-originated and non-stack-originated files. Stack-originated files now trigger upstream issue creation with reply links and thread resolution, while non-stack files follow existing batch-fix procedures with commit citations.

Changes

Cohort / File(s) Summary
Pull-Request Skill Guidance
.claude/skills/pull-request/SKILL.md
Expanded section 6c to add branching logic: detect stack-originated files via devkit-node remote; for stack files, create upstream issues and reply with links before resolution; for non-stack files, apply batch fixes with push/commit citation and verification.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related issues

  • #3180: This PR directly implements the feature requested in issue #3180, which specifies forwarding stack-related review comments as upstream issues instead of fixing them downstream.
  • #3604: Parallel implementation of stack-originated file detection and upstream issue escalation in a related repository's pull-request skill.

Possibly related PRs

  • #3167: Also modifies section 6c of the pull-request skill's actionable-comment handling with per-comment replies and adjusted loop logic.
  • #3160: Modifies the pull-request skill's overall feedback and thread-resolution flow, including branching and commit handling.

Poem

🐰 Stack files upstream, local files down below,
Comments now sorted—where should fixes go?
Create issues above, reply with the link,
Route each finding right—no need to rethink! 🌿

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: forwarding stack-related review comments as upstream issues instead of fixing them downstream.
Description check ✅ Passed The description follows the template with all major sections completed: Summary, Scope, Validation, Guardrails check, and Notes. All required information is present and appropriate for the change.
Linked Issues check ✅ Passed The PR implements the exact requirement from #3180: adding a guardrail in section 6c to forward stack-originated file comments as upstream issues instead of fixing them downstream.
Out of Scope Changes check ✅ Passed Changes are limited to the pull-request skill documentation (.claude/skills/pull-request/SKILL.md) and directly address the linked issue requirement with no out-of-scope modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch chore/forward-stack-review-comments

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

@PierreBrisorgueil
PierreBrisorgueil marked this pull request as ready for review March 6, 2026 21:26
Copilot AI review requested due to automatic review settings March 6, 2026 21:26

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the /pull-request Claude skill guidance so that review findings on upstream stack-owned files are forwarded as upstream issues rather than being fixed in downstream stack update PRs.

Changes:

  • Added a guardrail in section 6c describing how to handle review comments targeting stack-originated files.
  • Clarified that non-stack actionable comments should still be fixed in a single batch (verify → commit → push → reply/resolve).

Comment thread .claude/skills/pull-request/SKILL.md Outdated
Use git cat-file against devkit-node/master remote to determine if a
reviewed file belongs to the upstream stack.
@codecov

codecov Bot commented Mar 6, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.87%. Comparing base (8b7141e) to head (c903437).
⚠️ Report is 13 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #3189   +/-   ##
=======================================
  Coverage   89.87%   89.87%           
=======================================
  Files          52       52           
  Lines        1166     1166           
  Branches      235      235           
=======================================
  Hits         1048     1048           
  Misses        107      107           
  Partials       11       11           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.claude/skills/pull-request/SKILL.md:
- Around line 221-224: Update the "If the file is stack-originated:" block in
.claude/skills/pull-request/SKILL.md to explicitly specify the upstream repo
slug (use the devkit-node remote value `pierree-devkit/Node`) and show an
example GitHub CLI command that includes the --repo flag (i.e., demonstrate
using gh issue create --repo pierree-devkit/Node ...) so reviewers are
instructed to target the upstream repo rather than the default current repo;
ensure the step mentions deriving the slug from the devkit-node remote.
- Around line 215-219: The stack-file detection relies on the devkit-node remote
being present; add an explicit prerequisite note before section 6c
("prerequisite: run /update-stack first") or, better, add a defensive fetch
before the git check: run "git fetch devkit-node master" and handle fetch
failure (log a warning and fall back to downstream behavior) immediately before
executing the "git cat-file -e devkit-node/master:path/to/file" check so the
check uses an up-to-date ref; reference the existing check command and the
/update-stack skill in the update.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 90b96314-7501-4284-b538-d266bb2e9118

📥 Commits

Reviewing files that changed from the base of the PR and between 384d3c2 and 7d296d1.

📒 Files selected for processing (1)
  • .claude/skills/pull-request/SKILL.md

Comment thread .claude/skills/pull-request/SKILL.md Outdated
Comment thread .claude/skills/pull-request/SKILL.md
…ack check

- Fetch devkit-node/master before git cat-file to ensure ref is current
- Derive upstream repo slug from remote URL
- Use gh issue create --repo to target upstream repo explicitly
- Document fallback behavior when remote is missing
@PierreBrisorgueil
PierreBrisorgueil merged commit 5485ea0 into master Mar 7, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Chore release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore(pull-request skill): forward stack-related review comments as upstream issues

2 participants