ADR-0008: pykit is accepted by its own specs and tests
Status: accepted (2026-09-26) ยท Scope: all pykit specs, releases and acceptance criteria
Decision
pykit is a product in its own right. Its specs, acceptance criteria and release gates are things pykit can check inside this repository. Downstream products and applications are sources of requirements: they explain why a feature exists, but no pykit feature or release waits on work in another repository.
When acceptance needs a host application, a pykit test scaffolds one in a temporary directory, installs the packages under test into it, and exercises the behavior there.
Consequences
Every acceptance line can be verified by running pykit's own tests or CI. pykit's docs do not track another repository's plans, corrections or IDs. A scaffolded application proves pykit's contract; whether a particular application integrates correctly is that application's own test concern.
Influences
This decision shapes E9 release readiness, in particular F9.8, and the acceptance section of every feature.
Alternatives considered
Accepting features in a downstream golden repository or application makes a pykit release depend on someone running another repository and reporting back, and makes pykit's docs restate another product's plans.
Background
Decided by the owner on 2026-09-26. Before then, acceptance for several features was assigned to kiln's golden repositories and to named applications; F9.8 replaced them with scaffolded applications.