dylanroscover/Embody

mcp-tools-reference

MUST READ before first MCP tool call in a session. Complete Envoy tool catalog with parameters and usage.

release

Procedure for preparing version release commits -- changelog, README, templates, versioning

merge-divergent-tox

Merge or compare two divergent TouchDesigner .tox/.toe binaries that git cannot three-way-merge. Load when a merge/rebase conflicts on a .tox or .toe, when asked to merge, port, reconcile, or diff two versions of a TD component, or when comparing a component…

td-recovery

MUST READ when Envoy/TD connectivity is broken and has not self-healed: bridge internals, manual recovery, stale instances, broken venv.

run-tests

Run Embody's test suite and write new tests (Embody development)

multi-session-etiquette

MUST READ when a _peers advisory appears or multiple AI sessions are active in the same TouchDesigner project: advisory contract, claim leases, destructive gates, raw-file-edit visibility, division of labor.

add-mcp-tool

Add a new MCP tool to the Envoy server (Embody development)

agent-tests

MUST READ before calling RunAgentTests or touching agent-tier test infrastructure -- these tests spawn real AI clients (Claude Code, Codex) and SPEND SUBSCRIPTION USAGE; never run casually. Tier model, async runner rationale, auth/isolation rules.

multi-instance

Workflow for running multiple TD instances with Envoy, switching between them, and understanding the instance registry.

create-operator

MUST READ before creating or moving any operator (create_op, copy_op, set_op_position, or execute_python builds). Required verification, canonical positioning recipe, and error-checking steps.

td-api-reference

MUST READ before writing TD Python via execute_python, set_dat_content, or edit_dat_content, and before any heavy build. Parameters, storage, operators, referencing, threading, cook model, heavy-build safety caps.

visual-aesthetics

MUST READ before building or refining rendered visual output in TouchDesigner: generative art, VJ visuals, shaders, scenes, renders, projections, or anything shown on screen. Principles, verified TD recipes, and named looks for composition, camera, lighting,…

externalize-operator

MUST READ before calling externalize_op or save_externalization. Required workflow steps.

manage-annotations

MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks.

brief

Compile a conversational request into an Embody task brief (briefs/*.md): skills to load, discovered anchors, verifiable success criteria, and gates -- then execute the work from that contract. User-invoked via /brief.

pop-networks

MUST READ before building or editing POP networks, particle systems, GPU point/geometry work, glslPOP compute, or converting SOP chains to POPs in TouchDesigner 2025+.

movie-export

MUST READ before recording, exporting, or batch-encoding any movie or image sequence from TouchDesigner: the Realtime trap, zero-drop verification, deterministic per-frame export, async file-reader staleness.

parameter-design

MUST READ before creating or designing custom parameters on any COMP: pages, styles, ranges, help text, naming, ParGroup gotchas.

debug-operator

TRIGGER when operator errors appear or user reports broken behavior. Systematic diagnosis workflow.

specimen-authoring

Workflow and hard-won TD patterns for authoring Embody Specimens (the transparent TDN gallery networks). Load before building or persisting a Specimen.

create-extension

MUST READ before calling create_extension. Required parameters, lifecycle methods, and wiring steps.