Skip to content

#435 Rename review skills to lite and pro#531

Merged
hubertgajewski merged 2 commits into
mainfrom
feature/435
May 10, 2026
Merged

#435 Rename review skills to lite and pro#531
hubertgajewski merged 2 commits into
mainfrom
feature/435

Conversation

@hubertgajewski
Copy link
Copy Markdown
Owner

@hubertgajewski hubertgajewski commented May 10, 2026

Summary

  • Renames the preserved legacy review skill from deep-review to deep-review-lite.
  • Renames the multi-agent orchestrator from deep-review-next to deep-review-pro.
  • Updates README, CLAUDE guidance, Claude agent prompts, Codex skill symlinks, Codex agent wrappers, and the commit-review hook prompt to use the new names.

Closes #435
Contributes to #436

Note

#435 still references the S7/#434 gate. This PR implements the rename now per maintainer instruction in the fix session; #434 remains open.

Test plan

  • Stale-reference rg scan returns no matches for deep-review-next, old deep-review skill paths, or rollout/promotion wording.
  • find .agents/skills -maxdepth 1 -type l ... reports no broken Codex skill symlinks.
  • test -f .agents/skills/deep-review-lite/SKILL.md
  • test -f .agents/skills/deep-review-pro/SKILL.md
  • jq empty .claude/settings.json
  • git diff --check
  • git diff --cached --check
  • npx prettier --check ... passes for the changed Markdown and JSON files.
  • Reverse-diff check against HEAD^ passes and HEAD^ contains the pre-rename deep-review / deep-review-next paths.

Summary by CodeRabbit

  • New Features

    • Two review modes: /deep-review-lite for quick checklist reviews and /deep-review-pro for comprehensive multi-agent reviews.
    • Commit-time review now defaults to the lite review mode.
  • Chores

    • Updated documentation and CLI/listing of available review commands to reflect the new review options and migration away from prior review commands.

Review Change Stack

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 10, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 61edfed3-8aef-446b-91c1-8066a34c6f4c

📥 Commits

Reviewing files that changed from the base of the PR and between 4ea5fac and 9cd4473.

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

📝 Walkthrough

Walkthrough

This PR renames and consolidates review skills: preserves legacy as deep-review-lite, renames the orchestrator deep-review-next → deep-review-pro, and updates symlinks, agent prompts, commit hooks, Codex wrappers, and docs to the new names.

Changes

Deep-review Skills Rename and Path Consolidation

