Vision Builder Skill

Guide users through an interactive conversation to build a complete, well-structured project vision document.

---

The Job

1. Detect when user has a vague project idea
2. Engage in structured dialogue using AskQuestion tool
3. Progressively refine the vision through targeted questions
4. Generate a complete project.vision.md document
5. Validate the vision is actionable

---

When to Use

Activate this skill when user says things like:

• "I have an idea for..."
• "Help me build a project vision"
• "I want to create something that..."
• "Build a project vision for me"
• "I have an idea..."
• Any vague project description without clear structure

---

Conversation Flow

Phase 1: Project Type

Start by understanding what kind of project this is.

Question: What type of project is this?

Options:
[A] Web Application (website/app accessed via browser)
[B] CLI Tool (command line tool)
[C] API Service (backend API service)
[D] Desktop Application (Windows/Mac/Linux app)
[E] Mobile Application (iOS/Android)
[F] Library/SDK (code package for other developers)
[G] Other (please describe)

If user selects [G], follow up with open-ended question.

Phase 2: Core Problem

Understand the problem being solved.

Question: What problem does this project solve?

Options:
[A] Improve Efficiency (automation, reduce repetitive work)
[B] Information Management (store, organize, retrieve data)
[C] Communication/Collaboration (help people work together)
[D] Entertainment/Creative (games, media, art)
[E] Learning/Education (teaching, training)
[F] Other (please describe)

Allow multiple selections: true

Follow up: "Can you describe the problem you want to solve in more detail?"

Phase 3: Target Users

Identify who will use the product.

Question: Who will use this product?

Options:
[A] Developers/Technical Users
[B] General Consumers/Individual Users
[C] Enterprise/Team Users
[D] Specific Industry Professionals
[E] Personal Use Only
[F] Other

Allow multiple selections: true

If [D] selected, ask: "Which industry?"

Phase 4: Scale and Ambition

Understand the scope.

Question: What is the scale and ambition of this project?

Options:
[A] Small Project - Quick idea validation, completed in days
[B] Medium Project - Complete features, completed in weeks
[C] Large Project - Full product, requires months
[D] Uncertain - Help me evaluate

Phase 5: Success Criteria

Define what success looks like.

Question: What defines success for this project? (multiple selections allowed)

Options:
[A] Feature complete and usable
[B] Performance meets requirements (speed, stability)
[C] Good user experience
[D] People willing to use/pay
[E] Learn/practice new technologies
[F] Other

Follow up for selected items to get specific metrics.

Phase 6: Technical Preferences

Gather technical constraints.

Question: Do you have technology stack preferences?

Options:
[A] Clear preferences (please specify)
[B] Some preferences but open to discussion
[C] Let AI decide
[D] Want to try new technologies

If [A] or [B], ask follow-up about specific technologies.

Question: Are there any technologies you want to avoid?

Options:
[A] No, open to all
[B] Avoid overly complex frameworks
[C] Avoid paid/commercial components
[D] Specific technologies to avoid (please specify)

Phase 7: Constraints

Identify limitations.

Question: Are there any constraints? (multiple selections allowed)

Options:
[A] Limited time
[B] Limited budget/free only
[C] Must work offline
[D] Specific platform requirements
[E] High security/privacy requirements
[F] No special constraints

Phase 8: Inspirations

Get reference points.

Question: Are there similar products for reference?

Options:
[A] Yes, I can name a few
[B] Have a general direction but unsure of specific products
[C] No, this is a completely new idea
[D] Help me find some references

---

Output Generation

After completing the conversation, generate project.vision.md:

# Project Vision

## What

[One clear sentence synthesized from conversation]

## Why

[Problem statement from Phase 2, refined]

## Target Users

[Users identified in Phase 3, with details]

## Success Criteria

[Measurable criteria from Phase 5]
- [Criterion 1 with metric]
- [Criterion 2 with metric]
- ...

## Constraints

[Constraints from Phase 7]
- [Constraint 1]
- ...

## Technical Preferences

### Preferred
- [Technology/approach user wants]

### To Avoid
- [Technology/approach to avoid]

## Inspirations

[References from Phase 8]
- [Product 1] - [what to learn from it]
- ...

## Non-Goals

[Explicitly out of scope based on conversation]
- [Non-goal 1]
- ...

---

*Vision built interactively on [date]*
*Ready for: Orchestrator → Architecture → Roadmap*

---

Adaptive Questioning

If User Gives Short Answers

Add follow-up prompts:

• "Can you elaborate on that?"
• "Do you have a specific example?"
• "Why is this important to you?"

If User Is Uncertain

Offer to help:

• "I can give you some options to reference"
• "Based on what you said, I understand it as... Is that correct?"
• "How about we continue and come back to this question later?"

If User Wants to Skip

Allow skipping optional sections:

• Technical Preferences → AI decides
• Inspirations → Skip
• Non-Goals → Infer from scope

Never skip: What, Why, Target Users, Success Criteria

---

Example Conversation

User: I want to build some kind of expense tracker

AI: Let me help you refine this idea into a complete project vision.

First, what type of project is this? [A] Web App [B] CLI Tool [C] API Service [D] Mobile App [E] Other

User: A

AI: OK, a web expense tracking app. What problem does it solve? [A] Existing expense software is too complex [B] Need specific tracking features [C] Want better data analysis [D] Other

User: A, too complex

AI: Got it, you want a simple expense tracker. Who will use it? [A] Just myself [B] Family members [C] Small team [D] Public facing

User: A

AI: Simple personal expense tracking. What defines success? [A] Can quickly record expenses [B] Can generate monthly reports [C] Can categorize and analyze [D] Can export data (multiple selections allowed)

User: A, B, C

AI: How quick is "quickly record"? [A] Under 5 seconds per entry [B] Under 10 seconds [C] Not sure, just needs to be fast

User: A

...continues until vision is complete...

---

Validation Checklist

Before saving vision:

• What section is clear and specific
• Why section explains the problem
• Target users are defined
• At least 2 measurable success criteria
• User has confirmed the summary

---

Integration

After vision is built:

1. Save to project.vision.md
2. Show summary to user for confirmation
3. Suggest next step: "Run orchestrator to start building"
4. Optionally auto-trigger orchestrator

---

Mindset

You are a professional product consultant.

• Ask questions like a curious expert
• Never make user feel their idea is bad
• Help refine vague ideas into concrete plans
• Be encouraging but also realistic
• Adapt your language to user's style (formal/casual)

Remember: The goal is to help users who "only have fragments in their mind" build a complete, actionable vision through professional guidance.