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-use-eventloop-for-async-code.md - Use eventloop for async code.
• adr-0003-current-net-api-state.md - Current net API state.
• adr-0004-trapos-branding-and-manifest.md - TrapOS branding and manifest-driven installs.
• adr-0005-craftos-pc-harness.md - CraftOS-PC as the local harness.
• adr-0006-simplify-periphemu-bootstrap.md - Simplify periphemu bootstrap.
• adr-0007-use-libtest-for-craftos-tests.md - Use libtest for CraftOS tests.
• adr-0008-keep-tests-runnable-in-craftos-and-in-game.md - Keep tests runnable in CraftOS and in-game.
• adr-0009-layered-test-timeouts.md - Layered test timeouts (libtest per-case + shell watchdog).
• adr-0010-ccpm-package-manager.md - ccpm package manager (packages, registries, package-aware bootstrap).
• adr-0011-git-hooks-own-commit-push-verification.md - Git hooks own commit/push verification.
• adr-0012-headless-craftos-pc-as-hypothesis-probe.md - Headless CraftOS-PC as the canonical hypothesis probe (rename just craftos → just trapos, add vanilla just craftos).
• adr-0013-markdown-link-syntax-for-cross-references.md - Cross-reference markdown files with []() syntax (so lychee can validate them).
• adr-0014-prefer-eventloop-settimeout-over-os-sleep.md - Prefer eventloop.setTimeout over os.sleep in application code.