Add council-review skill test plan docs

2026-03-19 17:25:40 +08:00
parent 8b26815d53
commit 0b533a70f9
7 changed files with 584 additions and 0 deletions
@@ -0,0 +1,63 @@
+# 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/`.