46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
|
# 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`.
|