Skip to content

Architecture Decision Records

This folder holds progressive architecture decisions for oves-decks.

Use numbered ADR files such as 0001-title.md, 0002-title.md, and so on.

Current ADRs

# File Title Status
1 0001-react-spectacle-architecture.md React + Spectacle Architecture ✅ Accepted
2 0002-block-system-architecture.md Block System Architecture ✅ Accepted
3 0003-charting-approach.md Charting Approach ✅ Accepted

How to Use

  • AI agents: Read all ADRs before making architectural changes
  • Humans: Propose new ADR by copying 0001 structure, update status to Proposed
  • Review: Change status to Accepted after team agreement
  • Deprecate: Change status to Deprecated with rationale (never delete ADRs)

Template

# ADR-XXXX: <Title>

**Status:** Proposed | Accepted | Deprecated
**Date:** YYYY-MM-DD
**Deciders:** <names>
**Reviewed-by:** <names>

---

## Context
<why this decision matters>

## Decision
<what we decided>

## Consequences
### Positive
### Negative
### Neutral

## Compliance
- [ ] <rule 1>
- [ ] <rule 2>

## Related Decisions
- **ADR-XXXX**: <related title>

## References
- <link 1>