| ADR-001: Use Architecture Decision Records |
🟢 Accepted |
Use ADRs to explain the rationale behind architecturally significant design choices for future developers and AI assistants |
| ADR-002: Use prek for git hooks |
🟢 Accepted |
Use prek, a dependency-free Rust binary, to run Git hooks with no Python/uv requirement |
| ADR-003: Manage R dependencies with rv |
🔵 Superseded by ADR-006 |
Use rv, not renv/packrat, for declarative R dependency management |
| ADR-004: Unify docs into a single Quarto website |
🟢 Accepted |
Combine README, architecture/ADR markdown, and a generated API reference into one Quarto website |
| ADR-005: Generate API reference with box + rd2qmd instead of quartify |
🟢 Accepted |
Use box’s own internal doc parser + rd2qmd for the API reference, replacing quartify |
| ADR-006: Migrate R dependency management from rv to uvr |
🟢 Accepted |
Use uvr, which also installs R itself and supports dev-dependencies, replacing rv |
| ADR-007: Add ry static checker and track latest tool versions |
🟢 Accepted |
Add ry for type/scope checking; run air, jarl and ry at their latest versions via local system hooks |