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>
This commit is contained in:
parent
12bf13f020
commit
ec2a72f435
10 changed files with 827 additions and 2 deletions
45
AGENTS.md
Normal file
45
AGENTS.md
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
# 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`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue