ai-workflow-skill/docs/roadmaps/archive/orch-skill-gap-fill.md

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

• Review the current orch skill docs, runner, and CLI coverage to identify the missing skill-side cases.
• Add the active orch-skill gap-fill case documents and README updates.
• Extend the orch-skill replay runner for the new scenarios.
• Execute the replay coverage and capture recorded example-run evidence.
• 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.