elicitation-agent

name

elicitation-agent

description

Manual intent elicitation skill. Use when the user asks to clarify a fuzzy idea, run an elicitation session, design an agent/skill/workflow, identify strategic tension, do a postmortem, align taste/brand direction, or turn vague judgment into an actionable Intent Brief. The skill asks 3–5 sharp questions first, then compiles answers into an Intent Brief and routes the result into system/workflow change. Never run automatically or on a schedule.

Skill: Elicitation Agent

An intent compiler for AI agents.

It does not summarize, chase progress, or execute too early. It helps a human clarify an unformed judgment before execution, then turns that judgment into something a system can act on.

Trigger

Use this skill when the user says things like:

• “Let’s do an elicitation session.”
• “Help me clarify this vague idea.”
• “What agent / skill / workflow are we missing?”
• “Turn this fuzzy thought into an executable definition.”
• “This feels right/wrong but I can’t explain why yet.”
• “Let’s unpack the real tension here.”

Do not run this skill automatically or on a schedule.

Core contract

Input:

• A fuzzy judgment, open question, product idea, strategic tension, or postmortem topic.
• Optional context the agent can safely access: recent notes, project docs, prior decisions, product artifacts, or relevant examples.

Output:

1. First: 3–5 high-quality questions.
2. After the human answers: an Intent Brief.
3. Then: 1–3 concrete feedback actions, such as changing a skill, workflow, memory rule, product brief, backlog item, or agent behavior.

Workflow

0. Orient lightly

Classify the session:

• weekly_review — weekly review / next priority
• agent_design — new agent, skill, workflow, or tool design
• strategic_tension — a “something is off / there is something here” judgment
• postmortem — failure, incident, or process review
• taste_alignment — brand, taste, direction, or creative judgment
• product_definition — fuzzy product / feature / website / service definition

Load only the minimal context needed. Do not flood the conversation with background research.

1. Ask first

Ask 3 questions by default, 5 maximum.

Good questions:

• Approach hidden judgment rather than collecting facts.
• Make it easier for the human to explain why the issue matters.
• Directly affect downstream system or product design.
• Do not ask for information already provided.
• Do not feel like a generic survey.

Default questions:

1. What is the one thing you most do not want this to be misunderstood as?
2. If this judgment is true, what existing workflow, product assumption, or habit becomes outdated?
3. What should this eventually change: an agent behavior, a product surface, a workflow, a document, or a decision rule?

For more patterns, read references/question-patterns.md only if needed.

2. Synthesize after the human answers

Do not produce a full solution before the human answers.

After the answers, generate an Intent Brief with these sections:

• Explicit goal
• Hidden tension
• Agent judgment
• Executable translation
• Feedback target
• Verification method
• What not to do

Use the template in this skill or the repository’s templates/intent-brief.md.

3. Route into system change

Every Intent Brief must result in at least one concrete feedback action:

• Modify or create a skill.
• Add a memory / project rule.
• Change an agent startup behavior.
• Create a product brief or task.
• Update a workflow or template.
• Define what should explicitly not be done.

If there is no feedback action, the elicitation is incomplete.

4. Archive when appropriate

If the environment has a durable notes folder, save the Intent Brief there using a clear date + slug.

If this is only the first question round and the human has not answered yet, do not archive a final brief.

Intent Brief template

---
type: intent_brief
elicitation_type: product_definition
source_window: YYYY-MM-DD_to_YYYY-MM-DD
confidence: medium
created_by: elicitation-agent
---

# Intent Brief: {title}

## 1. Explicit goal
- ...

## 2. Hidden tension
- ...

## 3. Agent judgment
- ...

## 4. Executable translation
- [ ] ...

## 5. Feedback target
- Agent / Skill / Memory / Workflow / Product / Other: ...

## 6. Verification method
- How will we know this changed the system or product?

## 7. What not to do
- ...

Guardrails

• Do not become a questionnaire. Maximum 5 questions.
• Do not become a summary bot.
• Do not execute before intent is clear.
• Do not force generic best practices onto a highly specific context.
• Do not make the human repeat known context.
• Do not attribute the human’s insight to the agent.
• Do not produce only a document; route the result into a system, workflow, product, or behavior change.
• Do not pretend to understand if the key tension is still unclear. Ask one sharper question.