nemonix-cli 1.0.0

package/src/config/claude-code-config/skills/aibuilder-create-saas/steps/step-01-discovery.md

@@ -0,0 +1,342 @@
+---
+name: step-01-discovery
+description: Ask discovery questions to find the right SaaS idea based on user's experience
+prev_step: steps/step-00-init.md
+next_step: steps/step-02-brainstorm.md
+---
+
+# Step 1: Idea Discovery
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+- 🛑 NEVER suggest ideas in this step - only gather information
+- 🛑 NEVER ask all questions at once - ONE category at a time!
+- ✅ ALWAYS respond in `{user_language}` detected in step 0
+- ✅ Be flexible with answers - don't force the user
+- 📋 YOU ARE A curious interviewer, not a business advisor (yet)
+- 💬 FOCUS on gathering context about user's experiences
+- 🚫 FORBIDDEN to brainstorm or evaluate ideas in this step
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 **ONE CATEGORY AT A TIME** - Ask category 1, wait for response, then category 2, etc.
+- 💾 Store all answers in `{discovery_answers}` for step 2
+- 📖 Go through all 5 question categories progressively
+- ✅ Move on when user has shared enough
+
+## CONTEXT BOUNDARIES:
+
+- Variables from step-00: `{project_id}`, `{save_mode}`, `{auto_mode}`, `{user_language}`, `{output_dir}`
+- Don't assume knowledge about user's background
+- User is learning Next.js with Prisma and Better-Auth
+- Goal: SaaS that can be built in <2 weeks with 1 core feature
+
+## YOUR TASK:
+
+Gather rich context about user's experiences, pain points, and tool usage to fuel the brainstorming phase.
+
+---
+
+## REFERENCE:
+
+Load `../references/discovery-framework.md` for:
+- The Mom Test questions and rules
+- Jobs to Be Done (JTBD) interview framework
+- The Magic Questions for deep discovery
+- Red flags vs green flags
+
+---
+
+## DISCOVERY FLOW:
+
+```
+Introduction → Category 1 → wait → Category 2 → wait → ... → Category 5 → Summary
+```
+
+**CRITICAL: Send ONE category, wait for user response, then send next category.**
+
+---
+
+## STEP 1: Introduction
+
+**Display in `{user_language}`:**
+```
+🔍 Let's find YOUR perfect SaaS idea!
+
+The goal is to create a project that solves YOUR OWN problem.
+
+I'll ask you 5 quick questions, one at a time. Ready?
+```
+
+**Then immediately ask Category 1 (in same message).**
+
+---
+
+## QUESTION CATEGORIES (ask ONE at a time):
+
+### Category 1: Manual Tasks to Automate
+
+**Question:**
+> **What tasks do you do manually that could be automated with an app?**
+>
+> Examples:
+> - Creating content on multiple platforms and publishing to each one separately
+> - Managing accounting at the end of the month
+> - Translating large amounts of text with AI
+> - Scheduling social media posts manually
+> - Tracking expenses in a spreadsheet
+>
+> Give me 3 examples:
+
+**Store answers in:** `{discovery_answers.manual_tasks}`
+
+### Category 2: Work/School Pain Points
+
+**Question:**
+> **If you have experience in a company or school: what tasks were done manually that took too much time?**
+>
+> Examples:
+> - Teachers uploading grades to administration is complicated, we never get our grades on time
+> - Customer service struggles to find user information quickly
+> - Using an old WordPress plugin to manage appointments with psychiatrists
+> - Onboarding new employees takes forever with manual processes
+> - Tracking project progress across teams
+>
+> Give me 3 examples:
+
+**Store answers in:** `{discovery_answers.work_pain_points}`
+
+### Category 3: Paid Tools You Use
+
+**Question:**
+> **Have you paid for a tool recently? Why? And could you rebuild it simpler?**
+>
+> Examples:
+> - I pay for MailerLite to manage emails but only use 3 features
+> - I pay for Typefully only to schedule Twitter posts
+> - I pay for Senja just to collect reviews for my course
+> - I pay for Notion just for one specific workflow
+> - I pay for Calendly but could use something simpler
+>
+> Give me 3 examples:
+
+**Store answers in:** `{discovery_answers.paid_tools}`
+
+### Category 4: Community Problems
+
+**Question:**
+> **Are you active in any community? (Slack, Discord, Reddit...) What problems do they have?**
+>
+> Examples:
+> - I'm a member of a golf club and we struggle to track scores
+> - I'm in a LinkedIn community and we'd like a way to automatically support each other's posts
+> - I'm in a Bali community for playing Paddle but the app is really bad
+> - My Discord server has no good way to organize events
+> - Our running club has no good way to track group runs
+>
+> Give me 3 examples:
+
+**Store answers in:** `{discovery_answers.community_problems}`
+
+### Category 5: Complex Spreadsheets/Notion
+
+**Question:**
+> **Do you have a complex Google Sheet, Notion, or other system you could turn into an app?**
+>
+> Examples:
+> - I use Notion to manage my content planning
+> - I use Google Sheets to manage my accounting
+> - I use Google Docs to manage copywriting
+> - I have a spreadsheet tracking all my subscriptions
+> - I use Airtable as a makeshift CRM
+>
+> Give me 3 examples:
+
+**Store answers in:** `{discovery_answers.spreadsheet_tools}`
+
+---
+
+## BONUS QUESTIONS (for users who built projects before):
+
+**First, check if user has previous project experience:**
+Use AskUserQuestion:
+```yaml
+questions:
+  - header: "Experience"
+    question: "Have you already built a web application or SaaS project before?"
+    options:
+      - label: "Yes, I've built something"
+        description: "I have experience building web apps"
+      - label: "No, this is my first"
+        description: "I'm new to building web applications"
+    multiSelect: false
+```
+
+**If YES, ask these bonus questions:**
+
+> **When building your previous project:**
+> - Did you need an API or service that didn't exist or was too expensive?
+> - What parts of the development were the most frustrating?
+> - What would you build differently next time?
+
+**Store in:** `{discovery_answers.previous_project_insights}`
+**Set:** `{has_previous_project}` = true
+
+---
+
+## EXECUTION SEQUENCE:
+
+### Message 1: Introduction + Category 1
+- Display intro
+- Ask Category 1 (Manual Tasks)
+- **STOP and wait for user response**
+
+### Message 2: Category 2
+- Acknowledge their answer briefly
+- Ask Category 2 (Work Pain Points)
+- **STOP and wait for user response**
+
+### Message 3: Category 3
+- Acknowledge their answer briefly
+- Ask Category 3 (Paid Tools)
+- **STOP and wait for user response**
+
+### Message 4: Category 4
+- Acknowledge their answer briefly
+- Ask Category 4 (Community Problems)
+- **STOP and wait for user response**
+
+### Message 5: Category 5
+- Acknowledge their answer briefly
+- Ask Category 5 (Spreadsheets)
+- **STOP and wait for user response**
+
+### Message 6: Summary
+
+**Display summary in `{user_language}`:**
+```
+📝 **Great! Here's what I've learned about you:**
+
+**Manual tasks you'd like to automate:**
+- {answer1}
+- {answer2}
+- ...
+
+**Pain points from work/school:**
+- {answer1}
+- ...
+
+**Tools you pay for:**
+- {answer1}
+- ...
+
+**Community problems:**
+- {answer1}
+- ...
+
+**Spreadsheet/Notion systems:**
+- {answer1}
+- ...
+
+{If has_previous_project:}
+**Insights from previous projects:**
+- {answer1}
+- ...
+```
+
+### 7. Save to discovery.md (if save_mode)
+
+**Update `{output_dir}/discovery.md` with all answers:**
+```markdown
+---
+project_id: {project_id}
+updated: {timestamp}
+---
+
+# Discovery Notes
+
+## User Context
+{Brief description of who the user is based on their answers}
+
+## Discovery Answers
+
+### Manual Tasks
+{list all answers from category 1}
+
+### Work/School Pain Points
+{list all answers from category 2}
+
+### Paid Tools
+{list all answers from category 3}
+
+### Community Problems
+{list all answers from category 4}
+
+### Spreadsheet Systems
+{list all answers from category 5}
+
+### Previous Project Insights
+{list answers if applicable}
+
+## Key Insights
+{Patterns noticed across the answers - what problems keep coming up?}
+
+## Selected Direction
+*To be filled in step 2 after brainstorming*
+```
+
+### 6. Proceed to Brainstorm
+
+**If `{auto_mode}` = true:**
+→ Load step-02-brainstorm.md immediately
+
+**If `{auto_mode}` = false:**
+Use AskUserQuestion:
+```yaml
+questions:
+  - header: "Continue"
+    question: "I have enough context to brainstorm ideas. Ready to see what we can build?"
+    options:
+      - label: "Show me ideas! (Recommended)"
+        description: "Proceed to brainstorming phase"
+      - label: "I have more to add"
+        description: "Let me add more context first"
+    multiSelect: false
+```
+
+---
+
+## SUCCESS METRICS:
+
+✅ All 5 question categories asked
+✅ At least 1 answer per category received
+✅ Previous project experience checked
+✅ All answers stored in `{discovery_answers}`
+✅ Summary shown to user for confirmation
+✅ Answers saved to idea.md (if save_mode)
+
+## FAILURE MODES:
+
+❌ Suggesting or evaluating ideas during discovery
+❌ Proceeding with empty categories
+❌ Not asking bonus questions when user has previous project
+❌ **CRITICAL**: Not responding in user's detected language
+❌ **CRITICAL**: Not using AskUserQuestion for confirmations
+
+## DISCOVERY PROTOCOLS:
+
+- Be encouraging - no answer is "too small"
+- Ask follow-up questions if answers are vague
+- Look for patterns across categories
+- Store everything - more context = better brainstorming
+- Keep the conversation flowing naturally
+
+---
+
+## NEXT STEP:
+
+After user confirms via AskUserQuestion, load `./step-02-brainstorm.md`
+
+<critical>
+Remember: This step is ONLY about gathering information - don't evaluate or suggest ideas yet!
+</critical>

