Files
project_6/cccl_upstream/docs/maintainers/coderabbit.rst
muh-bot 2a7ca101d7 feat(cccl): integrate missing CCCL directories — python/, ci/, .agent/, docs/, test/
Sparse-checkout from NVIDIA/cccl main branch to complete cccl_upstream:

Added:
- python/cuda_cccl/ (226 files) — Python bindings for device-level algorithms
  Critical for muh toolchain: cuda.compute.reduce_into, scan, radix_sort, etc.
  Includes 204 .py files with full test coverage for all 27 algorithms
- ci/ (163 files) — Build/test infrastructure
  build_cub.sh, test_cub.sh, build_and_test_targets.sh, matrix.yaml
  Directly maps to our [INFRA-CI] and [INFRA-BUILD] items
- .agent/skills/ (7 files) — NVIDIA's own agent skills for CCCL
  cccl-style/SKILL.md, cccl-test/SKILL.md, sass-diff/SKILL.md
- docs/ (491 files) — Official CCCL documentation
  CI references, CMake guides, Python compute docs, libcudacxx PTX docs
- test/ (12 files) — Top-level integration tests (cuda_smoke, stdpar)
- Root configs: .clang-format, .clang-tidy, CONTRIBUTING.md, pyproject.toml
- CLAUDE.md symlink → AGENTS.md (NVIDIA's standard)

cccl_upstream now mirrors full NVIDIA/cccl structure:
  Before: 42M (cub + thrust + libcudacxx + cudax + c + examples + benchmarks)
  After:  53M (+python +ci +docs +.agent +test +configs)

This completes the CCCL base needed for:
- [muh-bench] items: ci/util/build_and_test_targets.sh for targeted builds
- [CCCL-verify] items: python/cuda_cccl/tests/ as reference implementations
- [CCCL-test] items: ci/test_cub.sh, ci/test_thrust.sh
- Agent workflow: .agent/skills/ for consistent style and test patterns
2026-08-07 02:34:33 +00:00

67 lines
2.6 KiB
ReStructuredText

CodeRabbit
==========
This page explains how to configure and use CodeRabbit for CCCL pull request
review. For the complete product documentation, see the
`CodeRabbit documentation <https://docs.coderabbit.ai/>`__.
Configuration
-------------
CCCL configures CodeRabbit through ``.coderabbit.yaml`` in the repository root.
The configuration in the pull request branch is used for that review.
When setting up or updating CodeRabbit:
#. Keep repository-specific settings in ``.coderabbit.yaml``.
#. Use ``@coderabbitai configuration`` on a pull request to inspect the
resolved configuration. This is useful when checking whether CodeRabbit is
using the expected repository settings for that pull request.
#. Use ``@coderabbitai generate configuration`` to export the resolved
configuration if a new baseline is needed. This is useful when moving
settings into a reviewable repository configuration file.
#. Keep configuration changes small and reviewable.
#. Use ``reviews.path_instructions`` for path-specific review guidance.
#. Use ``knowledge_base.code_guidelines.filePatterns`` for CCCL guidance files
that CodeRabbit should read as review context.
The CCCL configuration should keep comments focused on correctness, API
stability, performance, security, and other high-impact issues. Avoid enabling
features that add noisy generated comments or code by default.
Pull Request Reviews
--------------------
Automatic reviews may be disabled or restricted by the repository
configuration. Maintainers can always request review explicitly from a pull
request comment:
.. code-block:: text
@coderabbitai review
Use a full review when the pull request should be reviewed again from scratch:
.. code-block:: text
@coderabbitai full review
Other useful commands:
- ``@coderabbitai help`` shows the current command reference.
- ``@coderabbitai configuration`` shows the active configuration.
- ``@coderabbitai summary`` can be placed in the pull request description as a
placeholder for the generated summary.
- ``@coderabbitai pause`` and ``@coderabbitai resume`` pause or resume
automatic review behavior. This is useful when a pull request is still being
updated frequently and should not be reviewed again until it is ready.
- ``@coderabbitai ignore`` can be placed in the pull request description to
disable automatic reviews.
Review Guidance
---------------
Treat CodeRabbit feedback as review assistance, not as a merge requirement by
itself. Maintainers remain responsible for deciding whether comments are
actionable and whether a pull request has adequate tests and CI coverage.