Learn the artist's house conventions from a live TD subtree
learn_conventionsAnalyze a TouchDesigner node tree to extract naming, colour, topology, and parameter conventions and save them to a vault. Supports dry-run mode to preview without writing.
Instructions
Walk a TouchDesigner subtree under scope_path without mutating TD, infer naming/colour/topology/parameter conventions, and persist them to the configured vault. By default it writes Memory/conventions.md and may merge confident naming/layout signals into Memory/style.md; set dry_run=true to return the extract without disk writes. Requires TDMCP_VAULT_PATH and returns the sampled conventions plus flags showing which notes were written.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, return the extracted conventions but do NOT write the vault note. | |
| observe | No | Which convention families to extract. | |
| max_nodes | No | Cap on nodes walked (BFS, depth-unlimited until cap). | |
| scope_path | No | Root COMP whose subtree is sampled. Defaults to /project1. | /project1 |
| min_support | No | A pattern must appear at least this many times to be recorded. | |
| also_patch_style_memory | No | If a confident naming/layout signal is found, also merge it into Memory/style.md. |