Skip to content

Add CLAUDE.md#956

Merged
rohansjoshi merged 1 commit intomainfrom
rohjoshi/claude
Mar 6, 2026
Merged

Add CLAUDE.md#956
rohansjoshi merged 1 commit intomainfrom
rohjoshi/claude

Conversation

@rohansjoshi
Copy link
Copy Markdown
Contributor

@rohansjoshi rohansjoshi commented Mar 3, 2026

What does this PR do?

Add CLAUDE.md file with repo overview for AI agents

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide covering Model Optimizer concepts, architecture and design patterns, security and contribution guidelines, common commands and workflow, architecture layout and core abstractions, key components, CI/testing and export guidance, and links to further documentation. This improves onboarding and reference material for contributors and users.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Mar 3, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d4ddf82e-352d-4e8e-be18-455646e3c4ae

📥 Commits

Reviewing files that changed from the base of the PR and between 80699de86f62beeb611ecebf1fadf7977d32148b and d4f181f.

📒 Files selected for processing (1)
  • CLAUDE.md

📝 Walkthrough

Walkthrough

Added a new documentation file CLAUDE.md (106 lines) that documents ModelOpt concepts, architecture, core abstractions (modes), export flow, design patterns and anti-patterns, security and contribution guidance, common commands, CI/testing guidance, and environment/Docker notes.

Changes

Cohort / File(s) Summary
Documentation
CLAUDE.md
New comprehensive documentation covering ModelOpt architecture (namespaces/sub-packages), core abstractions (modes), export flow, design patterns and anti-patterns, security and IP guidance, development workflow, CI/testing guidance, and installation/environment instructions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately and concisely describes the main change: adding a new CLAUDE.md file to the repository.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Security Anti-Patterns ✅ Passed PR only adds CLAUDE.md documentation file with no Python code changes to modelopt package or examples.

✏️ 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 rohjoshi/claude

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

Comment thread CLAUDE.md
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a CLAUDE.md repository guide intended for AI agents, summarizing project architecture, workflows, security constraints, and common developer commands.

Changes:

  • Introduces CLAUDE.md with repo overview (architecture, key modules/files).
  • Documents development workflow/CI/testing commands and expectations.
  • Captures security coding rules and third-party/IP guidance.

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

Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Copy link
Copy Markdown
Contributor

@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 the current code and only fix it if needed.

Inline comments:
In `@CLAUDE.md`:
- Line 14: The CLAUDE.md license-header guidance is inconsistent: line 14
references "new Python/C++/CUDA files" while lines 123–124 include ".sh"; update
the document so both places are consistent—either add ".sh" to the list at line
14 or remove/clarify ".sh" from the later section—by editing the LICENSE_HEADER
guidance text and any related bullet(s) so they match exactly and reference the
same set of file types (e.g., "Python/C++/CUDA/.sh") wherever LICENSE_HEADER is
mentioned.

ℹ️ Review info

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 42e9becb9ca0c03d116482ebd910f6fc273b3562 and 995c432.

📒 Files selected for processing (1)
  • CLAUDE.md

Comment thread CLAUDE.md

**CRITICAL (YOU MUST):**

- NVIDIA Apache 2.0 license header on ALL new Python/C++/CUDA files (see `LICENSE_HEADER`)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Unify license-header scope to avoid contradictory guidance.

Line 14 says headers are required on new Python/C++/CUDA files, while Lines 123–124 also include .sh. Please make both sections consistent (either include .sh in both places or clarify the difference).

