From 560ef346be81d8b769a07f0b4c09fc109f7760c0 Mon Sep 17 00:00:00 2001
From: Lex Christopherson <lex@glittercowboy.com>
Date: Mon, 12 Jan 2026 14:07:55 -0600
Subject: [PATCH] feat(11-01): add parallelization frontmatter to phase-prompt
 template

- parallelizable: marks plan as safe for concurrent execution
- depends_on: explicit plan dependencies
- files_exclusive: conflict detection for parallel agents
- Added frontmatter_guidance section with usage rules
- Updated good_examples with parallel/sequential examples
---
 get-shit-done/templates/phase-prompt.md | 49 +++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/get-shit-done/templates/phase-prompt.md b/get-shit-done/templates/phase-prompt.md
index 65496588c..d13a663c2 100644
--- a/get-shit-done/templates/phase-prompt.md
+++ b/get-shit-done/templates/phase-prompt.md
@@ -11,10 +11,26 @@ Template for `.planning/phases/XX-name/{phase}-{plan}-PLAN.md` - executable phas
 ```markdown
 ---
 phase: XX-name
+plan: NN
 type: execute
+parallelizable: true|false  # Can run alongside other parallelizable plans
+depends_on: []              # Explicit plan dependencies (e.g., ["11-01", "11-02"])
+files_exclusive: []         # Files only this plan modifies (from <files> elements)
 domain: [optional - if domain skill loaded]
 ---
 
+<frontmatter_guidance>
+**Parallelization fields:**
+- `parallelizable`: Set to true if plan has no dependencies and doesn't share files with sibling plans. Default false for safety.
+- `depends_on`: Array of plan IDs this plan requires (e.g., `["11-01", "11-02"]`). Empty array means independent.
+- `files_exclusive`: Files from `<files>` elements that no sibling plan touches. Used for conflict detection by execute-phase.
+
+**When to set parallelizable: true:**
+- Plan has no depends_on entries
+- All files in plan are in files_exclusive (no overlap with sibling plans)
+- Plan doesn't consume outputs from sibling plans in same phase
+</frontmatter_guidance>
+
 <objective>
 [What this phase accomplishes - from roadmap phase goal]
 
@@ -186,10 +202,43 @@ See `~/.claude/get-shit-done/references/tdd.md` for TDD plan structure.
 
 <good_examples>
 
+**Sequential plan (has dependencies):**
+
 ```markdown
 ---
 phase: 01-foundation
+plan: 02
 type: execute
+parallelizable: false
+depends_on: ["01-01"]
+files_exclusive: [src/app/api/auth/login/route.ts]
+domain: next-js
+---
+```
+
+**Parallel plan (independent):**
+
+```markdown
+---
+phase: 03-features
+plan: 02
+type: execute
+parallelizable: true
+depends_on: []
+files_exclusive: [src/components/Dashboard.tsx, src/hooks/useDashboard.ts]
+---
+```
+
+**Full example:**
+
+```markdown
+---
+phase: 01-foundation
+plan: 01
+type: execute
+parallelizable: true
+depends_on: []
+files_exclusive: [prisma/schema.prisma, src/lib/db.ts]
 domain: next-js
 ---