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
This commit is contained in:
parent
628f984a10
commit
edf552368a
1 changed files with 121 additions and 0 deletions
121
workplans/COORDINATION-WP-0005-prj-cross-repo-and-agent-mode.md
Normal file
121
workplans/COORDINATION-WP-0005-prj-cross-repo-and-agent-mode.md
Normal file
|
|
@ -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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue