docs(custodian): add session protocol CLAUDE.md for State Hub integration

Registers markitect as a tracked domain in the Custodian State Hub.
Includes topic ID, session start/end protocol, and MCP tool reference.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-24 21:42:41 +01:00
parent b055c8d7bb
commit e9dc9a8517

34
CLAUDE.md Normal file
View File

@@ -0,0 +1,34 @@
# Markitect — Claude Code Instructions
## Custodian State Hub Integration
This project is tracked as the **markitect** domain in the Custodian State Hub.
Hub topic ID: `5571d954-0d30-4950-980d-7bcaaad8e3e2`
### Session Protocol
**At the start of every session:**
Call `get_state_summary()` via the `state-hub` MCP tool to orient yourself.
If the hub is not reachable, start it: `cd ~/the-custodian/state-hub && make api`
**At the end of every session:**
Call `add_progress_event()` with at minimum:
- `topic_id`: `5571d954-0d30-4950-980d-7bcaaad8e3e2`
- `summary`: what was accomplished or left in-flight
- `event_type`: `note` for routine updates, `milestone` for completions, `blocker` for blockers
### Available State-Hub MCP Tools
- `get_state_summary()` — full cross-domain overview
- `add_progress_event(summary, topic_id, event_type, detail)` — log progress
- `create_workstream(topic_id, title, ...)` — create a new workstream
- `create_task(workstream_id, title, ...)` — create a task under a workstream
- `update_task_status(task_id, status)` — move task through lifecycle
- `record_decision(title, decision_type, topic_id, ...)` — log decisions
- `resolve_decision(decision_id, rationale, decided_by)` — close a decision
### If the MCP Server is Not Available
The state-hub MCP server (`state-hub`) is registered at user scope in `~/.claude.json`.
It requires the API to be running at `http://127.0.0.1:8000`.
Fallback: use `curl` directly against the REST API — see `/docs` at the hub URL.