/r2a - Research-to-Artifacts v2.0
3-phase research pipeline: Research → Visualize → Deepen. Generates downloadable artifact bundles with quality gates, JSX dashboards, and categorized ideation prompts.
Syntax
/r2a "<topic>" [options]
Options
| Option | Description | Default |
|---|---|---|
--artifacts <list> | Comma-separated artifact types or all | executive-summary,quick-start,glossary |
--date-range <range> | Year range for search filtering | 2025-2026 |
--output-format <format> | Output format (zip/pdf/notion/confluence/obsidian/docx) | zip |
--mode <mode> | Research mode (standard/competitive/technical) | standard |
--review-after <phases> | Checkpoint after phases (research/analysis/generation/visualization/ideation) | none |
--full | Run all 3 phases (research + visualize + deepen) | false |
--phases <list> | Comma-separated phase numbers: 1=research, 2=visualize, 3=deepen | 1 |
--extended | Generate 6 dashboards instead of 4 (Phase 2) | false |
--seed | Seed folder mode — create directory structure before generation | false |
--incremental | Only fetch new sources since last run | false |
--since <date> | Date for incremental updates | - |
--force-refresh | Ignore cache, full refresh | false |
--template-set <name> | Use custom template set | default |
--output <path> | Output path for bundle | ./artifacts/ |
Artifact Types
| Type | Description | Phase |
|---|---|---|
executive-summary | 1-page leadership summary | 1 |
quick-start | 1-2-3 getting started guide | 1 |
sdd | Software Design Document | 1 |
tdd | Technical Design Document | 1 |
adrs | Architecture Decision Records | 1 |
glossary | Terminology definitions | 1 |
architecture-diagrams | C4 and system diagrams | 1 |
c4-architecture | Complete C4 model (Context→Code) | 1 |
compliance-analysis | FDA/HIPAA/SOC2/PCI-DSS mapping | 1 |
workflow-diagrams | Process flowcharts | 1 |
impact-analysis | Strategic impact assessment | 1 |
comparison-matrix | Feature comparison (competitive mode) | 1 |
Examples
Basic Usage
# Generate default artifacts (exec summary, quick start, glossary)
/r2a "AI agents in enterprise 2025-2026"
# Generate all artifact types
/r2a "Kubernetes best practices" --artifacts all
# Specific artifacts
/r2a "GraphQL vs REST" --artifacts comparison-matrix,executive-summary,glossary
Competitive Analysis
# Compare technologies
/r2a "PostgreSQL vs MySQL vs MongoDB" --mode competitive
# Compare products
/r2a "Vercel vs Netlify vs AWS Amplify" --mode competitive --artifacts all
Technical Deep Dive
# Full technical documentation
/r2a "Event-driven architecture patterns" --mode technical --artifacts sdd,tdd,adrs,architecture-diagrams
Quality Checkpoints
# Review sources before analysis
/r2a "LLM fine-tuning" --review-after research
# Review at multiple points
/r2a "Microservices patterns" --review-after research,analysis
Full Pipeline (All 3 Phases)
# Research + Visualize + Deepen in one command
/r2a "Temporal.io workflow engine" --full --extended
# Same with explicit phases
/r2a "Kubernetes operators" --phases 1,2,3
Phase 2: Visualization Only
# Generate JSX dashboards from existing research
/r2a:visualize ./artifacts/ --topic "AI Agents"
# Extended mode (6 dashboards)
/r2a:visualize ./artifacts/ --extended
Phase 3: Ideation Only
# Generate categorized deep-dive prompts
/r2a:deepen ./artifacts/ --count 25
# Filter to specific categories
/r2a:deepen ./artifacts/ --categories architecture-deep-dives,compliance-regulatory
Output Formats
# PDF for distribution
/r2a "Cloud security" --output-format pdf
# Notion for team wiki
/r2a "Onboarding guide" --output-format notion
# Obsidian for personal knowledge base
/r2a "AI research notes" --output-format obsidian
Incremental Updates
# Update with only new sources
/r2a "AI agents" --incremental --since 2026-01-01
# Force full refresh
/r2a "AI agents" --force-refresh
Workflow
┌───────────────────────────────────────────────────────────────┐
│ /r2a v2.0 │
├───────────────────────────────────────────────────────────────┤
│ │
│ ═══ PHASE 1: RESEARCH ═══════════════════════════════════ │
│ │
│ 1a. RESEARCH │
│ ├── Web Search (llm-research-patterns) │
│ ├── Doc Search │
│ └── Code Search │
│ │ │
│ ┌────────────┴──────────┐ │
│ │ QUALITY GATE 1 (85%) │ moe-judges │
│ └────────────┬──────────┘ │
│ │ │
│ 1b. ANALYSIS │
│ ├── Organize and Cluster │
│ ├── Extract Glossary │
│ └── Track Sources (source-attribution-tracker) │
│ │ │
│ ┌────────────┴──────────┐ │
│ │ QUALITY GATE 2 (90%) │ council-review │
│ └────────────┬──────────┘ │
│ │ │
│ 1c. GENERATION (9 artifacts, parallel groups A-E) │
│ ├── Executive Summary (Opus) │
│ ├── SDD/TDD (Opus) │
│ ├── C4 Architecture (Sonnet) │
│ ├── Compliance Analysis (Opus) │
│ ├── Quick Start / Glossary (Haiku) │
│ └── Cross-Link (artifact-cross-linker) │
│ │ │
│ ┌────────────┴──────────┐ │
│ │ QUALITY GATE 3 (88%) │ uncertainty-quantification │
│ └────────────┬──────────┘ │
│ │ │
│ ═══ PHASE 2: VISUALIZE (--full or --phases 2) ═══════════ │
│ │
│ 2a. JSX DASHBOARD GENERATION (4 core + 2 extended) │
│ ├── Tech Architecture Analyzer (Sonnet) │
│ ├── Strategic Fit Dashboard (Sonnet) │
│ ├── Integration Playbook (Opus) │
│ ├── Executive Decision Brief (Opus) │
│ ├── Competitive Comparison (Sonnet) [extended] │
│ └── Implementation Planner (Sonnet) [extended] │
│ │ │
│ ═══ PHASE 3: DEEPEN (--full or --phases 3) ══════════════ │
│ │
│ 3a. IDEATION PROMPTS (15-25 across 6 categories) │
│ ├── Architecture Deep-Dives (3-5) │
│ ├── Compliance and Regulatory (2-4) │
│ ├── Multi-Agent Orchestration (2-4) │
│ ├── Competitive and Market Intelligence (2-3) │
│ ├── Product Feature Extraction (2-4) │
│ └── Risk and Mitigation (2-3) │
│ │ │
│ ═══ BUNDLE ══════════════════════════════════════════════ │
│ └── artifact-bundler → ZIP/PDF/Notion/etc. │
│ │
└───────────────────────────────────────────────────────────────┘
Output Structure
{topic}-artifacts-{date}/
├── README.md
├── manifest.json
├── GENERATION-REPORT.md
├── executive-summary.md
├── quick-start.md
├── glossary.md
├── sdd.md
├── tdd.md
├── c4-architecture.md
├── compliance-analysis.md
├── coditect-impact.md
├── adrs/
│ └── ADR-*.md
├── diagrams/
│ ├── context-diagram.md
│ ├── container-diagram.md
│ └── index.md
├── dashboards/ # Phase 2
│ ├── dashboard-manifest.json
│ ├── tech-architecture-analyzer.jsx
│ ├── strategic-fit-dashboard.jsx
│ ├── coditect-integration-playbook.jsx
│ ├── executive-decision-brief.jsx
│ ├── competitive-comparison.jsx # --extended
│ └── implementation-planner.jsx # --extended
├── ideation-prompts.md # Phase 3
└── sources/
└── bibliography.md
Related Commands
| Command | Purpose |
|---|---|
/r2a:research | Research phase only |
/r2a:generate | Generate from existing research |
/r2a:visualize | Phase 2: JSX dashboard generation |
/r2a:deepen | Phase 3: Ideation prompt generation |
/r2a:bundle | Bundle existing artifacts |
/moe-judges | Manual quality evaluation |
/claude-research | Web research skill |