# design/index

This directory holds the working design for Keru OS. The code is scaffolding
and not yet functional end-to-end.

## What exists

- `recipe-format.md` — the Kama recipe format (easy/advanced tiers)
- `README.md` (repo root) — project identity + layout

## Open design questions

- **Bootstrapping toolchain**: chicken-and-egg — the first compiler must be
  obtained somehow. Options: a documented one-time bootstrap from a binary
  seed, or a multi-stage rebuild (host -> minimal -> full). Not yet decided.
- **No dependency resolver**: how upgrades/rebuilds are handled for a system
  that's "built once at install." Currently framed as install-time-only.
- **Cache artifacts vs. rebuilds**: whether the build cache stores binaries
  for fast re-install or always recompiles.