feat: gpu-draw-handler and set-sharp-from-angle snippets, no-legacy-vse-sequences rule

- snippets/gpu-draw-handler.py: POST_VIEW overlay that stores its
  draw_handler_add handle and removes it in unregister()
- snippets/set-sharp-from-angle.py: the 4.1+ replacement for
  use_auto_smooth, reading corner_normals
- rules/no-legacy-vse-sequences.mdc: flags .sequences and .sequences_all.
  Measured hasattr on a fresh SequenceEditor: 4.5.14 LTS has sequences,
  sequences_all, strips and strips_all; 5.2.1 LTS has only strips and
  strips_all (.sequences_all raises AttributeError too)

Both snippets ran headless on 4.5.14 and 5.2.1 (register twice, unregister,
handle cleared; 96 corner normals, all 18 faces smooth). Counts now 12 rules,
31 snippets; rule exports regenerated; run_all.py 35/35.

Closes #500
Closes #501
Closes #502

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -52,6 +52,7 @@
     "rules/no-unapplied-modifiers-on-export.mdc",
     "rules/use-correct-axis-rna-per-exporter.mdc",
     "rules/no-bgl.mdc",
-    "rules/no-removed-normals-api.mdc"
+    "rules/no-removed-normals-api.mdc",
+    "rules/no-legacy-vse-sequences.mdc"
   ]
 }

AGENTS.md

@@ -20,7 +20,7 @@ a `.cursor-plugin/plugin.json` manifest so the ecosystem drift checker
 classifies it as a `cursor-plugin`. This is content the AI loads when the user
 asks Blender questions or works on Blender add-ons in Cursor or Claude Code.
 
-The content base is 20 skills, 11 rules, 3 templates, 29 snippets, 66
+The content base is 20 skills, 12 rules, 3 templates, 31 snippets, 66
 examples, and 80 showcase pieces (counts are CI-enforced across README.md, the agent docs, ROADMAP.md,
 `site.json` and the site templates). The full inventory tables and per-item purposes live in
 `CLAUDE.md`. Example anatomy and authoring rules: copy `examples/bmesh-gear/`;
@@ -33,9 +33,9 @@ in `docs/VISUAL-STYLE.md`; the canonical run prompt is
 ```
 Blender-Developer-Tools/
   skills/<skill-name>/SKILL.md   # 20 skill files
-  rules/<rule-name>.mdc          # 11 rule files
+  rules/<rule-name>.mdc          # 12 rule files
   templates/<template-name>/     # 3 starter templates
-  snippets/<snippet-name>.py     # 29 standalone Python snippets
+  snippets/<snippet-name>.py     # 31 standalone Python snippets
   examples/<name>/               # 69 runnable smoke-gated examples (+ gallery.json)
   examples/gallery_framing.py    # shared Layer 1 framing measurement (render path only)
   showcase/<name>/               # budget-conformance props (sibling of examples/)

CLAUDE.md

@@ -18,9 +18,9 @@ The **Blender Developer Tools** repository is at **v0.156.0**. It packages skill
 
 ```
 skills/<skill-name>/SKILL.md   - AI workflow definitions, 20 total
-rules/<rule-name>.mdc          - Anti-pattern rules, 11 total
+rules/<rule-name>.mdc          - Anti-pattern rules, 12 total
 templates/<template-name>/     - Starter projects, 3 total
-snippets/<snippet-name>.py     - Standalone code patterns, 29 total
+snippets/<snippet-name>.py     - Standalone code patterns, 31 total
 examples/<name>/               - Runnable smoke-gated examples, 69 total (+ gallery.json)
 showcase/<name>/               - Budget-conformance props, 80 pieces, each with a gallery `category` (sibling of examples/; see showcase/README.md § Categories)
 scripts/build_gallery.py       - Regenerates docs/gallery/ from examples/gallery.json + showcase/gallery.json
@@ -55,7 +55,7 @@ VERSION                        - Source of truth for the repo version
 | porting-to-blender-5 | Index of every 4.x → 5.x break the pack covers (bgl, `action.fcurves`, `use_auto_smooth`, Principled sockets, `.sequences`, ID properties, compositor, NodesModifier inputs, ...), each linked to the skill, rule or example that owns the fix; headless triage recipe |
 | gpu-drawing-and-overlays | `gpu` instead of the removed `bgl`: `draw_handler_add`/`remove`, builtin shader names, `gpu.state` blending and depth, `POLYLINE_*` line width, `blf` text, `GPUOffScreen` with 5.2's `gpu.init()` headless |
 
-## Rules (11)
+## Rules (12)
 
 Every rule sets `alwaysApply: false`, so the Scope column below is the rule's
 actual load condition, not a description: a rule enters context only when a file
