Adopt workspace-wide agent standards; retire sow-docs #44

Merged
archvillainette merged 1 commits from docs/agent-standards into main 2026-07-24 18:40:04 +00:00
Owner

Part of the workspace-wide standards rollout. Establishes where work lives (issues vs ADRs vs standing law), scaffolds docs/agents/ for the engineering skills, and adopts ADR-0001 locally. See sow-platform ADR-0021 for the sow-docs retirement.

Part of the workspace-wide standards rollout. Establishes where work lives (issues vs ADRs vs standing law), scaffolds `docs/agents/` for the engineering skills, and adopts ADR-0001 locally. See `sow-platform` ADR-0021 for the `sow-docs` retirement.
archvillainette added 1 commit 2026-07-24 18:30:23 +00:00
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>
gitea-bot approved these changes 2026-07-24 18:35:44 +00:00
gitea-bot left a comment
Member

Approved: workspace-wide agent standards rollout.

Approved: workspace-wide agent standards rollout.
archvillainette scheduled this pull request to auto merge when all checks succeed 2026-07-24 18:39:28 +00:00
xtul approved these changes 2026-07-24 18:40:02 +00:00
archvillainette merged commit 0bdb59aaa0 into main 2026-07-24 18:40:04 +00:00
archvillainette deleted branch docs/agent-standards 2026-07-24 18:40:04 +00:00
Sign in to join this conversation.