IRIS Research Router
Intelligent routing skill that serves as the universal entry point for all IRIS
investigations. It analyzes the user's topic, determines the appropriate research
domain, and delegates to the correct domain-specific skill.
Available Domains
| Domain |
Skill |
Agents |
Scope |
| Tech |
/iris:tech |
27 agents |
Software, libraries, CLIs, APIs, frameworks, DevOps, infrastructure |
| Health |
/iris:health |
25 agents |
Clinical, pharmaceutical, epidemiology, public health, bioethics, health policy |
Workflow Routing
| Workflow |
Trigger |
File |
| Route |
"research", "investigate", "analyze", "study" |
workflows/route.md |
| Continue |
"continue", "deepen", "iterate" |
workflows/continue.md |
| Status |
"status", "list investigations" |
workflows/status.md |
| Archive |
"archive research" |
workflows/archive.md |
How It Works
- User invokes
/iris:research with a topic or intent
- Route workflow activates:
- Analyzes the topic for domain signals
- If domain is clear → delegates immediately
- If ambiguous → asks the user to clarify
- Hands off to the appropriate domain skill
Domain Detection
The router uses keyword and context analysis to determine the domain:
Tech Signals
- Software names, programming languages, frameworks
- CLI tools, APIs, libraries, packages
- DevOps, CI/CD, infrastructure, cloud
- Security vulnerabilities, code analysis
- Performance, benchmarks, architecture
Health Signals
- Diseases, conditions, symptoms, treatments
- Drugs, pharmaceuticals, clinical trials
- Medical devices, diagnostics
- Public health, epidemiology, prevention
- Regulatory (FDA, EMA, WHO), compliance (HIPAA)
- Mental health, nutrition, genomics
Ambiguous Topics
Some topics could belong to either domain:
- "security" → tech (cybersecurity) or health (patient safety)?
- "compliance" → tech (SOC2, GDPR) or health (HIPAA, FDA)?
- "AI" → tech (implementation) or health (AI in healthcare)?
When ambiguous, the router asks the user using ask_user with the two domain options.
Principles
Never Assume
If the domain is not obvious from the topic, always ask. A wrong delegation wastes
time and produces irrelevant results.
Quick Handoff
The router should not do research itself. Its job is to understand the topic and
delegate as fast as possible. Minimize conversational turns.
Direct Access
Power users who know their domain can skip the router:
/iris:tech investigate "Node.js" → goes directly to tech skill/iris:health investigate "diabetes" → goes directly to health skill
Guardrails
- This skill does NOT perform research — it only routes
- The ONLY writable directory is
.requests/ (for logging routing decisions)
- No code execution that modifies the system
- No privilege escalation
- No destructive filesystem operations
1---2name: research3description: IRIS Research router. USE WHEN the user wants to research or investigate ANY topic. Analyzes the topic, determines the appropriate domain (tech or health), and delegates to the correct domain-specific skill. For learning/educational content, redirects to /iris:teach. Users can also go directly to /iris:tech or /iris:health.4---56# IRIS Research Router78Intelligent routing skill that serves as the universal entry point for all IRIS9investigations. It analyzes the user's topic, determines the appropriate research10domain, and delegates to the correct domain-specific skill.1112## Available Domains1314| Domain | Skill | Agents | Scope |15|--------|-------|--------|-------|16| **Tech** | `/iris:tech` | 27 agents | Software, libraries, CLIs, APIs, frameworks, DevOps, infrastructure |17| **Health** | `/iris:health` | 25 agents | Clinical, pharmaceutical, epidemiology, public health, bioethics, health policy |1819## Workflow Routing2021| Workflow | Trigger | File |22|----------|---------|------|23| **Route** | "research", "investigate", "analyze", "study" | `workflows/route.md` |24| **Continue** | "continue", "deepen", "iterate" | `workflows/continue.md` |25| **Status** | "status", "list investigations" | `workflows/status.md` |26| **Archive** | "archive research" | `workflows/archive.md` |2728## How It Works29301. **User invokes `/iris:research`** with a topic or intent312. **Route workflow** activates:32 - Analyzes the topic for domain signals33 - If domain is clear → delegates immediately34 - If ambiguous → asks the user to clarify35 - Hands off to the appropriate domain skill3637## Domain Detection3839The router uses keyword and context analysis to determine the domain:4041### Tech Signals42- Software names, programming languages, frameworks43- CLI tools, APIs, libraries, packages44- DevOps, CI/CD, infrastructure, cloud45- Security vulnerabilities, code analysis46- Performance, benchmarks, architecture4748### Health Signals49- Diseases, conditions, symptoms, treatments50- Drugs, pharmaceuticals, clinical trials51- Medical devices, diagnostics52- Public health, epidemiology, prevention53- Regulatory (FDA, EMA, WHO), compliance (HIPAA)54- Mental health, nutrition, genomics5556### Ambiguous Topics57Some topics could belong to either domain:58- "security" → tech (cybersecurity) or health (patient safety)?59- "compliance" → tech (SOC2, GDPR) or health (HIPAA, FDA)?60- "AI" → tech (implementation) or health (AI in healthcare)?6162When ambiguous, the router asks the user using `ask_user` with the two domain options.6364## Principles6566### Never Assume67If the domain is not obvious from the topic, always ask. A wrong delegation wastes68time and produces irrelevant results.6970### Quick Handoff71The router should not do research itself. Its job is to understand the topic and72delegate as fast as possible. Minimize conversational turns.7374### Direct Access75Power users who know their domain can skip the router:76- `/iris:tech investigate "Node.js"` → goes directly to tech skill77- `/iris:health investigate "diabetes"` → goes directly to health skill7879## Guardrails8081- This skill does NOT perform research — it only routes82- The ONLY writable directory is `.requests/` (for logging routing decisions)83- No code execution that modifies the system84- No privilege escalation85- No destructive filesystem operations
shoootyou