fusion-research

name	fusion-research
description	Source-backed research orchestrator for the Fusion ecosystem. Routes to the correct research agent based on question type. Returns source-backed evidence only; will not invent Framework behavior, component APIs, skill catalog relationships, platform guidance, or backend implementation details. USE FOR: any research question needing source-backed evidence about Fusion Framework APIs, EDS components, the Fusion skill catalog, Fusion platform documentation, or backend service implementation. DO NOT USE FOR: implementing code changes, installing or editing skills, MCP setup or troubleshooting, or inventing Fusion behavior without evidence.
license	MIT
compatibility	Works best with Fusion MCP. Dispatches to `agents/framework.agent.md` for `mcp_fusion_search_framework`, `agents/eds.agent.md` for `mcp_fusion_search_eds`, `agents/skills.agent.md` for `mcp_fusion_search_skills`, `agents/docs.agent.md` for `mcp_fusion_search_docs`, and `agents/backend-code.agent.md` for `mcp_fusion_search_backend_code`. If MCP is unavailable, state that clearly rather than guessing.
metadata	{"version":"0.4.1","status":"experimental","owner":"@equinor/fusion-core","tags":["fusion","research","mcp","evidence","framework","eds","skills","docs","backend","csharp","services","platform-guidance"],"mcp":{"suggested":["mcp_fusion_search_framework","mcp_fusion_search_eds","mcp_fusion_search_docs","mcp_fusion_search_skills","mcp_fusion_search_backend_code","mcp_fusion_skills"]}}

Fusion Research

When to use

Use this skill when a user needs a source-backed answer about the Fusion ecosystem.

Typical triggers:

• "Research this Fusion Framework hook and show me the supporting source."
• "What props does this EDS component accept?"
• "Which skill handles X in a Fusion workflow?"
• "Find a source-backed example for…"
• "Which Fusion package or module owns this API?"
• "Is there an EDS design token for this value?"
• "How can I persist user preferences in a Fusion app?"
• "What's the recommended pattern for X in Fusion?"
• "Show me a Fusion Framework example for building X."
• "What are the design tokens for color and spacing in EDS?"
• "How does Fusion handle X at the platform level?"
• "What is the Fusion platform guidance on Y?"
• "How do I onboard to Fusion?"
• "What are the guidelines for Z in the Fusion platform?"

When not to use

Do not use this skill for:

• implementing code changes — use fusion-app-react-dev or the relevant dev skill; if the research is for a specific app you are actively building, use fusion-app-react-dev first — it will call this skill when needed
• finding, installing, updating, or removing skills — use fusion-discover-skills; use this skill only to understand a skill's scope, relationships, or catalog fit — not to discover what to install
• creating or editing skill files — use fusion-skill-authoring for authoring-time research
• Fusion MCP installation or troubleshooting — use fusion-mcp; once MCP is running, return here for research
• pure conceptual Fusion questions with no specific artifact name (hook, component, package, token, or platform topic) — ask the user for a concrete artifact reference or platform topic first

Instructions

Step 0 — Sharpen scope (optional)

Before classifying, you may use the domain-specific follow-up questions to narrow the user's exact need:

• Framework scope: assets/framework.follow-up.md
• EDS scope: assets/eds.follow-up.md
• Skills catalog scope: assets/skills.follow-up.md
• Docs scope: assets/docs.follow-up.md

Skip this step if the question already names a specific artifact (hook, component, package, token, or skill).

Step 1 — Classify the research question

Determine which domain the question belongs to:

Domain	Indicators	Agent
Framework	Fusion Framework hooks, packages, modules, TypeScript APIs, cookbook examples	agents/framework.agent.md
EDS	EDS component props, usage examples, accessibility, design tokens	agents/eds.agent.md
Skills	Skill catalog lookup, scope boundaries, companion/orchestrator relationships	agents/skills.agent.md
Docs	Fusion platform concepts, onboarding, platform operations, governance, non-implementation guidance	agents/docs.agent.md
Backend Code	C# service implementations, interfaces, CQRS patterns, authorization, validation, cross-service APIs	agents/backend-code.agent.md

If the question spans multiple domains, answer each domain separately using the appropriate agent in sequence.

Step 2 — Dispatch to the correct agent

• Framework questions → follow agents/framework.agent.md.
• EDS questions → follow agents/eds.agent.md.
• Skills questions → follow agents/skills.agent.md.
• Docs questions → follow agents/docs.agent.md.
• Backend code questions → follow agents/backend-code.agent.md.

If the runtime supports skill-local agents, invoke the agent directly. Otherwise, apply the agent's instructions inline.

Step 3 — Return the source-backed answer

Use the structure in assets/source-backed-answer-template.md:

• State which domain and agent was used.
• Include one to three source-backed evidence bullets.
• End with any remaining assumptions, uncertainty, or the next verification step.

Research agents

This skill includes five research agents in agents/. Each covers one Fusion research domain with its own query patterns and evidence checklist.

• agents/framework.agent.md — source-backed answers about Fusion Framework hooks, packages, modules, and cookbook examples. Uses mcp_fusion_search_framework.
• agents/eds.agent.md — source-backed answers about EDS component props, usage, accessibility, and design tokens. Uses mcp_fusion_search_eds.
• agents/skills.agent.md — source-backed answers about the Fusion skill catalog: what skills exist, their scope, and how they relate. Uses mcp_fusion_search_skills.
• agents/docs.agent.md — source-backed answers about Fusion platform concepts, onboarding, operations, and governance. Uses mcp_fusion_search_docs.
• agents/backend-code.agent.md — source-backed answers about Fusion backend service implementations: C# services, interfaces, CQRS patterns, authorization, and cross-service integrations. Uses mcp_fusion_search_backend_code.

Assets

• assets/source-backed-answer-template.md
• assets/framework.follow-up.md — pre-dispatch scope questions for Framework research
• assets/eds.follow-up.md — pre-dispatch scope questions for EDS research
• assets/skills.follow-up.md — pre-dispatch scope questions for skills catalog research
• assets/docs.follow-up.md — pre-dispatch scope questions for Docs platform research

Safety & constraints

Never:

• invent Fusion Framework hooks, EDS props, or skill catalog entries
• claim evidence exists when MCP is unavailable or results are weak
• keep refining indefinitely — state uncertainty after one refinement pass per agent
• implement code changes or mutate repositories during a research flow

Always:

• classify the question before choosing an agent
• capture the source path and supporting excerpt before finalizing any claim
• state explicitly which agent and source backed each part of the answer