prj-forgejo-org-refactor/AGENTS.md
tegwick 57ad4abefc Fix access inventory evidence and reconcile closure coordination
Assistant: codex
Assistant-Model: gpt-6.1-sol
Assistant-Session: 01a11beb-4eef-7fc1-94a7-597130a01ae9
2026-10-09 00:23:04 +02:00

1.8 KiB

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:

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.