@@ -74,6 +74,7 @@ matching its `globs` does. Changing a glob changes when the rule fires.
 | use-correct-axis-rna-per-exporter | `*.py` | `export_scene.gltf` with FBX `axis_forward`/`axis_up`, or `export_scene.fbx` with glTF `export_yup` |
 | no-bgl | `*.py` | `import bgl` or any `bgl.` call (removed in 5.x; the add-on fails to register) |
 | no-removed-normals-api | `*.py` | `use_auto_smooth`, `auto_smooth_angle`, `calc_normals_split()` and the other normals calls removed in 4.1 |
+| no-legacy-vse-sequences | `*.py` | `sequence_editor.sequences` / `.sequences_all` (removed in 5.x; `.strips` / `.strips_all` exist on 4.5 too) |
 
 ## Templates (3)
 
@@ -101,7 +102,7 @@ matching its `globs` does. Changing a glob changes when the rule fires.
 - Unity / Godot / Unreal glTF export via the engine-export-presets contract
 - Explicit exit codes matching `headless-batch-script-template` (0, then 2+)
 
-## Snippets (29)
+## Snippets (31)
 
 Small standalone `.py` files at `snippets/<name>.py`, each 5 to 75 lines.
 
@@ -111,7 +112,7 @@ v0.2.0: Principled BSDF material, driver-with-custom-function via `driver_namesp
 
 AI asset pipeline track: `decimate_to_budget.py`, `convex_hull_collider.py`, `lod_chain.py` (helper duplicated, not imported), `gltf_draco_export.py`, `export_preset_unity.py`, `export_preset_godot.py`, `export_preset_unreal.py`, `setup_bake_target_image.py`, `bake_normal_high_to_low.py`, `save_baked_image.py`.
 
-Extensions runtime: `extension-user-data.py` (`extension_path_user` settings file and an `online_access` guard). Long-running work: `thread-queue-timer.py` (worker thread, `queue.Queue`, main-thread drain timer).
+Extensions runtime: `extension-user-data.py` (`extension_path_user` settings file and an `online_access` guard). Long-running work: `thread-queue-timer.py` (worker thread, `queue.Queue`, main-thread drain timer). Porting to 5.x: `gpu-draw-handler.py` (viewport overlay with a stored, removable draw handler) and `set-sharp-from-angle.py` (the 4.1+ replacement for `use_auto_smooth`).
 
 ## Examples (69)
 

CONTRIBUTING.md

@@ -292,7 +292,7 @@ The drift-check workflow enforces these on every push and PR.
 
 ## Aggregate Counts
 
-`README.md` declares aggregate counts (e.g. "20 skills, 11 rules, 3 templates, 29 snippets, 69 examples, and 80 showcase pieces"). The `validate-counts` job in `.github/workflows/validate.yml` enforces these substrings against the filesystem on every push and PR. Showcase pieces are counted separately from examples. When you add or remove content, update the README counts in the same commit.
+`README.md` declares aggregate counts (e.g. "20 skills, 12 rules, 3 templates, 31 snippets, 69 examples, and 80 showcase pieces"). The `validate-counts` job in `.github/workflows/validate.yml` enforces these substrings against the filesystem on every push and PR. Showcase pieces are counted separately from examples. When you add or remove content, update the README counts in the same commit.
 
 ## Pull Request Process
 

README.md

@@ -25,7 +25,7 @@
 </p>
 
 <p align="center">
-  <strong>20 skills</strong> &nbsp;&bull;&nbsp; <strong>11 rules</strong> &nbsp;&bull;&nbsp; <strong>3 templates</strong> &nbsp;&bull;&nbsp; <strong>29 snippets</strong> &nbsp;&bull;&nbsp; <strong>69 examples</strong> &nbsp;&bull;&nbsp; <strong>80 showcase pieces</strong>
+  <strong>20 skills</strong> &nbsp;&bull;&nbsp; <strong>12 rules</strong> &nbsp;&bull;&nbsp; <strong>3 templates</strong> &nbsp;&bull;&nbsp; <strong>31 snippets</strong> &nbsp;&bull;&nbsp; <strong>69 examples</strong> &nbsp;&bull;&nbsp; <strong>80 showcase pieces</strong>
 </p>
 
 <p align="center">
@@ -44,7 +44,7 @@
 
 ## Overview
 
-This repository ships **20 skills, 11 rules, 3 templates, 29 snippets, 69 examples, and 80 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
+This repository ships **20 skills, 12 rules, 3 templates, 31 snippets, 69 examples, and 80 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
 
 The content is consumed by AI coding agents, installed as a plugin or read from a checkout. An optional second plugin registers the official [Blender Lab MCP server](https://www.blender.org/lab/mcp-server/) for live sessions (see [Live Blender session](#live-blender-session-mcp)); the server is referenced from upstream, not part of this repository, and nothing else depends on it. Cursor and Claude Code both install it as a plugin (see [Quick start](#quick-start)): Cursor loads the skills and applies `rules/*.mdc` wherever their scope globs match; Claude Code loads the skills and gets the rules through a generated `blender-rules` skill, since it does not read Cursor `.mdc` files. An agent picks a skill up when its description matches the task. Any agent that can read files in a workspace can use it the same way. There is no build step for the content — edit the Markdown and Python files directly.
 
@@ -53,15 +53,15 @@ The content is consumed by AI coding agents, installed as a plugin or read from
 | **Skills** | Guided workflows: scaffolding, operators, panels, properties, mesh and bmesh, headless batch, slotted actions, geometry nodes, procedural materials, depsgraph queries, drivers and handlers, `bl_info` migration, video sequencer, imported-mesh cleanup, high-to-low baking, engine export presets, extension runtime and packaging, timers, modal operators and threading, GPU drawing and viewport overlays, porting add-ons to Blender 5 |
 | **Rules** | Guardrails for the most common AI mistakes: ops-in-loops, bmesh leaks, legacy `bl_info` only, prop assignments, deprecated context-copy override, per-element loops over bulk mesh data, import without scale check, export without evaluated geometry, mixed glTF/FBX axis RNA |
 | **Templates** | A working Extensions Platform add-on starter, a headless batch script starter, and a GLB-in engine-ready asset pipeline |
-| **Snippets** | 29 small standalone Python files demonstrating canonical patterns, 5 to 75 lines each |
+| **Snippets** | 31 small standalone Python files demonstrating canonical patterns, 5 to 75 lines each |
 | **Examples** | Runnable headless scripts under [`examples/`](examples/). Each asserts an API contract and exits non-zero on failure. |
 | **Showcase** | Proof that the skills compose: each piece under [`showcase/`](showcase/) is one headless Python script that builds a game prop and runs the whole asset pipeline (cleanup, high-to-low bake, LODs, convex collider, engine export), asserting measured budgets on every LTS. Not API examples. Conventions: [`showcase/README.md`](showcase/README.md) |
 
 ## Quick start
 
 Neither agent needs a clone of `main`: both install the slim `plugin-dist` build. Clone the full repository only to [run the examples or contribute](#run-the-examples-or-contribute).
 
-- **Cursor** — install it as a local plugin from the slim `plugin-dist` branch, then run **Developer: Reload Window**. **Customize** lists the 20 skills and 11 rules; the rules apply by glob scope and the agent loads a skill when its description matches the task.
+- **Cursor** — install it as a local plugin from the slim `plugin-dist` branch, then run **Developer: Reload Window**. **Customize** lists the 20 skills and 12 rules; the rules apply by glob scope and the agent loads a skill when its description matches the task.
 
   ```bash
   git clone --branch plugin-dist --single-branch https://github.com/TMHSDigital/Blender-Developer-Tools.git ~/.cursor/plugins/local/blender-developer-tools
@@ -189,9 +189,9 @@ Browse both, with filters, full-size renders and each script's README, in the **
 
 ```
 skills/<name>/SKILL.md   - 20 skill files, YAML frontmatter, one canonical pattern each
-rules/<name>.mdc         - 11 rule files, anti-pattern + correction
+rules/<name>.mdc         - 12 rule files, anti-pattern + correction
 templates/<name>/        - 3 template directories (extension-addon-template, headless-batch-script-template, ai-asset-pipeline-template)
-snippets/<name>.py       - 29 standalone Python snippets, 5 to 75 lines each
+snippets/<name>.py       - 31 standalone Python snippets, 5 to 75 lines each
 examples/<name>/         - 69 example directories: script, README with exit codes and falsifier
 showcase/<name>/         - 80 showcase pieces: budget-gated game props, script and README
 claude/                  - generated Claude Code copies of the rules (blender-rules skill + import file)

ROADMAP.md

@@ -39,6 +39,7 @@ derives the actual version from conventional-commit types.
 | GPU drawing without `bgl` | 19 | 10 | 3 | 29 | Shipped |
 | Removed normals API rule (pre-4.1 auto smooth) | 19 | 11 | 3 | 29 | Shipped |
 | Porting index skill (`porting-to-blender-5`) | 20 | 11 | 3 | 29 | Shipped |
+| Porting snippets and the legacy VSE `.sequences` rule | 20 | 12 | 3 | 31 | Shipped |
 | Live-session bridge (opt-in `blender-live-session` plugin, upstream Blender Lab MCP) | - | - | - | - | Shipped |
 | Stable (1.0) | — | — | — | — | Upcoming; criteria below |
 

claude/blender-rules.md

@@ -17,6 +17,12 @@ Flag `import bgl` and any `bgl.` call. The `bgl` OpenGL wrapper was deprecated i
 
 Applies to: `**/*.py`. Full rule: [`rules/no-bgl.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-bgl.mdc).
 
