# Agent session protocol — prj-forgejo-org-refactor

Dev Hub (State Hub API): http://127.0.0.1:8000

## Before anything else

This project is **deliberately deferred**. Read `GOAL.md` "Why this is
deferred" and the `ORGREF-WP-0001` entry gate before proposing execution work.
T01 and T02 are read-only and safe to advance at any time; **T03 onward must
not start until all four entry-gate conditions hold.**

If you believe the gate is met, say which of the four conditions changed and
what evidence shows it — do not infer readiness from elapsed time.

## Session start

1. `GOAL.md` → `SCOPE.md` → `history/` → `workplans/`
2. `get_domain_summary("infotech")` when MCP tools are exposed, else
   `curl -s http://127.0.0.1:8000/state/summary`
3. `get_messages(to_agent="prj-forgejo-org-refactor", unread_only=True)`

## During work

`record_decision()` · `add_progress_event()` · `resolve_decision()`

State Hub is a read model. **Never register workplans or tasks by hand.**
Write the workplan file, commit, then run:

```bash
statehub fix-consistency --repo prj-forgejo-org-refactor
```

C-06 registers the workplan and writes IDs back into the file.

## Boundary

This repo coordinates; it hosts no production implementation. Child work lands
in participating repos and is linked by stable ID, never copied.

Do not absorb rapp-context or State Hub domain grouping into this project —
they are separate dimensions (decision `d07ee5f9`, OAS P1).

## Session close

`add_progress_event()` with the workplan id, then `statehub fix-consistency`.