clshortfuse/renodx/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.

Expected review evidence

Prefer comments that identify the missing proof or preservation step:

• Which signal is the real untonemapped, neutral_sdr, or graded_sdr source?
• Where does vanilla clamp, tonemap, LUT, color grade, or encode to SDR?
• Does the default path match original SDR black, midgray, highlight rolloff, saturation, and grade?
• Is visual augmentation opt-in through sliders/presets, or baked into the baseline?
• Does the LUT bridge compress/map to the LUT's SDR domain instead of simply clipping, then preserve the vanilla LUT result while reconstructing HDR/reference range?
• Immediately before each vanilla LUT sample, is the input hard-clipped by saturate, min(max(...), 1), or an equivalent log shaper? If so, does the PR avoid raw hard clip as a neutral_sdr substitute and instead use an engineered LUT-domain proxy, reconstruction path, or proven reference baseline?
• Is the saturate before/after a tonemap or inside Vanilla/0 resource-clamp emulation? Trimming small overflow after a vanilla tonemap or preserving the original RGBA8U/UNORM clamp in Vanilla/0 is expected; clipping untonemapped/HDR before a LUT or ToneMapPass is the problem.
• If hard clipping feeds a LUT, what preserves hue and saturation that would otherwise clip to white or wrong hues: max-channel/N2 scaling, gamut compression, selective hue/saturation clip emulation, or another proven bridge?
• Does replacement LUT sampling use renodx::lut::Config/renodx::lut::Sample or explicitly justify direct Texture.Sample to preserve exact vanilla addressing?
• Is LUT centering/half-texel/packed-strip addressing preserved as sampling fidelity without being mistaken for the vanilla grade itself?
• Are LUT inputs/outputs in their proven domain, usually sRGB/gamma for vanilla SDR LUTs, and decoded back to linear before ToneMapPass?
• If ToneMapPass runs with Vanilla/0, is that intentionally using the vanilla process as the tonemap while allowing user grading, and is there a Preset Off/reset path to true vanilla as closely as practical?
• If the PR uses PsychoV on a game with a LUT, does it use a modern bridge like Starfield/Wobbly Life: move PsychoV output into neutral SDR/LUT space, apply the grade, then reconstruct before final output?
• Do resource formats preserve values above 1.0, negative channels when needed, and precision until final output?
• If another mod is cited as an example, is the cited pattern specific and relevant, rather than implying the whole mod is authoritative?
• Does the output path prefer HDR10 with a clear SDR/HDR toggle, synchronized color space, and injected output preset? If scRGB is used, what rare compatibility or integration reason requires it?
• Does the changed-file list match the PR's mod scope? Are core/shared files, generated files, scratch/debug artifacts, and unrelated game folders justified by the implementation?
• Are multiple commits sensibly organized by topic, or do they mix unrelated cleanup/core changes with the mod work?

Correct directions to suggest