State-hub connect and initial workplans

README.md

@@ -1,3 +1,22 @@
-# repo-seed
+# markitect-tool
 
-A git repository template to bootstrap coulomb projects from.
+`markitect-tool` is a markdown-native toolkit and CLI for turning
+semi-structured Markdown into structured, queryable, reusable knowledge
+artifacts.
+
+This repository is the syntax-layer successor to the in-scope core of
+`markitect-main`. Its product boundary is defined in `INTENT.md` and the
+requirements documents in `wiki/`.
+
+## Start Here
+
+- `INTENT.md` - project purpose, boundaries, and design principles
+- `wiki/ProductRequirementsDocument.md` - product scope and success criteria
+- `wiki/FunctionalRequirementsSpecification.md` - observable functional behavior
+- `docs/markitect-main-scope-assessment.md` - migration assessment from `markitect-main`
+- `workplans/` - source-of-truth implementation and migration plans
+
+## State Hub
+
+The repo is registered with the Custodian State Hub as `markitect-tool` under
+the `markitect` domain. See `docs/state-hub-integration.md`.