intent-capture

fabriqaai/intent-capture

Communication

About

SKILL.md

Capture user intent through guided conversation. - No active intent exists - User wants to start something new **HIGH** — This is a creative, exploratory phase. Ask open-ended questions. Don't constrain prematurely. NEVER assume requirements — ALWAYS ask clarifying questions Capture the "what" and "why" — leave the "how" for decomposition Let user describe freely — don't interrupt What do you want to build? Let user describe freely. Don't interrupt. Based on response, ask follow-up questions:

<question if="unclear who benefits">
  Who is this for? Who will use this feature?
</question>

<question if="unclear problem">
  What problem does this solve? What's painful today?
</question>

<question if="unclear scope">
  What's the minimum that would be valuable? What can wait?
</question>

<question if="unclear constraints">
  Any technical constraints? Existing systems to integrate with?
</question>

<question if="unclear success">
  How will you know this is working? What does success look like?
</question>

Let me make sure I understand:

  **Goal**: {summarized goal}

  **Users**: {who benefits}

  **Problem**: {what pain this solves}

  **Success Criteria**:
  - {criterion 1}
  - {criterion 2}
  - {criterion 3}

  **Constraints**:
  - {constraint 1}
  - {constraint 2}

  Is this accurate? [Y/n/edit]
</output>
<check if="response == n or edit">
  <action>Ask specific clarifying questions</action>
  <goto step="3"/>
</check>

Create intent ID from title (kebab-case) Generate intent brief using template: templates/brief.md.hbs Create directory: .specs-fire/intents/{intent-id}/ Save: .specs-fire/intents/{intent-id}/brief.md Add intent to state.yaml Set intent status to "in_progress" **Intent captured**: "{intent-title}"

  Saved to: .specs-fire/intents/{intent-id}/brief.md

  ---

  Ready to break this into work items? [Y/n]
</output>
<check if="response == y">
  <invoke_skill>work-item-decompose</invoke_skill>
</check>

Artifact	Location	Template
Intent Brief	`.specs-fire/intents/{id}/brief.md`	`./templates/brief.md.hbs`

User intent fully understood through dialogue Goal, users, problem clearly captured Success criteria defined Constraints identified Intent brief saved to correct location State.yaml updated with new intent

SKILL.md

<question if="unclear who benefits">
  Who is this for? Who will use this feature?
</question>

<question if="unclear problem">
  What problem does this solve? What's painful today?
</question>

<question if="unclear scope">
  What's the minimum that would be valuable? What can wait?
</question>

<question if="unclear constraints">
  Any technical constraints? Existing systems to integrate with?
</question>

<question if="unclear success">
  How will you know this is working? What does success look like?
</question>

Let me make sure I understand:

  **Goal**: {summarized goal}

  **Users**: {who benefits}

  **Problem**: {what pain this solves}

  **Success Criteria**:
  - {criterion 1}
  - {criterion 2}
  - {criterion 3}

  **Constraints**:
  - {constraint 1}
  - {constraint 2}

  Is this accurate? [Y/n/edit]
</output>
<check if="response == n or edit">
  <action>Ask specific clarifying questions</action>
  <goto step="3"/>
</check>

  Saved to: .specs-fire/intents/{intent-id}/brief.md

  ---

  Ready to break this into work items? [Y/n]
</output>
<check if="response == y">
  <invoke_skill>work-item-decompose</invoke_skill>
</check>

Artifact	Location	Template
Intent Brief	`.specs-fire/intents/{id}/brief.md`	`./templates/brief.md.hbs`