chore: establish phase 0 baseline

2026-07-18 18:20:34 -04:00
commit b38da7d53f
42 changed files with 2618 additions and 0 deletions
@@ -0,0 +1,28 @@
+# Project Kiln
+
+Private Phase 0 scaffold for the CLI-first Arch gaming OS. `Kiln` and every
+`kiln-*` identifier are temporary repository-local names, not public compatibility
+promises.
+
+## Current proof
+
+The workspace contains a dependency-free Rust core and CLI smoke path. Rust 1.85 is
+the minimum supported compiler because it introduced Edition 2024; development and CI
+remain pinned to the reviewed Rust 1.97.1 toolchain:
+
+```text
+kiln version
+kiln doctor
+kiln doctor --json
+```
+
+Run deterministic repository and Rust gates with `make verify`. Run only the
+environment-independent repository checks with `make static`. Run the separately
+versioned, network-backed dependency advisory/license/source audit with `make audit`.
+Rust 1.97.1 is pinned.
+
+The active specification is under `docs/spec/`. Start with
+`docs/spec/00_SPEC_INDEX.md`; the archived monolith is intentionally excluded.
+
+Local Codex CLI work starts with `AGENTS.md`. The initial bounded Phase 1 brief is
+`docs/handoff/phase-1-codex-cli.md`.