Files
sow-tools/docs/adr/0002-sow-tools-becomes-the-crucible-suite.md
T
archvillainetteandClaude Opus 5 03e193d8cb
ci / ci (pull_request) Canceled after 21s
docs: adopt workspace-wide agent standards and retire sow-docs
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>
2026-07-24 20:30:28 +02:00

572 B

ADR-0002: sow-tools becomes the Crucible suite

  • Status: Accepted

  • Date: 2026-06-11

  • Migrated from: sow-docs 07-decisions-log.md entry D11, on the retirement of sow-docs. Content is the original decision, unchanged.

  • Decision: Rename the future toolchain surface to Crucible: one Go module, multiple cmd/ binaries, plus a dispatcher so wrapper commands can stay stable.

  • Rationale: Depot, HAK, module, topdata, and wiki tooling share internals but have different command surfaces. One module avoids premature repo splits.