Trait

Portable

Behaves the same locally, in the development container, and on a CI runner.

Architecture Build & Delivery

Automation & CI/CD

.gitea/ is the repository’s automation control folder: event-driven workflows and local actions that orchestrate the repository’s own commands.

.gitea/ 2

Architecture Environment & Tooling

Command Surface

An identical root Makefile in every repository, with the repository’s own components declared once in scripts/build/repository.mk.

Makefile 4

Convention Infrastructure & Runtime

Derived Developer Identity

A developer deployment names its instance from the Terraform workspace, chosen from an override, the CI branch, or the local username — never from a per-developer file.

workspaces/ 3

Architecture Environment & Tooling

Development Container

The authoritative development environment for a repository — reusable features provide the toolchains, and repository-specific lifecycle hooks finish the workspace.

.devcontainer/ 4

Contract Environment & Tooling

Explicit Skips

When a capability is intentionally unavailable, a command says so with a skip: line and succeeds, while a check that actually fails still exits non-zero.

scripts/ 6

Contract Environment & Tooling

Lint Gate

One aggregate lint command runs every linter that is installed, skips the rest with a clear message, and fails only on real findings.

scripts/lint.sh 4

Convention Documentation & Metadata

Managed Standard Files

Standard files copied into every repository carry a DO NOT EDIT header; they are changed at their source, never in the repository that received them.

./ 0

Architecture Infrastructure & Runtime

Modules

Small, focused infrastructure building blocks with explicit inputs and outputs, consumed by deployable roots in env/ and workspaces/.

modules/ 3

Architecture Environment & Tooling

Tools

Repository tooling with stable command entry points and documented contracts — small applications that own a workflow, rather than glue around one.

tools/ 2