@@ -78,6 +78,19 @@ Neither agent needs a clone of `main`: both install the slim `plugin-dist` build
   `@plugin-dist` is a generated branch holding only what the plugin loads (about 0.3 MB, rebuilt on every release), so the add does not clone the gallery renders, showcase props and history on `main`. Adding the repo without `@plugin-dist` still works; the plugin itself installs from `plugin-dist` either way.
 
   Claude Code does not read Cursor `.mdc` rules, so the plugin ships them as the `blender-rules` skill (generated from `rules/`), which Claude loads when it writes or reviews bpy code. No second clone is needed. To keep the rules in context all the time instead, add `@/path/to/Blender-Developer-Tools/claude/blender-rules.md` to your project's `CLAUDE.md` from a checkout. Without the plugin, copy `skills/*` and `claude/skills/*` into your project's `.claude/skills/`.
+- **Other agents (Codex, GitHub Copilot, Windsurf, Gemini CLI)** — clone the same slim build once, then copy into each project:
+
+  ```bash
+  git clone --branch plugin-dist --single-branch https://github.com/TMHSDigital/Blender-Developer-Tools.git bdt
+  # Skills: agents that read .agents/skills/ (Codex, Cursor project skills)
+  mkdir -p .agents/skills && cp -r bdt/skills/* .agents/skills/
+  # Rules: agents that read AGENTS.md (Codex, Windsurf, Gemini CLI, Copilot's coding agent)
+  cat bdt/agents/AGENTS.md >> AGENTS.md
+  # Rules: GitHub Copilot path-scoped instructions (applies to **/*.py)
+  mkdir -p .github/instructions && cp bdt/agents/copilot/blender-python.instructions.md .github/instructions/
+  ```
+
+  `agents/AGENTS.md` and the Copilot file are generated from `rules/` by `scripts/build_claude_rules.py`, and CI fails if they fall out of date. The plugin-dist build fails if either file is missing. The layouts follow each agent's documented conventions; CI does not run the agents themselves.
 
 ### Live Blender session (MCP)
 
 
