# Title

Add Missing Orch Skill Forward-Test Cases

## Status

- `completed`

## Owner

- Codex main agent

## Started At

- `2026-03-19`

## Goal

- Add three missing `docs/tests/orch-skill/` forward-test cases covering dependency-gated ready sequencing, direct task cancellation, and payload-only blocked answers.
- Extend the bundled-CLI replay runner so the new cases can be executed and recorded with concrete evidence.

## Scope

- update `docs/tests/orch-skill/README.md` with the new case index entries
- add three new case documents under `docs/tests/orch-skill/`
- extend `scripts/run_orch_skill_forward_tests.sh` to execute the new scenarios
- run the replay suite and record the new example-run evidence
- update `docs/implementation-roadmap.md`

## Checklist

- [x] Review the current orch skill docs, runner, and CLI coverage to identify the missing skill-side cases.
- [x] Add the active orch-skill gap-fill case documents and README updates.
- [x] Extend the orch-skill replay runner for the new scenarios.
- [x] Execute the replay coverage and capture recorded example-run evidence.
- [x] Update implementation progress docs and archive this roadmap.

## Files

- `docs/tests/orch-skill/README.md`
- `docs/tests/orch-skill/leader-dispatches-dependent-task-after-prerequisite-through-bundled-cli.md`
- `docs/tests/orch-skill/leader-cancels-active-task-through-bundled-cli.md`
- `docs/tests/orch-skill/leader-answers-blocked-task-with-payload-json-through-bundled-cli.md`
- `scripts/run_orch_skill_forward_tests.sh`
- `docs/implementation-roadmap.md`
- `docs/roadmaps/archive/orch-skill-gap-fill.md`

## Decisions

- Keep the new coverage in `orch-skill` rather than `docs/tests/orch/`, because the gap is leader-side skill usage, not raw CLI contract coverage.
- Use the direct bundled-CLI replay path for immediate recorded evidence, consistent with the existing orch-skill case documents.

## Blockers

- none

## Next Step

- rerun the direct replay suite when the orch skill bundle or any orch-skill case document changes, and add real subagent-forward evidence for the three new gap-fill cases when that coverage is needed.

## Completion Summary

- Added three new `docs/tests/orch-skill/` cases covering dependency-gated ready sequencing, direct active-task cancellation, and payload-only blocked answers.
- Extended `scripts/run_orch_skill_forward_tests.sh` so the replay runner now executes all eight documented orch-skill scenarios.
- Ran the full replay suite at `/tmp/orch-skill-forward-gap-fill` and recorded passing example-run evidence for the three new cases.
- Updated `docs/tests/orch-skill/README.md` and `docs/implementation-roadmap.md` to reflect the expanded orch-skill coverage and evidence status.