whiteboard: Skill for Claude Code

Workflow Authoring (whiteboard)

The repo's Dynamic Workflows live in .claude/workflows/*.workflow.mjs and are run via the Workflow tool. Roles: dev-loop (one task's inner loop) composes review (change-review gate, which has an optional inline dogfood phase); plan-initiative (multi-perspective planning) optionally composes consult-adversarial (Vet) and investigate (ground policy/hygiene/portability questions); dogfood-triage (standalone persona dogfooding); reconcile (pre-merge intent/conflict reconciliation); investigate (read-only, lightweight: fan out one investigator per concern dimension → synthesize a go/no-go with required-before-adopting steps; reusable for any "is it safe to commit/track X" question). The main session is the single integrator — it holds human gates (design approval, commit, PR, merge), git, and CI monitoring; workflows automate the rest and return needsHumanGate.

Gotchas (verified)

1. args arrives as a JSON string, not an object. args.foo is always undefined → silent fallback to defaults. Normalize at the top of every script:

   const A = (() => { try { return typeof args === 'string' ? JSON.parse(args) : (args && typeof args === 'object' ? args : {}) } catch { return {} } })()
   

   Then read A.foo. (A no-arg args-probe workflow that return { typeofArgs: typeof args } confirms this.)

2. Nesting is ONE level. workflow() inside a child throws. So dev-loop → review is fine, but review must NOT call workflow() — its dogfood is an inline phase (agent + Playwright), not a nested workflow. reconcile only detects/judges; the integrator does the actual fold.

3. Parallel dev = main session fans out, not a parent workflow. A parent-workflow → dev-loop → review would be 2 levels. Instead the main session launches several dev-loop runs concurrently (each its own task), and folds results via reconcile.

4. Parallel dev-loops run in isolated worktrees. A bare git worktree has no node_modules, but node .claude/scripts/new-worktree.mjs <name> [baseRef] does git worktree add .claude/worktrees/<name> + pnpm install --prefer-offline (~6s, warm pnpm store) so tests/typecheck run isolated there. Parallel pattern: the integrator (main session) creates one ready worktree per independent item, launches a dev-loop with cwd=<that worktree> (cwd-aware: git -C <cwd> + agents edit under it), runs several concurrently, then reconcile before folding. The main session stays at repo root (never cds away — see #5). A single-task dev-loop may still run on the main tree (implement stages only its files, never -A).