name: ck-parallel-development
version: 6.0.0
description: "LLM-Native parallel development with semantic dependency analysis, intelligent planning, and platform-agnostic execution"
author: "CloudKinetix Team"
category: "Development Automation"

commands:
  - id: parallel-dev
    name: "Parallel Dev"
    description: "Simple parallel development with user-specified work items and git worktree isolation"
    file: commands/parallel-dev.md
    primary: true
    modes:
      - "default - Execute user-specified work items in parallel"
      - "dry-run - Analyze conflicts without execution"
      - "single-wave - Force all items parallel (ignore conflicts)"
      - "status - Check progress of current parallel work"
      - "cleanup - Remove worktrees and cleanup"
      - "plan - Create structured workflow plan"
      - "workflow - Execute named workflow"
      - "workflow-status - Check workflow progress"
    features:
      - "LLM-native semantic dependency analysis"
      - "Platform-agnostic execution patterns"
      - "Hidden dependency detection"
      - "Risk-based wave planning"
      - "Predictive progress analytics"
      - "Intelligent conflict resolution"
      - "Dynamic plan adaptation"
      - "Git worktree isolation"
      - "Quality gate integration"
      - "Comprehensive pre-execution analysis"
  
  - id: parallel-dev-workflows
    name: "Parallel Dev Workflows"
    description: "Documentation for parallel development workflows"
    file: commands/parallel-dev-workflows.md
    primary: false

tasks:
  - id: validate-story-readiness
    name: "Validate Story Readiness"
    description: "3-tier validation system with critical blocks, overrideable warnings, and suggestions"
    file: tasks/validate-story-readiness.md
    
  - id: analyze-validation-overrides
    name: "Analyze Validation Overrides"
    description: "Learn from override patterns to improve validation rules"
    file: tasks/analyze-validation-overrides.md
    
  - id: analyze-work-conflicts
    name: "Analyze Work Conflicts"
    description: "Detect file conflicts between user-specified work items"
    file: tasks/analyze-work-conflicts.md
    
  - id: setup-worktrees
    name: "Setup Worktrees"
    description: "Create git worktrees for user-specified work items"
    file: tasks/setup-worktrees.md
    
  - id: smart-worktree-naming
    name: "Smart Worktree Naming"
    description: "Flexible worktree naming conventions"
    file: tasks/smart-worktree-naming.md
    
  - id: monitor-progress
    name: "Monitor Progress"
    description: "Track progress across all parallel work"
    file: tasks/monitor-progress.md
    
  - id: create-parallel-workflow-plan
    name: "Create Parallel Workflow Plan"
    description: "Create structured workflow plan for parallel development"
    file: tasks/create-parallel-workflow-plan.md
    
  - id: worktree-cleanup
    name: "Worktree Cleanup"
    description: "Clean up git worktrees after parallel development"
    file: tasks/worktree-cleanup.md
    
  - id: generate-pre-execution-report
    name: "Generate Pre-Execution Report"
    description: "Creates comprehensive report and execution plan before parallel development"
    file: tasks/generate-pre-execution-report.md
    
  - id: generate-semantic-analysis-report
    name: "Generate Semantic Analysis Report"
    description: "Creates detailed LLM-native dependency analysis reports with user review capabilities"
    file: tasks/generate-semantic-analysis-report.md

templates:
  - id: pre-execution-report
    name: "Pre-Execution Report Template"
    description: "Comprehensive report generated before parallel execution"
    file: templates/pre-execution-report-tmpl.md
    
  - id: execution-plan-schema
    name: "Execution Plan JSON Schema"
    description: "Schema for machine-readable execution plans"
    file: templates/execution-plan-schema.json
    
  - id: execution-plan-example
    name: "Execution Plan Example"
    description: "Example of a complete execution plan"
    file: templates/execution-plan-example.json
    
  - id: rollback-guide
    name: "Rollback Guide Template"
    description: "Step-by-step rollback procedures"
    file: templates/rollback-guide-tmpl.md
    
  - id: semantic-analysis-report
    name: "Semantic Analysis Report Template"
    description: "Template for comprehensive dependency analysis reports"
    file: templates/semantic-analysis-report-tmpl.md
    
  - id: user-review
    name: "User Review Template"
    description: "Interactive template for reviewing and correcting AI analysis"
    file: templates/user-review-tmpl.md

