tegwick
ec2a72f435
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>
45 lines
1.5 KiB
Markdown
45 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`.
|