Also applies to: 123-124

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CLAUDE.md` at line 14, The CLAUDE.md license-header guidance is inconsistent:
line 14 references "new Python/C++/CUDA files" while lines 123–124 include
".sh"; update the document so both places are consistent—either add ".sh" to the
list at line 14 or remove/clarify ".sh" from the later section—by editing the
LICENSE_HEADER guidance text and any related bullet(s) so they match exactly and
reference the same set of file types (e.g., "Python/C++/CUDA/.sh") wherever
LICENSE_HEADER is mentioned.

@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.13%. Comparing base (42482b1) to head (d4f181f).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #956   +/-   ##
=======================================
  Coverage   72.13%   72.13%           
=======================================
  Files         209      209           
  Lines       23631    23631           
=======================================
  Hits        17046    17046           
  Misses       6585     6585           

☔ 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.

Comment thread CLAUDE.md
Comment thread CLAUDE.md
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md
@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented Mar 4, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

Copy link
Copy Markdown
Contributor

@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.

🧹 Nitpick comments (1)
CLAUDE.md (1)

10-22: Consider simplifying critical rules to reduce redundancy.

Per past review feedback and Claude's best practices, CLAUDE.md should be concise and avoid repeating what's already in referenced documents. Lines 14-21 detail requirements that are:

  • Auto-enforced by pre-commit hooks (license headers, per learnings)
  • Fully documented in CONTRIBUTING.md (commit signing, PR requirements)
  • Fully documented in SECURITY.md (security guidelines)

Since lines 20-21 already direct readers to these authoritative sources, consider condensing lines 12-19 to a brief pointer like:

**CRITICAL:** Follow `SECURITY.md` and `CONTRIBUTING.md` — all commits require DCO sign-off (`-s`) + cryptographic signing (`-S`), and pre-commit hooks enforce standards automatically.

This keeps CLAUDE.md focused on what's unique to this file while avoiding maintenance burden of duplicating detailed requirements.

Based on learnings: "All commits must be signed-off using git commit with the --signoff option to certify contribution originality and licensing rights" and "All Python, C++, Markdown, and other code must adhere to coding standards checked automatically upon commit via pre-commit hooks."

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CLAUDE.md` around lines 10 - 22, The CRITICAL rules under "## Rules (Read
First)" and the "**CRITICAL (YOU MUST):**" block are redundant with
CONTRIBUTING.md and SECURITY.md; replace the long bullet list (license header,
git commit -s -S, pre-commit hooks, CODEOWNERS review, re-run tests after
rebase, security guideline enforcement) with a single concise pointer that
directs readers to those authoritative docs and states the key takeaway (e.g.,
"Follow SECURITY.md and CONTRIBUTING.md — commits require DCO sign-off and
cryptographic signing; pre-commit hooks enforce standards"), removing the
duplicated items while keeping the remaining unique instruction that new
Python/C++/CUDA files must include the NVIDIA Apache 2.0 header if you want to
keep that exception explicitly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@CLAUDE.md`:
- Around line 10-22: The CRITICAL rules under "## Rules (Read First)" and the
"**CRITICAL (YOU MUST):**" block are redundant with CONTRIBUTING.md and
SECURITY.md; replace the long bullet list (license header, git commit -s -S,
pre-commit hooks, CODEOWNERS review, re-run tests after rebase, security
guideline enforcement) with a single concise pointer that directs readers to
those authoritative docs and states the key takeaway (e.g., "Follow SECURITY.md
and CONTRIBUTING.md — commits require DCO sign-off and cryptographic signing;
pre-commit hooks enforce standards"), removing the duplicated items while
keeping the remaining unique instruction that new Python/C++/CUDA files must
include the NVIDIA Apache 2.0 header if you want to keep that exception
explicitly.

ℹ️ Review info

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b35358e7-4d9f-4ee1-9f85-3a90f6700937

📥 Commits

Reviewing files that changed from the base of the PR and between 995c432 and 07b9f9689821cf8eba691785a2638f00d86bb59a.

📒 Files selected for processing (1)
  • CLAUDE.md

@rohansjoshi rohansjoshi enabled auto-merge (squash) March 5, 2026 20:45
Signed-off-by: Rohan Joshi <rohjoshi@nvidia.com>
@rohansjoshi rohansjoshi merged commit a007820 into main Mar 6, 2026
33 checks passed
@rohansjoshi rohansjoshi deleted the rohjoshi/claude branch March 6, 2026 19:30
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.

3 participants