workflow-planned-work

Codex compatibility note:

• Invoke $skill-name: load the registered .agents/skills/<name>/SKILL.md and execute it with Codex tools; no separate Skill tool or Claude mode switch is needed. Author .claude/**; mirrors are generated.
• Track steps before execution and keep progress/evidence current. Explicit skill requests execute their protocol. Use the native question tool for required questions.
• Map foreign tool names to available host capabilities. A name mismatch needs no approval; an actually unavailable required capability stops with its step/evidence and a user question before adaptation.
• Subagent authorization: when a skill is user-invoked or AI-detected and its protocol requires subagents, that skill activation authorizes use of the required spawn_agent subagent(s) for that task.
• Preserve protocol order unless the user approves a deviation. Workflows use $start-workflow: gates stay fixed; other steps may flex with logged reasons and evidence.

Workflow Calls and Todo Bootstrap

Read the registry → workflows.workflow-planned-work together with this skill. Call $start-workflow workflow-planned-work to resolve the selected mode, pre-actions and fingerprint.

Todo FIRST: before triage, analysis or step execution, create one todo per phase of the selected mode, in order, listing every occurrence of that phase as a line, including conditional/optional ones (a mode that declares no phases gets one todo per occurrence); preserve occurrence IDs, roles and barrier groups. Use native todo tools or an equivalent persistent ledger. Then mark the first todo in_progress; close each step line with its run or skip evidence, and complete a phase todo only when every line is closed and its applicable exit gates hold. Mode selection and registry loading prepare tracking; any 'first action' below means the first substantive action after this bootstrap.

Call each step skill: read its linked SKILL.md and execute its protocol through the active host with the registry args. Reading or naming a skill alone is not execution. Required gates and core/optional flex follow the linked start-workflow Step Execution Protocol; keep this skill's quality gates, loops and evidence requirements.

Conditions: load each occurrence's registry applicability.when and skipReason verbatim, and record its run/skip evidence through the linked start-workflow protocol. Do not silently omit a todo or turn a conditional skill into an unconditional call; close, in one batch at triage, the todos whose condition is already false there. Declared parallel groups retain their all-return barrier.

Explicit step-skill calls by mode (registry order; roles and conditions remain owned by the registry):

• Mode idea-to-tasks: $web-research --chain=deep-dive (optional; conditional) → $brainstorm (optional; conditional) → $initiative (core) → $spec [mode=discovery] (optional; conditional) → $work-item --mode=review (optional; conditional) → $domain-analysis (optional; conditional) → $why-review (optional; conditional) → $spec [mode=draft] (optional; conditional) → $spec [mode=tests] (optional; conditional) → $work-item --mode=review --type=spec-tests (optional; conditional) → $spec [mode=clarify] (optional; conditional) → $scenario (optional; conditional) → $plan (optional; conditional) → $work-item --mode=refine (core) → $work-item --mode=review --type=task --fix-loop (gate) → $work-item --mode=challenge --reuse=task-review (optional; conditional) → $work-item --mode=story (core) → $work-item --mode=dor --reuse=task-review (gate) → $prioritize (optional; conditional) → $design-spec (optional; conditional) → $work-item --mode=review --type=design (optional; conditional) → $work-item --mode=mockup --explore (optional; conditional) → $docs-manager --mode=update (optional; conditional) → $feature-presentation (optional; conditional) → $workflow-end (gate) → $watzup (optional; conditional) Phase todos: Discover (7) → Specify (5) → Plan (11; exit review-converged, spec-synced) → Close (3; exit run-closed)

• Mode idea-to-spec: $web-research --chain=deep-dive (optional; conditional) → $brainstorm (optional; conditional) → $spec [mode=discovery] (optional; conditional) → $scenario (optional; conditional) → $domain-analysis (optional; conditional) → $why-review (optional; conditional) → $initiative (optional; conditional) → $spec [mode=draft] (core) → $spec [mode=tests] (core) → $work-item --mode=review --type=spec-tests --fix-loop (gate) → $design-spec (optional; conditional) → $work-item --mode=review --type=design (optional; conditional) → $spec [mode=clarify] (gate) → $why-review (optional; conditional) → $docs-manager --mode=update (optional; conditional) → $feature-presentation (optional; conditional) → $workflow-end (gate) → $watzup (optional; conditional) Phase todos: Discover (3) → Specify (12; exit review-converged) → Close (3; exit run-closed)

• Mode spec-to-tasks: $investigate (core) → $spec [mode=index] (optional; conditional) → $domain-analysis (optional; conditional) → $why-review (optional; conditional) → $spec [mode=clarify] (gate) → $scenario (optional; conditional) → $plan (optional; conditional) → $work-item --mode=refine (core) → $work-item --mode=review --type=task --fix-loop (gate) → $work-item --mode=challenge --reuse=task-review (optional; conditional) → $work-item --mode=story (core) → $work-item --mode=dor --reuse=task-review (gate) → $prioritize (optional; conditional) → $design-spec (optional; conditional) → $work-item --mode=review --type=design (optional; conditional) → $work-item --mode=mockup --explore (optional; conditional) → $docs-manager --mode=update (optional; conditional) → $feature-presentation (optional; conditional) → $workflow-end (gate) → $watzup (optional; conditional) Phase todos: Discover (4) → Specify (2) → Plan (11; exit review-converged, spec-synced) → Close (3; exit run-closed)