Add parallel-team preset and cross-session delivery contract - #69
Merged
Conversation
New skill `parallel-delivery` covers the claim protocol (assignee is the lock), workspace isolation (one clone/worktree per ticket), the ticket-is-sole-context rule for a worker with no one to ask, and the report-back contract (a PR + ticket comment + tracker transition, no side-channel status docs). Adds the `parallel-team` workflow preset (peer review always required, by a different session than the implementer) and its schema enum entry, wires up `--preset=parallel-team` in install.sh, and extends both ticket templates with Branch / Claimed by / Negative acceptance criteria / Verification steps fields. Replaces the stale "conductor of the orchestra — every agent reports to you" language in the Scrum Master commands (walked back as unfalsifiable in 5.1.0, but never fixed at the command layer) with the same board-integrity framing the skill itself already uses.
There was a problem hiding this comment.
Pull request overview
Adds a new workflow preset (parallel-team) and a new cross-session process skill (parallel-delivery) to support parallel ticket execution with explicit claim/lock semantics, workspace isolation, and a standardized report-back contract, plus template and documentation updates to keep the framework consistent.
Changes:
- Added
parallel-deliveryskill documenting the cross-session claim/isolation/report-back protocol. - Introduced
parallel-teamworkflow preset (and schema/docs) and wired it intoinstall.sh/README preset lists. - Extended ticket templates and updated related command/docs copy and skill-count references (42 → 43).
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Updates skill count and documents the new parallel-delivery process skill and preset option. |
| install.sh | Accepts --preset=parallel-team and validates it in argument parsing. |
| claude/workflow/workflow.yaml | Adds the parallel-team preset with CODE_REVIEWED always required. |
| claude/workflow/workflow.schema.json | Extends preset enum to include parallel-team. |
| claude/workflow/README.md | Documents parallel-team in the presets table. |
| claude/templates/user-story-template.md | Adds Branch, Claimed by, Negative AC, and Verification Steps fields to the user story template. |
| claude/skills/parallel-delivery/SKILL.md | New skill defining the parallel delivery contract and expectations. |
| claude/skills/management/scrum-master/references/templates.md | Extends the Scrum Master ticket template with Branch/Claimed by, Negative AC, and Verification Steps. |
| claude/commands/sm.md | Reframes Scrum Master “core principle” away from “conductor” language toward board-integrity framing. |
| claude/commands/luda.md | Same core-principle reframing as sm.md. |
| claude/CLAUDE.md | Updates skill count reference (42 → 43). |
| claude/AGENTS.md | Updates skill count reference (42 → 43). |
| CLAUDE.md | Updates skill count reference (42 → 43). |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
parallel-deliveryskill covering the claim protocol (assignee is the lock), workspace isolation (one clone/worktree per ticket), the ticket-is-sole-context rule, and the report-back contract (a PR + ticket comment + tracker transition — no side-channel status docs).parallel-teamworkflow preset (always_required: [CODE_REVIEWED], reviewer must be a different session than the implementer) toworkflow.yaml, and its enum entry inworkflow.schema.json; wires--preset=parallel-teamintoinstall.shand its--helptext.templates/user-story-template.mdand the Scrum Master'sreferences/templates.md) withBranch,Claimed by,Negative acceptance criteria, andVerification stepsfields.commands/sm.mdandcommands/luda.md— walked back as unfalsifiable in the 5.1.0 changelog but never fixed at the command layer — with the board-integrity framing the Scrum Master skill itself already uses.Dry run — one sample ticket filled from the new template fields alone
Every field above was fillable from the template + the
parallel-deliveryskill's instructions alone, with no external report to read.Test plan
python3 scripts/validate-framework.py— all 7 gates pass (skills=43 commands=50 templates=6)claude plugin validate ./claude— passes (pre-existing warnings only: noversionkey by design, plugin-rootCLAUDE.mdnot auto-loaded by design)workflow.yamlwithpreset: parallel-teamvalidated againstworkflow.schema.jsonviajsonschema.validate— passes./install.sh --dry-run --editors=claude --scope=project --preset=parallel-team --yes— installs cleanly, writespreset 'parallel-team'to the override file./install.sh --dry-run --editors=all --scope=project --yes(defaultsolopreset) — unchanged, still installs cleanlyworkflow.yaml/workflow.schema.jsonis additions-only:solo,small-team,regulatedblocks are byte-for-byte unchanged