prj-forgejo-org-refactor/AGENTS.md
tegwick ec2a72f435 Seed the org refactor: goal, scope, blast radius, entry gate
Establishes the prj- flavor baseline (GOAL.md, SCOPE.md, AGENTS.md,
.repo-classification.yaml, genesis, foundation workplan) for splitting the
single coulomb/ Forgejo org into stewardship orgs.

Records the blast radius verified 2026-08-11: 112 repos with a coulomb/ origin,
ArgoCD repoURL sources, Chart.yaml metadata, and - the finding that made this
project-sized rather than workplan-sized - container image paths, since
Forgejo's package registry is org-scoped. That failure is deferred: it does not
appear at rename time but at the next pod reschedule.

Seeded deliberately deferred per operator decision. ORGREF-WP-0001 is backlog
and carries a four-part entry gate (validator live, deployable coverage known,
stable re-runnable inventory, demonstrated rollback) so the decision to start
is made against evidence rather than memory. T01 and T02 are read-only and safe
to advance at any time.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 13:39:24 +02:00

1.5 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. 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.mdSCOPE.mdhistory/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.