Parallel Sessions

[CarlosChiari]

I wrote a Skill that makes Claude plan waves with multiple sessions to work many phases at the same time, in parallel, verifying overlaps and possible conflicts. When the sessions end, and we fetch origin and rebase, STATES.md and maybe other files have conflicts. I ask Claude to just append the new version to the original version and the conflict ends. Could be nice if GSD includes the skill to prepare parallel sessions and add a command to fetch and rebase them in order or whatever.

[trek-e]

@CarlosChiari — GSD already has pieces that overlap with what you described: /gsd-workstreams handles parallel workstream management (see docs/USER-GUIDE.md#workstreams and /gsd:workstreams in docs/COMMANDS.md), and phase execution already runs plans in parallel waves within a phase. The gap you are describing is cross-session merge-conflict resolution when multiple sessions converge.

The auto-merge part ("append the new version to the original") is risky as a default — STATE.md conflicts often signal real divergence (different active milestones, different progress, different decisions) and silently concatenating can double-count progress or revive rejected plans. The safer primitive is conflict-aware reconciliation with explicit precedence rules, not append-both.

If you want to push this further, open an Enhancement issue with: (1) the specific workflow that fails today, (2) what files conflict in practice and how, (3) proposed reconciliation rules per file type (STATE.md, ROADMAP.md, phase files), (4) alternatives considered (e.g., workstreams as-is, manual rebase with /gsd:resume-work). A maintainer will review from there.

[CarlosChiari]

Thanks for your time, will take a safer approach with how those files are handled when merging concurrent worktrees. GSD native workstreams indeed seem useful, but the skill I have, written with the help of Claude, besides using GSD skills/commands analyze the phases GSD had helped to plan, how they interact with code to find out which phases can be worked in parallel concurrently, and provides the prompt to give claude as the initial prompt at each worktree. Do GSD has such a coordinator? Maybe I haven't understood how to use them properly. Do workstreams already do that?