ai-workflow-skill/docs/roadmaps/archive/orch-markdown-test-gap-fill.md

Orch Markdown Test Gap Fill

Status

• completed

Owner

• codex

Started At

• 2026-03-19

Goal

• fill the five highest-priority Markdown test-plan gaps in docs/tests/orch/ so the current orch CLI has better coverage for key flag validation, non-default output behavior, and error contracts

Scope

• add or update docs/tests/orch/task-add/ for invalid acceptance-json and invalid priority
• add or update docs/tests/orch/ready/ for priority ordering and --limit
• add or update docs/tests/orch/answer/ for payload-only or empty-input validation
• add or update docs/tests/orch/cleanup/ for invalid-input or no-matching-work cleanup behavior
• add or update docs/tests/orch/council-report/ for pre-tally/invalid-show/only-unanimous report behavior as needed
• keep docs/tests/orch/ROADMAP.md and docs/implementation-roadmap.md synchronized

Checklist

• create an execution roadmap for the workstream
• add missing task add and ready cases and update indexes
• add missing answer and cleanup cases and update indexes
• add missing council report cases and update indexes
• synchronize docs/tests/orch/ROADMAP.md
• update docs/implementation-roadmap.md
• archive this roadmap with a completion summary

Files

• docs/roadmaps/archive/orch-markdown-test-gap-fill.md
• docs/implementation-roadmap.md
• docs/tests/orch/ROADMAP.md
• docs/tests/orch/task-add/README.md
• docs/tests/orch/task-add/*.md
• docs/tests/orch/ready/README.md
• docs/tests/orch/ready/*.md
• docs/tests/orch/answer/README.md
• docs/tests/orch/answer/*.md
• docs/tests/orch/cleanup/README.md
• docs/tests/orch/cleanup/*.md
• docs/tests/orch/council-report/README.md
• docs/tests/orch/council-report/*.md

Decisions

• use focused follow-up case files instead of broad rewrites to keep the current authored set stable
• keep shared tracking files in the main thread and delegate only disjoint command directories

Blockers

• none

Next Step

• no further step in this workstream; future follow-up should start from the updated docs/tests/orch/ROADMAP.md

Completion Summary

• added 10 supplemental orch Markdown test-plan cases covering high-priority gaps in task add, ready, answer, cleanup, and council report
• synchronized the relevant command index README.md files, the shared docs/tests/orch/ROADMAP.md ledger, and the project-level implementation roadmap
• used sub-agents for three disjoint directory slices while keeping shared tracking files in the main thread