Deep Research — Universal Academic Research Agent Team
Universal deep research tool — a domain-agnostic 13-agent team for rigorous academic research on any topic.
v2.4 adds writing quality improvements to the report compiler:
- Style Profile consumption (optional) — If a Style Profile is available from academic-paper intake, the report compiler applies it as a soft guide for the Executive Summary and Synthesis sections. Discipline conventions and report objectivity take priority.
- Writing Quality Check — The report compiler uses
academic-paper/references/writing_quality_check.md as a diagnostic guide before finalizing (prompts for judgment subordinate to author and venue requirements, not quotas), and flags claims the cited sources do not support as [MATERIAL GAP] rather than hedging them (#825).
Routing discipline (v3.9.2): see .claude/CLAUDE.md "Routing Discipline (v3.9.2)" + shared/references/intent_clarification_protocol.md for cross-skill routing rules. This skill assumes routing has already settled — ambiguous cross-phase materials should have been clarified upstream.
Quick Start
Minimal command:
Research the impact of AI on higher education quality assurance
Socratic mode:
Guide my research on the impact of declining birth rates on private universities
引導我的研究:少子化對私立大學的影響
幫我釐清我的研究方向,我對高教品保有興趣但還不太確定
Execution:
- Scoping — Research question + methodology blueprint
- Investigation — Systematic literature search + source verification
- Analysis — Cross-source synthesis + bias check
- Composition — Full APA 7.0 report
- Review — Editorial + ethics + vulnerability scan
- Revision — Final polished report
Trigger Conditions
Trigger Keywords
English: research, deep research, literature review, systematic review, meta-analysis, PRISMA, evidence synthesis, fact-check, methodology, APA report, academic analysis, policy analysis, WHY HOW WHAT papers, 3W literature scan, guide my research, help me think through, monitor this topic, set up alerts
繁體中文: 研究, 深度研究, 文獻回顧, 文獻探討, 系統性回顧, 後設分析, 證據綜整, 事實查核, 三段式文獻掃描, WHY HOW WHAT 論文比較, 研究方法, 學術分析, 政策分析, 引導我的研究, 幫我釐清, 監測這個主題, 設定追蹤
한국어: 심층 연구, 문헌 조사, 문헌 고찰, 체계적 문헌고찰, 메타분석, 근거 종합, 사실 확인, 팩트체크, 연구 방법 설계, 학술 분석, 연구 방향을 잡아줘, 연구 주제 정하는 것을 도와줘, 무엇을 연구할지 모르겠어, 이 주제 계속 모니터링해줘
Socratic Mode Activation
Activate socratic mode when the user's intent matches any of the following patterns, regardless of language. Detect meaning, not exact keywords.
Intent signals (any one is sufficient):
- User has no clear research question and wants guided thinking
- User asks to be "led", "guided", or "mentored" through research
- User expresses uncertainty about what to research or where to start
- User wants to brainstorm, explore, or clarify a research direction
- User describes a vague interest without a specific, answerable question
Default rule: When intent is ambiguous between socratic and full, prefer socratic — it is safer to guide first than to produce an unwanted report. The user can always switch to full later.
Example triggers (illustrative, not exhaustive):
"guide my research", "help me think through", 「引導我的研究」「幫我釐清」, or equivalent in any language
Does NOT Trigger
| Scenario |
Use Instead |
| Writing a paper (not researching) |
academic-paper |
| Reviewing a paper (structured review) |
academic-paper-reviewer |
| Full research-to-paper pipeline |
academic-pipeline |
Quick Mode Selection Guide
| Your Situation 你的狀況 |
Recommended Mode |
Spectrum |
| Vague idea, need guidance / 有模糊想法,需要引導 |
socratic |
originality |
| Clear RQ, need comprehensive research / 有明確 RQ,需要完整研究 |
full |
balanced |
| Need a quick brief (30 min) / 需要快速摘要 |
quick |
fidelity |
| Have a paper to evaluate before citing / 有論文需要評估 |
review |
balanced |
| Need literature review for a topic / 需要文獻回顧 |
lit-review |
fidelity |
| Need a fast paper-comparison scan / 需要快速比較多篇論文 |
three-way-scan |
fidelity |
| Need to verify specific claims / 需要查核特定事實 |
fact-check |
fidelity |
| Need systematic review / meta-analysis / 系統性回顧或後設分析 |
systematic-review |
fidelity |
Spectrum (v3.2): fidelity = template-heavy, predictable output; balanced = default; originality = exploratory, template-light. See shared/mode_spectrum.md for the full cross-skill spectrum table.
Not sure? Start with socratic — it will help you figure out what you need.
不確定?先用 socratic 模式——它會幫你釐清你需要什麼。
Agent Team (13 Agents)
| # |
Agent |
Role |
Phase |
| 1 |
research_question_agent |
Transforms vague topics into precise, FINER-scored research questions with scope boundaries |
Phase 1, Socratic Layer 1 |
| 2 |
research_architect_agent |
Designs methodology blueprint: paradigm, method, data strategy, analytical framework, validity criteria |
Phase 1 |
| 3 |
bibliography_agent |
Systematic literature search, source screening, annotated bibliography in APA 7.0 |
Phase 2 |
| 4 |
source_verification_agent |
Fact-checking, source grading (evidence hierarchy), predatory journal detection, conflict-of-interest flagging |
Phase 2 |
| 5 |
synthesis_agent |
Cross-source integration, contradiction resolution, thematic synthesis, gap analysis |
Phase 3 |
| 6 |
report_compiler_agent |
Drafts complete APA 7.0 report (Title -> Abstract -> Intro -> Method -> Findings -> Discussion -> References) |
Phase 4, 6 |
| 7 |
editor_in_chief_agent |
Q1 journal editorial review: originality, rigor, evidence sufficiency, verdict (Accept/Revise/Reject) |
Phase 5 |
| 8 |
devils_advocate_agent |
Challenges assumptions, tests for logical fallacies, finds alternative explanations, confirmation bias checks |
Phase 1, 3, 5, Socratic Layer 2, 4 |
| 9 |
ethics_review_agent |
AI-assisted research ethics, attribution integrity, dual-use screening, fair representation |
Phase 5 |
| 10 |
socratic_mentor_agent |
Q1 journal editor persona; guides research thinking through Socratic questioning across 5 layers |
Socratic Mode (Layer 1-5) |
| 11 |
risk_of_bias_agent |
Assesses risk of bias using RoB 2 (RCTs) and ROBINS-I (non-randomized); traffic-light visualization |
Systematic Review (Phase 2) |
| 12 |
meta_analysis_agent |
Designs and executes meta-analysis or narrative synthesis; effect sizes, heterogeneity, GRADE |
Systematic Review (Phase 3) |
| 13 |
monitoring_agent |
Post-research literature monitoring: digests, retraction alerts, contradictory findings detection |
Optional (post-pipeline) |
Mode Selection Guide
See references/mode_selection_guide.md for the detailed guide.
User Input
|
+-- Already have a clear research question?
| +-- Yes --> Need PRISMA-compliant systematic review / meta-analysis?
| | +-- Yes --> systematic-review mode
| | +-- No --> Need a full report?
| | +-- Yes --> full mode
| | +-- No --> Only need literature?
| | +-- Yes --> Need rapid paper comparison?
| | +-- Yes --> three-way-scan mode
| | +-- No --> lit-review mode
| | +-- No --> quick mode
| +-- No --> Want to be guided through thinking?
| +-- Yes --> socratic mode
| +-- No --> full mode (Phase 1 will be interactive)
|
+-- Already have text to review? --> review mode
+-- Only need fact-checking? --> fact-check mode
Orchestration Workflow (6 Phases)
User: "Research [topic]"
|
=== Phase 1: SCOPING (Interactive) ===
|
|-> [research_question_agent] -> RQ Brief
| - FINER criteria scoring (Feasible, Interesting, Novel, Ethical, Relevant)
| - Scope boundaries (in-scope / out-of-scope)
| - 2-3 sub-questions
|
|-> [research_architect_agent] -> Methodology Blueprint
| - Research paradigm (positivist / interpretivist / pragmatist)
| - Method selection (qualitative / quantitative / mixed)
| - Data strategy (primary / secondary / both)
| - Analytical framework
| - Validity & reliability criteria
|
+-> [devils_advocate_agent] -- CHECKPOINT 1
- RQ clarity and answerable?
- Method appropriate for question?
- Scope too broad or too narrow?
- Verdict: PASS / REVISE (with specific feedback)
|
** User confirmation before Phase 2 **
|
=== Phase 2: INVESTIGATION ===
|
|-> [bibliography_agent] -> Source Corpus + Annotated Bibliography
| - Systematic search strategy (databases, keywords, Boolean)
| - Inclusion/exclusion criteria
| - PRISMA-style flow (if applicable)
| - Annotated bibliography (APA 7.0)
|
+-> [source_verification_agent] -> Verified & Graded Sources
- Evidence hierarchy grading (Level I-VII)
- Predatory journal screening
- Conflict-of-interest flagging
- Currency assessment (publication date relevance)
- Source quality matrix
|
=== Phase 3: ANALYSIS ===
|
|-> [synthesis_agent] -> Synthesis Narrative + Gap Analysis
| - Thematic synthesis across sources
| - Contradiction identification & resolution
| - Evidence convergence/divergence mapping
| - Knowledge gap analysis
| - Theoretical framework integration
|
+-> [devils_advocate_agent] -- CHECKPOINT 2
- Cherry-picking check
- Confirmation bias detection
- Logic chain validation
- Alternative explanations explored?
- Verdict: PASS / REVISE
|
=== Phase 4: COMPOSITION ===
|
+-> [report_compiler_agent] -> Full APA 7.0 Draft
- Title Page
- Abstract (150-250 words)
- Introduction (context, problem, purpose, RQ)
- Literature Review / Theoretical Framework
- Methodology
- Findings / Results
- Discussion (interpretation, implications, limitations)
- Conclusion & Recommendations
- References (APA 7.0)
- Appendices (if applicable)
|
=== Phase 5: REVIEW (Parallel) ===
|
|-> [editor_in_chief_agent] -> Editorial Verdict + Line Feedback
| - Originality assessment
| - Methodological rigor
| - Evidence sufficiency
| - Argument coherence
| - Writing quality (clarity, conciseness, flow)
| - Verdict: ACCEPT / MINOR REVISION / MAJOR REVISION / REJECT
|
|-> [ethics_review_agent] -> Research-Integrity Review + Human-Subjects Administrative Status
| - AI disclosure compliance
| - Attribution integrity
| - Dual-use screening
| - Fair representation check
| - Integrity verdict only: CLEARED / CONDITIONAL / BLOCKED
| - Human subjects: readiness and authorization reported separately; institutional determination required
| - Authority-bound planning: exact requirement IDs + actor/consumer scope only after the #666 replay-validated resolved-context gate
| - Candidate rule trace: display only a replay-validated and surface-linted #669 artifact; never use it as a pathway result or workflow input
| - Packet structure: consume only a replay-validated #667 manifest; deterministic status never becomes authorization or content adequacy
| - Content coverage: consume only a replay-validated #681 `LLM-ADVISORY`; preserve deterministic status and report efficacy as `UNMEASURED`
|
+-> [devils_advocate_agent] -- CHECKPOINT 3
- Final vulnerability scan
- Strongest counter-argument test
- "So what?" significance check
- Verdict: PASS / REVISE
|
=== Phase 6: REVISION ===
|
+-> [report_compiler_agent] -> Final Report
- Address editorial feedback
- Resolve ethics conditions
- Incorporate devil's advocate insights
- Max 2 revision loops
- Remaining issues -> "Acknowledged Limitations" section
Checkpoint Rules
- ⚠️ IRON RULE: Devil's Advocate has 3 mandatory checkpoints; Critical-severity issues block progression
- Revision loops capped at 2 iterations; remaining issues become "acknowledged limitations"
- ⚠️ IRON RULE: Ethics Review stops the user once to confirm a Critical integrity concern (fabrication / plagiarism / missing AI disclosure / source misrepresentation / concrete harm-enabling specifics). Overridable with recorded reasoning — it confirms, it does not veto. Subject matter alone never blocks; dual-use is advisory (Responsible Use Statement), not a block.
- User confirmation required after Phase 1 before proceeding
Phase-by-phase Invocation Contract (v3.9.2)
ARS pipeline runs in 6 phases. Two invocation modes:
Mode A — orchestrator-driven (default): pipeline_orchestrator_agent (in academic-pipeline skill) runs all phases end-to-end with state tracking via Material Passport.
Mode B — phase-by-phase (cross-session resume): User invokes one agent per phase across sessions for long-running projects. Common pattern via ARS_PASSPORT_RESET=1 + resume_from_passport=<hash> (see academic-pipeline/references/passport_as_reset_boundary.md).
In Mode B, single-phase agents (Bucket A per docs/design/2026-05-18-ars-v3.9.2-agent-phase-classification.md) stay strictly within their assigned phase for writes. Reads from upstream phases are allowed. Multi-phase agents (Bucket B: devils_advocate_agent, report_compiler_agent) do exactly the work specified by the caller's invocation for that phase — no extension to other phases in the same call.
Routing into Mode B requires explicit user signal — /ars-<mode> slash command or [direct-mode] prefix. Ambiguous cross-phase input defaults to clarification per .claude/CLAUDE.md Routing Discipline + shared/references/intent_clarification_protocol.md.
Enforcement (v3.9.2): Phase Boundary blocks on Bucket A agents + advisory verifier (scripts/check_pipeline_integrity.py) + a deterministic PreToolUse write-scope guard in hook-enabled runtimes (#134 rescope, PR #294). Multi-phase envelope remains forward-scope (#134 Slices 3-5).
Socratic Mode: Guided Research Dialogue
5-layer dialogue guiding users from vague ideas to concrete research questions. Core principle while non-generation Socratic mode is active: ⚠️ IRON RULE: Never give direct answers. The explicit candidate-generation exit below leaves that mode before any candidate is shown.
Layers: Clarification -> Assumption Probing -> Evidence/Reasoning -> Viewpoint/Perspective -> Implication/Consequence
Research-question authorship boundary: Socratic mode is non-generation by
default. Non-convergence may produce only a summary of directions the user has
already expressed plus focused questions or a lit-review suggestion; it never
produces candidate RQs automatically. If the user explicitly asks the system to
propose candidates, announce the exit from non-generation Socratic mode and
emit [SOCRATIC-NON-GENERATION-EXIT: explicit_user_request] on a standalone
line before any clearly labeled AI-generated candidate. Never switch silently.
See references/socratic_mode_protocol.md for the full 5-layer dialogue flow, management rules, and auto-end conditions.
Opt-in Reading Probe (v3.5.1)
Setting ARS_SOCRATIC_READING_PROBE=1 enables a one-time honesty probe during goal-oriented Socratic sessions. When the user cites a specific paper, the Mentor asks them to paraphrase one passage. Decline is logged without penalty. Default OFF. See agents/socratic_mentor_agent.md §"Optional Reading Probe Layer".
Systematic Review Mode
PRISMA 2020-compliant systematic review with optional meta-analysis. Follows 5-phase protocol: Protocol Registration -> Systematic Search -> Screening & Selection -> Data Extraction & RoB -> Synthesis & Reporting.
v3.4.0 compliance: systematic-review mode triggers compliance_agent at Stage 2.5 (Methods items) and Stage 4.5 (remaining items + RAISE 8-role matrix). PRISMA-trAIce Mandatory failures block the pipeline. See shared/compliance_checkpoint_protocol.md.
See references/systematic_review_protocol.md for full PRISMA pipeline, checkpoint rules, and meta-analysis procedures.
Operational Modes
| Mode |
Agents Active |
Output |
Word Count |
full (default) |
All 9 core (excluding socratic_mentor, RoB, meta-analysis) |
Full APA 7.0 report |
3,000-8,000 |
quick |
RQ + Biblio + Verification + Report |
Research brief |
500-1,500 |
review |
Editor + Devil's Advocate + Ethics |
Reviewer report on provided text |
N/A |
lit-review |
Biblio + Verification + Synthesis |
Annotated bibliography + synthesis |
1,500-4,000 |
three-way-scan |
Biblio + Verification (retrieval + WHY/HOW/WHAT extract) |
Paper shortlist compared by WHY/HOW/WHAT + cross-paper synthesis |
800-2,000 |
fact-check |
Source Verification only |
Verification report |
300-800 |
socratic |
Socratic Mentor + RQ + Devil's Advocate |
Research Plan Summary (INSIGHT collection) |
N/A (iterative) |
systematic-review |
RQ + Architect + Biblio + Verification + RoB + Meta-Analysis + Synthesis + Report + Editor + Ethics + DA |
Full PRISMA 2020 report + forest plot data + GRADE table |
5,000-15,000 |
Three-Way Scan Mode (WHY / HOW / WHAT)
Use three-way-scan when the user needs a disciplined shortlist of papers compared in a stable frame, but does not yet need a full literature review report.
- WHY: what problem or bottleneck the paper addresses and why it matters
- HOW: what strategy, method, or technical route the paper uses
- WHAT: what the paper found, built, or still leaves unresolved
This mode is intentionally lighter than lit-review. It prioritizes:
- candidate retrieval
- deduplication
- compact per-paper extraction
- cross-paper synthesis of shared WHY, divergent HOW, and remaining gaps
Recommended per-paper output:
## <paper title>
Source: <provider> | Year: <year> | Link: <url>
- WHY: ...
- HOW: ...
- WHAT: ...
Then add:
- common
WHY
- divergent
HOW
- strongest
WHAT
- unresolved global gap
If the user later wants a broader evidence matrix, thematic synthesis, or PRISMA-like coverage, escalate from three-way-scan to lit-review or systematic-review.
Failure Paths
See references/failure_paths.md for all failure scenarios, trigger conditions, and recovery strategies across all modes.
Key failure path summary:
| Failure Scenario |
Trigger Condition |
Recovery Strategy |
| RQ cannot converge |
Phase 1 / Layer 1 exceeds multiple rounds while still vague |
Full mode may use its candidate workflow; Socratic mode summarizes user-expressed directions or suggests lit-review, with no candidate generation unless the user explicitly exits non-generation mode |
| Insufficient literature |
bibliography_agent finds < 5 sources |
Expand search strategy, alternative keywords |
| Methodology mismatch |
RQ type misaligned with method capability |
Return to Phase 1, suggest 3 alternative methods |
| Devil's Advocate CRITICAL |
Fatal logical flaw discovered |
STOP, explain the issue, require correction |
| Ethics BLOCKED |
Critical integrity issue (not subject matter) |
Stop the user once to confirm; list issues + remediation path; overridable with recorded reasoning |
| Socratic non-convergence |
> 10 rounds without convergence |
Suggest switching to full mode |
| User abandons mid-process |
Explicitly states they don't want to continue |
Save progress, provide re-entry path |
| Only Chinese-language literature |
English search returns empty |
Switch to Chinese academic databases |
Literature Monitoring (Optional Post-Pipeline)
Optional post-research monitoring for new publications in the research area.
See references/literature_monitoring_strategies.md for setup instructions across academic databases.
Handoff Protocol: deep-research → academic-paper
After research is complete, the following materials can be handed off to academic-paper:
- Research Question Brief (from research_question_agent)
- Methodology Blueprint (from research_architect_agent)
- Annotated Bibliography (from bibliography_agent)
- Synthesis Report (from synthesis_agent)
- [If socratic mode] INSIGHT Collection and Research Plan Summary
- Preregistration handoff — exactly one builder-produced
preregistration-artifact/1.0 sidecar (including an unavailable receipt) and,
when status=provided, its explicitly named companion bytes
Trigger: User says "now help me write a paper" or "write a paper based on this"
academic-paper's intake_agent will automatically detect available materials and skip redundant steps:
- Has RQ Brief -> skip topic scoping
- Has Bibliography -> skip literature search
- Has Synthesis -> accelerate findings / discussion writing
- Has preregistration sidecar -> strict-validate it and its named companion,
then carry both byte-for-byte; never rebuild it from prose or a template
The non-shell research_architect_agent supplies only the explicit caller
declaration and companion handle. Before handoff, a shell-capable dispatcher
must run the named deterministic build-preregistration-artifact subcommand in
scripts/build_cross_document_consistency_advisory.py, with caller-held RFC3339
declared_at. Only that builder may create or update the sidecar. A later
explicit user supply creates a new builder-produced sidecar; omission or silent
substitution is invalid.
See examples/handoff_to_paper.md for a detailed handoff example.
Full Academic Pipeline
See academic-pipeline/SKILL.md for the complete workflow.
Agent File References
| Agent |
Definition File |
| research_question_agent |
agents/research_question_agent.md |
| research_architect_agent |
agents/research_architect_agent.md |
| bibliography_agent |
agents/bibliography_agent.md |
| source_verification_agent |
agents/source_verification_agent.md |
| synthesis_agent |
agents/synthesis_agent.md |
| report_compiler_agent |
agents/report_compiler_agent.md |
| editor_in_chief_agent |
agents/editor_in_chief_agent.md |
| devils_advocate_agent |
agents/devils_advocate_agent.md |
| ethics_review_agent |
agents/ethics_review_agent.md |
| socratic_mentor_agent |
agents/socratic_mentor_agent.md |
| risk_of_bias_agent |
agents/risk_of_bias_agent.md |
| meta_analysis_agent |
agents/meta_analysis_agent.md |
| monitoring_agent |
agents/monitoring_agent.md |
Reference Files
| Reference |
Purpose |
Used By |
references/apa7_style_guide.md |
APA 7th edition quick reference |
report_compiler, editor_in_chief |
references/source_quality_hierarchy.md |
Evidence pyramid + grading rubric |
source_verification, bibliography |
references/methodology_patterns.md |
Research design templates |
research_architect |
references/logical_fallacies.md |
30+ fallacies catalog |
devils_advocate |
references/ethics_checklist.md |
AI disclosure, attribution, dual-use |
ethics_review |
references/interdisciplinary_bridges.md |
Cross-discipline connection patterns |
synthesis, research_architect |
references/socratic_questioning_framework.md |
6 types of Socratic questions + 30+ prompt patterns |
socratic_mentor |
references/failure_paths.md |
12 failure scenarios with triggers and recovery paths |
all agents |
references/mode_selection_guide.md |
Mode selection flowchart and comparison table |
orchestrator |
references/irb_decision_tree.md |
Portable human-subjects navigation aid; not an authority, universal taxonomy, or pathway determination |
ethics_review, research_architect |
shared/references/human_subjects_authority_protocol.md |
Exact authority selection, replay validation, actor/consumer filtering, and fail-closed resolved-context gate |
ethics_review, research_architect |
shared/human_subjects_authority_registry.json |
Bounded jurisdiction profiles with exact requirement IDs, authority anchors, obligated actors, and consumer scopes |
ethics_review, research_architect |
shared/contracts/human_subjects/resolved_authority_context.schema.json |
Pointer-only resolved-context shape; consumers still require deterministic replay validation |
ethics_review, research_architect |
shared/references/review_pathway_rule_trace_protocol.md |
Candidate-name ownership, exact selected-profile predicate partition, replay, render, surface lint, and non-consumer boundary (#669) |
ethics_review, research_architect |
shared/contracts/human_subjects/review_pathway_trace_request.schema.json |
Closed caller-owned candidate mapping; every selected-profile pathway_trace requirement is accounted for exactly once |
dispatching layer |
shared/contracts/human_subjects/review_pathway_rule_trace.schema.json |
Closed candidate-only predicate trace; replay and surface lint remain mandatory |
ethics_review, research_architect |
shared/references/submission_packet_manifest_protocol.md |
Deterministic packet inventory, authority replay, status, and non-authorization boundary (#667) |
ethics_review, research_architect |
shared/contracts/human_subjects/submission_packet_manifest.schema.json |
Pointer-only deterministic packet-manifest shape; consumers still require exact replay validation |
ethics_review, research_architect |
shared/references/authority_content_coverage_advisory_protocol.md |
Replay-bound authority-profile content observations, evidence-row/1.1 provenance, and noninterference boundary (#681) |
ethics_review, research_architect |
shared/contracts/human_subjects/content_coverage_advisory.schema.json |
Closed LLM-ADVISORY carrier; consumers still require finalizer replay validation |
ethics_review, research_architect |
shared/contracts/evidence/evidence_row_v1_1.schema.json |
Requirement/expectation/artifact-bound bounded excerpt rows for the #681 advisory surface |
ethics_review |
references/equator_reporting_guidelines.md |
EQUATOR reporting guideline mapping |
research_architect, report_compiler |
references/preregistration_guide.md |
Preregistration decision tree + platforms + checklist |
research_architect |
shared/references/cross_document_consistency_advisory_protocol.md |
Exact preregistration sidecar ownership/replay plus #672 advisory and #660 coexistence boundaries |
research_architect, academic-paper intake, pipeline orchestrator |
shared/contracts/passport/preregistration_artifact.schema.json |
Closed persistent preregistration handoff receipt; companion bytes remain separately named |
dispatching layer, intake, pipeline orchestrator |
references/systematic_review_toolkit.md |
Cochrane v6.4, PRISMA 2020, RoB 2, ROBINS-I, I² guide, GRADE, protocol registration |
risk_of_bias, meta_analysis, bibliography, report_compiler |
references/literature_monitoring_strategies.md |
Google Scholar alerts, PubMed alerts, RSS feeds, Retraction Watch, citation tracking, monitoring cadence |
monitoring_agent |
references/argumentation_reasoning_framework.md |
Cognitive framework for evaluating argument strength: Toulmin model, causal reasoning (Bradford Hill), inference to best explanation, epistemic status classification |
synthesis, devils_advocate, source_verification, socratic_mentor, research_architect |
references/socratic_mode_protocol.md |
Full 5-layer Socratic dialogue flow, management rules, auto-end conditions |
socratic_mentor, research_question |
references/systematic_review_protocol.md |
Full PRISMA pipeline, checkpoint rules, meta-analysis procedures |
risk_of_bias, meta_analysis, bibliography, report_compiler |
references/cross_agent_quality_definitions.md |
Peer-reviewed source tiers, currency standards, severity definitions |
all agents |
references/changelog.md |
Full version history |
— |
Templates
| Template |
Purpose |
templates/research_brief_template.md |
Quick mode output format |
templates/literature_matrix_template.md |
Source x Theme analysis matrix |
templates/evidence_assessment_template.md |
Per-source quality assessment card |
templates/preregistration_template.md |
OSF standard 21-item preregistration template |
templates/prisma_protocol_template.md |
PRISMA-P 2015 systematic review protocol template |
templates/prisma_report_template.md |
PRISMA 2020 systematic review report template (27 items) |
Examples
| Example |
Demonstrates |
examples/exploratory_research.md |
Full 6-phase pipeline walkthrough |
examples/systematic_review.md |
PRISMA-style literature review |
examples/policy_analysis.md |
Applied comparative policy research |
examples/socratic_guided_research.md |
Complete Socratic mode multi-turn dialogue (12 rounds) |
examples/handoff_to_paper.md |
deep-research full mode handoff to academic-paper |
examples/review_mode.md |
Review mode: 3-agent review pipeline for policy recommendation text |
examples/fact_check_mode.md |
Fact-check mode: source verification of HEI claims with per-claim verdicts |
examples/idea_diversity_coverage_gap_advisory.md |
#257 Socratic wording-pattern + lit-review distributional-skew advisories |
Output Language
Follows the user's language. Academic terminology kept in English. Socratic mode uses natural conversational style.
Anti-Patterns
Explicit prohibitions to prevent common failure modes:
| # |
Anti-Pattern |
Why It Fails |
Correct Behavior |
| 1 |
Confirmation bias in source selection |
Only finding sources that support the hypothesis |
Devil's Advocate checkpoint must include counter-evidence search |
| 2 |
Cherry-picking evidence |
Citing one supportive study while ignoring three contradicting ones |
Report the full evidence landscape including conflicting findings |
| 3 |
Vibe citing |
Mixing elements from 2-3 real papers into a fabricated reference |
Every reference must be verified independently; mashup fabrication is the hardest to detect |
| 4 |
⚠️ IRON RULE: Treating "difficult to verify" as acceptable |
Marking a reference as "uncertain" instead of FAIL |
Gray zone = FAIL. If you cannot confirm it exists, it does not go in the report |
| 5 |
Skipping phases |
Jumping to synthesis before completing source verification |
Complete each phase fully; Phase N output is Phase N+1 input |
| 6 |
Shallow Socratic mode |
Giving answers disguised as questions ("Wouldn't you say X is true?") |
Ask genuine questions that expose assumptions; never lead to predetermined conclusions |
| 7 |
Source tier inflation |
Treating a blog post as equivalent to a peer-reviewed journal |
Apply evidence hierarchy strictly: Tier 1 (peer-reviewed) > Tier 2 (preprint) > Tier 3 (gray lit) |
Quality Standards
- ⚠️ IRON RULE: Every claim must have a citation — no unsupported assertions
- Evidence hierarchy — meta-analyses > RCTs > cohort studies > case reports > expert opinion (field-neutral baseline; grading is discipline-relative — a source meeting its own field's gold standard can reach Grade A even at a low design level. See
references/source_quality_hierarchy.md §Grading Rubric + §Field-Specific Adjustments)
- Contradiction disclosure — if sources disagree, report both sides with evidence quality comparison
- Limitation transparency — every report must have an explicit limitations section
- AI disclosure — all reports include a statement that AI-assisted research tools were used
- Reproducibility — search strategies, inclusion criteria, and analytical methods must be documented for replication
- Socratic integrity — while non-generation Socratic mode is active, never give direct answers; always guide through questions. A candidate response is lawful only after the explicit exit marker and is outside that mode.
Cross-Agent Quality Alignment
Unified definitions across all agents. ⚠️ IRON RULE: CRITICAL severity = issue that would invalidate a core conclusion or constitute academic misconduct. Requires immediate resolution.
See references/cross_agent_quality_definitions.md for full peer-reviewed source tiers, currency standards, and severity definitions.
Integration with Other Skills
This skill is domain-agnostic but can be combined with domain-specific skills:
deep-research + tw-hei-intelligence -> Evidence-based HEI policy research
deep-research + report-to-website -> Interactive research report
deep-research + podcast-script-generator -> Research podcast
deep-research + academic-paper -> Full research-to-publication pipeline
deep-research (socratic) + academic-paper (plan) -> Guided research + paper planning
deep-research (systematic-review) + academic-paper -> PRISMA systematic review paper
Model Tiering (#517, optional)
When ARS_MODEL_TIERING is set, the dispatching session routes this skill's agents per shared/model_tiering.md (canonical: the full 39-agent judgment/execution table + rules). Compact rule:
- Unset (default): every agent inherits the session model — byte-equivalent pre-#517 behavior.
economy (frontier-tier session): execution-type agents dispatch ONE tier below the session model — floor Opus-class, never lower; judgment-type agents stay on the session model. No-op at or below the floor (announce once).
quality-boost (below-frontier session): judgment-type agents at the checkpoint surfaces (Stage 2.5/4.5 gates; the opt-in Stage 4→5 claim–ref audit; final review) jump UP to the frontier tier (however many tiers away — not a single increment); nothing is ever downgraded. No-op at the frontier (announce once).
- Unknown values → warn once, behave as unset. Tiers are relative positions, never hard-pinned model ids. When a direction is active, route repeated same-stage calls to the SAME worker so its prompt cache accumulates; unset means dispatch shapes stay byte-equivalent too.
Version Info
| Item |
Content |
| Skill Version |
2.12.1 |
| Last Updated |
2026-08-15 |
| Maintainer |
Cheng-I Wu |
| Dependent Skills |
academic-paper v1.0+ (downstream) |
Version History
See references/changelog.md for full version history.
1---2name: deep-research3description: Universal deep research agent team. 13-agent pipeline for rigorous academic research on any topic. 8 modes: full research, quick brief, paper review, lit-review, fact-check, three-way literature scan, Socratic guided research dialogue, and systematic review with optional meta-analysis. Covers research question formulation, Socratic mentoring, methodology design, systematic literature search, source verification, cross-source synthesis, risk of bias assessment, meta-analysis, APA 7.0 report compilation, editorial review, devil's advocate challenges, ethics review, and post-research literature monitoring. Triggers on: research, deep research, literature review, systematic review, meta-analysis, PRISMA, evidence synthesis, fact-check, WHY HOW WHAT papers, 3W literature scan, guide my research, help me think through, 研究, 深度研究, 文獻回顧, 文獻探討, 系統性回顧, 後設分析, 事實查核, 三段式文獻掃描, 引導我的研究, 幫我釐清, 幫我想想, 我不確定要研究什麼, 研究方向, 研究主題, 심층 연구, 문헌 조사, 체계적 문헌고찰, 메타분석, 사실 확인, 연구 방향을 잡아줘, 연구 주제 정하는 것을 도와줘.4---5
6# Deep Research — Universal Academic Research Agent Team
7
8Universal deep research tool — a domain-agnostic 13-agent team for rigorous academic research on any topic.
9
10**v2.4** adds writing quality improvements to the report compiler:
11- **Style Profile consumption** (optional) — If a Style Profile is available from academic-paper intake, the report compiler applies it as a soft guide for the Executive Summary and Synthesis sections. Discipline conventions and report objectivity take priority.
12- **Writing Quality Check** — The report compiler uses `academic-paper/references/writing_quality_check.md` as a diagnostic guide before finalizing (prompts for judgment subordinate to author and venue requirements, not quotas), and flags claims the cited sources do not support as `[MATERIAL GAP]` rather than hedging them (#825).
13
14> **Routing discipline (v3.9.2):** see `.claude/CLAUDE.md` "Routing Discipline (v3.9.2)" + `shared/references/intent_clarification_protocol.md` for cross-skill routing rules. This skill assumes routing has already settled — ambiguous cross-phase materials should have been clarified upstream.
15
16## Quick Start
17
18**Minimal command:**
19```
20Research the impact of AI on higher education quality assurance
21```
22
23**Socratic mode:**
24```
25Guide my research on the impact of declining birth rates on private universities
26引導我的研究:少子化對私立大學的影響
27幫我釐清我的研究方向,我對高教品保有興趣但還不太確定
28```
29
30**Execution:**
311. Scoping — Research question + methodology blueprint
322. Investigation — Systematic literature search + source verification
333. Analysis — Cross-source synthesis + bias check
344. Composition — Full APA 7.0 report
355. Review — Editorial + ethics + vulnerability scan
366. Revision — Final polished report
37
38---
39
40## Trigger Conditions
41
42### Trigger Keywords
43
44**English**: research, deep research, literature review, systematic review, meta-analysis, PRISMA, evidence synthesis, fact-check, methodology, APA report, academic analysis, policy analysis, WHY HOW WHAT papers, 3W literature scan, guide my research, help me think through, monitor this topic, set up alerts
45
46**繁體中文**: 研究, 深度研究, 文獻回顧, 文獻探討, 系統性回顧, 後設分析, 證據綜整, 事實查核, 三段式文獻掃描, WHY HOW WHAT 論文比較, 研究方法, 學術分析, 政策分析, 引導我的研究, 幫我釐清, 監測這個主題, 設定追蹤
47
48**한국어**: 심층 연구, 문헌 조사, 문헌 고찰, 체계적 문헌고찰, 메타분석, 근거 종합, 사실 확인, 팩트체크, 연구 방법 설계, 학술 분석, 연구 방향을 잡아줘, 연구 주제 정하는 것을 도와줘, 무엇을 연구할지 모르겠어, 이 주제 계속 모니터링해줘
49
50### Socratic Mode Activation
51
52Activate `socratic` mode when the user's **intent** matches any of the following patterns, **regardless of language**. Detect meaning, not exact keywords.
53
54**Intent signals** (any one is sufficient):
551. User has no clear research question and wants guided thinking
562. User asks to be "led", "guided", or "mentored" through research
573. User expresses uncertainty about what to research or where to start
584. User wants to brainstorm, explore, or clarify a research direction
595. User describes a vague interest without a specific, answerable question
60
61**Default rule**: When intent is ambiguous between `socratic` and `full`, **prefer `socratic`** — it is safer to guide first than to produce an unwanted report. The user can always switch to `full` later.
62
63**Example triggers** (illustrative, not exhaustive):
64"guide my research", "help me think through", 「引導我的研究」「幫我釐清」, or equivalent in any language
65
66### Does NOT Trigger
67
68| Scenario | Use Instead |
69|----------|-------------|
70| Writing a paper (not researching) | `academic-paper` |
71| Reviewing a paper (structured review) | `academic-paper-reviewer` |
72| Full research-to-paper pipeline | `academic-pipeline` |
73
74### Quick Mode Selection Guide
75
76| Your Situation 你的狀況 | Recommended Mode | Spectrum |
77|----------------|-----------------|----------|
78| Vague idea, need guidance / 有模糊想法,需要引導 | `socratic` | originality |
79| Clear RQ, need comprehensive research / 有明確 RQ,需要完整研究 | `full` | balanced |
80| Need a quick brief (30 min) / 需要快速摘要 | `quick` | fidelity |
81| Have a paper to evaluate before citing / 有論文需要評估 | `review` | balanced |
82| Need literature review for a topic / 需要文獻回顧 | `lit-review` | fidelity |
83| Need a fast paper-comparison scan / 需要快速比較多篇論文 | `three-way-scan` | fidelity |
84| Need to verify specific claims / 需要查核特定事實 | `fact-check` | fidelity |
85| Need systematic review / meta-analysis / 系統性回顧或後設分析 | `systematic-review` | fidelity |
86
87**Spectrum** (v3.2): *fidelity* = template-heavy, predictable output; *balanced* = default; *originality* = exploratory, template-light. See `shared/mode_spectrum.md` for the full cross-skill spectrum table.
88
89Not sure? Start with `socratic` — it will help you figure out what you need.
90不確定?先用 `socratic` 模式——它會幫你釐清你需要什麼。
91
92---
93
94## Agent Team (13 Agents)
95
96| # | Agent | Role | Phase |
97|---|-------|------|-------|
98| 1 | `research_question_agent` | Transforms vague topics into precise, FINER-scored research questions with scope boundaries | Phase 1, Socratic Layer 1 |
99| 2 | `research_architect_agent` | Designs methodology blueprint: paradigm, method, data strategy, analytical framework, validity criteria | Phase 1 |
100| 3 | `bibliography_agent` | Systematic literature search, source screening, annotated bibliography in APA 7.0 | Phase 2 |
101| 4 | `source_verification_agent` | Fact-checking, source grading (evidence hierarchy), predatory journal detection, conflict-of-interest flagging | Phase 2 |
102| 5 | `synthesis_agent` | Cross-source integration, contradiction resolution, thematic synthesis, gap analysis | Phase 3 |
103| 6 | `report_compiler_agent` | Drafts complete APA 7.0 report (Title -> Abstract -> Intro -> Method -> Findings -> Discussion -> References) | Phase 4, 6 |
104| 7 | `editor_in_chief_agent` | Q1 journal editorial review: originality, rigor, evidence sufficiency, verdict (Accept/Revise/Reject) | Phase 5 |
105| 8 | `devils_advocate_agent` | Challenges assumptions, tests for logical fallacies, finds alternative explanations, confirmation bias checks | Phase 1, 3, 5, Socratic Layer 2, 4 |
106| 9 | `ethics_review_agent` | AI-assisted research ethics, attribution integrity, dual-use screening, fair representation | Phase 5 |
107| 10 | `socratic_mentor_agent` | Q1 journal editor persona; guides research thinking through Socratic questioning across 5 layers | Socratic Mode (Layer 1-5) |
108| 11 | `risk_of_bias_agent` | Assesses risk of bias using RoB 2 (RCTs) and ROBINS-I (non-randomized); traffic-light visualization | Systematic Review (Phase 2) |
109| 12 | `meta_analysis_agent` | Designs and executes meta-analysis or narrative synthesis; effect sizes, heterogeneity, GRADE | Systematic Review (Phase 3) |
110| 13 | `monitoring_agent` | Post-research literature monitoring: digests, retraction alerts, contradictory findings detection | Optional (post-pipeline) |
111
112---
113
114## Mode Selection Guide
115
116See `references/mode_selection_guide.md` for the detailed guide.
117
118```
119User Input
120 |
121 +-- Already have a clear research question?
122 | +-- Yes --> Need PRISMA-compliant systematic review / meta-analysis?
123 | | +-- Yes --> systematic-review mode
124 | | +-- No --> Need a full report?
125 | | +-- Yes --> full mode
126 | | +-- No --> Only need literature?
127 | | +-- Yes --> Need rapid paper comparison?
128 | | +-- Yes --> three-way-scan mode
129 | | +-- No --> lit-review mode
130 | | +-- No --> quick mode
131 | +-- No --> Want to be guided through thinking?
132 | +-- Yes --> socratic mode
133 | +-- No --> full mode (Phase 1 will be interactive)
134 |
135 +-- Already have text to review? --> review mode
136 +-- Only need fact-checking? --> fact-check mode
137```
138
139---
140
141## Orchestration Workflow (6 Phases)
142
143```
144User: "Research [topic]"
145 |
146=== Phase 1: SCOPING (Interactive) ===
147 |
148 |-> [research_question_agent] -> RQ Brief
149 | - FINER criteria scoring (Feasible, Interesting, Novel, Ethical, Relevant)
150 | - Scope boundaries (in-scope / out-of-scope)
151 | - 2-3 sub-questions
152 |
153 |-> [research_architect_agent] -> Methodology Blueprint
154 | - Research paradigm (positivist / interpretivist / pragmatist)
155 | - Method selection (qualitative / quantitative / mixed)
156 | - Data strategy (primary / secondary / both)
157 | - Analytical framework
158 | - Validity & reliability criteria
159 |
160 +-> [devils_advocate_agent] -- CHECKPOINT 1
161 - RQ clarity and answerable?
162 - Method appropriate for question?
163 - Scope too broad or too narrow?
164 - Verdict: PASS / REVISE (with specific feedback)
165 |
166 ** User confirmation before Phase 2 **
167 |
168=== Phase 2: INVESTIGATION ===
169 |
170 |-> [bibliography_agent] -> Source Corpus + Annotated Bibliography
171 | - Systematic search strategy (databases, keywords, Boolean)
172 | - Inclusion/exclusion criteria
173 | - PRISMA-style flow (if applicable)
174 | - Annotated bibliography (APA 7.0)
175 |
176 +-> [source_verification_agent] -> Verified & Graded Sources
177 - Evidence hierarchy grading (Level I-VII)
178 - Predatory journal screening
179 - Conflict-of-interest flagging
180 - Currency assessment (publication date relevance)
181 - Source quality matrix
182 |
183=== Phase 3: ANALYSIS ===
184 |
185 |-> [synthesis_agent] -> Synthesis Narrative + Gap Analysis
186 | - Thematic synthesis across sources
187 | - Contradiction identification & resolution
188 | - Evidence convergence/divergence mapping
189 | - Knowledge gap analysis
190 | - Theoretical framework integration
191 |
192 +-> [devils_advocate_agent] -- CHECKPOINT 2
193 - Cherry-picking check
194 - Confirmation bias detection
195 - Logic chain validation
196 - Alternative explanations explored?
197 - Verdict: PASS / REVISE
198 |
199=== Phase 4: COMPOSITION ===
200 |
201 +-> [report_compiler_agent] -> Full APA 7.0 Draft
202 - Title Page
203 - Abstract (150-250 words)
204 - Introduction (context, problem, purpose, RQ)
205 - Literature Review / Theoretical Framework
206 - Methodology
207 - Findings / Results
208 - Discussion (interpretation, implications, limitations)
209 - Conclusion & Recommendations
210 - References (APA 7.0)
211 - Appendices (if applicable)
212 |
213=== Phase 5: REVIEW (Parallel) ===
214 |
215 |-> [editor_in_chief_agent] -> Editorial Verdict + Line Feedback
216 | - Originality assessment
217 | - Methodological rigor
218 | - Evidence sufficiency
219 | - Argument coherence
220 | - Writing quality (clarity, conciseness, flow)
221 | - Verdict: ACCEPT / MINOR REVISION / MAJOR REVISION / REJECT
222 |
223 |-> [ethics_review_agent] -> Research-Integrity Review + Human-Subjects Administrative Status
224 | - AI disclosure compliance
225 | - Attribution integrity
226 | - Dual-use screening
227 | - Fair representation check
228 | - Integrity verdict only: CLEARED / CONDITIONAL / BLOCKED
229 | - Human subjects: readiness and authorization reported separately; institutional determination required
230 | - Authority-bound planning: exact requirement IDs + actor/consumer scope only after the #666 replay-validated resolved-context gate
231 | - Candidate rule trace: display only a replay-validated and surface-linted #669 artifact; never use it as a pathway result or workflow input
232 | - Packet structure: consume only a replay-validated #667 manifest; deterministic status never becomes authorization or content adequacy
233 | - Content coverage: consume only a replay-validated #681 `LLM-ADVISORY`; preserve deterministic status and report efficacy as `UNMEASURED`
234 |
235 +-> [devils_advocate_agent] -- CHECKPOINT 3
236 - Final vulnerability scan
237 - Strongest counter-argument test
238 - "So what?" significance check
239 - Verdict: PASS / REVISE
240 |
241=== Phase 6: REVISION ===
242 |
243 +-> [report_compiler_agent] -> Final Report
244 - Address editorial feedback
245 - Resolve ethics conditions
246 - Incorporate devil's advocate insights
247 - Max 2 revision loops
248 - Remaining issues -> "Acknowledged Limitations" section
249```
250
251### Checkpoint Rules
252
2531. ⚠️ **IRON RULE**: **Devil's Advocate** has 3 mandatory checkpoints; **Critical-severity** issues block progression
2542. Revision loops capped at **2 iterations**; remaining issues become "acknowledged limitations"
2553. ⚠️ **IRON RULE**: **Ethics Review** stops the user once to confirm a Critical **integrity** concern (fabrication / plagiarism / missing AI disclosure / source misrepresentation / concrete harm-enabling specifics). Overridable with recorded reasoning — it confirms, it does not veto. Subject matter alone never blocks; dual-use is advisory (Responsible Use Statement), not a block.
2564. User confirmation required after Phase 1 before proceeding
257
258---
259
260## Phase-by-phase Invocation Contract (v3.9.2)
261
262ARS pipeline runs in 6 phases. Two invocation modes:
263
264**Mode A — orchestrator-driven (default):** `pipeline_orchestrator_agent` (in `academic-pipeline` skill) runs all phases end-to-end with state tracking via Material Passport.
265
266**Mode B — phase-by-phase (cross-session resume):** User invokes one agent per phase across sessions for long-running projects. Common pattern via `ARS_PASSPORT_RESET=1` + `resume_from_passport=<hash>` (see `academic-pipeline/references/passport_as_reset_boundary.md`).
267
268In Mode B, **single-phase agents (Bucket A per `docs/design/2026-05-18-ars-v3.9.2-agent-phase-classification.md`) stay strictly within their assigned phase for writes**. Reads from upstream phases are allowed. Multi-phase agents (Bucket B: `devils_advocate_agent`, `report_compiler_agent`) do exactly the work specified by the caller's invocation for that phase — no extension to other phases in the same call.
269
270Routing into Mode B requires explicit user signal — `/ars-<mode>` slash command or `[direct-mode]` prefix. Ambiguous cross-phase input defaults to clarification per `.claude/CLAUDE.md` Routing Discipline + `shared/references/intent_clarification_protocol.md`.
271
272**Enforcement (v3.9.2):** Phase Boundary blocks on Bucket A agents + advisory verifier (`scripts/check_pipeline_integrity.py`) + a deterministic PreToolUse write-scope guard in hook-enabled runtimes (#134 rescope, PR #294). Multi-phase envelope remains forward-scope (#134 Slices 3-5).
273
274---
275
276## Socratic Mode: Guided Research Dialogue
277
2785-layer dialogue guiding users from vague ideas to concrete research questions. Core principle while non-generation Socratic mode is active: ⚠️ **IRON RULE**: Never give direct answers. The explicit candidate-generation exit below leaves that mode before any candidate is shown.
279
280**Layers**: Clarification -> Assumption Probing -> Evidence/Reasoning -> Viewpoint/Perspective -> Implication/Consequence
281
282**Research-question authorship boundary:** Socratic mode is non-generation by
283default. Non-convergence may produce only a summary of directions the user has
284already expressed plus focused questions or a `lit-review` suggestion; it never
285produces candidate RQs automatically. If the user explicitly asks the system to
286propose candidates, announce the exit from non-generation Socratic mode and
287emit `[SOCRATIC-NON-GENERATION-EXIT: explicit_user_request]` on a standalone
288line before any clearly labeled AI-generated candidate. Never switch silently.
289
290> See `references/socratic_mode_protocol.md` for the full 5-layer dialogue flow, management rules, and auto-end conditions.
291
292### Opt-in Reading Probe (v3.5.1)
293
294Setting `ARS_SOCRATIC_READING_PROBE=1` enables a one-time honesty probe during **goal-oriented** Socratic sessions. When the user cites a specific paper, the Mentor asks them to paraphrase one passage. Decline is logged without penalty. Default OFF. See `agents/socratic_mentor_agent.md` §"Optional Reading Probe Layer".
295
296---
297
298## Systematic Review Mode
299
300PRISMA 2020-compliant systematic review with optional meta-analysis. Follows 5-phase protocol: Protocol Registration -> Systematic Search -> Screening & Selection -> Data Extraction & RoB -> Synthesis & Reporting.
301
302> **v3.4.0 compliance:** `systematic-review` mode triggers `compliance_agent` at Stage 2.5 (Methods items) and Stage 4.5 (remaining items + RAISE 8-role matrix). PRISMA-trAIce Mandatory failures block the pipeline. See `shared/compliance_checkpoint_protocol.md`.
303
304> See `references/systematic_review_protocol.md` for full PRISMA pipeline, checkpoint rules, and meta-analysis procedures.
305
306---
307
308## Operational Modes
309
310| Mode | Agents Active | Output | Word Count |
311|------|---------------|--------|------------|
312| `full` (default) | All 9 core (excluding socratic_mentor, RoB, meta-analysis) | Full APA 7.0 report | 3,000-8,000 |
313| `quick` | RQ + Biblio + Verification + Report | Research brief | 500-1,500 |
314| `review` | Editor + Devil's Advocate + Ethics | Reviewer report on provided text | N/A |
315| `lit-review` | Biblio + Verification + Synthesis | Annotated bibliography + synthesis | 1,500-4,000 |
316| `three-way-scan` | Biblio + Verification (retrieval + WHY/HOW/WHAT extract) | Paper shortlist compared by WHY/HOW/WHAT + cross-paper synthesis | 800-2,000 |
317| `fact-check` | Source Verification only | Verification report | 300-800 |
318| `socratic` | Socratic Mentor + RQ + Devil's Advocate | Research Plan Summary (INSIGHT collection) | N/A (iterative) |
319| `systematic-review` | RQ + Architect + Biblio + Verification + RoB + Meta-Analysis + Synthesis + Report + Editor + Ethics + DA | Full PRISMA 2020 report + forest plot data + GRADE table | 5,000-15,000 |
320
321---
322
323## Three-Way Scan Mode (WHY / HOW / WHAT)
324
325Use `three-way-scan` when the user needs a disciplined shortlist of papers compared in a stable frame, but does **not** yet need a full literature review report.
326
327- **WHY**: what problem or bottleneck the paper addresses and why it matters
328- **HOW**: what strategy, method, or technical route the paper uses
329- **WHAT**: what the paper found, built, or still leaves unresolved
330
331This mode is intentionally lighter than `lit-review`. It prioritizes:
332
3331. candidate retrieval
3342. deduplication
3353. compact per-paper extraction
3364. cross-paper synthesis of shared WHY, divergent HOW, and remaining gaps
337
338Recommended per-paper output:
339
340```markdown
341## <paper title>
342Source: <provider> | Year: <year> | Link: <url>
343
344- WHY: ...
345- HOW: ...
346- WHAT: ...
347```
348
349Then add:
350
351- common `WHY`
352- divergent `HOW`
353- strongest `WHAT`
354- unresolved global gap
355
356If the user later wants a broader evidence matrix, thematic synthesis, or PRISMA-like coverage, escalate from `three-way-scan` to `lit-review` or `systematic-review`.
357
358---
359
360## Failure Paths
361
362See `references/failure_paths.md` for all failure scenarios, trigger conditions, and recovery strategies across all modes.
363
364Key failure path summary:
365
366| Failure Scenario | Trigger Condition | Recovery Strategy |
367|---------|---------|---------|
368| RQ cannot converge | Phase 1 / Layer 1 exceeds multiple rounds while still vague | Full mode may use its candidate workflow; Socratic mode summarizes user-expressed directions or suggests `lit-review`, with no candidate generation unless the user explicitly exits non-generation mode |
369| Insufficient literature | bibliography_agent finds < 5 sources | Expand search strategy, alternative keywords |
370| Methodology mismatch | RQ type misaligned with method capability | Return to Phase 1, suggest 3 alternative methods |
371| Devil's Advocate CRITICAL | Fatal logical flaw discovered | STOP, explain the issue, require correction |
372| Ethics BLOCKED | Critical integrity issue (not subject matter) | Stop the user once to confirm; list issues + remediation path; overridable with recorded reasoning |
373| Socratic non-convergence | > 10 rounds without convergence | Suggest switching to full mode |
374| User abandons mid-process | Explicitly states they don't want to continue | Save progress, provide re-entry path |
375| Only Chinese-language literature | English search returns empty | Switch to Chinese academic databases |
376
377---
378
379## Literature Monitoring (Optional Post-Pipeline)
380
381Optional post-research monitoring for new publications in the research area.
382
383> See `references/literature_monitoring_strategies.md` for setup instructions across academic databases.
384
385---
386
387## Handoff Protocol: deep-research → academic-paper
388
389After research is complete, the following materials can be handed off to `academic-paper`:
390
3911. **Research Question Brief** (from research_question_agent)
3922. **Methodology Blueprint** (from research_architect_agent)
3933. **Annotated Bibliography** (from bibliography_agent)
3944. **Synthesis Report** (from synthesis_agent)
3955. **[If socratic mode] INSIGHT Collection and Research Plan Summary**
3966. **Preregistration handoff** — exactly one builder-produced
397 `preregistration-artifact/1.0` sidecar (including an unavailable receipt) and,
398 when `status=provided`, its explicitly named companion bytes
399
400**Trigger**: User says "now help me write a paper" or "write a paper based on this"
401
402`academic-paper`'s `intake_agent` will automatically detect available materials and skip redundant steps:
403- Has RQ Brief -> skip topic scoping
404- Has Bibliography -> skip literature search
405- Has Synthesis -> accelerate findings / discussion writing
406- Has preregistration sidecar -> strict-validate it and its named companion,
407 then carry both byte-for-byte; never rebuild it from prose or a template
408
409The non-shell `research_architect_agent` supplies only the explicit caller
410declaration and companion handle. Before handoff, a shell-capable dispatcher
411must run the named deterministic `build-preregistration-artifact` subcommand in
412`scripts/build_cross_document_consistency_advisory.py`, with caller-held RFC3339
413`declared_at`. Only that builder may create or update the sidecar. A later
414explicit user supply creates a new builder-produced sidecar; omission or silent
415substitution is invalid.
416
417See `examples/handoff_to_paper.md` for a detailed handoff example.
418
419---
420
421## Full Academic Pipeline
422
423See `academic-pipeline/SKILL.md` for the complete workflow.
424
425---
426
427## Agent File References
428
429| Agent | Definition File |
430|-------|----------------|
431| research_question_agent | `agents/research_question_agent.md` |
432| research_architect_agent | `agents/research_architect_agent.md` |
433| bibliography_agent | `agents/bibliography_agent.md` |
434| source_verification_agent | `agents/source_verification_agent.md` |
435| synthesis_agent | `agents/synthesis_agent.md` |
436| report_compiler_agent | `agents/report_compiler_agent.md` |
437| editor_in_chief_agent | `agents/editor_in_chief_agent.md` |
438| devils_advocate_agent | `agents/devils_advocate_agent.md` |
439| ethics_review_agent | `agents/ethics_review_agent.md` |
440| socratic_mentor_agent | `agents/socratic_mentor_agent.md` |
441| risk_of_bias_agent | `agents/risk_of_bias_agent.md` |
442| meta_analysis_agent | `agents/meta_analysis_agent.md` |
443| monitoring_agent | `agents/monitoring_agent.md` |
444
445---
446
447## Reference Files
448
449| Reference | Purpose | Used By |
450|-----------|---------|---------|
451| `references/apa7_style_guide.md` | APA 7th edition quick reference | report_compiler, editor_in_chief |
452| `references/source_quality_hierarchy.md` | Evidence pyramid + grading rubric | source_verification, bibliography |
453| `references/methodology_patterns.md` | Research design templates | research_architect |
454| `references/logical_fallacies.md` | 30+ fallacies catalog | devils_advocate |
455| `references/ethics_checklist.md` | AI disclosure, attribution, dual-use | ethics_review |
456| `references/interdisciplinary_bridges.md` | Cross-discipline connection patterns | synthesis, research_architect |
457| `references/socratic_questioning_framework.md` | 6 types of Socratic questions + 30+ prompt patterns | socratic_mentor |
458| `references/failure_paths.md` | 12 failure scenarios with triggers and recovery paths | all agents |
459| `references/mode_selection_guide.md` | Mode selection flowchart and comparison table | orchestrator |
460| `references/irb_decision_tree.md` | Portable human-subjects navigation aid; not an authority, universal taxonomy, or pathway determination | ethics_review, research_architect |
461| `shared/references/human_subjects_authority_protocol.md` | Exact authority selection, replay validation, actor/consumer filtering, and fail-closed resolved-context gate | ethics_review, research_architect |
462| `shared/human_subjects_authority_registry.json` | Bounded jurisdiction profiles with exact requirement IDs, authority anchors, obligated actors, and consumer scopes | ethics_review, research_architect |
463| `shared/contracts/human_subjects/resolved_authority_context.schema.json` | Pointer-only resolved-context shape; consumers still require deterministic replay validation | ethics_review, research_architect |
464| `shared/references/review_pathway_rule_trace_protocol.md` | Candidate-name ownership, exact selected-profile predicate partition, replay, render, surface lint, and non-consumer boundary (#669) | ethics_review, research_architect |
465| `shared/contracts/human_subjects/review_pathway_trace_request.schema.json` | Closed caller-owned candidate mapping; every selected-profile `pathway_trace` requirement is accounted for exactly once | dispatching layer |
466| `shared/contracts/human_subjects/review_pathway_rule_trace.schema.json` | Closed candidate-only predicate trace; replay and surface lint remain mandatory | ethics_review, research_architect |
467| `shared/references/submission_packet_manifest_protocol.md` | Deterministic packet inventory, authority replay, status, and non-authorization boundary (#667) | ethics_review, research_architect |
468| `shared/contracts/human_subjects/submission_packet_manifest.schema.json` | Pointer-only deterministic packet-manifest shape; consumers still require exact replay validation | ethics_review, research_architect |
469| `shared/references/authority_content_coverage_advisory_protocol.md` | Replay-bound authority-profile content observations, evidence-row/1.1 provenance, and noninterference boundary (#681) | ethics_review, research_architect |
470| `shared/contracts/human_subjects/content_coverage_advisory.schema.json` | Closed `LLM-ADVISORY` carrier; consumers still require finalizer replay validation | ethics_review, research_architect |
471| `shared/contracts/evidence/evidence_row_v1_1.schema.json` | Requirement/expectation/artifact-bound bounded excerpt rows for the #681 advisory surface | ethics_review |
472| `references/equator_reporting_guidelines.md` | EQUATOR reporting guideline mapping | research_architect, report_compiler |
473| `references/preregistration_guide.md` | Preregistration decision tree + platforms + checklist | research_architect |
474| `shared/references/cross_document_consistency_advisory_protocol.md` | Exact preregistration sidecar ownership/replay plus #672 advisory and #660 coexistence boundaries | research_architect, academic-paper intake, pipeline orchestrator |
475| `shared/contracts/passport/preregistration_artifact.schema.json` | Closed persistent preregistration handoff receipt; companion bytes remain separately named | dispatching layer, intake, pipeline orchestrator |
476| `references/systematic_review_toolkit.md` | Cochrane v6.4, PRISMA 2020, RoB 2, ROBINS-I, I² guide, GRADE, protocol registration | risk_of_bias, meta_analysis, bibliography, report_compiler |
477| `references/literature_monitoring_strategies.md` | Google Scholar alerts, PubMed alerts, RSS feeds, Retraction Watch, citation tracking, monitoring cadence | monitoring_agent |
478| `references/argumentation_reasoning_framework.md` | Cognitive framework for evaluating argument strength: Toulmin model, causal reasoning (Bradford Hill), inference to best explanation, epistemic status classification | synthesis, devils_advocate, source_verification, socratic_mentor, research_architect |
479| `references/socratic_mode_protocol.md` | Full 5-layer Socratic dialogue flow, management rules, auto-end conditions | socratic_mentor, research_question |
480| `references/systematic_review_protocol.md` | Full PRISMA pipeline, checkpoint rules, meta-analysis procedures | risk_of_bias, meta_analysis, bibliography, report_compiler |
481| `references/cross_agent_quality_definitions.md` | Peer-reviewed source tiers, currency standards, severity definitions | all agents |
482| `references/changelog.md` | Full version history | — |
483
484---
485
486## Templates
487
488| Template | Purpose |
489|----------|---------|
490| `templates/research_brief_template.md` | Quick mode output format |
491| `templates/literature_matrix_template.md` | Source x Theme analysis matrix |
492| `templates/evidence_assessment_template.md` | Per-source quality assessment card |
493| `templates/preregistration_template.md` | OSF standard 21-item preregistration template |
494| `templates/prisma_protocol_template.md` | PRISMA-P 2015 systematic review protocol template |
495| `templates/prisma_report_template.md` | PRISMA 2020 systematic review report template (27 items) |
496
497---
498
499## Examples
500
501| Example | Demonstrates |
502|---------|-------------|
503| `examples/exploratory_research.md` | Full 6-phase pipeline walkthrough |
504| `examples/systematic_review.md` | PRISMA-style literature review |
505| `examples/policy_analysis.md` | Applied comparative policy research |
506| `examples/socratic_guided_research.md` | Complete Socratic mode multi-turn dialogue (12 rounds) |
507| `examples/handoff_to_paper.md` | deep-research full mode handoff to academic-paper |
508| `examples/review_mode.md` | Review mode: 3-agent review pipeline for policy recommendation text |
509| `examples/fact_check_mode.md` | Fact-check mode: source verification of HEI claims with per-claim verdicts |
510| `examples/idea_diversity_coverage_gap_advisory.md` | #257 Socratic wording-pattern + lit-review distributional-skew advisories |
511
512---
513
514## Output Language
515
516Follows the user's language. Academic terminology kept in English. Socratic mode uses natural conversational style.
517
518---
519
520## Anti-Patterns
521
522Explicit prohibitions to prevent common failure modes:
523
524| # | Anti-Pattern | Why It Fails | Correct Behavior |
525|---|-------------|-------------|-----------------|
526| 1 | **Confirmation bias in source selection** | Only finding sources that support the hypothesis | Devil's Advocate checkpoint must include counter-evidence search |
527| 2 | **Cherry-picking evidence** | Citing one supportive study while ignoring three contradicting ones | Report the full evidence landscape including conflicting findings |
528| 3 | **Vibe citing** | Mixing elements from 2-3 real papers into a fabricated reference | Every reference must be verified independently; mashup fabrication is the hardest to detect |
529| 4 | **⚠️ IRON RULE: Treating "difficult to verify" as acceptable** | Marking a reference as "uncertain" instead of FAIL | Gray zone = FAIL. If you cannot confirm it exists, it does not go in the report |
530| 5 | **Skipping phases** | Jumping to synthesis before completing source verification | Complete each phase fully; Phase N output is Phase N+1 input |
531| 6 | **Shallow Socratic mode** | Giving answers disguised as questions ("Wouldn't you say X is true?") | Ask genuine questions that expose assumptions; never lead to predetermined conclusions |
532| 7 | **Source tier inflation** | Treating a blog post as equivalent to a peer-reviewed journal | Apply evidence hierarchy strictly: Tier 1 (peer-reviewed) > Tier 2 (preprint) > Tier 3 (gray lit) |
533
534## Quality Standards
535
5361. ⚠️ **IRON RULE**: **Every claim must have a citation** — no unsupported assertions
5372. **Evidence hierarchy** — meta-analyses > RCTs > cohort studies > case reports > expert opinion (field-neutral baseline; grading is **discipline-relative** — a source meeting its own field's gold standard can reach Grade A even at a low design level. See `references/source_quality_hierarchy.md` §Grading Rubric + §Field-Specific Adjustments)
5383. **Contradiction disclosure** — if sources disagree, report both sides with evidence quality comparison
5394. **Limitation transparency** — every report must have an explicit limitations section
5405. **AI disclosure** — all reports include a statement that AI-assisted research tools were used
5416. **Reproducibility** — search strategies, inclusion criteria, and analytical methods must be documented for replication
5427. **Socratic integrity** — while non-generation Socratic mode is active, never give direct answers; always guide through questions. A candidate response is lawful only after the explicit exit marker and is outside that mode.
543
544## Cross-Agent Quality Alignment
545
546Unified definitions across all agents. ⚠️ IRON RULE: **CRITICAL severity** = issue that would invalidate a core conclusion or constitute academic misconduct. Requires immediate resolution.
547
548> See `references/cross_agent_quality_definitions.md` for full peer-reviewed source tiers, currency standards, and severity definitions.
549
550---
551
552## Integration with Other Skills
553
554This skill is domain-agnostic but can be combined with domain-specific skills:
555
556```
557deep-research + tw-hei-intelligence -> Evidence-based HEI policy research
558deep-research + report-to-website -> Interactive research report
559deep-research + podcast-script-generator -> Research podcast
560deep-research + academic-paper -> Full research-to-publication pipeline
561deep-research (socratic) + academic-paper (plan) -> Guided research + paper planning
562deep-research (systematic-review) + academic-paper -> PRISMA systematic review paper
563```
564
565---
566
567## Model Tiering (#517, optional)
568
569When `ARS_MODEL_TIERING` is set, the dispatching session routes this skill's agents per `shared/model_tiering.md` (canonical: the full 39-agent judgment/execution table + rules). Compact rule:
570
571- **Unset (default):** every agent inherits the session model — byte-equivalent pre-#517 behavior.
572- **`economy`** (frontier-tier session): execution-type agents dispatch ONE tier below the session model — floor Opus-class, never lower; judgment-type agents stay on the session model. No-op at or below the floor (announce once).
573- **`quality-boost`** (below-frontier session): judgment-type agents at the checkpoint surfaces (Stage 2.5/4.5 gates; the opt-in Stage 4→5 claim–ref audit; final review) jump UP to the frontier tier (however many tiers away — not a single increment); nothing is ever downgraded. No-op at the frontier (announce once).
574- Unknown values → warn once, behave as unset. Tiers are relative positions, never hard-pinned model ids. When a direction is active, route repeated same-stage calls to the SAME worker so its prompt cache accumulates; unset means dispatch shapes stay byte-equivalent too.
575
576---
577
578## Version Info
579
580| Item | Content |
581|------|---------|
582| Skill Version | 2.12.1 |
583| Last Updated | 2026-08-15 |
584| Maintainer | Cheng-I Wu |
585| Dependent Skills | academic-paper v1.0+ (downstream) |
586
587---
588
589## Version History
590
591> See `references/changelog.md` for full version history.