Add Quarkdown render adapter boundary

README.md

@@ -1,3 +1,44 @@
-# repo-seed
+# markitect-quarkdown
 
-A git repository template to bootstrap coulomb projects from.
+`markitect-quarkdown` provides the concrete Quarkdown render/export adapter for
+Markitect. It keeps Quarkdown runtime assumptions out of `markitect-tool` while
+still satisfying the Markitect render adapter contract.
+
+## Scope
+
+This repository owns:
+
+- `render.quarkdown` adapter descriptor and entry point
+- Markitect profile to Quarkdown profile mapping
+- controlled Quarkdown CLI execution plans
+- Quarkdown permission and runtime dependency mapping
+- generated artifact validation and checksums
+- open-reuse integration metadata
+
+It does not reimplement Quarkdown, fork Quarkdown, or make core Markitect
+responsible for renderer behavior.
+
+## Development
+
+Run tests from this checkout:
+
+```bash
+PYTHONPATH=src:/home/worsch/markitect-tool/src python3 -m pytest
+```
+
+The suite uses fake execution for adapter-boundary tests. A real Quarkdown
+runtime smoke check skips when `quarkdown` is not installed.
+
+## Entry Point
+
+```toml
+[project.entry-points."markitect_tool.render_export_adapters"]
+quarkdown = "markitect_quarkdown.adapter:quarkdown_adapter_descriptor"
+```
+
+## Docs
+
+- `docs/adapter-boundary.md`
+- `docs/profile-matrix.md`
+- `docs/permissions-and-runtime.md`
+- `integration/quarkdown.integration.yaml`