65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# 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/`.
|