Synopsis
aigon research-eval <ID> [--force]Shortcuts
/are(slash command) ·aigon are(CLI)
Flags
| Flag | Description |
|---|---|
--force | Re-run evaluation even if the topic is already in 04-in-evaluation/ |
Description
research-eval is the synthesis step that turns raw agent findings into actionable feature recommendations. It transitions the research topic to 04-in-evaluation/, reads all per-agent findings files, and produces a consolidated view: what agents agreed on, where they diverged, and a deduplicated feature table ranked by priority and consensus strength.
Unlike feature-eval, this command does not pick a single winner — it merges insights from all agents. The evaluator presents a consolidated feature table and asks the user which features to create, then stops. The user decides what to promote; research-eval never creates features automatically.
For unbiased synthesis, use a different model than those that conducted the research.
What it does
- Transitions the spec from
03-in-progress/to04-in-evaluation/(skipped if already there; use--forceto re-evaluate) - Reads all findings files:
docs/specs/research-topics/logs/research-{ID}-*-findings.md - Produces a Consensus section — what all agents agreed on
- Produces a Divergent Views section — where agents disagreed and why
- Consolidates the
## Suggested Featurestables across all findings, deduplicating by concept - Presents the merged feature table and asks the user which features to create
- Stops — does not close the topic or create features automatically
Examples
# Evaluate after all agents have submitted findings
aigon research-eval 5
# Re-run evaluation (topic already in 04-in-evaluation/)
aigon research-eval 5 --force
# Use a different model for unbiased synthesis
# (Start a fresh Claude session with Sonnet before running)
/aigon:research-eval 5After evaluation
After presenting the feature table and getting user confirmation, the typical next step is to create features for selected items, then close:
aigon feature-create <selected-feature-name>
# ... create more features as needed ...
aigon research-close 5Related
research-do— agents write findings (runs before eval)research-submit— Fleet agents signal completion before eval is triggeredresearch-close— archive the topic after evaluation is doneresearch-autopilot— runs research-start + research-eval automatically- Research Workflow guide