@@ -0,0 +1,72 @@
+# Blender Developer Tools rules
+
+<!-- Generated by scripts/build_claude_rules.py from rules/*.mdc. Do not edit. -->
+
+Apply these when writing or reviewing Blender Python. Each rule links to the
+full version with Wrong/Right examples.
+
+## always-free-bmesh
+
+Flag bmesh.new() calls without a paired bm.free() in a try/finally block. Blender frees an unreferenced BMesh only when its Python wrapper dies, which a traceback, global, closure or modal operator can delay for the whole session; an explicit free() in finally releases it deterministically.
+
+Applies to: `**/*.py`. Full rule: [`rules/always-free-bmesh.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/always-free-bmesh.mdc).
+
+## no-bgl
+
+Flag `import bgl` and any `bgl.` call. The `bgl` OpenGL wrapper was deprecated in 3.x and is gone in Blender 5.x (`importlib.util.find_spec('bgl')` is `None` on 5.0, 5.1 and 5.2), so an add-on that imports it fails to register. Draw with the `gpu` module, `gpu.state` and `gpu_extras.batch` instead; see the gpu-drawing-and-overlays skill.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-bgl.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-bgl.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.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-removed-normals-api.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-removed-normals-api.mdc).
+
+## no-unapplied-modifiers-on-export
+
+Flag an export call on objects that still carry unapplied modifiers when the export arguments do not request evaluated geometry. The engine then receives the authored cage, not the modifier result.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-unapplied-modifiers-on-export.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-unapplied-modifiers-on-export.mdc).
+
+## prefer-data-over-ops-in-loops
+
+Flag bpy.ops.* calls inside iteration over many objects, meshes, or frames. Each bpy.ops call triggers a full depsgraph evaluation and UI redraw; loops slow down by orders of magnitude. Use bpy.data.* and bmesh instead.
+
+Applies to: `**/*.py`. Full rule: [`rules/prefer-data-over-ops-in-loops.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/prefer-data-over-ops-in-loops.mdc).
+
+## prefer-temp-override-over-context-copy
+
+Flag uses of `bpy.context.copy()` to override context for an operator call. Passing a context dict to an operator was deprecated in Blender 3.2 and removed in 4.0, so it already fails on the 4.5 LTS fallback. Use `bpy.context.temp_override(**overrides)` as a context manager instead.
+
+Applies to: `**/*.py`. Full rule: [`rules/prefer-temp-override-over-context-copy.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/prefer-temp-override-over-context-copy.mdc).
+
+## target-extensions-platform-format
+
+Flag new Blender add-ons that ship only a legacy bl_info dict without a blender_manifest.toml. New add-ons must use the Extensions Platform format. bl_info may appear alongside as a fallback for backward compatibility, but the manifest is the source of truth.
+
+Applies to: `**/__init__.py`, `**/blender_manifest.toml`. Full rule: [`rules/target-extensions-platform-format.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/target-extensions-platform-format.mdc).
+
+## type-annotate-props-and-defend-context
+
+Flag two related anti-patterns. (1) bpy.props defined as class-level assignments instead of type annotations (deprecated since 2.8). (2) Code that touches bpy.context.active_object without guarding for None, or that assumes the active object is selected.
+
+Applies to: `**/*.py`. Full rule: [`rules/type-annotate-props-and-defend-context.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/type-annotate-props-and-defend-context.mdc).
+
+## use-correct-axis-rna-per-exporter
+
+Flag export_scene.gltf calls that pass FBX axis_forward or axis_up, and export_scene.fbx calls that pass glTF export_yup. The two exporters do not share axis RNA.
+
+Applies to: `**/*.py`. Full rule: [`rules/use-correct-axis-rna-per-exporter.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/use-correct-axis-rna-per-exporter.mdc).
+
+## use-foreach-set-for-bulk-data
+
+Flag Python loops that set vertex coordinates, normals, UVs, or other bulk per-element data one element at a time. For meshes of more than a few thousand elements, this is 100x to 1000x slower than `mesh.vertices.foreach_set("co", flat_array)`, which writes through to C-level storage in one pass.
+
+Applies to: `**/*.py`. Full rule: [`rules/use-foreach-set-for-bulk-data.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/use-foreach-set-for-bulk-data.mdc).
+
+## validate-imported-mesh-scale
+
+Flag a glTF or FBX import followed by mesh operations with no transform_apply and no unit-scale check. Generated files often arrive with non-identity object scale or a non-meter scene scale; mesh edits then bake the wrong size.
+
+Applies to: `**/*.py`. Full rule: [`rules/validate-imported-mesh-scale.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/validate-imported-mesh-scale.mdc).
@@ -0,0 +1,76 @@
+---
+applyTo: "**/*.py"
+---
+
+# Blender Developer Tools rules
+
+<!-- Generated by scripts/build_claude_rules.py from rules/*.mdc. Do not edit. -->
+
+Apply these when writing or reviewing Blender Python. Each rule links to the
+full version with Wrong/Right examples.
+
+## always-free-bmesh
+
+Flag bmesh.new() calls without a paired bm.free() in a try/finally block. Blender frees an unreferenced BMesh only when its Python wrapper dies, which a traceback, global, closure or modal operator can delay for the whole session; an explicit free() in finally releases it deterministically.
+
+Applies to: `**/*.py`. Full rule: [`rules/always-free-bmesh.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/always-free-bmesh.mdc).
+
+## no-bgl
+
+Flag `import bgl` and any `bgl.` call. The `bgl` OpenGL wrapper was deprecated in 3.x and is gone in Blender 5.x (`importlib.util.find_spec('bgl')` is `None` on 5.0, 5.1 and 5.2), so an add-on that imports it fails to register. Draw with the `gpu` module, `gpu.state` and `gpu_extras.batch` instead; see the gpu-drawing-and-overlays skill.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-bgl.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-bgl.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.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-removed-normals-api.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-removed-normals-api.mdc).
+
+## no-unapplied-modifiers-on-export
+
+Flag an export call on objects that still carry unapplied modifiers when the export arguments do not request evaluated geometry. The engine then receives the authored cage, not the modifier result.
+
+Applies to: `**/*.py`. Full rule: [`rules/no-unapplied-modifiers-on-export.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/no-unapplied-modifiers-on-export.mdc).
+
+## prefer-data-over-ops-in-loops
+
+Flag bpy.ops.* calls inside iteration over many objects, meshes, or frames. Each bpy.ops call triggers a full depsgraph evaluation and UI redraw; loops slow down by orders of magnitude. Use bpy.data.* and bmesh instead.
+
+Applies to: `**/*.py`. Full rule: [`rules/prefer-data-over-ops-in-loops.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/prefer-data-over-ops-in-loops.mdc).
+
+## prefer-temp-override-over-context-copy
+
+Flag uses of `bpy.context.copy()` to override context for an operator call. Passing a context dict to an operator was deprecated in Blender 3.2 and removed in 4.0, so it already fails on the 4.5 LTS fallback. Use `bpy.context.temp_override(**overrides)` as a context manager instead.
+
+Applies to: `**/*.py`. Full rule: [`rules/prefer-temp-override-over-context-copy.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/prefer-temp-override-over-context-copy.mdc).
+
+## target-extensions-platform-format
+
+Flag new Blender add-ons that ship only a legacy bl_info dict without a blender_manifest.toml. New add-ons must use the Extensions Platform format. bl_info may appear alongside as a fallback for backward compatibility, but the manifest is the source of truth.
+
+Applies to: `**/__init__.py`, `**/blender_manifest.toml`. Full rule: [`rules/target-extensions-platform-format.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/target-extensions-platform-format.mdc).
+
+## type-annotate-props-and-defend-context
+
+Flag two related anti-patterns. (1) bpy.props defined as class-level assignments instead of type annotations (deprecated since 2.8). (2) Code that touches bpy.context.active_object without guarding for None, or that assumes the active object is selected.
+
+Applies to: `**/*.py`. Full rule: [`rules/type-annotate-props-and-defend-context.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/type-annotate-props-and-defend-context.mdc).
+
+## use-correct-axis-rna-per-exporter
+
+Flag export_scene.gltf calls that pass FBX axis_forward or axis_up, and export_scene.fbx calls that pass glTF export_yup. The two exporters do not share axis RNA.
+
+Applies to: `**/*.py`. Full rule: [`rules/use-correct-axis-rna-per-exporter.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/use-correct-axis-rna-per-exporter.mdc).
+
+## use-foreach-set-for-bulk-data
+
+Flag Python loops that set vertex coordinates, normals, UVs, or other bulk per-element data one element at a time. For meshes of more than a few thousand elements, this is 100x to 1000x slower than `mesh.vertices.foreach_set("co", flat_array)`, which writes through to C-level storage in one pass.
+
+Applies to: `**/*.py`. Full rule: [`rules/use-foreach-set-for-bulk-data.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/use-foreach-set-for-bulk-data.mdc).
+
+## validate-imported-mesh-scale
+
+Flag a glTF or FBX import followed by mesh operations with no transform_apply and no unit-scale check. Generated files often arrive with non-identity object scale or a non-meter scene scale; mesh edits then bake the wrong size.
+
+Applies to: `**/*.py`. Full rule: [`rules/validate-imported-mesh-scale.mdc`](https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/validate-imported-mesh-scale.mdc).
@@ -1,6 +1,6 @@
 ---
 name: blender-rules
