Immutable. This exact content is served forever at /api/v1/blob/e007f4f8c350a6b3.
---
name: okhp3-elicitation-interviews
description: Plan and facilitate structured elicitation sessions using BABOK v3 interview and workshop techniques. Use this skill when you need to gather process knowledge from subject matter experts; when the user wants a question plan before an interview or workshop; when elicitation is incomplete and gaps need targeted follow-up; when they say "help me interview the process owner", "prepare questions for the workshop", or "what should I ask to fill in the missing steps". Produces a question plan and elicitation notes template.
license: MIT
homepage: https://github.com/overkillhill/mermaid-diagram-bpmn/tree/main/skills/elicitation-and-interview-facilitation
repository: https://github.com/overkillhill/mermaid-diagram-bpmn
metadata:
bp_skill_version: "0.3.0"
status: core
version: "0.1.0"
author: OverKill Hill P³
project: "BP-SKILL: Business Process Agent Skill Suite"
category: process-analysis
standards_refs:
- "BABOK v3 §4 (Elicitation and Collaboration)"
- "BABOK v3 §10.25 (Interviews)"
- "BABOK v3 §10.50 (Workshops)"
- "BABOK v3 §10.14 (Document Analysis)"
- "BPM CBOK v4 §4.3 (Process Discovery Techniques)"
produces: "question-plan.yaml, elicitation-notes.md"
consumes: "pir.yaml, scope-statement.md"
depends_on: ["process-intake-and-scope"]
tags: elicitation, interview-facilitation, question-plan, BABOK, workshop, subject-matter-expert, process-discovery
triggers:
- prepare interview questions
- help me run the workshop
- question plan
- what should I ask
- elicitation session
- interview the process owner
- SME interview
- workshop facilitation
origin: okhp3/skillz
homepage: https://overkillhill.com
author-github: https://github.com/OKHP3
in_scope: "The named stage of the governed business-process documentation lifecycle and its stated input-output handoff."
out_of_scope: "Inventing process facts, bypassing required upstream artifacts, or publishing without authorization."
---
# okhp3-elicitation-interviews
**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)
## Purpose
Generate a structured elicitation question plan and facilitate evidence-based process interviews using BABOK v3 §10.25 and §10.50 techniques. The plan targets known gaps in the PIR and provides sequenced, open-ended questions mapped to each PIR section.
---
## When to use this skill
- PIR exists but has `completeness_score < 70` or open_questions that need targeted follow-up
- User needs to interview a subject matter expert and wants a prepared question set
- User is planning a process discovery workshop and needs a facilitator guide
- You need to fill elicitation gaps before proceeding to `process-narrative-authoring`
## When NOT to use this skill
- PIR is already complete (score ≥ 70, no open_questions) — proceed directly to `process-narrative-authoring`
- User has no access to process owners — document the gap and proceed with assumptions flagged
- Do not fabricate answers from the question plan — only record what participants confirm
---
## Question Plan Generation
`scripts/generate-question-plan.mjs` reads the PIR and generates targeted questions for each incomplete section.
### Question categories
| PIR section | Question type | Sample opening |
|---|---|---|
| `trigger` | Context | "What makes you realise the process needs to start today?" |
| `actors` | Role | "Who else touches this beyond the people we've named?" |
| `inputs` | Artefact | "What document or data do you need before you can begin?" |
| `outputs` | Artefact | "What does the person receiving your output actually do with it?" |
| `steps` | Sequence | "Walk me through what you do on a typical day this runs." |
| `business_rules` | Constraint | "Is there a policy or procedure that forces you to do it this way?" |
| `exceptions` | Edge case | "Tell me about the last time this went wrong. What happened?" |
| `systems` | Tool | "Which systems do you open, update, or check during this process?" |
| `controls` | Governance | "How do you know when the process has been done correctly?" |
### Branching logic
- If `trigger.event_type` is absent → lead with Stage 1 trigger questions
- If `actors` has no `approver` → probe approval chain: *"Who has the authority to stop or reject this?"*
- If `exceptions` is empty → probe with historical incident: *"What was the hardest version of this you've dealt with?"*
- If `business_rules` is empty → probe obligation: *"Are there any rules you must follow that an outsider wouldn't know?"*
---
## Facilitation Guidelines
1. **Open with context** — read back the process name and one-sentence scope; confirm it is correct
2. **Use the question plan in order** — complete highest-gap sections first
3. **Probe with "tell me more"** — do not accept one-word answers for steps or rules
4. **Record verbatim** — capture exact wording of rules and exceptions; paraphrase only for clarity
5. **Flag uncertainty** — mark any answer prefaced with "I think" or "usually" as `confidence: low`
6. **Close with open invitation** — *"Is there anything else you think I should know to document this correctly?"*
7. **Write up within 24 hours** — update the PIR before memory fades
---
## Elicitation Notes Template
The `elicitation-notes.md` output contains:
- Session metadata (date, participants, facilitator, method)
- Answers mapped to PIR sections
- Verbatim quotes for business rules
- Confidence flags for uncertain answers
- Outstanding items that need follow-up
---
## Handoff Instruction
After elicitation, update `pir.yaml` and re-run `process-intake-and-scope` scoring. When score ≥ 70, pass `pir.yaml` to `stakeholder-and-role-mapping` and then `process-narrative-authoring`.
---
## References
Load on demand:
- `references/babok-elicitation-techniques.md` — BABOK v3 §4, §10.14, §10.25, §10.50 technique summaries and question frameworks
## Scripts
- `scripts/generate-question-plan.mjs` — generates elicitation question plan from PIR scope and open_questions
## Assets
- `assets/fixtures/question-plan-example.yaml` — canonical question plan for purchase-approval intake
## About
Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)
Published at [github.com/OKHP3](https://github.com/OKHP3)
Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.
MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.