Skip to content

docs(architecture): S1 — documentation IA + ADR-supersession policy (#71)#78

Merged
Polichinel merged 1 commit into
developmentfrom
docs/s1-architecture-decision
Jun 27, 2026
Merged

docs(architecture): S1 — documentation IA + ADR-supersession policy (#71)#78
Polichinel merged 1 commit into
developmentfrom
docs/s1-architecture-decision

Conversation

@Polichinel

Copy link
Copy Markdown
Collaborator

Epic: #70 · S1 (#71) — the planning/needs-decision gate.

Records two decisions S2–S5 depend on, in docs/architecture/README.md:

  1. Information architecture — one home per knowledge type (README / role_and_seams.md / ADRs / CICs).
  2. ADR-supersession policy — write a new superseding ADR rather than rewriting Accepted ones (ADRs are immutable records, ADR-000). Applied in S4: ADR-001Superseded by ADR-012; new ADR-012 = current ontology; ADR-002 extended in place.

Decision ratified by the maintainer (ADR-012 route). Docs-only; ruff clean, suite green.

Closes #71

🤖 Generated with Claude Code

)

Decision record for the documentation truth-up epic (#70): fixes the information
architecture (one home per knowledge type — README / role_and_seams / ADRs /
CICs) and the ADR-supersession policy (write a new superseding ADR, don't
rewrite Accepted ones; ADR-001 -> Superseded by ADR-012, with ADR-002 extended
in place). S2-S5 execute against this. Docs-only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Polichinel Polichinel merged commit 62065da into development Jun 27, 2026
4 checks passed
@Polichinel Polichinel deleted the docs/s1-architecture-decision branch June 27, 2026 16:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant