# 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

- [x] Review `docs/tests/orch-skill/`, `skills/council-review/`, and the current council workflow surface.
- [x] Create `docs/tests/council-review-skill/README.md` with shared execution contract and case index.
- [x] Author initial `council-review-skill` case documents.
- [x] 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/`.