| name | semantic-router |
| description | Route natural-language clinical trial design requests into normalized semantic intent, package-specific skills, and recommended gsDesign ecosystem workflows. Use when a request spans multiple trial design concepts, when the right package is unclear, or when Codex needs to map endpoint family, estimand, information, timing, boundaries, multiplicity, adaptation, or simulation requirements to gsDesign, gsDesign2, gsDesignNB, simtrial, graphicalMCP, rpact, wpgsd, illness-death, or related skills.
|
Trial Design Semantic Router
Use this skill before package-specific skills when user intent needs to be
translated into a trial-design workflow.
Resources
- Routing rules:
references/routing-patterns.md
- Shared vocabulary:
../../../glossary/core-concepts.md
- Package crosswalks:
../../../crosswalks/*.yaml
- Routing examples:
../../../evals/natural-language-requests.yaml
Workflow
- Normalize the request into semantic fields: endpoint family, estimand,
hypothesis type, design family, timing basis, information source,
boundaries, multiplicity, adaptation, and simulation.
- Read the relevant glossary entries and package crosswalks only as needed.
- Select the smallest set of package skills that can satisfy the intent.
- Identify missing inputs that change the workflow, analysis, or package
choice. Ask only for those inputs before implementation.
- Hand off to the selected package skill for code patterns and API details.
- Explain the routing decision in terms of user intent and package capability.
Output Pattern
When useful, summarize routing with this compact structure:
intent:
endpoint_family:
estimand:
design_family:
timing_basis:
information_source:
multiplicity:
adaptation:
simulation:
routing:
skills:
packages:
workflow:
missing_inputs:
Keep the structure short. Do not force every field when the user asked a narrow
question.
Clarification Rule
Ask a clarification question only when the answer changes the recommended
package, workflow, statistical method, or required inputs. Otherwise, make a
reasonable assumption and state it.