utils:
  - id: report-manager
    name: "Report Management Utility"
    description: "Manage pre-execution reports, execution plans, and audit trails"
    file: utils/report-manager.md
    
  - id: llm-dependency-analyzer
    name: "LLM-Native Dependency Analyzer"
    description: "Semantic dependency analysis using LLM reasoning"
    file: utils/llm-dependency-analyzer.md
    
  - id: llm-conflict-resolver
    name: "LLM-Native Conflict Resolver"
    description: "Intelligent conflict resolution for semantic and architectural conflicts"
    file: utils/llm-conflict-resolver.md
    
  - id: llm-execution-orchestrator
    name: "LLM-Native Execution Orchestrator"
    description: "Platform-agnostic orchestration patterns for any LLM"
    file: utils/llm-execution-orchestrator.md
    
  - id: llm-progress-tracker
    name: "LLM-Native Progress Tracker"
    description: "Intelligent progress tracking with predictive analytics"
    file: utils/llm-progress-tracker.md
    
  - id: semantic-analysis-reporter
    name: "Semantic Analysis Reporter"
    description: "Generates comprehensive semantic analysis reports with user review capabilities"
    file: utils/semantic-analysis-reporter.md

workflows:
  - id: parallel-feature-development
    name: "Parallel Feature Development"
    description: "Develop multiple features in parallel with conflict management"
    file: workflows/parallel-feature-development.yaml
    
  - id: parallel-story-execution
    name: "Parallel Story Execution"
    description: "Execute sprint stories in parallel with wave management"
    file: workflows/parallel-story-execution.yaml
    
  - id: parallel-bug-fixing
    name: "Parallel Bug Fixing"
    description: "Fix multiple bugs efficiently with isolation"
    file: workflows/parallel-bug-fixing.yaml
    
  - id: parallel-story-development
    name: "Parallel Story Development with BMAD Integration"
    description: "Execute BMAD stories with 3-tier validation and progressive quality gates"
    file: workflows/parallel-story-development.yaml
    
agents:
  - id: parallel
    name: "Unified Parallel Development Orchestrator"
    description: "Combines intelligent semantic analysis with practical git worktree execution for complete parallel development orchestration"
    file: agents/parallel.md
    primary: true

configuration:
  defaults:
    max_parallel_items: 6
    auto_cleanup: true
    conflict_detection: true
    coordination_method: "claude_task_results"
    worktree_base_dir: "../"
    branch_prefix: "parallel/"
    wave_strategy: "conflict_aware"
    user_controlled: true
    validation:
      enabled: true
      config_file: "config/validation-rules.yml"
      override_logging: true
      override_log_path: ".bmad-workspace/ck-parallel-dev/validation-overrides.log"
    pre_execution_reports:
      enabled: true
      require_approval: true
      report_dir: ".bmad-workspace/ck-parallel-dev/runs"
      retention_days: 30
      auto_archive_failures: true
    
  requirements:
    git_version: "2.7+"
    dependencies:
      - "git"
      - "bash"
      - "grep"
      - "sed"
    
  integration:
    compatible_agents:
      - "dev"
      - "any Task tool compatible agent"
    ck_framework: "compatible"

dependencies:
  core_tasks:
    - common/tasks/create-doc.md
    - common/tasks/execute-checklist.md
  description: "This expansion pack relies on core BMAD utilities for document creation and checklist execution"

installation:
  steps:
    - "Copy command files to .claude/commands/: cp commands/*.md ~/.claude/commands/"
    - "Ensure git worktree support (Git 2.7+)"
    - "Verify git repository is initialized"
    - "Test with simple parallel work"
    
  verification:
    - "Run: /parallel-dev --dry-run \"test work\" test-wt"
    - "Check: git worktree list"
    - "Verify: git status (clean)"

usage:
  modern: |
    # Simple parallel development
    /parallel-dev "Fix auth bug" bg-auth "Add dashboard" ft-dash
    
    # Analyze conflicts first
    /parallel-dev --dry-run "work1" wt1 "work2" wt2
    
    # Check progress
    /parallel-dev:status
    
    # Force parallel (ignore conflicts)
    /parallel-dev --single-wave "work1" wt1 "work2" wt2
    
    # Mixed work types
    /parallel-dev "Fix bug" bg-login "Add feature" ft-api "Update docs" docs
    
    # Cleanup when done
    /parallel-dev:cleanup
    
  advanced: |
    - Conflict analysis: analyze-work-conflicts
    - Worktree management: setup-worktrees
    - Smart naming: smart-worktree-naming
    - Wave-based execution with conflict prevention
    - User-controlled work specifications
    - Simple coordination with Claude Task results