Repository topology

A repository is scoped to one concern of its standard. A reader who opens an infrastructure library sees the organization's conventions for that technology and nothing else, and a consumer who depends on it pulls in exactly one service. The organization defines five repository tiers, and every member repository of a standard belongs to exactly one:

A standard's adjacent libraries stand beside the five tiers rather than in one, and the agent-tooling repositories and the organization-context repositories stand outside them.

Adjacent libraries

A module repository may stand adjacent to a standard rather than in it: a standalone library any project on the standard's technology can adopt on its own. It is not an infrastructure library, because it presents no one external technology as a service, and it keeps its guide in its own repository. An adjacent library follows the standard's engineering principles (naming, module layout, releases and CI, tests and documentation) without being a member of any tier. It is consumed downward like any library: a tier may depend on it, and it depends on no tier, though it may build on another adjacent library.

Dependencies run downward, one tier at a time

A reference architecture depends on its application SDK, the infrastructure libraries, adjacent libraries, and providers it composes, and the core SDK. A template depends on the core SDK and its one application SDK. An application SDK and an infrastructure library never depend on each other; both depend on the core SDK and on no other tier. The core SDK depends only on what its standard's dependency line admits. Knowledge follows the same direction: a repository documents its dependencies and never names its dependents (dependencies flow downward only).

Versioning across the tiers

Each repository releases independently (independent releases). The core SDK is a dependency shared by every repository above it; a change to it releases first and is taken up by the coordinated releases that follow.

Keyboard shortcuts

Settings