# 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