docs: PM-mode discipline + multi-agent relay coordination protocol #5

Merged

alee merged 2 commits from docs/pm-discipline into main 2026-07-04 15:23:36 +00:00

Conversation 0 Commits 2 Files Changed 3 +513 -3

alee commented 2026-07-02 00:04:19 +00:00

Owner

Copy Link

What lands

• AGENTS.md +292 lines: relay (model-agnostic MCP bus at localhost:7110), PM session launch checklist, session handoff, PM turn-start discipline, multi-dev parallelism (5-rule checklist), when-PM-is-blocked protocol
• docs/superpowers/kickoffs/slice-4-pm-prompt.md: the kickoff prompt baked into AGENTS.md's PM session discipline section

Why

Load-bearing for the multi-agent workflow executing slice-4. Session discipline (turn-start polling, no standby mode, proactive surfacing) was a prior failure mode; this bakes the correction into AGENTS.md so fresh PM sessions inherit it.

Reviews

• Companion to the slice-4 spec (separate PR)

## What lands - AGENTS.md +292 lines: relay (model-agnostic MCP bus at localhost:7110), PM session launch checklist, session handoff, PM turn-start discipline, multi-dev parallelism (5-rule checklist), when-PM-is-blocked protocol - docs/superpowers/kickoffs/slice-4-pm-prompt.md: the kickoff prompt baked into AGENTS.md's PM session discipline section ## Why Load-bearing for the multi-agent workflow executing slice-4. Session discipline (turn-start polling, no standby mode, proactive surfacing) was a prior failure mode; this bakes the correction into AGENTS.md so fresh PM sessions inherit it. ## Reviews - Companion to the slice-4 spec (separate PR)

alee added 1 commit 2026-07-02 00:04:21 +00:00

docs: PM-mode discipline + multi-agent relay coordination protocol ... aae485536e

AGENTS.md +292 lines: the relay (model-agnostic MCP message-bus at
localhost:7110), PM session launch checklist (poller, watch.sh, kitty/tmux
spawner), session handoff (inbox.log / poller.log / relay-log.jsonl), PM
turn-start discipline (drain inbox, list_pending, git log, surface
proactively), multi-dev parallelism (5-rule checklist with the slice-3
anti-pattern), when-the-PM-is-blocked protocol. Plus the slice-4 PM
kickoff prompt under docs/superpowers/kickoffs/.

Load-bearing for the multi-agent workflow executing slice-4 (and beyond):
session discipline (turn-start polling, no standby mode, proactive
surfacing) was the prior failure mode; the prompt + these sections bake
the correction into AGENTS.md so a fresh PM agent session inherits it.

alee referenced this pull request 2026-07-02 00:08:07 +00:00

spec+plan(slice-4): barge-in / VAD-driven playout kill on dedicated media thread #6

alee added 1 commit 2026-07-02 00:12:59 +00:00

docs: require DCO signoff on every commit (fixes #6 from adversarial review) ... 7270a608dc

Every commit MUST be signed off (git commit -s). Preserves the
copyright-holder's option to dual-license later — without a DCO/CLA
instrument, every external contribution erodes that option (ADR-0004).
Particularly load-bearing under multi-agent parallel authorship, where
multiple sessions commit in parallel and the DCO is the only per-commit
aggregation instrument.

Adds DCO.md with the full Linux-Foundation DCO text + the agents-sign-off-
with-the-human's-identity rule. AGENTS.md Git workflow gains the DCO bullet.

alee merged commit 13f4b14bee into main 2026-07-04 15:23:36 +00:00

alee referenced this issue from a commit 2026-07-04 15:23:37 +00:00

Merge pull request 'docs: PM-mode discipline + multi-agent relay coordination protocol' (#5) from docs/pm-discipline into main

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

alee

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: alee/rutster#5