docs(agents): seats read the queue, not CURRENT.md (row 10, #1508)
AGENTS.md cadence, pointer and recovery rule name `scripts/mosaic queue next <seat>` and the ratified goal order. The six seat CONTEXT files run the queue instead of reading CURRENT.md for ownership and gates. The queue README says why queue-commit.sh calls cli.mjs directly (Filbert A2 r1 n3). Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
@@ -109,12 +109,14 @@ substitute for a real blocker.
|
|||||||
|
|
||||||
- **Register** your session in `docs/SESSIONS.md` — one append-only line
|
- **Register** your session in `docs/SESSIONS.md` — one append-only line
|
||||||
(date, actor, scope, outcome). Never rewrite or remove entries.
|
(date, actor, scope, outcome). Never rewrite or remove entries.
|
||||||
- **Cadence**: read `docs/plans/QUEUE.md` first; your next piece is the first
|
- **Cadence**: run `scripts/mosaic queue next <your seat>` first. It names
|
||||||
row you own that is briefed, in progress or in review, unless Jason has named
|
the row to resume, review or start, or says there is nothing. The goal order
|
||||||
an explicit current priority in that queue. Open only
|
in `docs/plans/2026-09-27_goals-review.md` sets priority, not CURRENT.md.
|
||||||
the brief that row links to. Execute it through every authorized stage (implement → test → verify against acceptance
|
Open only the brief that row links to. Execute it through every authorized
|
||||||
criteria; commit, push, or close only when the established plan authorizes
|
stage (implement → test → verify against acceptance criteria; commit, push,
|
||||||
each) → move your QUEUE.md row → register in SESSIONS.md.
|
or close only when the established plan authorizes each) → move the row with
|
||||||
|
`scripts/mosaic queue move` (never by editing QUEUE.md) → register in
|
||||||
|
SESSIONS.md.
|
||||||
- "next" means one action. A batch mandate ("run the queue") repeats the
|
- "next" means one action. A batch mandate ("run the queue") repeats the
|
||||||
loop until green or truly blocked under the boundary rules above.
|
loop until green or truly blocked under the boundary rules above.
|
||||||
- Substantial work gets a Gitea issue and a BUILD-LOG phase entry
|
- Substantial work gets a Gitea issue and a BUILD-LOG phase entry
|
||||||
@@ -188,7 +190,8 @@ Full reference — usage, fields, exit codes, safety notes:
|
|||||||
## Pointers (depth lives here)
|
## Pointers (depth lives here)
|
||||||
|
|
||||||
- `docs/plans/2026-09-27_goals-review.md` — north star and goal order (Jason ratified 2026-09-27)
|
- `docs/plans/2026-09-27_goals-review.md` — north star and goal order (Jason ratified 2026-09-27)
|
||||||
- `docs/plans/QUEUE.md` — THE task list (one row per piece; read first)
|
- `docs/plans/QUEUE.md` — THE task list, rendered from `docs/plans/queue.json`
|
||||||
|
(`scripts/mosaic queue next <seat>` reads it; `packages/queue/README.md` has the verbs)
|
||||||
- `docs/plans/CURRENT.md` — narrative log behind the queue rows
|
- `docs/plans/CURRENT.md` — narrative log behind the queue rows
|
||||||
- `docs/plans/ROADMAP.md` — agreed milestone path (M16+)
|
- `docs/plans/ROADMAP.md` — agreed milestone path (M16+)
|
||||||
- `docs/plans/CONDUCTOR.md` — orchestration protocol and guardrails
|
- `docs/plans/CONDUCTOR.md` — orchestration protocol and guardrails
|
||||||
@@ -203,9 +206,9 @@ Full reference — usage, fields, exit codes, safety notes:
|
|||||||
## Recovery rule
|
## Recovery rule
|
||||||
|
|
||||||
Compacted, restarted, or new? Nothing that matters is lost: this file +
|
Compacted, restarted, or new? Nothing that matters is lost: this file +
|
||||||
`docs/plans/CURRENT.md` + `git log --oneline -10` + the suites reconstruct
|
`scripts/mosaic queue next <seat>` + `docs/plans/CURRENT.md` +
|
||||||
the full state. **Never guess** — verify with the suites; the run records
|
`git log --oneline -10` + the suites reconstruct the full state. **Never
|
||||||
and logs hold the receipts.
|
guess** — verify with the suites; the run records and logs hold the receipts.
|
||||||
|
|
||||||
## Version pin
|
## Version pin
|
||||||
|
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ to change unrelated files, other agents' work, or the live fleet.
|
|||||||
|
|
||||||
For an assigned improvement, inspect the implementation, reproduce the issue,
|
For an assigned improvement, inspect the implementation, reproduce the issue,
|
||||||
make the smallest useful change, verify it, and continue through the authorized
|
make the smallest useful change, verify it, and continue through the authorized
|
||||||
outcome. Read docs/plans/CURRENT.md to reconcile ownership and existing gates;
|
outcome. Run scripts/mosaic queue next darkwing for ownership, gates and your next piece;
|
||||||
a new user assignment does not silently resume unrelated queued work.
|
a new user assignment does not silently resume unrelated queued work.
|
||||||
|
|
||||||
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ to change unrelated files, other agents' work, or the live fleet.
|
|||||||
|
|
||||||
For an assigned improvement, inspect the implementation, reproduce the issue,
|
For an assigned improvement, inspect the implementation, reproduce the issue,
|
||||||
make the smallest useful change, verify it, and continue through the authorized
|
make the smallest useful change, verify it, and continue through the authorized
|
||||||
outcome. Read docs/plans/CURRENT.md to reconcile ownership and existing gates;
|
outcome. Run scripts/mosaic queue next dewey for ownership, gates and your next piece;
|
||||||
a new user assignment does not silently resume unrelated queued work.
|
a new user assignment does not silently resume unrelated queued work.
|
||||||
|
|
||||||
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ to change unrelated files, other agents' work, or the live fleet.
|
|||||||
|
|
||||||
For an assigned improvement, inspect the implementation, reproduce the issue,
|
For an assigned improvement, inspect the implementation, reproduce the issue,
|
||||||
make the smallest useful change, verify it, and continue through the authorized
|
make the smallest useful change, verify it, and continue through the authorized
|
||||||
outcome. Read docs/plans/CURRENT.md to reconcile ownership and existing gates;
|
outcome. Run scripts/mosaic queue next filbert for ownership, gates and your next piece;
|
||||||
a new user assignment does not silently resume unrelated queued work.
|
a new user assignment does not silently resume unrelated queued work.
|
||||||
|
|
||||||
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ bootstrap configuration. It is not a managed fleet seat or sandbox. Host tools
|
|||||||
are available for authorized research, evidence and fixture work; their presence
|
are available for authorized research, evidence and fixture work; their presence
|
||||||
never grants access to unrelated work, secrets or live services.
|
never grants access to unrelated work, secrets or live services.
|
||||||
|
|
||||||
Read `docs/plans/QUEUE.md` and the applicable owner-approved task before acting.
|
Run `scripts/mosaic queue next researcher` and read the task it names before acting.
|
||||||
The current internal development team is Sage, Darkwing, Dewey, Filbert, Rocko
|
The current internal development team is Sage, Darkwing, Dewey, Filbert, Rocko
|
||||||
and Researcher under `agents/`. Route development coordination to Sage. Use
|
and Researcher under `agents/`. Route development coordination to Sage. Use
|
||||||
repository communication tooling with an explicitly verified destination/socket;
|
repository communication tooling with an explicitly verified destination/socket;
|
||||||
|
|||||||
@@ -12,7 +12,7 @@ claim that Pi's /goal lifecycle is available here. Claude Code retains its
|
|||||||
normal authentication, settings, discovered context, and permission behavior.
|
normal authentication, settings, discovered context, and permission behavior.
|
||||||
Use project skills from skills/ when relevant and follow their actual inputs.
|
Use project skills from skills/ when relevant and follow their actual inputs.
|
||||||
|
|
||||||
Read docs/plans/CURRENT.md to reconcile current ownership and existing gates.
|
Run scripts/mosaic queue next rocko for ownership, gates and your next piece.
|
||||||
A new user assignment does not silently resume unrelated queued work. The
|
A new user assignment does not silently resume unrelated queued work. The
|
||||||
canonical checkout is /mnt/storage/src/mosaic-stack; v1/ is archived legacy
|
canonical checkout is /mnt/storage/src/mosaic-stack; v1/ is archived legacy
|
||||||
source. Preserve other agents' work and coordinate scope with Sage.
|
source. Preserve other agents' work and coordinate scope with Sage.
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ to change unrelated files, other agents' work, or the live fleet.
|
|||||||
|
|
||||||
For an assigned improvement, inspect the implementation, reproduce the issue,
|
For an assigned improvement, inspect the implementation, reproduce the issue,
|
||||||
make the smallest useful change, verify it, and continue through the authorized
|
make the smallest useful change, verify it, and continue through the authorized
|
||||||
outcome. Read docs/plans/CURRENT.md to reconcile ownership and existing gates;
|
outcome. Run scripts/mosaic queue next sage for ownership, gates and your next piece;
|
||||||
a new user assignment does not silently resume unrelated queued work.
|
a new user assignment does not silently resume unrelated queued work.
|
||||||
|
|
||||||
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
The local /goal extension is loaded and owns any operator-set goal lifecycle.
|
||||||
|
|||||||
@@ -150,6 +150,11 @@ is swept in:
|
|||||||
commit and those entries are still H's. Otherwise exit 3 and print the
|
commit and those entries are still H's. Otherwise exit 3 and print the
|
||||||
command. Until it runs, the guard refuses ordinary commits.
|
command. Until it runs, the guard refuses ordinary commits.
|
||||||
|
|
||||||
|
`queue-commit.sh` calls `node packages/queue/src/cli.mjs` directly, not
|
||||||
|
`scripts/mosaic queue`. That stays after A2 on purpose: step 4 runs HEAD's
|
||||||
|
archived copy, which then depends only on the package, not on the
|
||||||
|
dispatcher.
|
||||||
|
|
||||||
`scripts/git-hooks/pre-commit` is the guard. `scripts/queue-commit.sh
|
`scripts/git-hooks/pre-commit` is the guard. `scripts/queue-commit.sh
|
||||||
--install-hook` installs it (jason or sage). It refuses any `git commit`
|
--install-hook` installs it (jason or sage). It refuses any `git commit`
|
||||||
whose index entries for the two queue files differ from HEAD's.
|
whose index entries for the two queue files differ from HEAD's.
|
||||||
|
|||||||
Reference in New Issue
Block a user