archvillainetteandClaude Opus 5
03e193d8cb
ci / ci (pull_request) Canceled after 21s
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>
25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
# ADR-0004: Nix-built OCI images start server-side with Crucible; local Anvil images deferred
|
|
|
|
- **Status:** Accepted
|
|
- **Date:** 2026-06-12
|
|
- **Migrated from:** `sow-docs` `07-decisions-log.md` entry **D29**, on the
|
|
retirement of `sow-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-tools` will grow a
|
|
Nix-built `crucible` package plus `crucible-image`; PR CI builds/smokes it and
|
|
`main` publishes the normal pinned OCI image
|
|
`registry.westgate.pw/deployment/crucible:<sha>`. `docker/Dockerfile` stays 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-image` is explicitly deferred until real
|
|
`sow-codebase/src` exists 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`; no `nix-sidecar` or
|
|
Kubernetes-style runtime cache layer; no removal of client Dockerfiles.
|