tegwick
57ad4abefc
Assistant: codex Assistant-Model: gpt-6.1-sol Assistant-Session: 01a11beb-4eef-7fc1-94a7-597130a01ae9
48 lines
1.8 KiB
Markdown
48 lines
1.8 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.
|
|
Within ORGREF-WP-0001, T01 and T02 are read-only and safe to advance at any
|
|
time; **ORGREF-WP-0001-T03 onward must not start until all four entry-gate
|
|
conditions hold.** ORGREF-WP-0002 coordinates access control independently,
|
|
under its own accepted policy, owner boundaries and visibility-wave gates.
|
|
It does not authorize repository transfers or waive the org-migration gate.
|
|
|
|
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`.
|