Skip to content

Agent Plugins

Interpretive Orchestration: Epistemic Partnership for Qualitative Research

Interpretive Orchestration gives qualitative research sessions a staged workflow, specialist agents, and enforceable checks.

AI can automate coding, but interpretive depth demands deliberate partnership.

Interpretive Orchestration is a multi-host plugin for structured human-AI work in qualitative research. Claude Code provides its fullest agent integration; Codex, GitHub Copilot CLI and Kimi Code have native plugin routes. It is not a tool for faster coding; it is infrastructure for deeper thinking.

AGENT PLUGINXule Lin & Kevin CorleyNode.js 20+ for scripts and bundled Lotus

Sourcegithub.com/linxule/interpretive-orchestration ↗

Infrastructure for deeper thinking

Built at Imperial College London · Framework: Cognitio Emergens (opens in a new tab) (Lin, 2025) — Partnership Agency for interpretive inquiry · Paper: Interpretive Orchestration (opens in a new tab) (Lin, 2026, Strategic Organization) — the methodology this plugin operationalizes · Starter project: interpretive-orchestration-starter (opens in a new tab) — a ready-to-use VS Code workspace with beginner-friendly settings.

Warning

The plugin checks Stage 1 readiness before selected collaborative-analysis commands and agents. These checks can ask you to confirm an exception and record a reason. They are not an unbypassable methodological boundary or a guarantee of rigor; the researcher remains responsible for the method and the decision to proceed.

Why it matters

Traditional AI approach:

  • Give AI your data → Get instant analysis → Review output
  • AI automates manual labor (the "calculator mindset")
  • Faster but not necessarily deeper

Interpretive Orchestration approach:

  • Build your foundation first → Collaborate with visible reasoning → Synthesize with tradition
  • AI asks questions that deepen your reflexivity
  • Scale and interpretive depth through Partnership Agency

"Human and AI boundaries dissolve into unified epistemic system generating insights neither could produce independently." — Cognitio Emergens (Lin, 2025)

The philosophy: Friction over flow. If the plugin stops you, it's asking you to think.

How it works

Both human and AI are apprentices to the craft tradition of interpretive inquiry. Neither masters the other. Both learn from craft principles: rigor, reflexivity, theoretical sensitivity, interpretive depth.

Solo practice

What you do: Manual coding of 10-15 documents, memo-writing, framework development

AI role: @stage1-listener watches but doesn't intervene

Why it matters: This stage builds the irreplaceable theoretical sensitivity that makes partnership meaningful. Selected collaborative calls check this foundation. A researcher can proceed with an explicit reason; the check does not replace judgment about readiness.

Side-by-side collaboration

What you do: Guide AI, refine patterns, parallel theoretical + empirical streams

AI role: @dialogical-coder with 4-stage visible reasoning:

  1. What I observe in the data
  2. What patterns I'm noticing
  3. What theoretical connections emerge
  4. What remains uncertain

@research-configurator translates technical decisions to research language, so you do not need coding knowledge for this step.

Dialogue with tradition

What you do: Interpret significance, synthesize findings

AI role: @scholarly-companion asks tradition's questions (Gioia, Corley, Constructivist GT)

Outcome: Work that can withstand methodological scrutiny

Skills architecture

Skills are instruction packages the host loads for the task. The current release has 12 workflow skills and 17 command-skills; these workflow skills carry much of the methodology:

SkillTriggersPurpose
project-setup"initialize", "new project"Socratic onboarding + config
gioia-methodology"data structure", "Gioia"Data structure building (1st→2nd→aggregate)
literature-sweep"literature", "Stream A"Search + fetch + organize papers
interview-ingest"transcribe", "convert audio"Audio/PDF conversion
deep-reasoning"think through", "plan"Written analytical steps in the conversation; no MCP required
paradox-navigation"tension", "both/and"Lotus Wisdom integration