Layer / File(s) Summary
Skill Directory Symlinks
.agents/skills/*
Pointer files updated: removed legacy pointer and added/pointed deep-review-lite and deep-review-pro to corresponding .claude/skills/* directories.
Skill Specification Updates
.claude/skills/deep-review-pro/*
Orchestrator docs and references switched from /deep-review-next/deep-review-pro; REFERENCES.md header and SKILL.md updated; new “Relationship to deep-review-lite” notes and PR_BODY passthrough/sha-warning added.
Agent Prompt Orchestrator References
.claude/agents/deep-review-*.md
All specialist prompts updated to invoke /deep-review-pro and resolve citations from .claude/skills/deep-review-pro/REFERENCES.md; minor emphasis/format tweaks applied.
Workflow Hook & Issue-Handling
.claude/settings.json, .claude/skills/fix-issue/SKILL.md
Commit PreToolUse hook switched to deep-review-lite; fix-issue skill normalizes ISSUE input, detects parent epic, reworks branch creation with remote checks/suffixing, and routes review checklist to lite/pro as appropriate.
Codex Agent Wrapper Configs
.codex/agents/*.toml
Developer instruction strings updated to reference .claude/skills/deep-review-pro/REFERENCES.md as bibliography source.
Public Docs
CLAUDE.md, README.md
Docs updated to list /deep-review-lite (default checklist) and /deep-review-pro (full orchestrator) and to adjust repository structure and prerequisites text accordingly.

Estimated Code Review Effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related issues

Possibly related PRs

Suggested reviewers

  • claude

Poem

🐰 The skills have hopped to clearer tracks,
next became pro and legacy stayed back,
lite for quick checks, pro for the deep,
Symlinks and docs set the path to keep—
Hooray, the review burrow’s neat and stacked!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Title '#435 Rename review skills to lite and pro' clearly and concisely summarizes the main change—renaming deep-review to deep-review-lite and deep-review-next to deep-review-pro.
Linked Issues check ✅ Passed All acceptance criteria from issue #435 are met: both skills renamed [deep-review→lite, deep-review-next→pro], documentation updated, invocation semantics preserved, and revertability ensured through atomic single-PR implementation.
Out of Scope Changes check ✅ Passed All changes directly support the rename objectives: file/directory renames, reference updates in documentation/configs, symlink updates, and no unrelated features or refactoring introduced.
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
  • Commit unit tests in branch feature/435

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

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.claude/skills/fix-issue/SKILL.md:
- Around line 7-14: Normalize the incoming issue identifier once (e.g., strip a
leading '#' from $ARGUMENTS into a new variable like ISSUE or ISSUE_NUM) and
then use that normalized variable everywhere instead of $ARGUMENTS; update the
PARENT lookup (the gh api call that sets PARENT) and any later uses that build
PR body text (e.g., places that generate "Closes #...") to reference the
normalized ISSUE variable so you never pass "##322" or include an extra '#' in
API calls or PR text.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9fb84357-5a28-405a-b3c4-c0ca4925af36

📥 Commits

Reviewing files that changed from the base of the PR and between 830678f and 4ea5fac.

📒 Files selected for processing (33)
  • .agents/skills/deep-review
  • .agents/skills/deep-review-lite
  • .agents/skills/deep-review-next
  • .agents/skills/deep-review-pro
  • .claude/agents/deep-review-architecture.md
  • .claude/agents/deep-review-ci.md
  • .claude/agents/deep-review-code.md
  • .claude/agents/deep-review-docs.md
  • .claude/agents/deep-review-project-checklist.md
  • .claude/agents/deep-review-python.md
  • .claude/agents/deep-review-qa.md
  • .claude/agents/deep-review-security.md
  • .claude/agents/deep-review-simplification.md
  • .claude/agents/deep-review-typescript.md
  • .claude/agents/deep-review-unit-test.md
  • .claude/settings.json
  • .claude/skills/deep-review-lite/SKILL.md
  • .claude/skills/deep-review-pro/REFERENCES.md
  • .claude/skills/deep-review-pro/SKILL.md
  • .claude/skills/fix-issue/SKILL.md
  • .codex/agents/deep-review-architecture.toml
  • .codex/agents/deep-review-ci.toml
  • .codex/agents/deep-review-code.toml
  • .codex/agents/deep-review-docs.toml
  • .codex/agents/deep-review-project-checklist.toml
  • .codex/agents/deep-review-python.toml
  • .codex/agents/deep-review-qa.toml
  • .codex/agents/deep-review-security.toml
  • .codex/agents/deep-review-simplification.toml
  • .codex/agents/deep-review-typescript.toml
  • .codex/agents/deep-review-unit-test.toml
  • CLAUDE.md
  • README.md
💤 Files with no reviewable changes (2)
  • .agents/skills/deep-review-next
  • .agents/skills/deep-review

Comment thread .claude/skills/fix-issue/SKILL.md Outdated
@hubertgajewski
Copy link
Copy Markdown
Owner Author

Fixed CodeRabbit inline comment in 9cd4473. fix-issue now resolves a canonical bare ISSUE before parent lookup, issue fetch, branch naming, commit/PR prose, and Project board lookup. Natural-language references are only allowed after unambiguous resolution; otherwise the workflow stops for clarification. Validated with npx prettier --check .claude/skills/fix-issue/SKILL.md, git diff --check, and a stale raw-argument pattern scan.

@hubertgajewski hubertgajewski merged commit ccd8af2 into main May 10, 2026
19 of 20 checks passed
@hubertgajewski hubertgajewski deleted the feature/435 branch May 10, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[tooling] Rename review skills to deep-review-lite and deep-review-pro

1 participant