From 3231e10625f6946fb49771ec686afeccb050c1ca Mon Sep 17 00:00:00 2001 From: tegwick Date: Wed, 8 Jul 2026 14:50:33 +0200 Subject: [PATCH] Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules templates: workplan-first session protocol, legacy terminology footnote, and GET /workplans/ examples. --- .claude/rules/first-session.md | 10 +++++----- .claude/rules/session-protocol.md | 14 ++++++-------- .claude/rules/workplan-convention.md | 16 +++++++++++++--- 3 files changed, 24 insertions(+), 16 deletions(-) diff --git a/.claude/rules/first-session.md b/.claude/rules/first-session.md index 358e6d1..3b87a8e 100644 --- a/.claude/rules/first-session.md +++ b/.claude/rules/first-session.md @@ -20,14 +20,14 @@ roadmap phase. **Wait for approval before creating.** workplans/RAILIANCE-WP-NNNN-.md ← write this, commit it ``` Then register by running the consistency check — do **not** call -`create_workplan`/`create_task` (or legacy `create_workstream`) yourself; -manual registration duplicates what C-06 creates from the file: +`create_workplan`/`create_task` yourself; manual registration duplicates what +C-06 creates from the file: ```bash statehub fix-consistency --repo railiance-apps ``` -C-06 creates the hub workplan + tasks and writes `state_hub_workstream_id` / -`state_hub_task_id` back into the file (legacy field names, kept for -compatibility — they hold workplan/task IDs). +C-06 creates the hub workplan + tasks and writes `state_hub_workstream_id` +(legacy frontmatter name — holds the workplan UUID) and `state_hub_task_id` +back into the file. **Step 5 — Record the setup** ``` diff --git a/.claude/rules/session-protocol.md b/.claude/rules/session-protocol.md index 51392df..72c3e2f 100644 --- a/.claude/rules/session-protocol.md +++ b/.claude/rules/session-protocol.md @@ -57,15 +57,13 @@ If no workplans: follow First Session Protocol (`first-session.md`). **During work:** `record_decision()` · `add_progress_event()` · `resolve_decision()` > State Hub is a *read model*. **Never register workplans or tasks by hand** -> (`create_workplan`, `create_task`, or the legacy `create_workstream`) — write -> the workplan file in `workplans/` and run `fix-consistency`; its C-06 check -> registers the workplan and its tasks in the hub and writes the IDs back into -> the file. Manual registration creates duplicates the moment fix-consistency -> runs. Work structure belongs in repo files (ADR-001). +> (`create_workplan`, `create_task`) — write the workplan file in `workplans/` +> and run `fix-consistency`; C-06 registers the workplan and tasks and writes +> IDs back into the file. Manual registration creates duplicates when +> fix-consistency runs. Work structure belongs in repo files (ADR-001). > -> Terminology: "workstream" is the legacy name for workplan. Some API/frontmatter -> field names keep it for compatibility (`state_hub_workstream_id`, -> `workstream_id` params) — treat them as workplan IDs. +> Legacy: `create_workstream` and `/workstreams/` remain as metered aliases — +> see `workplan-convention.md` (compatibility footnote). **Session close:** With MCP tools: diff --git a/.claude/rules/workplan-convention.md b/.claude/rules/workplan-convention.md index 659020d..32ee5b9 100644 --- a/.claude/rules/workplan-convention.md +++ b/.claude/rules/workplan-convention.md @@ -24,7 +24,7 @@ multiple planned phases into a normal workplan. Ecosystem todos from other agents arrive as `[repo:railiance-apps]` hub tasks — visible at session start. Pick one up by creating the workplan file, committing, and running `statehub fix-consistency` — C-06 registers the workplan in the hub. -Never register by hand with `create_workplan`/`create_workstream`. +Never register by hand with `create_workplan` (legacy MCP alias: `create_workstream`). Task blocks use this shape: @@ -39,7 +39,17 @@ Status progression is `todo` → `progress` → `done`; use `wait` for waiting o blocked work and `cancel` for stopped work. Workplan frontmatter carries `state_hub_workstream_id` — a legacy field name -kept for compatibility ("workstream" is the old term for workplan); it holds -the hub workplan id and is written by fix-consistency. Do not edit or rename it. +kept for compatibility; it holds the hub workplan UUID and is written by +fix-consistency. Do not edit or rename it. + +### Legacy terminology (compatibility footnote) + +**Workplan** is the fleet term — see +`the-custodian/canon/standards/workplan-terminology-fleet_v0.1.md`. +**Workstream** is legacy only: some API routes (`/workstreams/`), params +(`workstream_id`), MCP aliases (`create_workstream`), and the frontmatter field +above remain until `STATE-WP-0069` retires them via legacy-meter. Treat those +identifiers as workplan IDs. Prefer `GET /workplans/` and `workplan_id` in new +examples and scripts.