ai-workflow-skill/docs/roadmaps/archive/orch-skill-test-plan.md

Title

Add Orch Skill Test Plan Documents

Status

• completed

Owner

• Codex main agent

Started At

• 2026-03-19

Goal

• Add a human-readable forward-test plan directory for the packaged skills/orch/ bundle under docs/tests/.
• Mirror the proven structure of docs/tests/inbox-skill/ while adapting it to leader-side orch workflows and inbox-backed worker coordination.

Scope

• Create docs/tests/orch-skill/README.md.
• Author an initial set of orch skill scenario cases as separate Markdown files.
• Update implementation progress docs to record the new test-plan directory.

Checklist

• Review docs/tests/inbox-skill/, skills/orch/, and current orch workflow surface.
• Create docs/tests/orch-skill/README.md with shared execution contract and case index.
• Author initial orch-skill case documents.
• Update implementation roadmap and archive this execution roadmap.

Files

• docs/tests/orch-skill/README.md
• docs/tests/orch-skill/leader-run-dispatch-reconcile-through-bundled-cli.md
• docs/tests/orch-skill/leader-blocked-answer-resume-through-bundled-cli.md
• docs/tests/orch-skill/strict-worktree-dispatch-to-cleanup-through-bundled-cli.md
• docs/tests/orch-skill/leader-retries-failed-task-through-bundled-cli.md
• docs/tests/orch-skill/leader-reassigns-blocked-task-through-bundled-cli.md
• docs/implementation-roadmap.md
• docs/roadmaps/archive/orch-skill-test-plan.md

Decisions

• Keep orch-skill separate from council-review skill docs, because council-review is a distinct project-local skill package.
• Use the same forward-test style as inbox-skill, but inject skills/orch/ only into the leader and skills/inbox/ into workers.
• Treat shared DB bootstrap through inbox init as part of the test-runner setup contract rather than pretending orch owns schema initialization.

Blockers

• none

Next Step

• Add a parallel docs/tests/council-review-skill/ directory when the separate council skill test surface is ready to be documented.

Completion Summary

• Added docs/tests/orch-skill/README.md as the shared execution contract and index for leader-side skill validation.
• Added five initial forward-test scenario documents covering happy-path orchestration, blocked-answer resume, strict worktree cleanup, retry after failure, and reassignment from one worker to another.
• Updated docs/implementation-roadmap.md to record that the orch skill now has a dedicated forward-test plan directory under docs/tests/orch-skill/.