t1k-routing-unity.json
priority: 90
Engine-kit routing for theonekit-unity. <role>-dots keys live in the dots-core p91 overlay (modules/dots-core/t1k-routing-unity-dots-core.json) and are selected once the architecture project fact resolves. The BARE lane is the MONO/core lane: every bare key names an agent that ships in a required module or in core’s p10 fallback, so a MonoBehaviour project that never installed the optional dots-core still resolves every role to an agent that exists on disk. Protocol: theonekit-core skills/t1k-cook/references/routing-protocol.md § “Architecture-Suffixed Roles”.
Error recovery
Section titled “Error recovery”| Error type | Role |
|---|---|
burst-error | implementer |
compilation | implementer |
performance | optimizer |
runtime-nan | debugger |
scene-broken | environment |
test-failure | tester |
Raw JSON (ground truth)
{ "_doc-bare-key-flip": "609b landed: the 7 bare keys that still named `dots-core` agents (`compile-doctor`, `reviewer`, `debugger`, `optimizer`, `environment`, `validator`, `shader`) now resolve on the mono/core lane. Trigger, both halves verified before the flip: (1) core `t1k-base` ships the declarative `architectureDetect` fallback in `readArchitecture()` (core#1694), and this kit's `base` module REQUIRES `theonekit-core:t1k-base >=3.319.0`, so the fact resolves from the kit fragment alone with nobody running anything; (2) the released `manifest.json` carries per-module `agents[]` again (release-action#582 / core#4699), so doctor #98 can report a role naming an optional uninstalled module's agent as INFO rather than FAIL. Residual known and accepted: a consumer still on an older core has an inert `architectureDetect` and its DOTS projects resolve the bare keys to mono agents until its next `t1k modules update` — the same mixed-fleet risk every kit release carries, never a silent wrong answer once the core floor above is enforced.", "_doc-bare-lane": "The BARE keys are the MONO/core lane. Every one names an agent that ships in a REQUIRED module (`base`) or in core's p10 fallback (`t1k-code-reviewer`, `t1k-debugger`), so no bare row can name an agent absent from disk — the state that, before 609b, made 78-87% of those delegations fail on a MonoBehaviour project that had never installed the optional `dots-core` (2026-09 telemetry). `reviewer`/`debugger` name CORE's agents rather than restating a mono twin at p90: restating core's own mapping shadows it and drifts on core's next agent rename; `theonekit-web` makes the same call. A DOTS project is unaffected: the p91 overlay's suffixed key still wins whenever the `architecture` fact resolves, and `fileRouting`/`errorRecovery` hold role KEYS so they follow the split for free (see `_doc-fileRouting-roles`). `roles.feel-developer` is the ONE remaining bare row whose target ships in a non-required module (`rendering`) — a pre-existing, separate gap, not part of the bare lane; closing it (make `rendering` required, or add a base-module stand-in) is a Wave-2 decision tracked in `plans/609b-bare-role-flip.md`.", "_doc-dots-lane": "The DOTS lane is `roles['<role>-dots']` in the dots-core p91 overlay, selected when the project fact `architecture` resolves. The overlay is resolved by the suffixed-key rule in core's `agent-routing-index.cjs` `resolveRole()` — a suffixed key is tried first and the bare key is the total fallback, so the overlay can never break a role, and a DOTS project keeps its DOTS agent on every role the overlay declares.", "_doc-engineRouting": "Engine vocabulary bound to the specialist that owns it (the `#GGD` mechanism in core's `agent-routing-index.cjs`), so a lane brief naming an engine concept resolves to the specialist at fragment priority (p90) ahead of a rival matched only on an incidental token such as `lane`, `audit` or `review`. Measured on Unity project transcripts (about 3200 sessions, 765 generic spawns): about 180 code-write lanes, about 100 PR reviews and about 31 parity audits fell through to generic agents. Project-specific words from the source project (`monster`, `behaviors`) were not ported. Data-driven: deleting this block removes the tiebreak and redirects nothing.", "_doc-fileRouting-roles": "`fileRouting` and `errorRecovery` values are role KEYS, never agent names, so they inherit the architecture split for free and are deliberately NOT duplicated into the overlay — a second copy of the same pattern would be a second source of truth that could drift.", "description": "Engine-kit routing for theonekit-unity. `<role>-dots` keys live in the dots-core p91 overlay (modules/dots-core/t1k-routing-unity-dots-core.json) and are selected once the `architecture` project fact resolves. The BARE lane is the MONO/core lane: every bare key names an agent that ships in a required module or in core's p10 fallback, so a MonoBehaviour project that never installed the optional `dots-core` still resolves every role to an agent that exists on disk. Protocol: theonekit-core `skills/t1k-cook/references/routing-protocol.md` § \"Architecture-Suffixed Roles\".", "engineRouting": { "adversarial": "t1k-unity-base-pr-reviewer", "authoring": "t1k-unity-dots-core-implementer", "baker": "t1k-unity-dots-core-implementer", "batching": "t1k-unity-base-optimizer", "canvas": "t1k-unity-base-ui-developer", "closure": "t1k-unity-base-parity-porter", "delta": "t1k-unity-base-pr-reviewer", "dialog": "t1k-unity-base-ui-developer", "dots": "t1k-unity-dots-core-implementer", "ecs": "t1k-unity-dots-core-implementer", "fixture": "t1k-unity-base-test-writer", "fixtures": "t1k-unity-base-test-writer", "grid": "t1k-unity-base-ui-developer", "hitching": "t1k-unity-base-optimizer", "hud": "t1k-unity-base-ui-developer", "inventory": "t1k-unity-base-ui-developer", "messagepipe": "t1k-unity-base-feature-implementer", "monobehaviour": "t1k-unity-base-feature-implementer", "mutation": "t1k-unity-base-pr-reviewer", "nunit": "t1k-unity-base-test-writer", "overdraw": "t1k-unity-base-optimizer", "overlay": "t1k-unity-base-ui-developer", "panel": "t1k-unity-base-ui-developer", "parity": "t1k-unity-base-parity-porter", "persist": "t1k-unity-base-feature-implementer", "popup": "t1k-unity-base-ui-developer", "signalbus": "t1k-unity-base-feature-implementer", "stores": "t1k-unity-base-feature-implementer", "subscene": "t1k-unity-dots-core-implementer", "suites": "t1k-unity-dots-core-tester", "tests": "t1k-unity-base-test-writer", "ugui": "t1k-unity-base-ui-developer", "unitask": "t1k-unity-base-feature-implementer", "vcontainer": "t1k-unity-base-feature-implementer", "windowed": "t1k-unity-dots-core-validator", "xvfb": "t1k-unity-dots-core-validator" }, "errorRecovery": { "burst-error": "implementer", "compilation": "implementer", "performance": "optimizer", "runtime-nan": "debugger", "scene-broken": "environment", "test-failure": "tester" }, "fileRouting": { "*.shader|*.hlsl|*.shadergraph": "shader", "*Canvas*|*UI*|*Panel*|*HUD*": "ui-developer", "Assets/Demos/*/Editor/": "environment", "Packages/*/Runtime/": "implementer", "Packages/*/Tests/": "tester" }, "priority": 90, "registryVersion": 1, "roles": { "asset-porter": "t1k-unity-base-asset-porter", "audio-developer": "t1k-unity-audio-developer", "compile-doctor": "t1k-unity-base-developer", "data-author": "t1k-unity-base-data-author", "debugger": "t1k-debugger", "environment": "t1k-unity-base-developer", "feature-implementer": "t1k-unity-base-feature-implementer", "feel-developer": "t1k-unity-rendering-feel-developer", "game-brainstormer": "t1k-unity-base-brainstormer", "game-developer": "t1k-unity-base-developer", "implementer": "t1k-unity-base-developer", "lane-lead": "t1k-unity-base-lane-lead", "mono-implementer": "t1k-unity-base-developer", "mono-optimizer": "t1k-unity-base-optimizer", "optimizer": "t1k-unity-base-optimizer", "parity-porter": "t1k-unity-base-parity-porter", "pr-reviewer": "t1k-unity-base-pr-reviewer", "project-bootstrapper": "t1k-unity-base-project-bootstrapper", "reviewer": "t1k-code-reviewer", "scene-environment": "t1k-unity-base-developer", "shader": "t1k-unity-base-developer", "test-writer": "t1k-unity-base-test-writer", "tester": "t1k-unity-base-mono-tester", "ui-developer": "t1k-unity-base-ui-developer", "ui-implementer": "t1k-unity-base-ui-implementer", "validator": "t1k-unity-base-mono-tester", "visual-director": "t1k-unity-base-visual-director" }}