Code Review

RenoDX Code Review Skill

Use this skill when reviewing RenoDX pull requests. Apply it together with root AGENTS.md, the nearest nested AGENTS.md, .agents/skills/swapchain-resource-analysis/SKILL.md, and .agents/skills/handle-sdr-tonemap-lut/SKILL.md when relevant.

Before reviewing any RenoDX-authored C++ under src/, read docs/CXX_STYLE.md in full and review every touched C++ region against it. Do not rely on summaries in AGENTS.md, scoped instructions, or prior knowledge of the guide. Treat style-guide violations as review findings even when the code builds and passes formatting checks.

Review stance

Copilot review should comment when a PR is technically buildable but violates RenoDX HDR behavior. Do not let a PR pass silently just because it compiles if the mod changes the default look, clips HDR through SDR, or treats the final swapchain frame as an HDR source.

Review comments should be helpful and actionable: name the risky behavior, explain the missing proof or invariant, and suggest a concrete RenoDX pattern to employ. Mentioning another mod can be useful when pointing to a specific file, bridge, or technique, but do not assume every existing mod is high quality or treat a mod name as proof by itself.

Every Copilot code review must include a RenoDX review checklist section in the review body. Do not leave a review without the checklist. Mark each relevant item as Pass, Needs comment, or N/A; leave actionable comments for every Needs comment item.

Required review checklist

• PR scope and commits are tidy: mod PRs are mostly target game/mod changes plus required shared support.
• Review comments are helpful: each issue explains the risky behavior or missing proof and suggests a concrete RenoDX pattern.
• Defaults preserve the original/vanilla look as closely as practical; extra HDR look, contrast, saturation, or brightness is opt-in.
• Preset Off/reset and Vanilla/0 behavior are clear; Vanilla/0 is not treated as full Off if grading/effects remain active.
• The PR does not implement final-frame inverse tonemapping from a completed SDR swapchain/backbuffer.
• Tonemap/LUT shaders prove the untonemapped, neutral_sdr, and graded_sdr signals used by ToneMapPass or UpgradeToneMap.
• ToneMapPass, PsychoV, and other tonemappers receive linear input; encoded/gamma/sRGB values are decoded before tonemapping.
• Vanilla LUT paths prove their domain, sampling, masks/strength/scaling, and HDR bridge/reconstruction strategy.
• Hard clips, saturate, UNORM writes, or lower-format copies do not destroy HDR range before HDR-critical work is complete, except scoped Vanilla/0 resource-clamp emulation.
• SwapChainPass is only final output encoding for a proven intermediate, not hidden tonemap replacement, LUT reconstruction, or inverse SDR expansion.
• Output mode prefers HDR10/PQ with an SDR/HDR toggle; scRGB is used only for rare, justified compatibility or integration cases.

Must-comment issues

Leave a review comment when changed code does any of the following:

• Makes the default output more contrasty, more saturated, brighter, or more stylized than vanilla without an explicit opt-in slider or named preset such as HDR Look.
• Uses HDR headroom as a reason to redesign the image instead of matching the original/vanilla look as closely as practical at default settings.
• Starts from the completed SDR swapchain/backbuffer and applies an inverse curve, peak-nits multiplier, AutoHDR/RTX HDR/ReShade-style expansion, or similar final-frame heuristic.
• Feeds an SDR LUT from a hard-clipped/log-shaped HDR or pre-LUT scene signal (saturate, min(max(...), 1)) and then uses the sampled LUT result as output or graded_sdr without a matching explicit neutral_sdr or reconstruction. Two-argument ToneMapPass(untonemapped, graded_sdr) is not enough proof when the LUT input was a different clipped SDR baseline.
• Treats a hard clip or saturate neutral as a complete LUT bridge when the clip collapses saturated highlights to white or wrong hues. For visible hard-clip-to-LUT behavior, expect Wobbly Life-style max-channel/gamut compression and reconstruction or Silksong-style selective hue/saturation clip emulation.
• Leaves a game LUT as an afterthought: a raw sample, skipped LUT, or unchanged sampler path may be valid vanilla preservation, but review should check for missing LUT-domain proof, renodx::lut::Config setup, strength/scaling, masks/blends, SDR bridge, or HDR reconstruction.
• Assumes a raw LUT sample is enough when the vanilla path uses packed 2D sampling, tetrahedral sampling, masks, strength, scaling, generated LUTs, user LUTs, sRGB/gamma domains, PQ/HDR/log domains, or multiple LUT draws.
• Assumes a vanilla SDR LUT uses linear input without proof. Most vanilla LUTs are sRGB/gamma-domain; encoded values must not be fed directly into ToneMapPass or any tonemapper.
• Uses raw saturate(untonemapped) or an equivalent hard clip of the HDR source as neutral_sdr, a LUT bridge, or proof that a hard-clip/no-tonemap path is handled. This does not include a Vanilla/0 path deliberately emulating the original RGBA8U/UNORM resource clamp after a resource upgrade.
• Feeds encoded/gamma/sRGB color into ToneMapPass, PsychoV, or another tonemapper instead of decoding to linear first.
• Treats ToneMapPass with RENODX_TONE_MAP_TYPE == 0 / Vanilla as a full Off preset while user grading, HDR-look controls, or custom effect overrides remain active.
• Replaces a real upstream signal with ToneMapPass or PsychoV without preserving required vanilla presentation effects such as exposure, bloom, fades, vignette, LUT masks, grade strength, or output-domain expectations.
• Adds saturate, min/max, UNORM resolves, or lower-format copies before HDR-critical work is complete, destroying values above SDR white, negative channels, or precision. Do not confuse this with a vanilla saturate after an already-tonemapped value that only trims small overflow, or a Vanilla/0 path that restores the original RGBA8U/UNORM clip after a resource upgrade.
• Uses SwapChainPass on a final SDR buffer as if it proves HDR. SwapChainPass is valid final encoding only after a high-precision intermediate or real pre-SDR signal is proven.
• Defaults to scRGB or a floating-point swapchain output without a rare-case justification, or omits an SDR/HDR output toggle when an HDR10/PQ path is viable. A float proxy/intermediate is not by itself a reason to expose scRGB as the primary output mode.
• Lets unrelated files creep into a mod PR: scratch files, generated/debug artifacts, unrelated global CMake/CI/vendor changes, core/shared utility edits without a clear dependency, or changes from another game/mod. Multiple commits are fine, but the PR and each commit group should be coherent and reviewable.