You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: close agent escape hatch — parallelism requires PlanDB, not just complexity
Agents were justifying skipping PlanDB for "simple" parallel tasks (e.g.,
2 independent API calls). The gate now explicitly requires PlanDB when
there are 2+ independent actions, regardless of individual complexity.
Also removes code-specific language throughout — PlanDB is for any task
(research, API calls, analysis, writing, deployment), not just code.
Copy file name to clipboardExpand all lines: install.sh
+8-7Lines changed: 8 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -216,11 +216,12 @@ plandb_instructions() {
216
216
<plandb-philosophy>
217
217
You have `plandb` installed. It is your task graph — use it to decompose every non-trivial task into a dependency graph, track progress, and coordinate parallel work.
218
218
219
-
**BEFORE you write any code or make any change, ask yourself: is this a single straightforward edit?**
220
-
- If YES (one file, one clear change, no dependencies) — just do it.
221
-
- If NO — **STOP. Plan in PlanDB first.** Decompose into tasks, set dependencies, then work the graph. Do NOT start implementing until the plan exists in PlanDB.
219
+
**BEFORE you start any task, ask yourself: can this be done in a single action with no dependencies?**
220
+
- If YES (one action, no parallelism possible, no follow-up steps) — just do it.
221
+
- If NO — **STOP. Plan in PlanDB first.** This includes: multiple steps, parallel work, research + execution, anything with dependencies between parts.
222
+
- If there are **2+ independent actions** — that's parallelism. Use PlanDB even if each action is simple.
222
223
223
-
This is non-negotiable. Every multi-step task must be decomposed in PlanDB before execution begins. The graph tells you what to work on, what to parallelize, and what to skip — but only if you build it first.
224
+
This is non-negotiable. Do NOT justify skipping PlanDB because individual steps are "simple." If there are multiple steps or any opportunity to parallelize, the graph must exist before work begins. PlanDB is not just for code — it's for any task: research, API calls, data analysis, writing, deployment, investigation.
224
225
225
226
PlanDB is a compound graph with two orthogonal structures:
226
227
- **Containment** (place graph): tasks contain subtasks recursively, to any depth
plandb status --detail # 5. Reassess after each task
244
245
```
245
246
246
-
**Description is mandatory.** Every task's `--description` must be a self-contained work order: what to do, which files to touch, acceptance criteria. The title is a label — the description is the spec.
247
+
**Description is mandatory.** Every task's `--description` must be a self-contained work order: what to do, what to produce, acceptance criteria. The title is a label — the description is the spec.
247
248
</plandb-core-loop>
248
249
249
250
<plandb-decomposition>
@@ -341,7 +342,7 @@ Your goal is maximum quality at maximum speed. PlanDB enables this — but only
341
342
342
343
**Maximize the width of your graph.** The more tasks that are `ready` simultaneously, the more work runs in parallel. Structure dependencies to unlock breadth early:
343
344
- Front-load research and design tasks — they unblock everything downstream.
344
-
- Split implementation by feature or module, not by layer. "Build auth API" and "Build search API" can parallelize. "Build all models" then "build all controllers" cannot.
345
+
- Split work by independent outcome, not by sequential phase. "Fetch ad performance" and "Check audience status" can parallelize. "Gather all data" then "analyze everything" cannot.
345
346
- Use `plandb ahead --depth 3` to check if your graph has enough width.
346
347
347
348
**Use the critical path to prioritize.** `plandb critical-path` shows the longest chain to completion — that's your bottleneck. If you have a choice between working on something on the critical path or off it, always choose the critical path. `plandb bottlenecks` shows which tasks block the most downstream work.
@@ -352,7 +353,7 @@ Your goal is maximum quality at maximum speed. PlanDB enables this — but only
352
353
<plandb-rules>
353
354
## Rules
354
355
355
-
1. **Use PlanDB for every non-trivial task.** If it has more than 2 steps, decompose it into a graph.
356
+
1. **Use PlanDB for every non-trivial task.** Multiple steps, parallel actions, or dependencies between parts — plan it. This applies to any work: code, research, API calls, analysis, writing, deployment.
356
357
2. **Description is the spec.** `--description` must contain everything needed to execute: context, approach, files, acceptance criteria.
357
358
3. **Maximize graph width.** Structure tasks to unlock as many parallel branches as possible.
358
359
4. **Parallelize ready tasks.** When `plandb list --status ready` returns multiple tasks, run them concurrently — with sub-agents if available.
0 commit comments