Files
ai-workflow-skill/docs/roadmaps/archive/council-review-skill-test-plan.md
T

2.7 KiB

Title

Add Council Review 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/council-review/ bundle under docs/tests/.
  • Mirror the structure used by docs/tests/inbox-skill/ and docs/tests/orch-skill/ while adapting it to the high-level orch council ... workflow and reviewer coordination model.

Scope

  • Create docs/tests/council-review-skill/README.md.
  • Author an initial set of council-review skill scenario cases as separate Markdown files.
  • Update implementation progress docs to record the new test-plan directory.

Checklist

  • Review docs/tests/orch-skill/, skills/council-review/, and the current council workflow surface.
  • Create docs/tests/council-review-skill/README.md with shared execution contract and case index.
  • Author initial council-review-skill case documents.
  • Update implementation roadmap and archive this execution roadmap.

Files

  • docs/tests/council-review-skill/README.md
  • docs/tests/council-review-skill/council-brainstorm-end-to-end-through-bundled-cli.md
  • docs/tests/council-review-skill/council-unanimous-only-default-report-through-bundled-cli.md
  • docs/tests/council-review-skill/council-wait-timeout-through-bundled-cli.md
  • docs/tests/council-review-skill/council-report-rejects-before-tally-through-bundled-cli.md
  • docs/implementation-roadmap.md
  • docs/roadmaps/archive/council-review-skill-test-plan.md

Decisions

  • Keep council-review-skill separate from orch-skill, because council-review is a distinct project-local skill package with its own user-facing semantics.
  • Use the same forward-test style as the other skill test-plan directories, but inject skills/council-review/ only into the leader and skills/inbox/ into reviewer agents.
  • Treat shared DB bootstrap through inbox init as part of the test-runner setup contract rather than pretending council-review owns schema initialization.

Blockers

  • none

Next Step

  • Capture one or more real recorded example runs for the end-to-end and unanimous-only cases after the packaged council-review skill is exercised in practice.

Completion Summary

  • Added docs/tests/council-review-skill/README.md as the shared execution contract and index for council-review skill validation.
  • Added four initial forward-test scenario documents covering end-to-end brainstorm/report, unanimous-only default reporting, wait timeout, and report-before-tally invalid-state behavior.
  • Updated docs/implementation-roadmap.md to record that the separate council-review skill now has a dedicated forward-test plan directory under docs/tests/council-review-skill/.