archvillainetteandClaude Opus 5
03e193d8cb
Scaffold the per-repo configuration the engineering skills expect, and put
the three-way split of work into standing law:
- Live work -> wayfinder maps + Gitea issues (closeable, assignable,
queryable).
- Settled decisions -> ADR files in docs/adr/ (immutable, findable, never
closed).
- Standing law -> DOCTRINE.md / AGENTS.md / CONTEXT.md.
Adds docs/agents/{issue-tracker,triage-labels,domain}.md and an
"Agent skills" section in AGENTS.md. The tracker doc records Gitea via the
tea CLI, the wayfinder map/ticket/blocking operations, and the rule that
issues follow ownership: file work in the repo that owns it, not the one you
happen to be standing in.
ADR-0001 (markdown is reference, law, or an ADR - nothing else) is adopted
from sow-codebase so the rule is local to every repo.
sow-docs is retired: its 35 decisions become ADRs in the repos that own them,
its living docs move to sow-platform and sow-assets-manifest, and its
unfinished intent becomes Gitea issues.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1.4 KiB
ADR-0004: Nix-built OCI images start server-side with Crucible; local Anvil images deferred
-
Status: Accepted
-
Date: 2026-06-12
-
Migrated from:
sow-docs07-decisions-log.mdentry D29, on the retirement ofsow-docs. Content is the original decision, unchanged. -
Decision: Introduce Nix-built OCI images as an artifact-production option, starting with
sow-tools/Crucible in server-side CI.sow-toolswill grow a Nix-builtcruciblepackage pluscrucible-image; PR CI builds/smokes it andmainpublishes the normal pinned OCI imageregistry.westgate.pw/deployment/crucible:<sha>.docker/Dockerfilestays during parity and as the client-compatible fallback. -
Local rule: Nix users may get optional wrappers that provide tools and call the existing Dockerfiles for local Anvil/NWServer testing. A true
nix build .#nwserver-test-imageis explicitly deferred until realsow-codebase/srcexists and the Dockerfile image is proven. -
Rationale: Server-side image build shape is harder to change once deploy promotion and registry gates are active, so prove Nix image builds before cutover. Crucible is the lowest-risk pilot because it is a Go toolchain image; NodeBB and Anvil/NWServer depend more heavily on upstream container filesystem semantics.
-
Non-goals: no source builds in
sow-platform; nonix-sidecaror Kubernetes-style runtime cache layer; no removal of client Dockerfiles.