feat: add compositor-glare smoke-gated example

Witness the 5.0 compositor rewrite that breaks AI-generated bloom code:
scene.node_tree/use_nodes are gone on 5.x (the scene compositor is a node
group on scene.compositing_node_group), the Glare node moved from legacy
enum properties to menu/float input sockets, the 4.x threshold property is
a dead shim, and EEVEE has had no use_bloom since 4.2. The example wires
Render Layers -> Glare (Fog Glow) -> output on both API surfaces and proves
with pixels that the halo falls off strictly with the compositor on and is
exactly zero with it off.

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -60,6 +60,7 @@
   ],
   "examples": [
     "examples/bmesh-gear",
+    "examples/compositor-glare",
     "examples/curve-bevel-arc",
     "examples/depsgraph-export",
     "examples/driver-wave",

.github/workflows/blender-smoke.yml

@@ -232,3 +232,14 @@ jobs:
           # verts=1044 faces=1028, tube rests on floor. Exits non-zero on failure.
           xvfb-run -a "$BLENDER" --background \
             --python examples/curve-bevel-arc/curve_bevel_arc.py --
+
+      - name: Shipped example - compositor glare (Fog Glow + 5.x node group)
+        run: |
+          set -euo pipefail
+          # Two tiny 1-sample Cycles renders (compositor on vs off, ~seconds each):
+          # asserts the cross-version compositor plumbing (compositing_node_group
+          # on 5.x, scene.node_tree on 4.x), the Glare Fog Glow configuration, a
+          # strictly-falling halo with the compositor on, and exactly-zero halo
+          # pixels with it off. Exits non-zero on failure.
+          xvfb-run -a "$BLENDER" --background \
+            --python examples/compositor-glare/compositor_glare.py --

.gitignore

@@ -23,6 +23,7 @@ env/
 *.blend2
 *.blend3
 *.blend@
+.scratch
 
 # OS
 .DS_Store
@@ -45,4 +46,3 @@ dist/
 build/
 *.zip
 *.log
-docs/new-example-prompt.md

AGENTS.md

@@ -27,7 +27,7 @@ The content base (counts are CI-enforced against README.md and the manifest):
 - 2 templates: `extension-addon-template` for Extensions Platform add-ons,
   and `headless-batch-script-template` for unattended batch jobs.
 - 17 snippets covering canonical patterns.
-- 12 examples under `examples/<name>/`: runnable scripts that assert a real
+- 13 examples under `examples/<name>/`: runnable scripts that assert a real
   API contract with deterministic checks, exit non-zero on failure, and
   optionally render a still via `--output`. Each is executed headless on
   Blender 4.5 LTS and 5.1 by `blender-smoke.yml`; its render ships in the
@@ -41,7 +41,7 @@ Blender-Developer-Tools/
   rules/<rule-name>.mdc          # 6 rule files
   templates/<template-name>/     # 2 starter templates
   snippets/<snippet-name>.py     # 17 standalone Python snippets
-  examples/<name>/               # 12 runnable smoke-gated examples (+ gallery.json)
+  examples/<name>/               # 13 runnable smoke-gated examples (+ gallery.json)
   scripts/build_gallery.py       # generates docs/gallery/ (stdlib only)
   scripts/site/                  # vendored landing-page build (build_site.py + template)
   docs/gallery/                  # committed generated gallery pages + hero assets

CLAUDE.md

@@ -19,7 +19,7 @@ skills/<skill-name>/SKILL.md   - AI workflow definitions, 12 total
 rules/<rule-name>.mdc          - Anti-pattern rules, 6 total
 templates/<template-name>/     - Starter projects, 2 total
 snippets/<snippet-name>.py     - Standalone code patterns, 17 total
-examples/<name>/               - Runnable smoke-gated examples, 12 total (+ gallery.json)
+examples/<name>/               - Runnable smoke-gated examples, 13 total (+ gallery.json)
 scripts/build_gallery.py       - Regenerates docs/gallery/ from gallery.json (stdlib only)
 scripts/site/                  - Vendored landing-page build (Jinja2)
 docs/gallery/                  - Committed generated gallery pages + hero renders
@@ -80,11 +80,11 @@ v0.1.0: canonical object creation and deletion, depsgraph evaluated mesh, bmesh
 
 v0.2.0: Principled BSDF material, driver-with-custom-function via `driver_namespace`, application handler registration, shader node group with cross-version `interface` API, `foreach_get` bulk vertex read, version-branch skeleton, and USD export with `evaluation_mode='RENDER'`.
 
-## Examples (12)
+## Examples (13)
 
 Runnable scripts at `examples/<name>/`, each asserting a real API contract with
 deterministic checks (exit non-zero on failure) and optionally rendering a still via
-`--output`. All twelve run headless on Blender 4.5 LTS and 5.1 in `blender-smoke.yml`;
+`--output`. All thirteen run headless on Blender 4.5 LTS and 5.1 in `blender-smoke.yml`;
 their renders ship in the site gallery at `docs/gallery/`. `examples/gallery.json` is the
 gallery's source of truth. When authoring a new one, copy the anatomy of
 `examples/bmesh-gear/` (script structure, README shape, dark-studio render recipe) and

README.md

@@ -17,14 +17,14 @@
 </p>
 
 <p align="center">
-  <strong>12 skills</strong> &nbsp;&bull;&nbsp; <strong>6 rules</strong> &nbsp;&bull;&nbsp; <strong>2 templates</strong> &nbsp;&bull;&nbsp; <strong>17 snippets</strong> &nbsp;&bull;&nbsp; <strong>12 examples</strong>
+  <strong>12 skills</strong> &nbsp;&bull;&nbsp; <strong>6 rules</strong> &nbsp;&bull;&nbsp; <strong>2 templates</strong> &nbsp;&bull;&nbsp; <strong>17 snippets</strong> &nbsp;&bull;&nbsp; <strong>13 examples</strong>
 </p>
 
 ---
 
 ## Overview
 
-This repository ships **12 skills, 6 rules, 2 templates, 17 snippets, and 12 runnable examples** for Blender Python development targeting Blender 5.1 (current stable) with Blender 4.5 LTS fallback support.
+This repository ships **12 skills, 6 rules, 2 templates, 17 snippets, and 13 runnable examples** for Blender Python development targeting Blender 5.1 (current stable) with Blender 4.5 LTS fallback support.
 
 The content is consumed by AI coding agents (Cursor, Claude Code, any MCP-capable client) when working on Blender add-ons, geometry nodes scripts, batch pipelines, or animation tooling. There is no build step. Edit the markdown and Python files directly.
 
@@ -218,6 +218,21 @@ A beveled Bezier semicircle authored on `bpy.types.Curve` — `splines.new('BEZI
 without a prior mesh conversion. Asserts eight points, `bevel_depth == 0.15`, and
 evaluated topology 1044 verts / 1028 faces.
 
+</td>
+</tr>
+<tr>
+<td width="46%" valign="middle">
+<a href="examples/compositor-glare/"><img src="examples/compositor-glare/preview.webp" alt="Compositor glare: three neon rings - violet, cyan, and amber - with colored bloom halos and mirrored reflections on a dark studio floor" /></a>
+</td>
+<td valign="middle">
+
+### [compositor-glare](examples/compositor-glare/)
+
+Bloom through the compositor on both sides of the 5.0 rewrite — a `Glare` (Fog Glow)
+node fed by `Render Layers`, wired via `scene.compositing_node_group` on 5.x and
+`scene.node_tree` on 4.x. Witnesses with pixels that the halo falls off strictly with
+the compositor on and is exactly zero with it off — and that EEVEE has no `use_bloom`.
+
 </td>
 </tr>
 </table>