The other six are analysis-orchestration, coding-workflow, coherence-check, document-conversion, methodological-rules, and project-dashboard. Full triggers are in plugin/CLAUDE.md in the repository (opens in a new tab).

Bundled MCPs

Lotus Wisdom is the only bundled MCP server in release 0.3.5. The plugin scripts require Node.js 18 or newer, but the current unversioned Lotus package requires Node.js 20 or newer. Use Node.js 20 or newer for the complete default setup, with npx on the host's PATH. The first launch may need network access to fetch the package. Lotus needs no API key.

MCPPurpose in pluginCommand
Lotus WisdomNavigate paradoxes and integrate tensions/qual-wisdom-check

/qual-think-through now asks the model to write analytical steps in the conversation. It does not require Sequential Thinking; add that server separately if your workflow needs its explicit step record. Follow the plugin's current installation guide (opens in a new tab) rather than an older bundled-server list.

Optional MCPs (credentials depend on the service and mode):

MCPPurposeKey Required
MinerUCloud-backed document parsingMINERU_API_KEY
VoxMulti-model validationProvider API keys
Exa (opens in a new tab)Literature searchEXA_API_KEY
Jina (opens in a new tab)Fetch articlesJINA_API_KEY
ZoteroBibliography managementNo API key for local reads; the web API needs ZOTERO_API_KEY and ZOTERO_LIBRARY_ID, while Zotero 10+ supports separate local-write authorization

The plugin's own dependency list still names Zen MCP for the multi-model row. Zen is retired here: Vox registers the same way and does the same job.

Commands

Seventeen commands, grouped the way the plugin groups them.

CommandGroupPurpose
/qual-initProjectInitialize a project with Socratic philosophical onboarding
/qual-check-setupProjectVerify installation and MCP server status
/qual-designProjectConfigure research design for multi-case, longitudinal, or parallel-stream studies
/qual-statusProjectShow the journey dashboard and progress through the stages
/qual-advance-stageProjectAdvance to the next stage, with validation
/qual-configure-analysisProjectModel selection, thinking budget, batch strategy, cost
/qual-stage1-guideStage 1Guidance for manual coding and building theoretical sensitivity
/qual-memoStage 1Write analytical memos while insights are still forming
/qual-complete-stage1Stage 1Validate the manual foundation and close the stage
/qual-parallel-streamsStage 2Run the theoretical and empirical streams
/qual-characterize-patternsStage 2Dimensional analysis: how patterns vary, and under what conditions
/qual-code-deductiveStage 2Apply settled patterns to the remaining data
/qual-synthesizeStage 2Merge the two streams into unified patterns
/qual-think-throughAnalysisDeep sequential reasoning
/qual-wisdom-checkAnalysisNavigate paradoxes, integrate contradictions
/qual-examine-assumptionsAnalysisSurface the ontological and epistemological commitments underneath the work
/qual-reflectAnalysisSynthesis dialogue and reflexive pause

Agents

The plugin provides four specialized agents, each scoped to a particular stage of the atelier methodology.

AgentStageRole
@stage1-listener1Thinking partner — asks questions, never suggests codes
@dialogical-coder24-stage visible reasoning for reflexive coding
@research-configurator2"The Whisperer" — technical setup without jargon
@scholarly-companion3Asks tradition's questions about theoretical significance

@research-configurator ("The Whisperer") bridges research goals and technical implementation for non-coding researchers, covering model selection, cost estimation, batch processing strategy, saturation monitoring, and more. Invoke with @research-configurator Help me set up my analysis.

Methodology hooks

The hooks check Stage 1 progress, prompt interpretive pauses, surface coherence issues and record reflection. Stage 1 checks use document, memo and tradition thresholds; they cannot assess interpretive depth for you.

An AI-started collaborative call in Claude Code can trigger a confirmation prompt. Kimi can deny that call until a researcher replies. Typed commands and Codex routes instead instruct the model to show progress and ask whether to proceed. Hook trust and host behavior matter; adapter errors can fail open. Pauses are prompts, not timed waits or compulsory reflection.

