61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
# Orch Markdown Test Plan Skeleton
|
|
|
|
## Status
|
|
|
|
- `completed`
|
|
|
|
## Owner
|
|
|
|
- codex
|
|
|
|
## Started At
|
|
|
|
- `2026-03-19`
|
|
|
|
## Goal
|
|
|
|
- create an inbox-style human-readable Markdown test-plan skeleton for `orch` so future agents can add command and workflow cases without rediscovering the documentation structure
|
|
|
|
## Scope
|
|
|
|
- add `docs/tests/orch/README.md` and `docs/tests/orch/ROADMAP.md`
|
|
- add shared and workflow entrypoint documents under `docs/tests/orch/`
|
|
- add one directory per `orch` leaf command with an index `README.md`
|
|
- update the implementation roadmap and archive this execution roadmap when complete
|
|
|
|
## Checklist
|
|
|
|
- [x] read the existing inbox Markdown test-plan roadmap and directory conventions
|
|
- [x] define the `orch` leaf-command directory model
|
|
- [x] add the `docs/tests/orch/` skeleton files and per-command indexes
|
|
- [x] update `docs/implementation-roadmap.md`
|
|
- [x] archive this roadmap with a completion summary
|
|
|
|
## Files
|
|
|
|
- `docs/roadmaps/archive/orch-markdown-test-plan-skeleton.md`
|
|
- `docs/implementation-roadmap.md`
|
|
- `docs/tests/orch/README.md`
|
|
- `docs/tests/orch/ROADMAP.md`
|
|
- `docs/tests/orch/_shared/README.md`
|
|
- `docs/tests/orch/workflows/README.md`
|
|
|
|
## Decisions
|
|
|
|
- mirror the inbox test-plan structure at the directory and index level, but model `orch` by leaf commands rather than command groups
|
|
- seed the new roadmap with a concrete pending-case backlog derived from existing `internal/cli/orch/integration_test.go` coverage so later authoring can proceed without rediscovery
|
|
|
|
## Blockers
|
|
|
|
- none
|
|
|
|
## Next Step
|
|
|
|
- start writing the highest-value `orch` case documents from the new backlog, beginning with the happy-path scheduler workflow and strict worktree dispatch cases
|
|
|
|
## Completion Summary
|
|
|
|
- created `docs/tests/orch/` with a top-level `README.md`, `ROADMAP.md`, shared conventions, workflow entrypoint, and one index `README.md` per implemented leaf command
|
|
- documented the initial `orch` Markdown test-plan model as leaf-command directories instead of command groups
|
|
- updated the project implementation roadmap so future agents can discover the new `orch` test-plan skeleton from the main handoff document
|