akw-factory-floorsfloors.akwlabs.dev · ga

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