package/src/config/claude-code-config/skills/aibuilder-create-saas/steps/step-02-brainstorm.md

@@ -0,0 +1,230 @@
+---
+name: step-02-brainstorm
+description: Generate 3-6 SaaS ideas based on discovery answers and let user choose one
+prev_step: steps/step-01-discovery.md
+next_step: steps/step-03-validate.md
+---
+
+# Step 2: Idea Brainstorming
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+- 🛑 NEVER validate or research ideas in this step - only generate and present
+- ✅ ALWAYS generate 3-6 ideas, not more, not less
+- ✅ ALWAYS respond in `{user_language}`
+- 📋 YOU ARE A creative brainstormer, not a market analyst (yet)
+- 💬 FOCUS on generating diverse, actionable ideas from discovery answers
+- 🚫 FORBIDDEN to do competitor research in this step
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Use discovery answers to fuel idea generation
+- 💾 Present ideas in a clear table format
+- 📖 Each idea must have: name, sector, core feature, B2B/B2C
+- 🚫 FORBIDDEN to load step-03 until user selects an idea
+
+## CONTEXT BOUNDARIES:
+
+- Variables from previous steps: `{discovery_answers}`, `{has_previous_project}`, `{user_language}`, `{output_dir}`, `{save_mode}`
+- User is learning Next.js with Prisma and Better-Auth
+- Ideas must be buildable in <2 weeks with 1 core feature
+- Don't research competitors yet - that's step 3
+
+## YOUR TASK:
+
+Generate 3-6 diverse SaaS ideas based on discovery answers and let user choose one to validate.
+
+---
+
+## IDEA GENERATION CRITERIA:
+
+Each idea MUST be:
+1. **Buildable in 2 weeks** - Single core feature, no complex integrations
+2. **Solving a REAL problem** - From discovery answers, not hypothetical
+3. **Monetizable** - Clear path to revenue (subscription/one-time/usage)
+4. **Feasible for solo dev** - No need for team, heavy marketing, or funding
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Analyze Discovery Answers
+
+**Review all categories:**
+- `{discovery_answers.manual_tasks}` → Automation opportunities
+- `{discovery_answers.work_pain_points}` → B2B opportunities
+- `{discovery_answers.paid_tools}` → Simplification opportunities
+- `{discovery_answers.community_problems}` → Niche community tools
+- `{discovery_answers.spreadsheet_tools}` → App conversion opportunities
+- `{discovery_answers.previous_project_insights}` → Technical gap opportunities
+
+**Look for patterns:**
+- Problems mentioned multiple times
+- Pain points with existing paid solutions
+- Niche markets with underserved needs
+
+### 2. Generate 3-6 Ideas
+
+**For each idea, define:**
+
+| Field | Description |
+|-------|-------------|
+| **Name** | Catchy, memorable name suggestion |
+| **Sector** | Industry/domain (e.g., Productivity, Content, Community, Finance) |
+| **Core Feature** | THE ONE thing it does (MVP focus) |
+| **Target** | B2B / B2C / Both |
+| **Business Model** | Subscription / One-time / Usage-based |
+| **Source** | Which discovery answer inspired this |
+| **Difficulty** | 🟢 Easy / 🟡 Medium / 🔴 Hard (with Claude Code) |
+
+### 3. Present Ideas Table
+
+**Display in `{user_language}`:**
+```
+💡 Based on what you told me, here are 3-6 SaaS ideas:
+
+| # | Name | Sector | Core Feature | B2B/B2C | Business Model | Difficulty |
+|---|------|--------|--------------|---------|----------------|------------|
+| 1 | {name} | {sector} | {feature} | {target} | {model} | 🟢 |
+| 2 | {name} | {sector} | {feature} | {target} | {model} | 🟡 |
+| ... | ... | ... | ... | ... | ... | ... |
+
+**Quick descriptions:**
+
+**1. {Name}** - {2-3 sentence description of what it does and why it solves your problem}
+
+**2. {Name}** - {2-3 sentence description}
+
+...
+```
+
+### 4. Add Context for Each Idea
+
+**For each idea, briefly explain:**
+- Why this came from their answers
+- Why it's buildable in 2 weeks
+- Who would pay for it
+
+### 5. Let User Choose
+
+Use AskUserQuestion:
+```yaml
+questions:
+  - header: "Choose"
+    question: "Which idea interests you the most?"
+    options:
+      - label: "Idea 1: {name}"
+        description: "{one-line summary}"
+      - label: "Idea 2: {name}"
+        description: "{one-line summary}"
+      - label: "Idea 3: {name}"
+        description: "{one-line summary}"
+      # Add more if generated
+      - label: "None - I have my own"
+        description: "I want to propose a different idea"
+    multiSelect: false
+```
+
+### 6. Handle User Response
+
+**If user selects an idea:**
+- Store in `{selected_idea}`
+- Proceed to validation
+
+**If user selects "None - I have my own":**
+- Ask: "Tell me about your idea. What problem does it solve and for whom?"
+- Store their description in `{selected_idea}`
+- Proceed to validation
+
+**If user wants to go back:**
+- Return to step-01-discovery.md
+- Ask for more context
+
+### 7. Save to idea.md (if save_mode)
+
+**Append to `{output_dir}/idea.md`:**
+```markdown
+## Brainstormed Ideas
+
+| # | Name | Sector | Core Feature | B2B/B2C | Business Model |
+|---|------|--------|--------------|---------|----------------|
+{table rows}
+
+### Selected Idea: {selected_idea.name}
+
+**Why this one:**
+{user's choice or their own idea description}
+
+---
+*Brainstorm completed: {timestamp}*
+```
+
+### 8. Transition Message
+
+**Display in `{user_language}`:**
+```
+Great choice! Now let's validate "{selected_idea.name}" by:
+- Researching competitors
+- Challenging the idea honestly
+- Defining the details
+
+This is the most important step - we'll make sure this idea is worth building.
+```
+
+---
+
+## IDEA DIVERSITY GUIDELINES:
+
+**Ensure variety across:**
+- Sectors (don't generate 4 productivity tools)
+- Business models (mix subscription, one-time, usage)
+- Difficulty levels (include at least 1 easy option)
+- Target markets (mix B2B and B2C)
+
+**Prioritize ideas that:**
+- Come directly from user's pain points
+- Have obvious monetization paths
+- Don't require complex integrations
+- User would actually use themselves
+
+---
+
+## SUCCESS METRICS:
+
+✅ 3-6 ideas generated (not more, not less)
+✅ Each idea has all required fields filled
+✅ Ideas are diverse in sector and business model
+✅ Ideas directly relate to discovery answers
+✅ User successfully selected or proposed an idea
+✅ Selection saved to idea.md (if save_mode)
+
+## FAILURE MODES:
+
+❌ Generating generic ideas not tied to discovery
+❌ Generating too many or too few ideas
+❌ Doing competitor research in this step
+❌ Not providing enough context for each idea
+❌ **CRITICAL**: Not using AskUserQuestion for selection
+❌ **CRITICAL**: Not responding in user's detected language
+
+## BRAINSTORM PROTOCOLS:
+
+- Be creative but realistic
+- Tie every idea to something user mentioned
+- Don't oversell - be honest about difficulty
+- Include at least one "simple but useful" option
+- Make names catchy and memorable
+
+---
+
+## NEXT STEP:
+
+After user selects an idea via AskUserQuestion, load `./step-03-validate.md`
+
+**If user wants different ideas:**
+- Generate 3-6 NEW ideas with different approaches
+- Or return to step-01-discovery.md for more context
+
+<critical>
+Remember: This step is ONLY about generating and selecting ideas - don't validate or research yet!
+</critical>