About parallel-agents
A skill for coding agents that guides parallel development while reducing conflicts in shared files. It covers file boundaries, merge-friendly edits, conflict hotspot reviews, and concise agent documentation.
Key features
- 01Choose file boundaries by feature
- 02Shape shared lists for merging
- 03Investigate recurring conflict hotspots
- 04Maintain concise agent documentation
Use cases
- 01Plan file structure for parallel features
- 02Reduce conflicts in registries and generated files
- 03Review repeated code conflict areas
- 04Trim agent instruction documents
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/parallel-agentsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
agents/openai.yamlreferences/doc-gardening.mdhotspot-audit.mdmergeable-edits.mdone-feature-one-file.mdDetails
From the project READMEParallel agents
Keep independently owned work from colliding in shared files. Apply structural changes when concurrent work or observed conflict history justifies them.
- Give independent behavior its own file when that creates a useful ownership boundary. Keep edits to shared registries small. Do not split a cohesive module merely to achieve a one-line registration.
- Shape shared lists for merging: one item per line, stable insertion order, and no unrelated reformatting. Regenerate generated files and lockfiles.
- Investigate repeated conflict hotspots before splitting them. Keep structural moves separate from behavior changes when both are requested.
- Keep agent docs concise: working agreements, non-obvious constraints, and useful setup/check entry points. Keep module detail near its owner.
References
Read only the reference relevant to the task:
- one-feature-one-file.md: choosing file boundaries for concurrent feature work.
- mergeable-edits.md: editing shared registries, generated files, or conflicting branches.
- hotspot-audit.md: measuring conflict hotspots when an audit or structural repair is requested.
- doc-gardening.md: maintaining agent instructions or reducing duplicated documentation.
Comments
Markdown supported