parallel-setup

One-time setup of parallel/ directory for multi-agent development

Quality

55%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/product-design/skills/parallel-setup/SKILL.md

parallel-setup

Category: Parallel Development

Usage

/parallel-setup [--tech django|typescript|go]

Arguments

--tech: Optional - Technology stack hint for future decompositions (default: auto-detect)

Purpose

One-time initialization of the parallel/ directory at project root for parallel multi-agent development. This creates the infrastructure for organizing decomposed tasks by Tech Spec.

Run this once per project. Then use /parallel-decompose for each Tech Spec.

Execution Instructions for Claude Code

When this command is run, Claude Code should:

1. Create Directory Structure

mkdir -p parallel

Creates:

parallel/
├── README.md           # Explains parallel development workflow
└── .gitignore          # What to track vs ignore

2. Create README.md

Create parallel/README.md:

# Parallel Development Artifacts

This directory contains artifacts for parallel multi-agent development.

## Structure

Each Tech Spec decomposition creates a subdirectory:

parallel/ ├── TS-0042-inventory-system/ # Keyed by Tech Spec ID │ ├── manifest.json # Regeneration metadata │ ├── context.md # Shared project context │ ├── tasks/ # Task specifications │ ├── contracts/ # Shared types & API schema │ ├── prompts/ # Agent launch prompts │ ├── scripts/ # Launch & monitor scripts │ ├── architecture.md # System design │ └── task-graph.md # Dependency visualization └── ...

## Commands

- `/parallel-decompose <prd> --tech-spec <ts-file>` - Decompose PRD into tasks
- `/parallel-integrate --parallel-dir <dir>` - Verify integration

## Regeneration

Each subdirectory contains a `manifest.json` with metadata to regenerate artifacts:
```bash
# Re-run decomposition with same args
/parallel-decompose docs/prd.md --tech-spec tech-specs/approved/TS-XXXX.md

### 3. Create .gitignore

Create `parallel/.gitignore`:
```gitignore
# Generated prompts and scripts (regenerate with /parallel-decompose)
*/prompts/
*/scripts/

# Integration reports
*/integration-report.md

# Keep tracked:
# - manifest.json (regeneration metadata)
# - context.md (shared context)
# - tasks/ (task specifications)
# - contracts/ (shared types & API)
# - architecture.md (system design)
# - task-graph.md (dependencies)

4. Update CLAUDE.md (if exists)

If CLAUDE.md exists at project root, add a section:

## Parallel Development

This project uses parallel multi-agent development. Artifacts are in `parallel/`.

- Each Tech Spec decomposition creates `parallel/TS-XXXX-{slug}/`
- Task files use compact YAML format for token efficiency
- Contracts are shared via `contracts/` subdirectory
- Run `/parallel-decompose --help` for usage

5. Report Results

Output summary:

Created parallel/ directory structure

parallel/
├── README.md           # Workflow documentation
└── .gitignore          # Track config

Next steps:
1. Create a Tech Spec: /create-tech-spec <title>
2. Decompose PRD: /parallel-decompose <prd> --tech-spec <ts-file>

Example

# Initialize parallel development
/parallel-setup

# With technology hint
/parallel-setup --tech django

Notes

This command is idempotent - safe to run multiple times
Existing files are NOT overwritten
Creates foundation for /parallel-decompose command
Each decomposition creates its own subdirectory (e.g., parallel/TS-0042-slug/)

Repository: jpoutrin/product-forge
Path: plugins/product-design/skills/parallel-setup/SKILL.md
Commit: 0ebe7ae

Last updated: about 11 hours ago
First committed: 6 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.