Software Research · {{MODE}} · v2 (verified)

{{TOPIC_TITLE}}

A multi-lens engineering synthesis. Every claim independently checked against its primary source — version-aware — before publication.

Date  {{DATE}} Method  {{N_LENSES}} expert lenses ({{MODE}}) + contradiction map Audience  {{AUDIENCE: the reader's role, default tech-lead; omit this span if none given}}
Verified All {{N}} citations independently checked against primary sources on {{DATE}}. Result: {{X}} corrected, {{Y}} demoted, {{Z}} version-stale. Confidence = source-tier evidence quality.
Recommendation
{{RECOMMENDATION: the pick, in 1-4 words}}
{{one-line why}}
Confidence
{{SCORE}}/10
{{based on source tier}}
Top risk
{{TOP_RISK: 1-4 words}}
{{one-line why it matters}}
Decide by
{{THE ONE CHECK: what settles it, or "Ready"}}
{{what to test / confirm first}}

How to read this

  • The lens panel is author-constructed. Where lenses agree, treat it as a strong hypothesis, not field consensus.
  • Confidence is scored 1-10 on source tier: primary docs/specs > security DBs (OSV/GHSA) > registries > reproducible benchmarks > sentiment surveys.
  • Every claim is version-bound. A high score means the fact is verified for the stated version, not that it is the right choice for you.

Version currency: verified against {{VERSIONS_CHECKED}} as of {{DATE}}.

01

Bottom Line

{{SUMMARY: 3-5 short sentences a busy tech-lead reads in under a minute. Plain words. Lead with the recommendation + the verified fact it rests on, then the main trade-off, then the key risk. Bold the single most important sentence.}}

01b

Side-by-Side

Criterion{{OPTION_A}}{{OPTION_B}}
{{CRITERION}}{{A verdict}} {{T1-3}}{{B verdict}} {{T1-3}}
02

Key Findings, Ranked by Reliability

{{FINDING_TITLE}}
{{N}}
Reliability: {{RELIABILITY_LABEL}}
{{SCORE}}/10

{{FINDING_BODY: plain and direct — what it says, the evidence, and the verified caveat that caps the score. Short sentences; define any term inline. Bold any correction made during verification.}}

Supported by{{WHICH LENSES + the actual primary source}}
Challenged by{{WHICH LENSES disagree, or "No one"}}
Corrected{{what changed after primary-source check; delete if nothing changed}}
Contested signal · monitor, do not assert · confidence {{SCORE}}/10

{{CLAIM_TITLE}}

{{Why it is contested: the critique, the counter-evidence, the source. Tell the reader not to state it as fact.}}

03

Why The Findings Seem To Conflict

{{Name the two findings that look like they clash.}}

{{Explain what actually connects them — the link only visible across all the lenses.}}

{{The one-sentence takeaway. If it leans on a weak finding, say so in parentheses.}}

What We Assumed / What We Didn't Check

{{What the lenses took as fixed. Name the one perspective that would change the conclusions, not just add nuance.}}

{{The one gap that could flip the findings. Keep it in mind when you build.}}

04

What To Actually Do Differently

{{Who this is for + framing: specific moves, not principles.}}

{{NN}}
{{The move in a sentence.}}

{{Why + exactly how, tied to a finding.}}

04b

What You Can / Can't Say Confidently

✓ Safe — verified against primary source

  • {{Claims confirmed by official/primary sources, safe to state flatly.}}

⚠ Say with a caveat

  • {{Claims that need attribution or qualification.}}

✕ Don't assert

  • {{Contested, version-stale, or unverifiable claims. Name them so they don't slip back in.}}
05

The One Thing To Resolve Next

{{The one question that would change everything if answered.}}

{{Why it matters: what it threatens, why no lens addressed it, what answering it unlocks.}}

06

Landscape & Current State

{{The specific players / versions / patterns in play as of the research date. Name them. State what is current vs deprecated and the version where it changed. Not "the ecosystem is mature" — the actual state.}}

07

How To Actually Do It

{{The practical core — win or lose "practical" here. Real setup steps, commands, config, minimal code, file layout, env vars. Show the actual path, not "an overview of implementation." Use a code-compare / annotated-diagram / deployment-pipeline widget where it helps.}}

08

Stack & Tooling Detail

{{Exact languages / frameworks / versions / tools, and WHY each fits the reader's case. Pin versions. A comparison-matrix widget fits here.}}

09

Integration & Interoperability

{{How it connects to what the reader ALREADY runs: APIs, protocols, data formats, compatibility windows. Cite the compat matrix / version-support window. c4-container-view or sequence-flow widget if a picture helps.}}

10

Performance & Scalability

{{Real numbers with disclosed methodology; the scaling model and where it saturates; the reader's expected load vs that ceiling. Not "scales well." Use metric-bars / range-bar / capacity-scaling-curve.}}

11

Security & Compliance

{{Concrete: specific CVEs/GHSA + affected/patched versions, the SPDX license + obligations, the attack surface, the hardening steps. Use the severity-summary widget.}}

12

Recommendation, For Your Situation

{{The decision and why, referencing the reader's stack / team size / scale / constraints BY NAME. State what you'd NOT do and why. weighted-decision-matrix or verdict-card widget.}}

13

Roadmap

{{Phased, estimable steps (effort S/M/L, sequence, what unblocks what) — concrete enough to hand to the team on Monday. phasing-roadmap or migration-checklist widget.}}

14

Risks & Mitigations

{{Named risks with likelihood/impact and a SPECIFIC mitigation each; the rollback / exit path. No "there are risks" — enumerate them. risk-heatmap widget.}}

15

How This Was Verified

{{How claims were checked; the verification tally (N checked / X corrected / Y demoted / Z version-stale); confidence by source tier. The evidence-confidence widget fits here.}}

References · sources & verification status