+## no-legacy-vse-sequences
+
+Flag `sequence_editor.sequences` and `.sequences_all`. Both are gone in Blender 5.x (AttributeError on 5.0, 5.1 and 5.2), while `.strips` and `.strips_all` already exist on 4.5 LTS, so use those everywhere with no version branch. See the vse-python skill.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-legacy-vse-sequences.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-legacy-vse-sequences.mdc).
+
 ## no-removed-normals-api
 
 Flag the mesh normals API removed in Blender 4.1 — `use_auto_smooth`, `auto_smooth_angle`, `calc_normals_split()`, `free_normals_split()`, `create_normals_split()`. Each raises AttributeError on 4.5 LTS and 5.x. Use `Mesh.set_sharp_from_angle`, `object.shade_auto_smooth`, and `Mesh.corner_normals` (always current) instead.

claude/skills/blender-rules/SKILL.md

@@ -22,6 +22,12 @@ Flag `import bgl` and any `bgl.` call. The `bgl` OpenGL wrapper was deprecated i
 
 Applies to: `**/*.py`. Full rule: [`rules/no-bgl.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-bgl.mdc).
 
+## no-legacy-vse-sequences
+
+Flag `sequence_editor.sequences` and `.sequences_all`. Both are gone in Blender 5.x (AttributeError on 5.0, 5.1 and 5.2), while `.strips` and `.strips_all` already exist on 4.5 LTS, so use those everywhere with no version branch. See the vse-python skill.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-legacy-vse-sequences.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-legacy-vse-sequences.mdc).
+
 ## no-removed-normals-api
 
 Flag the mesh normals API removed in Blender 4.1 — `use_auto_smooth`, `auto_smooth_angle`, `calc_normals_split()`, `free_normals_split()`, `create_normals_split()`. Each raises AttributeError on 4.5 LTS and 5.x. Use `Mesh.set_sharp_from_angle`, `object.shade_auto_smooth`, and `Mesh.corner_normals` (always current) instead.

exports/AGENTS.md

@@ -17,6 +17,12 @@ Flag `import bgl` and any `bgl.` call. The `bgl` OpenGL wrapper was deprecated i
 
 Applies to: `**/*.py`. Full rule: [`rules/no-bgl.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-bgl.mdc).
 
+## no-legacy-vse-sequences
+
+Flag `sequence_editor.sequences` and `.sequences_all`. Both are gone in Blender 5.x (AttributeError on 5.0, 5.1 and 5.2), while `.strips` and `.strips_all` already exist on 4.5 LTS, so use those everywhere with no version branch. See the vse-python skill.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-legacy-vse-sequences.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-legacy-vse-sequences.mdc).
+
 ## no-removed-normals-api
 
 Flag the mesh normals API removed in Blender 4.1 — `use_auto_smooth`, `auto_smooth_angle`, `calc_normals_split()`, `free_normals_split()`, `create_normals_split()`. Each raises AttributeError on 4.5 LTS and 5.x. Use `Mesh.set_sharp_from_angle`, `object.shade_auto_smooth`, and `Mesh.corner_normals` (always current) instead.

exports/copilot/blender-python.instructions.md

@@ -21,6 +21,12 @@ Flag `import bgl` and any `bgl.` call. The `bgl` OpenGL wrapper was deprecated i
 
 Applies to: `**/*.py`. Full rule: [`rules/no-bgl.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-bgl.mdc).
 
+## no-legacy-vse-sequences
+
+Flag `sequence_editor.sequences` and `.sequences_all`. Both are gone in Blender 5.x (AttributeError on 5.0, 5.1 and 5.2), while `.strips` and `.strips_all` already exist on 4.5 LTS, so use those everywhere with no version branch. See the vse-python skill.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-legacy-vse-sequences.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-legacy-vse-sequences.mdc).
+
 ## no-removed-normals-api
 
 Flag the mesh normals API removed in Blender 4.1 — `use_auto_smooth`, `auto_smooth_angle`, `calc_normals_split()`, `free_normals_split()`, `create_normals_split()`. Each raises AttributeError on 4.5 LTS and 5.x. Use `Mesh.set_sharp_from_angle`, `object.shade_auto_smooth`, and `Mesh.corner_normals` (always current) instead.