This directory holds the living truth about what modern-python/.github does now: one file per capability, plus a single glossary.md (the ubiquitous language). These files carry no frontmatter and are dated by git.

Promotion rule: when a change alters a capability's behavior, hand-edit the matching architecture/<capability>.md in the same PR as the code — the edit rides in the same diff and is reviewed with it. The change bundle in planning/changes/ stays as the why; this directory stays true.

Capability files and glossary.md are authored lazily — each appears when the first capability or term is worth pinning down.