prodigy 0.4.4

Turn ad-hoc Claude sessions into reproducible development pipelines with parallel AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

## Full Workflow Structure

For more complex workflows, use the full format with explicit configuration:

```yaml
# Full format with environment and merge configuration
commands:
  - shell: "cargo build"
  - claude: "/prodigy-test"

# Global environment variables (available to all commands)
env:
  NODE_ENV: production
  API_URL: https://api.example.com

# Secret environment variables (masked in logs)
secrets:
  API_KEY: "${env:SECRET_API_KEY}"

# Environment files to load (.env format)
env_files:
  - .env.production

# Environment profiles (switch contexts easily)
profiles:
  development:
    NODE_ENV: development
    DEBUG: "true"

# Custom merge workflow (for worktree integration)
# Simplified format (direct array of commands)
merge:
  - shell: "git fetch origin"
  - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"

# OR with timeout (use config object format)
merge:
  commands:
    - shell: "git fetch origin"
    - shell: "git merge origin/main"
    - shell: "cargo test"
    - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"
  timeout: 600  # Timeout in seconds for entire merge phase
```

**Source**: Merge workflow structure from `src/config/mapreduce.rs:86-124`

## Merge Workflow Formats

Prodigy supports two formats for merge workflows:

1. **Direct Array Format** - For simple merge operations without timeout:
   ```yaml
   merge:
     - shell: "git fetch origin"
     - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"
   ```

2. **Config Object Format** - When you need to specify a timeout:
   ```yaml
   merge:
     commands:
       - shell: "git fetch origin"
       - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"
     timeout: 600  # Optional timeout in seconds
   ```

**When to Use Custom Merge Workflows:**

Custom merge workflows execute when merging worktree changes back to the main branch. Use them for:
- Pre-merge validation and testing
- Automatic conflict resolution
- Running CI checks before merge
- Cleaning up temporary files

If no custom merge workflow is specified, Prodigy uses default merge behavior.

**Source**: Deserializer implementation in `src/config/mapreduce.rs:96-124`

## Merge Context Variables

The following variables are available in merge workflows:

- `${merge.worktree}` - Name of the worktree being merged
- `${merge.source_branch}` - Source branch (worktree branch)
- `${merge.target_branch}` - Target branch (your original branch when workflow started)
- `${merge.session_id}` - Session ID for correlation and debugging

**Example with all variables**:
```yaml
merge:
  - shell: |
      echo "Merging worktree: ${merge.worktree}"
      echo "From: ${merge.source_branch}"
      echo "To: ${merge.target_branch}"
      echo "Session: ${merge.session_id}"
  - claude: "/validate-merge --branch ${merge.source_branch}"
  - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"
```

**Source**: Variable substitution from `tests/merge_workflow_integration.rs:274-290`

## Real-World Examples

**Example 1: Pre-merge Validation** (from `workflows/implement.yml:32-42`):
```yaml
merge:
  - claude: "/prodigy-merge-master"  # Merge main into worktree first
  - claude: "/prodigy-ci"             # Run CI checks and auto-fix issues
  - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"
```

**Example 2: Cleanup and Testing** (from `workflows/workflow-syntax-drift.yml:38-49`):
```yaml
merge:
  - shell: "rm -rf .prodigy/syntax-analysis"
  - shell: "git add -A && git commit -m 'chore: cleanup temp files' || true"
  - shell: "git fetch origin"
  - claude: "/prodigy-merge-master"
  - claude: "/prodigy-merge-worktree ${merge.source_branch} ${merge.target_branch}"
```

**Example 3: With Environment Variables** (from `workflows/mapreduce-env-example.yml:82-94`):
```yaml
merge:
  commands:
    - shell: "echo Merging changes for $PROJECT_NAME"
    - claude: "/validate-merge --branch ${merge.source_branch} --project $PROJECT_NAME"
    - shell: "echo Merge completed"
  timeout: 600
```