From edf552368a36d6b3397e16fe0e93c3c7896be927 Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 14 Sep 2026 13:48:17 +0200 Subject: [PATCH] Add COORDINATION-WP-0005 for prj- drivers and cross-owner mode. Make coordination-engine aware of project-repository workplans, then roll that mode into Codex/Claude/Grok agent instructions. Assistant: grok Assistant-Session: 01a09dc1-b21e-77e1-919e-fcad2f82b267 --- ...N-WP-0005-prj-cross-repo-and-agent-mode.md | 121 ++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 workplans/COORDINATION-WP-0005-prj-cross-repo-and-agent-mode.md diff --git a/workplans/COORDINATION-WP-0005-prj-cross-repo-and-agent-mode.md b/workplans/COORDINATION-WP-0005-prj-cross-repo-and-agent-mode.md new file mode 100644 index 0000000..b7b3c6d --- /dev/null +++ b/workplans/COORDINATION-WP-0005-prj-cross-repo-and-agent-mode.md @@ -0,0 +1,121 @@ +--- +id: COORDINATION-WP-0005 +type: workplan +title: "prj- awareness, cross-owner waits, and agent coordination mode" +domain: communication +repo: coordination-engine +status: proposed +owner: grok +topic_slug: communication +flavor: extension +created: "2026-09-14" +updated: "2026-09-14" +related: + - COORDINATION-WP-0002 + - COORDINATION-WP-0003 + - STATE-WP-0092 + - CUST-WP-0072 + - CUST-ADR-005 +origin: residual-policy +origin_ref: the-custodian/history/20260914-open-workplan-chokepoints.md +--- + +# prj- awareness, cross-owner waits, and agent coordination mode + +Founder direction 2026-09-14: cross-owner coordination is the top theme +holding the open-workplan count up. Tackle it with coordination-engine, +not more inbox `wait` notes. The engine must understand **`prj-` +workplans** as drivers of cross-repository work (`ADR-005`, +`project-repository-flavor_v0.1.md`). Agent instructions for Codex, +Claude, Grok and others change **after** that mode exists, so they +coordinate instead of stranding. + +This repo owns observation, leases, wake-up, checkpoints, safety gates +and receipts (`COORDINATION-WP-0003`). State Hub remains the work-record +read model. Product implementation stays in participating repos. + +Do not enable live worker injection as a side effect of this plan. +Do not invent credential vending. + +## Model prj- workplans as cross-repo drivers + +```task +id: COORDINATION-WP-0005-T01 +status: todo +priority: high +``` + +Extend `spec/coordination-model-v0.1.md` (or a v0.2 successor) so a +`CoordinationCase` can be driven by a project-repository workplan: +`repo_flavor: project` / `prj-*` identity, child workplans in +participating repos, and `depends_on` edges as commitments rather than +prose. Distinguish driver (the `prj-` plan) from implementers (product +repos). Record what is out of scope: the engine does not author +workplans and does not replace State Hub. + +Done when the spec names the driver/implementer split, maps `prj-` +workplans onto cases/commitments, and has a worked example from an +existing project repo. + +## Cross-owner wait handling mode + +```task +id: COORDINATION-WP-0005-T02 +status: todo +priority: high +depends_on: [COORDINATION-WP-0005-T01] +``` + +Define the handling mode that replaces “set status wait and hope”: +observe the foreign owner’s record, open or attach a coordination case, +lease/wakeup only for selected gita-registered worker targets, checkpoint +progress, fail closed on missing authorization, and emit a receipt the +hub can project. Cover the common estate pattern: repo A blocked on repo +B owner return (security subsystems included). No silent re-assignment +of another owner’s tasks. + +Done when the mode is specified with entry/exit conditions, safety +gates, and a receipt shape, reconciled with the v0.1 worker-coordination +service rather than forked. + +## State Hub adapter for workplans, flavor, and prj- + +```task +id: COORDINATION-WP-0005-T03 +status: wait +priority: medium +depends_on: [COORDINATION-WP-0005-T01, STATE-WP-0092] +``` + +Read workplans, `depends_on`, flavor, and repo classification +(including `prj-`) from State Hub. Residual flavor is not a coordination +driver unless promoted. Until `STATE-WP-0092` is indexed, stay `wait` on +that dependency; T01–T02 may proceed on files and classification +standards. + +Done when a local test can build a case from hub JSON for a `prj-` +workplan and refuse to treat a residual as actionable demand. + +## Agent instruction pack + +```task +id: COORDINATION-WP-0005-T04 +status: wait +priority: high +depends_on: [COORDINATION-WP-0005-T02] +``` + +After the mode exists, update agent instructions so Codex, Claude, Grok +and other workers can tackle or coordinate cross-repo work: + +- `the-custodian/AGENTS.md` and session protocol +- coordination-engine `AGENTS.md` +- repo-seed / fleet template snippets used by other repos + +Instructions must say: follow the coordination-engine mode; do not mint +a stranded `wait` when a `prj-` driver exists; do not implement +residuals; do not message `ops-warden` for secrets. Keep the pack short. + +Done when the named files describe the mode with a pointer to the spec, +and a new session can choose “coordinate via engine” without inventing a +parallel process.