Skip to content

Terminology: Tier Conventions

The term "tier" is used in multiple distinct contexts across this codebase. Always use a descriptive prefix to avoid ambiguity:

PrefixMeaningDefined in
credential delivery tierThe four-tier model for how agents receive credentials: (1) prefetch + post-process, (2) providers + L7, (3) host-side REST server, (4) host filesADR 0025
intent authorization tierThe four-tier model for change authorization: (0) standing rules, (1) tactical/issue, (2) strategic, (3) organizationalintent-representation.md
configuration tierThe three-tier inheritance model for agent configuration: upstream defaults -> org config -> per-repo overrides. The customized/ overlay mechanism (ADR-0035) has been removed; use config-driven agent registration per ADR 0064ADR 0035

Do not use bare "Tier N" or "tier" without a prefix — the same number means different things in different contexts (e.g., "Tier 2" could be provider-based credential delivery or strategic intent authorization). External tier references (e.g., "GitLab Free tier", "GitHub plan tiers") are exempt from this convention.