cc-libs/docs/adrs/README.md

Architecture Decision Records

This directory contains lightweight Architecture Decision Records for this repository.

The goal is simple: keep a short memory of why we made repo-level choices while building ComputerCraft / CC:Tweaked code for Minecraft. This is not meant to be a heavy process.

Future ADRs can reuse the shape of the existing files when it is useful.

Records

• adr-0001-target-computercraft.md — Target ComputerCraft.
• adr-0002-eventloop-and-service-bus.md — Eventloop substrate, service-name bus on a single channel, and os.sleep discipline.
• adr-0005-craftos-pc-harness-and-probes.md — CraftOS-PC as the local harness, minimal periphemu bootstrap, and headless probes as the canonical hypothesis-test pattern.
• adr-0007-test-framework.md — libtest per-case helper, runtest suite orchestration, and the two-layer timeout (libtest + shell watchdog).
• adr-0010-ccpm-package-manager.md — ccpm package manager (packages, registries, package-aware bootstrap).
• adr-0011-repo-conventions.md — Git hooks own commit/push verification; markdown link syntax for cross-references.

Gaps in numbering (0003, 0004, 0006, 0008, 0009, 0012, 0013, 0014, 0015) are records that were either superseded by later decisions or consolidated into the surviving ADRs above.