chore: adopt engineering standard v1.0.0 (#3)

Adopt the org engineering standard (its-consulting/standards @ v1.0.0).

Adds baseline governance/CI/policy files rendered from the standard's
templates and pins .standards-version=1.0.0. Vendored OPA/Rego policies
under .standards/policies/ so CI runs the gate locally (no cross-repo dep).
Placeholders ({{ORG}}/{{REPO}}/{{OWNER_HANDLE}}/{{MAINTAINER_EMAIL}}) filled in.
Existing files that differ were left untouched by the adopter.

Automated rollout. Files created: 16.
This commit is contained in:
Kenearos 2026-07-02 01:19:33 +02:00 committed by GitHub
parent 262be954bb
commit cd6d1f7b57
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
26 changed files with 1893 additions and 0 deletions

72
sops/SOP-000-template.md Normal file
View file

@ -0,0 +1,72 @@
---
title: <Procedure title>
status: Draft
owner: alex
review-date: YYYY-MM-DD
---
<!--
SOP template — matches the section contract in docs/00-overview.md §5.5.
Used by `make sop-new` and rendered by adopt-standard.sh into
<repo>/sops/SOP-NNN-kebab-topic.md.
Rules:
- File name: SOP-NNN-kebab-topic.md, NNN zero-padded (SOP-007, SOP-008, …).
- Sections MUST appear in this order: Purpose, Scope, Roles, Procedure,
Enforced by, Failure modes & rollback, References.
- Every Procedure step is FALSIFIABLE: you can mechanically tell whether it
was done (a command ran, a file exists, a check is green).
- Keep the ADR <-> SOP <-> Policy triangle intact: name the ADR that motivates
this SOP and the Policy/CI that enforces its checkable steps.
Delete this comment when you fill the template in.
-->
# SOP-NNN: <Procedure title>
## Purpose
<!-- One paragraph: what outcome this procedure guarantees and why it exists. -->
## Scope
<!-- When this SOP applies and when it does NOT (repos, branches, environments,
mandanten). Be explicit about boundaries. -->
## Roles
<!-- Who does what. Use roles/IDs, not real names (data traffic-light: YELLOW). -->
| Role | Responsibility |
|------|----------------|
| Author | … |
| Reviewer (CODEOWNERS) | … |
| Approver | … |
## Procedure
<!-- Numbered, falsifiable steps. Each step states the action and its observable
"done" condition. Reference the exact command/file where possible. -->
1. **<Action>.** Done when: `<observable check, e.g. a command exits 0 / a file exists>`.
2. **<Action>.** Done when: `…`.
3. **<Action>.** Done when: `…`.
## Enforced by
<!-- Link the machine checks that gate the falsifiable steps above:
- Policy: ../policies/<domain>/<name>.rego (+ tests/<name>_test.rego)
- CI: ../ci/github/reusable-*.yml | ../ci/woodpecker/.woodpecker.*.yml
- Local: .pre-commit-config.yaml hooks
- ADR: ../docs/adr/NNNN-*.md (the decision this SOP operationalizes)
If a step is human-judgement only, say so and explain the compensating control. -->
## Failure modes & rollback
<!-- What can go wrong at each critical step, how it is detected, and the exact
rollback. Be concrete: "revert commit X", "re-run with --force-unlock", etc. -->
- **Failure:** … → **Detection:** … → **Rollback:**
## References
<!-- Related SOPs, ADRs, policies, external docs (repo-relative markdown links). -->