Skip to content

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

RoleAgent
asset-portert1k-unity-base-asset-porter
audio-developert1k-unity-audio-developer
compile-doctort1k-unity-base-developer
data-authort1k-unity-base-data-author
debuggert1k-debugger
environmentt1k-unity-base-developer
feature-implementert1k-unity-base-feature-implementer
feel-developert1k-unity-rendering-feel-developer
game-brainstormert1k-unity-base-brainstormer
game-developert1k-unity-base-developer
implementert1k-unity-base-developer
lane-leadt1k-unity-base-lane-lead
mono-implementert1k-unity-base-developer
mono-optimizert1k-unity-base-optimizer
optimizert1k-unity-base-optimizer
parity-portert1k-unity-base-parity-porter
pr-reviewert1k-unity-base-pr-reviewer
project-bootstrappert1k-unity-base-project-bootstrapper
reviewert1k-code-reviewer
scene-environmentt1k-unity-base-developer
shadert1k-unity-base-developer
test-writert1k-unity-base-test-writer
testert1k-unity-base-mono-tester
ui-developert1k-unity-base-ui-developer
ui-implementert1k-unity-base-ui-implementer
validatort1k-unity-base-mono-tester
visual-directort1k-unity-base-visual-director
Error typeRole
burst-errorimplementer
compilationimplementer
performanceoptimizer
runtime-nandebugger
scene-brokenenvironment
test-failuretester

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"
}
}