Skip to content

chore(docs): split cycle discussions and architecture decisions into …#6

Merged
2davi merged 2 commits intodevfrom
chore/docs-cycles-decisions-split
Apr 25, 2026
Merged

chore(docs): split cycle discussions and architecture decisions into …#6
2davi merged 2 commits intodevfrom
chore/docs-cycles-decisions-split

Conversation

@2davi
Copy link
Copy Markdown
Owner

@2davi 2davi commented Apr 25, 2026

…separate genres

Move existing references/ard-XXXX-* assets into references/cycles/ as historical artifacts (no rename — name evolution itself is part of the repo history). Introduce references/decisions/ for new ADRs in MADR 0.5 format.

  • references/cycles/ — Cycle Discussion Records (CDR) + preserved ARDs
  • references/decisions/ — Architecture Decision Records (ADR), one decision per file
  • Add CDR_TEMPLATE.md, ADR_TEMPLATE.md with formalized format rules
  • README.md in each directory documents genre distinction and naming conventions

ARD (Architectural Requirements Document) was a misnomer; the standard term is ADR (Architecture Decision Record). Going forward, single decisions live as ADR and per-cycle discussions live as CDR.

…separate genres

Move existing references/ard-XXXX-* assets into references/cycles/ as historical
artifacts (no rename — name evolution itself is part of the repo history).
Introduce references/decisions/ for new ADRs in MADR 0.5 format.

- references/cycles/   — Cycle Discussion Records (CDR) + preserved ARDs
- references/decisions/ — Architecture Decision Records (ADR), one decision per file
- Add CDR_TEMPLATE.md, ADR_TEMPLATE.md with formalized format rules
- README.md in each directory documents genre distinction and naming conventions

ARD (Architectural Requirements Document) was a misnomer; the standard term is
ADR (Architecture Decision Record). Going forward, single decisions live as ADR
and per-cycle discussions live as CDR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@2davi 2davi changed the base branch from main to dev April 25, 2026 08:18
@2davi 2davi merged commit 45ec1d1 into dev Apr 25, 2026
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