From f7af151f37a7d652fe389daf43efc9be0d3e2bc0 Mon Sep 17 00:00:00 2001
From: tegwick <bernd.worsch@gmail.com>
Date: Sat, 5 Sep 2026 10:24:18 +0200
Subject: [PATCH] docs: use canonical State Hub reads with caller attribution

Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a06ed7-828d-7ca0-a8d4-0c3e5a0c4102
---
 AGENTS.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 4340146..e632005 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -133,6 +133,19 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
 
 ## Workplan Convention (ADR-001)
 
+### State Hub reads and caller identity
+
+Use `GET /workplans/{id}` and `GET /tasks/?workplan_id=<id>` for reads.
+Do not send the legacy `workstream_id` query parameter or call `/workstreams/`
+routes (410 Gone). Keep `state_hub_workstream_id` in file frontmatter unchanged.
+Send `X-StateHub-Component: fluid-telegram` on direct HTTP requests so operational
+reviews can attribute callers. Example:
+
+```bash
+curl -fsS -H 'X-StateHub-Component: fluid-telegram' \
+  'http://127.0.0.1:8000/tasks/?workplan_id=<workplan-uuid>'
+```
+
 Work items originate as files in this repo — not in the hub. The hub is a
 read/cache/index layer that rebuilds from files.