ADR 0003 — Derive the MDX tree list per host instead of typing paths
ga · floor-software-engineer
Decision
Derive the MDX tree list per host instead of typing paths
Why
A typed path list is a path that can be mistyped, and a zero beside a declared path reads as a true statement about a host. Deriving from the one host list removes the bug class rather than correcting one string.
Measured
'platform.claude.com/en/docs' was transposed -- the real tree is docs/en -- so the inventory read 193 documents while 1,549 mirrored files sat unread, 1,495 of them the API reference. Deriving moved it to 7,870 docs and 4,096 components.
Inputs and outputs
This decision declares none. Every name in this section, when present, resolves against the capability vocabulary or the floor registry -- a typo fails the generator rather than rendering.
Where it is
| Floor | floor-software-engineer |
| Stage | ga |
| Pull request | akwlabs-ai/akw-workplace-agents#302 |
| Routed | 2026-09-02 |
| Id | 90583fdcf8d6a288 |