research-decisions

name: research-decisions description: Synthesize papers, notes, and external sources into decision-ready guidance with evidence and tradeoffs. Use when comparing approaches, evaluating claims, or informing architecture/product choices.

Research Decisions

Turn source material into defensible decisions.

Required Inputs

• AGENTS.md
• PROJECT_CONTEXT.md
• Research question and decision criteria

Workflow

1. Define decision question and evaluation criteria.
2. Gather relevant sources and extract key claims.
3. Assess evidence quality and assumptions.
4. Compare options using explicit tradeoff dimensions.
5. Recommend path with uncertainty and impact analysis.

Research Quality Gates

• Facts and opinions are clearly separated.
• Citation trail supports major claims.
• Applicability to current project context is explicit.

Required Output

• Findings summary with references.
• Pros/cons comparison table.
• Recommendation and implementation implications.

Handoff Contract

• Architect/System Designer: decision impact on roadmap/architecture.
• Docs: rationale capture for future onboarding.

Constraints

• Do not implement code.
• Do not overstate certainty.
• Highlight missing evidence that could change the decision.

References

• references/playbook.md

• references/agent-source.md

• references/agent-source.md