ai-workflow-skill/skills/council-review/SKILL.md

name, description

name	description
council-review	Structured three-reviewer brainstorming and review through a bundled orch CLI. Use when an agent needs a high-level council workflow on top of orch to launch reviewer roles, wait for their outputs, tally grouped recommendations, and report consensus, majority, and minority findings.

Council Review

Use the bundled ./assets/orch CLI to run the high-level orch council ... workflow.

Quick Start

• Invoke ./assets/orch relative to this skill directory.
• Pass --db explicitly for every command.
• Prefer --json whenever another agent or script will read the output.
• Treat this skill as a high-level workflow on top of orch, not as a separate infrastructure layer.

Reviewer Roles

• architecture-reviewer
• implementation-reviewer
• risk-reviewer

Rules

• Use this skill when the user explicitly wants a multi-reviewer brainstorm or review.
• Treat the workflow as analysis-first unless the user explicitly asks for patch proposals or code-change recommendations.
• Use orch council as the execution surface for start, wait, tally, and report.
• Default to the fixed reviewer roles architecture, implementation, and risk.
• Collect all three reviewer outputs before tallying.
• Use normal similarity unless the user asks for stricter grouping.
• If the user asks for unanimous-only output, rely on --only-unanimous and expect default report output to show only consensus.
• Otherwise present consensus first, then majority, and include minority when requested.
• Support text, repository, mixed, or task-target context when available.

Typical Commands

./assets/orch --db ./coord.db --json council start --run council_blog_001 --target-file brief.md --target-type mixed --mode brainstorm --output both
./assets/orch --db ./coord.db --json council wait --run council_blog_001 --timeout-seconds 900
./assets/orch --db ./coord.db --json council tally --run council_blog_001 --similarity normal
./assets/orch --db ./coord.db --json council report --run council_blog_001 --show consensus,majority

Command Map

• council start: create the council run and dispatch the three reviewer tasks
• council wait: block until all reviewers finish or timeout is reached
• council tally: parse reviewer outputs, group similar findings, and count support
• council report: render the final grouped council output and persist report metadata

Notes

• This skill depends on the underlying orch orchestration model and persists its run state, grouped findings, and report metadata there.
• Use council wait before council tally, and council tally before council report.
• council report defaults to consensus,majority, except unanimous-only runs where the default is consensus.
• If the bundled binary cannot execute on the current host, stop and report the compatibility issue instead of guessing a replacement path or workflow.