Agency Standards

On this page

This module holds the agency-wide engineering standards every GADHS project follows. They are the canonical, human-facing prose; the terse, agent-facing digests of the same rules live in .claude/rules/.

IMPORTANT

These pages are distributed to every project as synced files via the manifest engine (cargo xtask check-docs) — NOT composed at build time. That keeps them readable in-repo and makes drift deterministically detectable and fixable. Do not edit them downstream; on drift, run cargo xtask check-docs --fix --yes. Full rationale: docs/adrs/adr-001-antora-distribution.adoc.

The standards

  • Security Baseline — Kerckhoffs’s principle, public-visibility enforcement.

  • Git Workflow — branching, commits, signing, hooks, versioning.

  • GitLab Workflow — issue/MR/epic standards.

  • Delivery Protocol — preflight, recommendations, debugging, delivery + the information cascade.

  • Coding Conventions — Rust style, errors, types, lints, dependencies, service patterns.

  • Testing — test strategy, runners, categories, the pre-push battery.

  • CLAUDE.md Skeleton — what belongs in .claude/CLAUDE.md vs the synced rules/standards, and how to thin a bloated one.

  • Migration Runbook — the engine-driven re-sync flow + the mature-repo hazards the engine can’t know about.

Edit this page · latest