chorus-proposal-reviewer

Reviews Chorus proposals against originating ideas and posts structured VERDICT comments via MCP.

1.2k|104|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/Chorus-AIDLC/Chorus --skill chorus-proposal-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chorus-proposal-reviewer
Source: https://github.com/Chorus-AIDLC/Chorus/tree/main/plugins/chorus/skills/chorus-proposal-reviewer
Command: npx skills add https://github.com/Chorus-AIDLC/Chorus --skill chorus-proposal-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

LLM-generated project proposals often look well-structured but contain hidden gaps: missing requirements, vague acceptance criteria, wrong task dependencies, or hallucinated technical details. This Skill performs an adversarial, read-only audit of a Chorus proposal so human reviewers get a concrete, evidence-based verdict instead of rubber-stamping.

Core Features & Use Cases

  • Full proposal audit: Fetches the proposal, its comments, the originating idea, and its elaboration via Chorus MCP tools, then checks PRD completeness, specificity, feasibility, and module contracts.
  • Task DAG validation: Verifies task granularity, acceptance-criteria quality, requirement-to-task coverage, and dependency correctness (missing or circular edges).
  • Structured verdict output: Classifies findings as BLOCKER or NOTE and posts exactly one grep-able verdict comment (VERDICT: PASS, VERDICT: PASS WITH NOTES, or VERDICT: FAIL) via chorus_add_comment.
  • Use Case: A PM agent drafts a proposal for a new feature. Spawn this reviewer with the proposal UUID; it cross-references every requirement against task ACs and posts a FAIL verdict with evidence when it finds an uncovered requirement.

Quick Start

Ask the agent to review proposal <proposal-uuid> with at most 3 review rounds and post its VERDICT comment.

Frequently Asked Questions about chorus-proposal-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a Chorus proposal automatically?

Invoke the skill via spawn_agent with the skill path chorus:chorus-proposal-reviewer and a text item containing the proposal UUID and max review rounds. The reviewer fetches the proposal, audits it, and posts one VERDICT comment.

What does the Chorus proposal reviewer check in a PRD?

It checks completeness (functional, non-functional, error and edge cases), specificity of requirements, technical feasibility, module contracts, hallucinated external details like API signatures, and conflicts with project rules in files like CLAUDE.md or AGENTS.md.

Can the proposal reviewer modify files or run commands?

No. The reviewer is strictly read-only: it cannot create, modify, or delete files, and Bash is disabled by the sandbox. Its only write action is posting a review comment through chorus_add_comment.

What verdicts does the Chorus reviewer output?

It ends with exactly one of three literal strings: VERDICT: PASS, VERDICT: PASS WITH NOTES, or VERDICT: FAIL. Findings classified as BLOCKER produce FAIL, NOTE-only findings produce PASS WITH NOTES, and automation greps for these exact strings.

How does round 2 proposal review differ from round 1?

In round 2 and later, the reviewer focuses only on whether previous BLOCKER findings were fixed. It does not introduce new NOTE items, keeping re-reviews scoped to the blocking issues.