Skip to content

Improve Claude Code setup#1378

Open
santir489 wants to merge 4 commits into
mainfrom
WG-improve-claude-setup
Open

Improve Claude Code setup#1378
santir489 wants to merge 4 commits into
mainfrom
WG-improve-claude-setup

Conversation

@santir489

@santir489 santir489 commented Apr 20, 2026

Copy link
Copy Markdown
Contributor

Description

This PR improves the Claude Code setup for rails_api_base by adding project-specific guidance, agents, commands, rules, and skills focused on Ruby, Rails, RSpec, PR creation, and code review workflows.

Changes include:

  • Adds Claude Code skills for Rootstrap Ruby, Rails, and RSpec conventions.
  • Adds a code-reviewer subagent to review diffs against the base branch using project conventions.
  • Adds a pr-size-checker subagent to detect large PRs and suggest logical splits.
  • Adds a create-pr command to standardize PR creation using the repository template.
  • Adds GitHub PR formatting rules to guide consistent PR descriptions.
  • Adds CLAUDE.md as the main entry point for Claude Code project context.
  • Updates the README with Claude Code setup information.

Notes

This is documentation/tooling only. It does not change application runtime behavior.

santir489 and others added 3 commits April 20, 2026 10:47
  Rootstrap's tech-guides conventions when Claude Code edits Ruby,
  Rails, or RSpec code in projects bootstrapped from this template
- pr-size-checker (agent): analyzes the current branch's diff against
  its base and recommends splitting into smaller PRs when the effective
  added lines exceed ~400, while respecting Rails-specific groupings
  (model+migration, routes+controller, factories with new models).
- github-pr-formatting (rule): single source of truth for PR creation —
  walks through filling each section of the repo's PR template (Board,
  Description, Notes, Tasks, Risk, Preview), defines the title format
  ([TICKET-ID] when applicable), and documents GitHub markdown gotchas.
- create-pr (command): workflow for opening a PR — runs the size check,
  prepares the branch, gathers commit info, and invokes
  github-pr-formatting to fill the body.
- Adds .claude/agents/code-reviewer.md, a read-only review subagent
  that preloads the ruby/rails/rspec convention skills and applies
  them to diffs against the base branch. Restricted via the `tools:`
  whitelist to read-only operations.
- Removes the Timecop guidance from rspec-conventions: this template
  uses Rails' built-in `freeze_time` / `travel_to` (configured in
  spec/rails_helper.rb), and Timecop is not in the bundle.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@sonarqubecloud

sonarqubecloud Bot commented May 4, 2026

Copy link
Copy Markdown

@sonarqubecloud

Copy link
Copy Markdown

@santir489 santir489 marked this pull request as ready for review June 26, 2026 15:35
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.

2 participants