-description: Blender Python anti-pattern rules (bmesh leaks, bpy.ops in loops, deprecated context-copy overrides, bulk mesh writes, prop annotations and context guards, Extensions manifest, import scale, export modifiers, glTF/FBX axis RNA). Use when writing, reviewing or fixing any bpy / Blender add-on or script code.
+description: Blender Python anti-pattern rules (bmesh leaks, bpy.ops in loops, deprecated context-copy overrides, bulk mesh writes, prop annotations and context guards, Extensions manifest, import scale, export modifiers, glTF/FBX axis RNA, the removed bgl module, the normals API removed in 4.1). Use when writing, reviewing or fixing any bpy / Blender add-on or script code.
 ---
 
 # Blender Developer Tools rules (Claude Code)
 
@@ -1,15 +1,20 @@
 #!/usr/bin/env python3
-"""Generate the Claude Code copies of rules/*.mdc.
+"""Generate the agent-readable copies of rules/*.mdc.
 
-Claude Code does not read Cursor .mdc rules. This writes the same plain-markdown
-summary (one section per rule: description, load scope, link to the full rule
-with its Wrong/Right examples) to two places:
+Only Cursor reads .mdc rules. This writes the same plain-markdown summary (one
+section per rule: description, load scope, link to the full rule with its
+Wrong/Right examples) to four places:
 
 - claude/skills/blender-rules/SKILL.md: a skill the plugin ships
   (.claude-plugin/plugin.json "skills"), so plugin users get the rules with no
   second clone; Claude loads it when writing or reviewing bpy code.
 - claude/blender-rules.md: for always-on use, imported from a project's
   CLAUDE.md with ``@path/to/Blender-Developer-Tools/claude/blender-rules.md``.
+- agents/AGENTS.md: for agents that read AGENTS.md (Codex, Windsurf, Gemini
+  CLI, Copilot's coding agent); append it to a project's AGENTS.md (#376).
+- agents/copilot/blender-python.instructions.md: a GitHub Copilot path-scoped
+  instructions file (``applyTo: "**/*.py"``, the rules' own scope) for a
+  project's .github/instructions/.
 
 Links are absolute GitHub URLs so they open from an installed plugin, a
 checkout, or a CLAUDE.md import alike.
