chore: add Claude Code configuration for AReaL

[rchardx]

Description

Set up comprehensive Claude Code integration with domain-specific agents, commands, rules, and skills for the codebase.

Key changes:

• Add 7 specialized agents (algorithm, FSDP, Megatron, Archon experts)
• Add /pr-review and /gen-commit-msg commands
• Add rules for code style, API config, distributed, and testing
• Add skills for adding datasets, rewards, workflows, and debugging
• Update CLAUDE.md with project overview and guidelines
• Configure settings.json with project-specific permissions

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not
  work as expected)
• Documentation update
• Code refactoring (no functional changes)
• Performance improvement
• Test coverage improvement

Checklist

• I have read the Contributing Guide
• I have run formatting tools (pre-commit or manual)
• I have run relevant unit tests and they pass
• I have added tests for new functionality
• I have updated documentation if needed
• My branch is up to date with main
• This PR introduces breaking changes (if yes, fill out details below)
• If this PR changes documentation, I have built and previewed it locally with
  jb build docs
• No critical issues raised by AI reviewers (/gemini review)

[gemini-code-assist]

Summary of Changes

Hello @rchardx, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the AReaL codebase by integrating a comprehensive Claude Code setup. The changes aim to automate and streamline various development processes, from code review and commit message generation to providing expert guidance on complex topics like distributed training and algorithm implementation. By introducing specialized AI agents, commands, rules, and skills, the PR seeks to improve code quality, accelerate development cycles, and provide robust support for engineers working on the project.

Highlights

• New Specialized AI Agents: Introduced seven new AI agents: algorithm-expert, archon-expert, code-verifier, fsdp-expert, megatron-expert, planner, and simple-code-reviewer, each designed for specific areas of the codebase.
• New Commands for Development Workflow: Added two new commands: '/pr-review' for intelligent pull request code reviews with dynamic agent allocation, and '/gen-commit-msg' for generating conventional commit messages based on staged changes.
• New Code Quality Rules: Implemented new rules covering API and configuration conventions, general code style, distributed programming practices, and testing guidelines to ensure consistency and quality.
• New Development Skills: Provided new skills to guide users through common development tasks, including adding new datasets, reward functions, workflows, and debugging distributed training issues.
• Updated Project Documentation: Replaced the existing 'CLAUDE.md' with a comprehensive project overview, guidelines, and boundaries for using Claude Code within the AReaL framework.
• Configured Claude Code Hooks: Added a 'settings.json' file to configure a 'PostToolUse' hook that reminds developers to update relevant expert agents when specific code paths are modified.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request sets up a comprehensive configuration for Claude Code, including specialized agents, commands, rules, and skills tailored for the AReaL codebase. The changes are extensive and well-structured, primarily involving the addition of markdown and configuration files. I've identified a few minor formatting issues in the markdown files that could improve clarity and one potential area for improvement in the agent selection logic to make it more precise. Overall, this is a great addition that will significantly enhance the development workflow.

[Copilot]

Pull request overview

Adds a repository-scoped Claude Code setup for AReaL, including shared agents/commands/rules/skills and updated project guidance.

Changes:

• Add .claude/ configuration: specialized agents, reusable commands, rule packs, skills, and PR-review reference data.
• Update CLAUDE.md to document project structure, workflows, and common developer commands.
• Update .gitignore to keep Claude local/session artifacts untracked while committing shared Claude config.

Reviewed changes

Copilot reviewed 22 out of 24 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
CLAUDE.md	New project overview + Claude usage guidance.
.gitignore	Stops ignoring all of .claude/; ignores local settings + sessions only.
.claude/settings.json	Enables a PostToolUse hook for reminding agent updates.
.claude/hooks/check-expert-update.sh	Hook script that maps edited paths to “expert agent” reminders.
.claude/rules/testing.md	Claude “testing rules” guidance scoped to test paths.
.claude/rules/distributed.md	Claude “distributed code rules” guidance scoped to engine/experimental/fsdp paths.
.claude/rules/code-style.md	Claude “code style rules” guidance (global).
.claude/rules/api-config.md	Claude “API/config rules” guidance scoped to areal/api/**.
.claude/data/pr-review-templates.md	Template library used by /pr-review.
.claude/data/pr-review-change-types.md	Change-type detection reference used by /pr-review.
.claude/commands/pr-review.md	Defines /pr-review command workflow and output format.
.claude/commands/gen-commit-msg.md	Defines /gen-commit-msg command workflow and output format.
.claude/agents/simple-code-reviewer.md	Adds a lightweight reviewer agent configuration.
.claude/agents/planner.md	Adds an implementation planning agent configuration.
.claude/agents/megatron-expert.md	Adds a Megatron/Pipeline Parallel expert agent configuration.
.claude/agents/fsdp-expert.md	Adds an FSDP/DTensor expert agent configuration.
.claude/agents/code-verifier.md	Adds a “run checks/tests” verifier agent configuration.
.claude/agents/archon-expert.md	Adds an Archon/MoE expert agent configuration.
.claude/agents/algorithm-expert.md	Adds an RL algorithm expert agent configuration.
.claude/skills/debug-distributed/SKILL.md	Adds a distributed debugging playbook skill.
.claude/skills/add-workflow/SKILL.md	Adds a “how to add a workflow” skill template.
.claude/skills/add-reward/SKILL.md	Adds a “how to add a reward” skill template.
.claude/skills/add-dataset/SKILL.md	Adds a “how to add a dataset” skill template.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[garrett4wade]

Let's goooooo