docs: add orch skill gap-fill cases

2026-03-19 19:27:50 +08:00
parent b753102312
commit b6ba470190
7 changed files with 723 additions and 5 deletions
@@ -0,0 +1,66 @@
+# 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.