Document organic OpenClaw routing layer

docs/openclaw-integration-contract.md

@@ -20,10 +20,13 @@ The first safe integration foundation now exists on the T420 workspace:
   - `health`
   - `project-state`
   - `query`
+  - `detect-project`
+  - `auto-context`
   - fail-open fallback when AtoCore is unavailable
 
-This means the network and workflow foundation is working, even though deeper
-automatic integration into OpenClaw runtime behavior is still deferred.
+This means the network and workflow foundation is working, and the first
+organic routing layer now exists, even though deeper autonomous integration
+into OpenClaw runtime behavior is still deferred.
 
 ## Integration Principles
 
@@ -43,6 +46,7 @@ OpenClaw may use AtoCore for:
 - context building for contextual prompts
 - retrieval/query support
 - project-state lookup when a project is detected
+- automatic project-context augmentation for project-knowledge questions
 
 OpenClaw should not yet use AtoCore for:
 
@@ -76,6 +80,8 @@ The current helper script exposes:
 - `stats`
 - `projects`
 - `project-template`
+- `detect-project <prompt>`
+- `auto-context <prompt> [budget] [project]`
 - `propose-project ...`
 - `register-project ...`
 - `update-project ...`
@@ -117,10 +123,17 @@ Recommended first behavior:
 ## Suggested Usage Pattern
 
 1. OpenClaw receives a user request
-2. OpenClaw decides whether the request is contextual enough to query AtoCore
-3. If yes, OpenClaw calls AtoCore
-4. If AtoCore returns usable context, OpenClaw includes it
-5. If AtoCore fails or returns nothing useful, OpenClaw proceeds normally
+2. If the prompt looks like project knowledge, OpenClaw should try:
+   - `auto-context "<prompt>" 3000`
+3. If the prompt is clearly asking for trusted current truth, OpenClaw should
+   prefer:
+   - `project-state <project>`
+4. If the user explicitly asked for source refresh or ingestion, OpenClaw
+   should use:
+   - `refresh-project <id>`
+5. If AtoCore returns usable context, OpenClaw includes it
+6. If AtoCore fails, returns `no_project_match`, or is unavailable, OpenClaw
+   proceeds normally
 
 ## Deferred Work