Skip to content

Commit 52dc0f7

Browse files
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.
1 parent d7be81b commit 52dc0f7

1 file changed

Lines changed: 8 additions & 7 deletions

File tree

install.sh

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -216,11 +216,12 @@ plandb_instructions() {
216216
<plandb-philosophy>
217217
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.
218218
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.
222223
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.
224225
225226
PlanDB is a compound graph with two orthogonal structures:
226227
- **Containment** (place graph): tasks contain subtasks recursively, to any depth
@@ -243,7 +244,7 @@ plandb done --next # 4. Complete + claim next
243244
plandb status --detail # 5. Reassess after each task
244245
```
245246
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.
247248
</plandb-core-loop>
248249
249250
<plandb-decomposition>
@@ -341,7 +342,7 @@ Your goal is maximum quality at maximum speed. PlanDB enables this — but only
341342
342343
**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:
343344
- 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.
345346
- Use `plandb ahead --depth 3` to check if your graph has enough width.
346347
347348
**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
352353
<plandb-rules>
353354
## Rules
354355
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.
356357
2. **Description is the spec.** `--description` must contain everything needed to execute: context, approach, files, acceptance criteria.
357358
3. **Maximize graph width.** Structure tasks to unlock as many parallel branches as possible.
358359
4. **Parallelize ready tasks.** When `plandb list --status ready` returns multiple tasks, run them concurrently — with sub-agents if available.

0 commit comments

Comments
 (0)