# 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

- [x] Review `docs/tests/inbox-skill/`, `skills/orch/`, and current `orch` workflow surface.
- [x] Create `docs/tests/orch-skill/README.md` with shared execution contract and case index.
- [x] Author initial `orch-skill` case documents.
- [x] 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/`.