Files

tegwick e9dc9a8517 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>

2026-02-24 21:42:41 +01:00

1.5 KiB

Raw Blame History

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.