Document the Krad package boundary and workflow

README.md

@@ -0,0 +1,28 @@
+# krad
+
+Krad is the source-pinned component graph for a compact client-side C/C++
+toolchain. It keeps the compiler, libc, platform glue, and support libraries as
+four independently replaceable packages instead of copying multi-gigabyte
+source trees into this repository:
+
+```text
+krad-clang
+    └── krad-utils
+          └── krad-musl
+                └── krad-libs
+```
+
+The first boundary is reproducible source identity. Verify the local research
+inputs without downloading or changing them:
+
+```sh
+node tools/krad.js plan
+node tools/krad.js verify ../research
+npm test
+```
+
+Use `--json` with `plan` or `verify` for machine-readable output. The four
+packages are private until compiler/sysroot artifacts and their browser runtime
+contract are built and tested; they must not be published as empty toolchains.
+No upstream source is vendored here, and each component records its own source
+license and exact researched revision.