Skip to content

Engineering Standard — Standards

Classification index for Bluefly normative technical standards.

Per ES-STRUCTURE-001, all standards reside in domain-specific subdirectories under standards/. Never leave standards flat at the root.


Core Standards (core/)

Domain-independent standards for execution, authorization, git, evidence, and repository hygiene.

Document ID Domain Authority
STD-WORK-001-durable-work-governance.md STD-WORK-001 Work governance, worktrees & completion canonical
ES-STRUCTURE-001-engineering-standard-layout.md ES-STRUCTURE-001 Directory layout & placement doctrine canonical
naming-convention-and-taxonomy.md STD-034 Naming convention & taxonomy canonical
authentication-secrets-constitution.md STD-AUTH-001 Auth & secrets canonical
cedar-factory-authorization-standard.md STD-CEDAR-001 Cedar authorization canonical
es-0001-bluefly-engineering-standard.md ES-0001 Foundation engineering standard canonical
repository-structure-standard.md STD-REPO-001 Repository structure canonical
factory-domain-separation-standard.md STD-SEP-001 Factory vs Domain Separation canonical
STD-CHANGELOG-001-ai-changelog-standard.md STD-CHANGELOG-001 AI Changelog Standard canonical
STD-CHECKPOINT-001-checkpoint-repository-convergence-standard.md STD-CHECKPOINT-001 Checkpoint Convergence Directive canonical

| documentation-governance-standard.md | — | Documentation governance | canonical | | agent-contract-standard.md | — | Agent contract (.agents/) | canonical | | api-first-standard.md | — | API-first design | canonical | | git-standard.md | — | Git versioning & branch model | canonical | | git-discipline.md | — | Git operational discipline | canonical | | gitlab-project-settings-standard.md | STD-GITLAB-001 | GitLab project settings | canonical | | portable-paths-and-workstation-privacy.md | GOV-PATH-PRIV-001 | Path portability & workstation hygiene | canonical | | deployment-standard.md | — | Deployment procedure | canonical | | production-deployment-law.md | — | Production deployment & provenance | canonical | | evidence-contract.md | — | Evidence claims & vocabulary | canonical | | evidence-reporting-standard.md | — | Evidence reporting format | canonical | | receipts-standard.md | — | Receipts specification | canonical | | execution-receipt-specification.md | — | Execution receipt schema | canonical | | execution-receipt-taxonomy.md | — | Execution receipt taxonomy | canonical | | investigation-standard.md | — | Investigation methodology | canonical | | investigation-methodology.md | — | Investigation procedure | canonical | | runtime-dependency-investigation.md | — | Runtime dependency investigation | canonical | | decision-vocabulary.md | — | Decision vocabulary | canonical | | contrib-first-policy.md | — | Contrib-first policy | canonical | | lockdown-standard.md | — | Lockdown enforcement | canonical | | upstream-synchronization-standard.md | — | Upstream synchronization | canonical | | tools-standard.md | — | Standard tooling | canonical | | platform-reset-standard.md | — | Platform reset procedure | canonical | | gluless-specification.md | — | Gluless integration | canonical | | ossa-repository-governor-spec.md | — | OSSA repository governor | canonical | | repository-governance-workflow.md | — | Repository governance workflow | canonical | | std-exec-001-execution-environment-constitution.md | STD-EXEC-001 | Execution environment constitution | canonical | | gas-city-native-first-operating-model.md | — | Gas City native-first model | canonical | | convergence-doctrine.md | — | Convergence doctrine | canonical | | execution-constitution.md | — | Execution constitution | canonical | | authority-boundary-rules.md | — | Authority boundaries | canonical | | capability-invariant.md | — | Capability invariants | canonical | | commit-metadata-governance.md | — | Commit metadata governance | canonical | | document-authority-metadata.md | — | Document metadata schema | canonical | | status-legend.md | — | Document status taxonomy | canonical |


Drupal Standards (drupal/)

Document Domain
drupal-standard.md Drupal AI assembly & backend architecture
drupal-site-building-standard.md Drupal site-building & component doctrine
drupal-component-dry-standard.md Drupal component DRY rules
1password-drupal-secrets.md 1Password Connect & Drupal secret architecture

DDEV Standards (drupal/ddev/)

Document Domain
ddev-standard.md DDEV environment standard
ddev-addon-policy.md DDEV add-on policy
ddev-playlist-standard.md DDEV playlist standard

Gas City Standards (gas-city/)

Document Domain
gascity-worker-contract.md Gas City worker contract

Architecture Standards (architecture/)

Document ID Domain
platform-agent-execution-architecture.md STD-ARCH-002 Platform architecture
inference-topology.md — LLM routing & inference
capability-convergence.md — Ownership gravity
durable-facts-architecture.md — Durable fact persistence

Platform Standards (platforms/)

Runtime (platforms/runtime/)

Document Domain
blucity-operator-contract.md BluCity operator rules
bluefly-operational-model.md Operational model
gas-city-command-execution-trust-boundaries.md GC trust boundaries
gas-city-deployment-wiring.md GC deployment wiring
infra-convergence-roadmap.md Infrastructure roadmap
openclaw-mayor-operations.md OpenClaw/Mayor ops

Security (platforms/security/)

Document Domain
auth-control-plane.md Auth control plane

Apple (platforms/apple/)

Document ID Domain
APPLE-001-provider-authority.md APPLE-001 Provider authority
APPLE-002-modernization-rules.md APPLE-002 Modernization rules
APPLE-003-verification-gate.md APPLE-003 Verification gate
APPLE-004-local-ownership-gate.md APPLE-004 Local ownership gate

Protocols (protocols/)

Document Domain
README.md Inter-system and agent communication protocols

Schemas (schemas/)

Document Domain
gitlab-project-settings.yaml Declarative GitLab project settings schema