# Agent Rules

- Never add extra behavior, aliases, compatibility layers, or "convenience" changes unless explicitly requested.
- Suggestions and ideas are welcome, but any non-requested implementation requires user confirmation first.
- When in doubt, implement only the exact requested scope and ask before expanding.
- Do not add fallback scenarios, fallback code paths, or silent degradations unless they are critical for safety or the user explicitly asks for them.
- Changes must add to what already works and must not change existing working behavior, so earlier templates remain compatible, unless the user specifically requests a behavioral change.

## Rendering Bug Protocol (Code-First)

- If user reports a rendering/layout bug, treat the bug as real immediately.
- First action: perform a code audit for alignment/positioning logic before any explanation.
- Do not give a root-cause explanation until:
  1) code audit identifies a concrete risky construct, and
  2) the agent reproduces the output locally from current code.
- If user did not provide artifact, agent must generate it from code and inspect it.
- Never ask user to prove the bug when the agent can reproduce it from repository code.
- Mark statements as `Confirmed` vs `Hypothesis`; only `Confirmed` may be presented as cause.

## No Fallback Fixes

- Do not add fallback behavior, backup rendering paths, graceful degradation paths, or "at least show something" logic during debugging unless the user explicitly asks for that behavior.
- If the primary path is broken, fix the primary path. Do not patch around it with temporary alternate behavior.
- In rendering/editor bugs, a failed preview/render path must be treated as a bug to fix, not as a trigger to add substitute UI behavior.
- Do not spend time implementing fallback scenarios when the user is asking for the real path to work.

## Python/PDF Inspection Runtime

- For any Python execution or PDF inspection task, always use:
  `/Users/kinsleypetit-homme/python-venvs/pymupdf-audit/bin/python`
- Do not use `python` or `python3` for these tasks.