# Parallel Dev > Autonomous parallel development with rigorous planning, execution, and validation Use when this capability is needed. - Skill: `tomevault-io/parallel-dev` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/parallel-dev` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/parallel-dev/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/parallel-dev --- # Parallel Development Skill Build applications and features autonomously with rigorous planning, parallel agent execution, QA validation, and merge coordination - minimal user interaction after initial requirements gathering. --- ## Overview This skill provides **end-to-end autonomous development** by: - **Planning**: Guided requirement gathering with all questions upfront - **Decomposition**: Breaking plans into parallelizable tasks - **Execution**: Multiple agents working simultaneously in isolated worktrees - **Validation**: Automated QA checks (lint, test, build, acceptance criteria) - **Merge**: Conflict detection, resolution, and cleanup **Value**: Develop features with minimal supervision after initial planning - Claude handles the implementation, testing, and integration autonomously. --- ## When to Use This Skill ### Ideal Use Cases | Scenario | Example | |----------|---------| | Building a new feature | "Build user authentication with OAuth" | | Starting a full application | "Create a REST API for inventory management" | | Developing multiple features | "Add shopping cart, checkout, and payment" | | Documented project kickoff | "Build the app from this PRD" | | Parallel work streams | "Implement database, API, and frontend simultaneously" | ### Trigger Phrases - "build out this application" - "develop this feature end-to-end" - "start parallel development" - "autonomous development of..." - "plan and build..." - "full development lifecycle for..." - `/parallel-dev` (explicit invocation) ### When NOT to Use | Scenario | Use Instead | |----------|-------------| | Quick bug fix | Direct editing | | Single file change | Edit tool | | Research/exploration | Explore agent | | Simple refactor | feature-dev:code-architect | --- ## Quick Actions | Need | Action | Command | |------|--------|---------| | Start planning a feature | Guided planning session | `/parallel-dev:plan ` | | View existing plan | Display plan details | `/parallel-dev:plan-show ` | | List all plans | See all plans with status | `/parallel-dev:plan-list` | | Approve a plan | Mark ready for execution | `/parallel-dev:plan-edit --approve` | | Break plan into tasks | Generate task decomposition | `/parallel-dev:decompose ` | | Start parallel execution | Begin autonomous work | `/parallel-dev:start ` | | Check progress | View execution status | `/parallel-dev:status` | | Pause execution | Gracefully pause agents | `/parallel-dev:pause ` | | Resume work | Continue after break | `/parallel-dev:resume ` | | Run QA validation | Lint, test, build checks | `/parallel-dev:validate ` | | Check for conflicts | Preview merge issues | `/parallel-dev:conflicts ` | | Merge to main | Complete and cleanup | `/parallel-dev:merge ` | --- ## Complete Workflow ``` ┌─────────────────────────────────────────────────────────────────┐ │ PARALLEL-DEV WORKFLOW │ ├─────────────────────────────────────────────────────────────────┤ │ PHASE 1: PLANNING │ │ └─ /parallel-dev:plan │ │ ├─ Vision & Goals questions │ │ ├─ Features & Scope questions │ │ ├─ Technical Decisions questions │ │ └─ Generates: plans/{name}.md │ ├─────────────────────────────────────────────────────────────────┤ │ PHASE 2: APPROVAL │ │ ├─ /parallel-dev:plan-show (review) │ │ ├─ /parallel-dev:plan-edit (adjust if needed) │ │ └─ /parallel-dev:plan-edit --approve │ ├─────────────────────────────────────────────────────────────────┤ │ PHASE 3: DECOMPOSITION │ │ └─ /parallel-dev:decompose │ │ ├─ Breaks into phases (Foundation, Core, Integration, Test) │ │ ├─ Creates tasks with dependencies │ │ ├─ Identifies parallelization opportunities │ │ └─ Generates: plans/{name}-tasks.yaml │ ├─────────────────────────────────────────────────────────────────┤ │ PHASE 4: EXECUTION │ │ └─ /parallel-dev:start │ │ ├─ Creates worktree at ~/tmp/worktrees/{project}/{name} │ │ ├─ Creates feature branch: feature/{name} │ │ ├─ Spawns parallel agents (up to 3 by default) │ │ │ ├─ Implementer agents (database, api, frontend) │ │ │ ├─ Tester agents │ │ │ └─ Documenter agents │ │ ├─ Tracks progress in executions/{name}/state.yaml │ │ └─ Continues until all tasks complete │ │ │ │ During execution: │ │ ├─ /parallel-dev:status (monitor progress) │ │ ├─ /parallel-dev:pause (graceful pause) │ │ └─ /parallel-dev:resume (continue work) │ ├─────────────────────────────────────────────────────────────────┤ │ PHASE 5: VALIDATION │ │ └─ /parallel-dev:validate │ │ ├─ Static Analysis (lint, typecheck, format) │ │ ├─ Testing (unit tests, integration tests, coverage) │ │ ├─ Build Verification (production build) │ │ └─ Acceptance Criteria (verify each criterion) │ ├─────────────────────────────────────────────────────────────────┤ │ PHASE 6: MERGE │ │ ├─ /parallel-dev:conflicts (preview conflicts) │ │ └─ /parallel-dev:merge │ │ ├─ Merges feature branch to main │ │ ├─ Runs post-merge validation │ │ ├─ Pushes to remote │ │ ├─ Removes worktree │ │ ├─ Deletes feature branch │ │ └─ Archives execution │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Reference Documentation For detailed information, see the references/ directory: - @references/detailed-workflows.md — Planning, execution, validation step-by-step - @references/configuration.md — Config, agents, file locations, templates, integrations - @references/troubleshooting.md — Common issues and solutions ## Related - @.claude/commands/parallel-dev/README.md — Command reference - @.claude/context/patterns/worktree-shell-functions.md — Worktree patterns - @.claude/orchestration/README.md — Task orchestration patterns --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/davidmoneil) — claim your Tome and manage your conversions.