Hi - I answer from the OpenSmartRoute documentation: routing, the API, plans and quotas, self-hosting. Ask away, or open a support ticket if you need a person.
Grounded in the docs - follow a source before acting on it.
contextual-inquiry - Skill - OpenSmartRoute
Skillv1.0.0
contextual-inquiry
See `content/06-decision-tree.xml`. The tree routes from observable inputs to a rule-grounded conclusion, every leaf referencing a rule from `01-core-rules.xml`. Use it when in doubt about which varia
Imported from faionfaion/faion-network (skills/faion/knowledge/ux/contextual-inquiry/AGENTS.md). Install upstream with npx skills add faionfaion/faion-network --skill contextual-inquiry. Copyright stays with the author.
Contextual Inquiry
Summary
One-sentence: Produces a contextual-inquiry report from semi-structured interviews conducted in the user's environment while they perform actual work, with master-apprentice notes + interpretation session.
One-paragraph: Contextual inquiry observes users in their environment performing actual work, with the researcher adopting the master-apprentice stance: user is master, researcher is apprentice. Sessions are 1-3 hours; observations focus on artefacts, breakdowns, workarounds, and verbatim language. Output is a per-participant transcript + interpretation session results + affinity-diagram themes.
Ефективно для:
Early-stage product discovery: розуміти actual workflow, не declared.
B2B / regulated workflow де lab-tests втрачають context (e.g. healthcare).
Surface workarounds + breakdowns що користувачі не згадають у survey.
Validate / falsify персон проти польових даних.
Applies If (ALL must hold)
Researcher can co-locate with the user during their actual work.
Work involves enough activity to observe (not pure desk thinking).
Master-apprentice frame is acceptable to the participant.
Skip If (ANY kills it)
Remote-only workflows where observation requires screen-share — use diary studies.
Sensitive contexts where observation would alter behaviour materially.
Quantitative validation of known hypotheses — use surveys or analytics.
Prerequisites
Artefact
Format
Source
Recruitment plan
criteria + count
research
Consent form
PDF
legal
Note template
structured
this methodology
Recording device
audio + photo (with consent)
research kit
Assumes Loaded
Methodology
Why
[[personas]]
Outputs feed persona refinement
[[diary-studies]]
Alternative when on-site observation is infeasible
Contextual inquiry interview guide with master-apprentice prompts
templates/interview-guide.md
Contextual inquiry interview guide with master-apprentice prompts Generated from templates/interview-guide.md.j2 by tpl-jinja --migrate; do not hand-edit.
templates/field-notes.md.j2
Per-session field note template with timestamped verbatim quotes + breakdown log
templates/field-notes.md
Per-session field note template with timestamped verbatim quotes + breakdown log Generated from templates/field-notes.md.j2 by tpl-jinja --migrate; do not hand-edit.
Scripts
File
Purpose
When to call
scripts/validate-contextual-inquiry.py
Validate artefact JSON against output schema
Pre-commit / CI on artefact change
Related
[[personas]]
[[focus-groups]]
[[diary-studies]]
Decision tree
See content/06-decision-tree.xml. The tree routes from observable inputs to a rule-grounded conclusion, every leaf referencing a rule from 01-core-rules.xml. Use it when in doubt about which variant of the methodology to apply.
Use it
Copy one of these into your project. Installing also returns the manifest and these snippets.
yaml
targets:
- https://api.opensmartroute.ai/api/v1/registry/faionfaion-faion-network-contextual-inquiry/manifest # or paste the manifest below
Manifest
An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.
{
"ocm": "1",
"id": "faionfaion-faion-network-contextual-inquiry",
"kind": "skill",
"name": "contextual-inquiry",
"description": "See `content/06-decision-tree.xml`. The tree routes from observable inputs to a rule-grounded conclusion, every leaf referencing a rule from `01-core-rules.xml`. Use it when in doubt about which variant of the methodology to apply.",
"publisher": "faionfaion",
"version": "1.0.0",
"capabilities": {
"domains": [
"general"
],
"tags": [
"skill-md",
"github-agents"
],
"languages": [
"en"
]
},
"quality_prior": 0.6,
"examples": [
"See `content/06-decision-tree.xml`. The tree routes from observable inputs to a rule-grounded conclusion, every leaf referencing a rule from `01-core-rules.xml`. Use it when in doubt about which variant of the methodology to apply."
],
"primary": false,
"metadata": {
"source": {
"provider": "github-agents",
"repository": "https://github.com/faionfaion/faion-network",
"path": "skills/faion/knowledge/ux/contextual-inquiry/AGENTS.md",
"ref": "8e31684537e64d45c75264b1e0a2384f9b024a34",
"url": "https://github.com/faionfaion/faion-network/blob/8e31684537e64d45c75264b1e0a2384f9b024a34/skills/faion/knowledge/ux/contextual-inquiry/AGENTS.md",
"key": "faionfaion/faion-network/skills/faion/knowledge/ux/contextual-inquiry/AGENTS.md"
}
},
"instructions": "# Contextual Inquiry\n\n## Summary\n\n**One-sentence:** Produces a contextual-inquiry report from semi-structured interviews conducted in the user's environment while they perform actual work, with master-apprentice notes + interpretation session.\n\n**One-paragraph:** Contextual inquiry observes users in their environment performing actual work, with the researcher adopting the master-apprentice stance: user is master, researcher is apprentice. Sessions are 1-3 hours; observations focus on artefacts, breakdowns, workarounds, and verbatim language. Output is a per-participant transcript + interpreta",
"cost": {
"context_tokens": 1042
}
}
Fetch it by URL: GET /api/v1/registry/faionfaion-faion-network-contextual-inquiry/manifest?version=1.0.0
Reviews
Star ratings from people who tried it. One review per account; edit yours any time.
No reviews yet. Install it, try it, and be the first to rate it.
