feat(brainstorming,writing-plans): propose parallel execution tracks by default#1524
Open
freakathlete wants to merge 1 commit into
Open
feat(brainstorming,writing-plans): propose parallel execution tracks by default#1524freakathlete wants to merge 1 commit into
freakathlete wants to merge 1 commit into
Conversation
…by default
Adds a "Parallel Execution Plan" section to the brainstorming skill and
a "Track Structure" section to the writing-plans skill, so any spec
covering 2+ logically independent stories proactively proposes how to
split the work across parallel sessions.
The current brainstorming flow produces sequential specs by default. For
users running multiple Claude sessions concurrently, sequential specs
leave throughput on the table — parallel-track analysis tends to surface
only after the user explicitly asks "can we parallelize this?". This
moves that analysis into the default spec output.
Brainstorming changes (skills/brainstorming/SKILL.md):
- New checklist step "Add Parallel Execution Plan section" between
"Present design" and "Write design doc".
- Updated the design "Cover:" list to include the parallel plan.
- New "Parallel Execution Plan" section defining the four required
components: track decomposition, dependency graph, merge plan, and
session count estimate. Includes the inline
"Parallel-safety / handoff status" subsection pattern for PRD sections
that span tracks (e.g. backend ships now, UI deferred).
- Explicit skip condition for single-story specs.
Writing-plans changes (skills/writing-plans/SKILL.md):
- New "Track Structure (parallel execution)" section between
"Scope Check" and "File Structure".
- Plans now organize tasks into tracks that mirror the spec's parallel
plan; per-track headers tag dependencies; the last task of each
parallel-safe track ends with a handoff stub naming exactly what
shipped so a parallel session can pick it up cleanly.
- Forbids cross-track file edits ("not actually parallel" rule).
Framing throughout is offense (ship faster), not defense (avoid
conflicts).
Validated with parallel subagent RED/GREEN test:
- RED (no skill): subagent produced a sequential spec, zero parallel
section.
- GREEN (skill content provided): subagent produced a complete Parallel
Execution Plan with all four required components.
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
Adds a "Parallel Execution Plan" section to the brainstorming skill and a "Track Structure" section to the writing-plans skill. Any spec covering 2+ logically independent stories now proactively proposes how to split the work across parallel sessions, instead of producing a sequential spec by default.
Motivation
The current brainstorming flow produces sequential specs. For users running multiple Claude sessions concurrently, sequential specs leave throughput on the table — parallel-track analysis tends to surface only after the user explicitly asks "can we parallelize this?". This change moves that analysis into the default spec output as offense (ship faster), not defense (avoid conflicts).
What's in the brainstorming change
What's in the writing-plans change
(independent)or(depends on Track X's <thing>)).Validation
Ran a RED/GREEN test with two parallel subagents on an identical 2-story feature request (Flask audit-logging backend + admin dashboard UI):
Skill content materially changes the spec output.
Test plan