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/.

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. The set of synced artifacts is declared in .claude/sync-manifest.toml.

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.

CRAIG project complements

These project-owned pages elaborate the universal standards with CRAIG-specific detail (they live in the ROOT module, not here):

  • Quality Gates & Enforcement — CRAIG’s mechanically-enforced quality-budget, function-cohesion, and lint-policy gates.

  • Testing Reference — CRAIG’s test-infrastructure reference (helpers, fault injection, E2E, CI stages).

Edit this page · latest