feat: establish read-only DocForge MCP foundation

README.md

@@ -0,0 +1,24 @@
+# DocForge
+
+DocForge is a project-scoped documentation service for people and AI agents. It loads canonical
+Markdown and TOML from one repository, validates stable nodes and relationships, builds a disposable
+search index, and returns bounded context with source provenance.
+
+DocForge does not own project facts. It does not select project work, edit generated output, run
+project commands, or perform Git and deployment operations.
+
+## Current gate
+
+DFG-1 and DFG-2 are complete. DFG-3 is the active gate: isolated changesets for structured create,
+update, move, and delete proposals. Canonical writes remain closed.
+
+## Development
+
+```bash
+uv sync
+uv run python -m unittest discover -s tests -v
+uv run docforge --project-root tests/fixtures/alpha validate
+```
+
+The command prints deterministic JSON. Derived indexes live under each project's configured cache
+directory and are never canonical input.