docs(workflows): chart a better task order as a departure #144

Merged

claudiomaradonna merged 1 commit from docs/execute-plan-chart into main

2026-10-19 20:41:08 +02:00

motoko commented

2026-10-19 15:07:49 +02:00

Collaborator

Why

execute-plan step 6 takes a better order for the remaining tasks as a departure, through route-back. The flowchart on docs/workflows/execute-plan.md instead goes straight from "Check the order of the tasks left" back to the next task, so a reader following the chart misses a stop the skill makes. The document reviewer found this during #142.

What changed

The chart routes a better order to route-back. It gains a dashed edge labeled "a better order: a departure". The existing edge to the next task still covers the case where no better order exists.

How to verify

grep -c 'RO -.->|"a better order: a departure"| RB' docs/workflows/execute-plan.md prints 1, and 0 on main.

These pass on the tip: bash tests/verify-agent-config.sh (257), bash tests/check-work-folder.sh (46), .agents/hooks/shellcheck.sh repo, prettier --check '**/*.md', scripts/verify-agent-config.sh, and git diff --check main. The chart was checked from its source, not rendered.

## Why `execute-plan` step 6 takes a better order for the remaining tasks as a departure, through `route-back`. The flowchart on `docs/workflows/execute-plan.md` instead goes straight from "Check the order of the tasks left" back to the next task, so a reader following the chart misses a stop the skill makes. The document reviewer found this during #142. ## What changed - **The chart routes a better order to `route-back`.** It gains a dashed edge labeled "a better order: a departure". The existing edge to the next task still covers the case where no better order exists. ## How to verify - `grep -c 'RO -.->|"a better order: a departure"| RB' docs/workflows/execute-plan.md` prints 1, and 0 on main. These pass on the tip: `bash tests/verify-agent-config.sh` (257), `bash tests/check-work-folder.sh` (46), `.agents/hooks/shellcheck.sh repo`, `prettier --check '**/*.md'`, `scripts/verify-agent-config.sh`, and `git diff --check main`. The chart was checked from its source, not rendered.

motoko added 1 commit

2026-10-19 15:07:56 +02:00

docs(workflows): chart a better task order as a departure bbf4b9032d