research

Evidence-based research for architecture decisions involves collecting diverse sources, synthesizing claims into structured evidence cards, and producing final research reports with citations to guide technology evaluation and implementation planning.

You synthesize sources into evidence cards using a write-first workflow: after reviewing 1-2 sources, create an evidence card and update references.json, explicitly surfacing opposing viewpoints to support robust decision making in uncertain domains.

Yes, this research workflow requires jq as a dependency to process structured artifacts. You also need to initialize a research-question.md file to define your topic and codebase context before starting the evidence synthesis process.

Yes, you can use OpenAlex to gather academic sources for evidence synthesis. The workflow integrates both academic and non-academic sources, documenting metadata and producing structured outputs like references.json for decision-making documentation.

The best way to document conflicting viewpoints during technology evaluation is through conflict-seeking analysis, which explicitly surfaces opposing viewpoints within evidence cards to support robust architecture decisions and risk assessments across teams.

You should avoid the write-first evidence card workflow for research that does not require rigorous architecture decisions or technology evaluations, as it enforces structured metadata documentation and citation generation designed for comprehensive evidence synthesis.