@@ -27,10 +32,17 @@
 REPO = Path(__file__).resolve().parent.parent
 OUT = REPO / "claude" / "blender-rules.md"
 SKILL_OUT = REPO / "claude" / "skills" / "blender-rules" / "SKILL.md"
+AGENTS_OUT = REPO / "agents" / "AGENTS.md"
+COPILOT_OUT = REPO / "agents" / "copilot" / "blender-python.instructions.md"
+COPILOT_FRONT = """---
+applyTo: "**/*.py"
+---
+
+"""
 RULE_URL = "https://github.com/TMHSDigital/Blender-Developer-Tools/blob/main/rules/"
 SKILL_FRONT = """---
 name: blender-rules
-description: Blender Python anti-pattern rules (bmesh leaks, bpy.ops in loops, deprecated context-copy overrides, bulk mesh writes, prop annotations and context guards, Extensions manifest, import scale, export modifiers, glTF/FBX axis RNA). Use when writing, reviewing or fixing any bpy / Blender add-on or script code.
+description: Blender Python anti-pattern rules (bmesh leaks, bpy.ops in loops, deprecated context-copy overrides, bulk mesh writes, prop annotations and context guards, Extensions manifest, import scale, export modifiers, glTF/FBX axis RNA, the removed bgl module, the normals API removed in 4.1). Use when writing, reviewing or fixing any bpy / Blender add-on or script code.
 ---
 
 """
@@ -49,9 +61,9 @@ def parse(path: Path) -> tuple[str, list[str]]:
     return desc.group(1).strip(), globs
 
 
-def render() -> str:
+def render(title: str = "Blender Developer Tools rules (Claude Code)") -> str:
     lines = [
-        "# Blender Developer Tools rules (Claude Code)",
+        f"# {title}",
         "",
         "<!-- Generated by scripts/build_claude_rules.py from rules/*.mdc. Do not edit. -->",
         "",
@@ -74,7 +86,9 @@ def render() -> str:
 
 def outputs() -> dict[Path, str]:
     body = render()
-    return {OUT: body, SKILL_OUT: SKILL_FRONT + body}
+    generic = render("Blender Developer Tools rules")
+    return {OUT: body, SKILL_OUT: SKILL_FRONT + body, AGENTS_OUT: generic,
+            COPILOT_OUT: COPILOT_FRONT + generic}
 
 
 def main() -> int:
@@ -88,7 +102,7 @@ def main() -> int:
             print(f"{', '.join(stale)} stale; run python scripts/build_claude_rules.py",
                   file=sys.stderr)
             return 1
-        print("claude/blender-rules.md and claude/skills/blender-rules/SKILL.md are up to date")
+        print("rules exports (claude/, agents/AGENTS.md, agents/copilot/) are up to date")
         return 0
     for path, new in outputs().items():
         path.parent.mkdir(parents=True, exist_ok=True)
 
@@ -35,7 +35,7 @@
 # the Blender Lab MCP server (launched with uvx from a pinned upstream commit;
 # GPL, so referenced, never vendored) and its skill. It is opt-in, so the core
 # plugin starts no server (#483).
-DIRS = ("skills", "claude", "rules", "snippets", "templates", "live-session")
+DIRS = ("skills", "claude", "agents", "rules", "snippets", "templates", "live-session")
 # The Cursor manifest ships too, so Cursor users can install the same slim
 # tree as a local plugin (~/.cursor/plugins/local/) instead of the full repo.
 # assets/favicon.svg is the Cursor manifest's "logo".
@@ -168,6 +168,10 @@ def verify(out: Path, size: int) -> list[str]:
             errors.append(f"{d.relative_to(out)} has no SKILL.md")
     if not (out / "claude" / "skills" / "blender-rules" / "SKILL.md").is_file():
         errors.append("blender-rules skill missing")
+    # The README's "Other agents" commands copy these (#376).
+    for rel in ("agents/AGENTS.md", "agents/copilot/blender-python.instructions.md"):
+        if not (out / rel).is_file():
+            errors.append(f"{rel} missing (the README's other-agents commands copy it)")
     cursor = json.loads((out / ".cursor-plugin" / "plugin.json").read_text(encoding="utf-8"))
     if "mcpServers" in plugin or "mcpServers" in cursor:
         errors.append("the core plugin must not start an MCP server; that is "