ai-workflow-skill/docs/roadmaps/archive/orch-markdown-test-plan-skeleton.md

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

• read the existing inbox Markdown test-plan roadmap and directory conventions
• define the orch leaf-command directory model
• add the docs/tests/orch/ skeleton files and per-command indexes
• update docs/implementation-roadmap.md
• 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