public_git
/
freenas-proxmox
mirror of https://github.com/TheGrandWazoo/freenas-proxmox.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
freenas-proxmox/.claude/cos/adrs
History
Kevin Adams 4833cfbcca docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 
All seven ADRs were in draft/proposed/decided states — promote all to
Accepted now that the decisions are implemented and stable.

Add .claude/cos/adrs/README.md documenting the ADR lifecycle process.

Add KSA Workspace Standards section to CLAUDE.md (sourced from scaffold
at claude-scaffold/CLAUDE.md) so future sessions inherit workspace-wide
rules without needing a separate file load.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 		2026-05-19 11:07:49 -04:00
..
ADR-001-consolidate-build-into-main-repo.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-002-ui-strategy.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-003-apt-repo-hosting.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-004-cleanup-on-failure.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-005-bearer-token-authentication.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-006-versioning-strategy.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-007-freenas-vs-truenas-naming.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
README.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00

README.md

Architecture Decision Records

ADRs document significant decisions made about this project. They follow an RFC-style lifecycle.

Lifecycle

Status Meaning
Draft Being written or discussed. Not yet binding. May change freely.
Accepted Agreed upon and in effect. Guides implementation.
Superseded Replaced by a newer ADR. The old record is preserved as history. The header notes which ADR supersedes it.
Rejected Proposed but explicitly decided against. Preserved so we remember why.
Deprecated Was accepted but no longer applicable (e.g., a feature was dropped). Not replaced.

Rules

  • Never edit the Decision section of an Accepted ADR. If the decision changes, write a new ADR and mark the old one Superseded by ADR-XXX.
  • Draft ADRs can be edited freely — they are working documents.
  • Numbering is sequential and permanent. A superseded ADR keeps its number; the new one gets the next number.
  • Context and Consequences sections may be lightly edited for clarity even after acceptance (fix typos, add links), but the decision itself is immutable.

Index

ADR Title Status
ADR-001 Consolidate Build Pipeline into Main Repo Accepted
ADR-002 UI Integration Strategy Accepted
ADR-003 APT Repository Hosting Accepted
ADR-004 Transactional Cleanup on API Operation Failure Accepted
ADR-005 Bearer Token Authentication as Primary Auth Method Accepted
ADR-006 Package Versioning Strategy Accepted
ADR-007 FreeNAS vs TrueNAS Module Naming Accepted