UnityLaparoscopicSceneSimulator/.claude/commands/realtime-performance-budget.md

Real-time Performance Budget (project-scoped)

Sets the budgets and verification routine for the LaparoscopicSurgeryEmulation scene.

When to use

Load after any visual, hierarchy, material, lighting, or post-processing change, or when diagnosing "scene feels heavy" / "frame rate dropped" reports.

Per-frame budget

Resource	Budget	Notes
Triangle count (visible)	≤ 250k	Cavity is small; most triangles should be culled
Draw calls (visible)	≤ 200	Static batching helps
SetPass calls	≤ 100	Raised by unique shaders / materials
Real-time lights (visible)	≤ 4	One key, one fill, two rims; everything else baked
Reflection probes (visible)	≤ 1	One cavity probe at 256²
Texture memory (visible)	≤ 64 MB	Mostly mucosa + organ textures
Post-processing overrides	≤ 8	Bloom + Vignette + DoF + Tonemapping + ColorAdjustments + LensDistortion + ChromaticAberration + FilmGrain = 8
Render scale	≤ 1.25	Bumping to 1.5+ to "fix" softness is a landmine
MSAA	≤ 4×	2× is the safe default
Volume profiles (active global)	≤ 1	Multiple globals cause blending surprises

Flag any budget at 80% capacity as a warning (not a fail).

Texture budget

Texture role	Max size	Format
Mucosa base (TissueMucosa.png)	2048	BC7 (desktop) or ASTC (mobile)
Mucosa normal	2048	BC5 / ASTC normal
Organ diffuse	2048	BC7 / ASTC
Organ normal	2048	BC5 / ASTC normal
Organ roughness	1024	BC4 / ASTC (single channel)
Decals (if added)	512	BC7 / ASTC

Verify import settings on any new/modified texture:

• sRGB on for colour, off for normal/roughness/AO.
• Correct texture type (Default vs Normal map vs Single Channel).
• Generate Mip Maps: on.
• Max Size within budget.

Shader cost

• Default: URP/Lit. URP/Simple Lit only as non-hero fallback. URP/Unlit only for HUD/debug.
• Custom shaders (RenderDepth.shader, BlendShader.compute) are constrained to depth/WebRTC pipelines — do not extend for visual work without a bounded change.
• Minimize material keywords: every enabled keyword adds a shader variant.

Verification routine

Run after every bounded change:

1. mcp__UnityMCP__read_console(types=["error","warning"], count=50, include_stacktrace=true).
2. mcp__UnityMCP__find_gameobjects(search_term="SurgeryBenchmark", search_method="by_path", include_inactive=true) — confirm authored roots.
3. mcp__UnityMCP__manage_profiler(action="profiler_get_counters", category="Render") — check draw calls, SetPass, triangles.
4. mcp__UnityMCP__manage_graphics(action="stats_get") — confirm texture memory.
5. Two screenshots: scope angle + 30–45° offset.

Scene-cleanliness checks

• Missing references (from read_console).
• Empty containers with no authored purpose.
• Objects outside SurgeryBenchmark/ that are not the preserved MainScene subtrees.
• Duplicate or stray .mat files not in the five-canonical-materials inventory.
• Unused textures > 512px in Assets/Materials/ or Assets/Textures/.

Verdict levels

• PASS — inside budget and visually intact.
• WARNING — one or more budgets at 80–100%; no regression; note for next agent.
• REGRESSED — a budget was inside before the last change and is now exceeded. Request a rollback from unity-execution.
• FAIL — a budget was already exceeded before the last change, or a regression is severe. Escalate; do not paper over.