Host support

Host support: which research environments this tool works in
HostSupportNotes
Claude Code (CLI / Desktop Code tab)Full supportSkills, specialist agents, methodology hooks and bundled Lotus. Review host permissions and the readiness checks before work.
Codex CLI / Codex DesktopPartial supportNative plugin with skills, Lotus and Codex hook adapters; no plugin agents. Review and trust hooks after installation or updates. Named $interpretive-orchestration:qual-* skills carry the command workflow.
GitHub Copilot CLIPartial supportNative plugin and host-specific hook adapters. Hook events and after-skill handling differ from Claude Code.
Kimi CodePartial supportNative plugin with skills, Lotus and hook adapters. Confirm the installed capabilities in that host.
Claude Cowork / other clientsAdjacent supportNo separate Cowork marketplace entry in the current release. The published methodology and standalone Lotus server remain usable; do not assume plugin hooks or agents are available.

These are source-documented integrations, not an end-to-end host certification from this review. The bundled Lotus Wisdom server is also usable separately in an MCP client.

Install

New to Claude Code? INSTALL.md in the repository (opens in a new tab) has complete setup instructions (Windows, macOS, Linux).

Want a pre-configured environment? Use the Starter Project (opens in a new tab): a ready-to-use VS Code workspace with beginner-friendly settings.

Already have Claude Code?

cd your-qualitative-project
claude
/plugin marketplace add linxule/interpretive-orchestration
/plugin install interpretive-orchestration@interpretive-orchestration
/qual-check-setup  # Verify installation
/qual-init         # Begin Socratic onboarding

For other hosts, use the native plugin route:

  • Codex: run codex plugin marketplace add linxule/interpretive-orchestration, then codex plugin add interpretive-orchestration@interpretive-orchestration. Review hook trust when Codex next starts. Invoke the named $interpretive-orchestration:qual-* skills.
  • Copilot CLI: run copilot plugin marketplace add linxule/interpretive-orchestration, then copilot plugin install interpretive-orchestration@interpretive-orchestration.
  • Kimi Code: run /plugins install https://github.com/linxule/interpretive-orchestration in Kimi Code.

Restart or reload the host as its plugin interface requests. Inspect the installed skills, hook permissions and Lotus connection before submitting research data. /qual-check-setup checks the setup; it does not certify your methodological decisions.

Then: Complete Stage 1 manual coding (10-15 documents) before beginning collaborative analysis with AI. This builds the irreplaceable theoretical sensitivity that makes partnership meaningful.

Who should use this?

  • PhD students learning qualitative methods
  • Researchers committed to methodological rigor
  • Those working with Gioia methodology or Constructivist GT
  • Anyone valuing depth over speed
  • Researchers who want defensible collaborative work with AI
  • Those interested in human-AI epistemic partnership

Part of Research Memex

This plugin is the practical implementation of interpretive orchestration: the core philosophy that animates Research Memex.

The progression:

  1. Core Principles → Understand the philosophy
  2. Individual MCPs → Learn the tools (Sequential Thinking, Lotus Wisdom, Vox)
  3. Interpretive Orchestration Plugin → Apply it all to qualitative research

Resources


← Back to the Toolkit · Agentic workflows →

cite this page

Lin, X. (2026). Interpretive Orchestration: Epistemic Partnership for Qualitative Research. Research Memex. https://research-memex.org/docs/toolkit/interpretive-orchestration-plugin

@misc{docs-toolkit-interpretive-orchestration-plugin-2026,
  author = {Xule Lin},
  title = {Interpretive Orchestration: Epistemic Partnership for Qualitative Research},
  year = {2026},
  howpublished = {\url{https://research-memex.org/docs/toolkit/interpretive-orchestration-plugin}},
  note = {ORCID: 0000-0001-7885-4194}
}

one renderingthe source remains