okhp3-elicitation-interviews

Generates gap-targeted elicitation question plans from PIR files using BABOK v3 techniques.

1|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/OKHP3/refoldec --skill okhp3-elicitation-interviews-okhp3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: okhp3-elicitation-interviews
Source: https://github.com/OKHP3/refoldec/tree/main/.agents/skills/okhp3-elicitation-interviews
Command: npx skills add https://github.com/OKHP3/refoldec --skill okhp3-elicitation-interviews-okhp3

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Business process documentation often stalls because analysts don't know what to ask subject matter experts, leading to incomplete Process Information Records (PIRs) with gaps in triggers, actors, steps, exceptions, and business rules. ## Core Features & Use Cases - Question Plan Generation: Reads a PIR YAML file and produces a sequenced, section-mapped question plan with probes and expected outputs targeting known gaps. - BABOK v3 Facilitation Guidance: Applies interview (§10.25), workshop (§10.50), and document analysis (§10.14) techniques with structured session guidance. - Elicitation Notes Template: Captures verbatim answers, confidence flags, and outstanding follow-ups mapped back to PIR sections. - Use Case: A business analyst has a PIR scoring below 70 completeness with undocumented exceptions and business rules. Run the question plan script to generate targeted interview questions, then facilitate the SME session using the facilitation guidelines. ## Quick Start Ask the assistant to prepare an interview question plan from your pir.yaml file to fill gaps before process narrative authoring.

Frequently Asked Questions about okhp3-elicitation-interviews

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prepare interview questions for a business process discovery session?▼

Run the generate-question-plan.mjs script against your PIR YAML file to produce a gap-targeted question plan. Questions are mapped to PIR sections like trigger, actors, steps, and exceptions, each with probes and expected outputs.

What BABOK techniques does this skill use for elicitation?▼

It applies BABOK v3 §10.25 Interviews, §10.50 Workshops, and §10.14 Document Analysis, guided by §4 Elicitation and Collaboration principles. A reference file summarizes each technique with session structures and selection guidance.

When should I not run an elicitation session for process documentation?▼

Skip elicitation when the PIR completeness score is 70 or higher with no open questions; proceed directly to narrative authoring. Also avoid fabricating answers when no process owner is available—flag assumptions instead.

How do I handle conflicting stakeholder accounts in a process interview?▼

Keep questions neutral, separate reported facts from assumptions, and include reconciliation questions that locate the source of disagreement. Request artifacts or observations needed to resolve the conflict rather than deferring to authority.

What input format does the question plan generator require?▼

The script expects a PIR YAML file with fields such as process_id, trigger, actors, inputs, steps, exceptions, business_rules, and open_questions. It outputs a JSON question plan with typed, section-mapped questions.