dylanroscover/Embody

multi-instance

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

Quellsprache: Englisch

td-recovery

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

Quellsprache: Englisch

mcp-tools-reference

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

Quellsprache: Englisch

operator-gotchas

MUST READ before wiring a TOP, CHOP, MAT, DAT, light, camera or instancing chain you have not built before: the parameter names TD abbreviates, the defaults that silently do the wrong thing, and the input-order rules, per operator, verified on TD 2025.33230.…

Quellsprache: Englisch

build-ui

MUST READ before building or styling any TouchDesigner panel UI (dialog, wizard, HUD, control panel, buttons, text): design tokens, layout rules, component recipes, and the OP Viewer TOP verification loop. Mechanics (which panel COMP, single-window, click…

Quellsprache: Englisch

collab

Switch this session into thinking-partner mode for TouchDesigner: discuss, read the docs, build one small step at a time in the visible output, and hand the next decision back instead of finishing the network autonomously. User-invoked via /collab; /brief or…

Quellsprache: Englisch

create-extension

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

Quellsprache: Englisch

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.

Quellsprache: Englisch

debug-operator

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

Quellsprache: Englisch

externalize-operator

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

Quellsprache: Englisch

glsl-shaders

MUST READ before writing GLSL or creating a glslTOP, glslmultiTOP, glslMAT or glslPOP: docked DATs, uniforms and the Colors page, TD's built-in functions and samplers, feedback and multi-pass, reading compile errors. Every built-in named here compiled on TD…

Quellsprache: Englisch

manage-annotations

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

Quellsprache: Englisch

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…

Quellsprache: Englisch

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.

Quellsprache: Englisch

parameter-design

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

Quellsprache: Englisch

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+.

Quellsprache: Englisch

release

MUST READ before preparing a release commit or GitHub release -- the blocking GitHub preflight (dev/release_preflight.py), project.save() versioning, changelog, README, template sync verification, fresh-install smoke, and the post-push GitHub release…

Quellsprache: Englisch

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.

Quellsprache: Englisch

testing

MUST READ before declaring any TouchDesigner build, fix or show done, and before any soak or performance test: the verification ladder (structure, errors, frame, motion, data, performance, soak, end to end), run_soak_test and the observer-effect rules that…

Quellsprache: Englisch

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,…

Quellsprache: Englisch

specimen-authoring

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

Quellsprache: Englisch

run-tests

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

Quellsprache: Englisch

add-mcp-tool

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

Quellsprache: Englisch

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.

Quellsprache: Englisch

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.

Quellsprache: Englisch

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.

Quellsprache: Englisch