nemonix-cli 1.0.0

package/src/config/claude-code-config/skills/aibuilder-create-saas/references/tools.md

@@ -0,0 +1,132 @@
+# Recommended Tools & Stack
+
+Reference document for technical decisions in SaaS projects.
+
+---
+
+## Core Framework
+
+| Tool | Purpose | Why |
+|------|---------|-----|
+| **Next.js 15** | Full-stack framework | App Router, RSC, great DX, Vercel integration |
+| **TypeScript** | Type safety | Catch errors early, better IDE support |
+| **Tailwind CSS v4** | Styling | Fast, consistent, utility-first |
+
+## UI & Components
+
+| Tool | Purpose | When to use |
+|------|---------|-------------|
+| **shadcn/ui** | Component library | Always - accessible, customizable |
+| **Lucide React** | Icons | Default icon set |
+| **Sonner** | Toast notifications | User feedback |
+| **cmdk** | Command palette | Power user features |
+
+## State & Data Fetching
+
+| Tool | Purpose | When to use |
+|------|---------|-------------|
+| **TanStack Query** | Server state | API data, caching, mutations |
+| **nuqs** | URL state | Filters, pagination, shareable state |
+| **Zustand** | Client state | Complex UI state (use sparingly) |
+| **React Hook Form** | Forms | All forms with validation |
+| **Zod v4** | Validation | Schema validation everywhere |
+
+## Backend & API
+
+| Tool | Purpose | When to use |
+|------|---------|-------------|
+| **Server Actions** | Mutations | Default for data mutations |
+| **next-safe-action** | Type-safe actions | Wrap all server actions |
+| **next-zod-route** | API routes | When REST endpoints needed |
+| **Prisma** | ORM | Database access |
+
+## Database
+
+| Option | Best for | Trade-offs |
+|--------|----------|------------|
+| **Neon** | Most projects | Free tier, serverless Postgres |
+| **Supabase** | Real-time + auth | More features, different paradigm |
+| **PlanetScale** | Scale needs | MySQL, branching |
+
+## Authentication
+
+| Tool | Purpose | When to use |
+|------|---------|-------------|
+| **Better Auth** | Auth solution | Default - flexible, self-hosted |
+| **Clerk** | Managed auth | When you want zero auth code |
+
+### Auth Methods
+
+| Method | Complexity | UX |
+|--------|------------|-----|
+| Email + Password | 🟢 Low | Traditional |
+| Magic Link / OTP | 🟢 Low | Modern, passwordless |
+| OAuth (Google/GitHub) | 🟡 Medium | Convenient for devs |
+| All combined | 🟡 Medium | Maximum flexibility |
+
+## Email
+
+| Tool | Purpose | Free tier |
+|------|---------|-----------|
+| **Resend** | Transactional email | 3,000/month |
+| **React Email** | Email templates | Unlimited |
+
+## Payments
+
+| Tool | Best for | Trade-offs |
+|------|----------|------------|
+| **Stripe** | Most projects | Most flexible, well-documented |
+| **Lemon Squeezy** | Simplicity | Handles taxes, less flexible |
+
+## Analytics & Monitoring
+
+| Tool | Purpose | When to add |
+|------|---------|-------------|
+| **PostHog** | Product analytics | Post-launch |
+| **Sentry** | Error tracking | Post-launch |
+| **Vercel Analytics** | Web vitals | Free with Vercel |
+
+## Deployment
+
+| Tool | Purpose | Why |
+|------|---------|-----|
+| **Vercel** | Hosting | Best Next.js integration |
+| **GitHub Actions** | CI/CD | Automated testing |
+
+---
+
+## Decision Matrix
+
+### When to use what
+
+| Need | Solution |
+|------|----------|
+| Simple CRUD app | Next.js + Prisma + Neon |
+| Real-time features | Supabase or Convex |
+| AI features | Vercel AI SDK |
+| File uploads | Uploadthing or S3 |
+| Background jobs | Trigger.dev or Inngest |
+| Search | Algolia or Typesense |
+| Caching | Upstash Redis |
+
+---
+
+## Cost Estimation Template
+
+### At 1,000 users/month
+
+| Service | Free tier | Paid |
+|---------|-----------|------|
+| Vercel | 100GB bandwidth | $20/mo |
+| Neon | 10GB storage | $19/mo |
+| Resend | 3,000 emails | $20/mo |
+| **Total** | ~$0 | ~$59/mo |
+
+### At 10,000 users/month
+
+| Service | Estimate |
+|---------|----------|
+| Vercel | $20-50/mo |
+| Database | $50-100/mo |
+| Email | $50/mo |
+| **Total** | ~$120-200/mo |

package/src/config/claude-code-config/skills/aibuilder-create-saas/scripts/rename-project.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Rename SaaS project folder and update all project_id references
+# Usage: ./rename-project.sh <old-name> <new-name>
+
+set -e
+
+OLD_NAME="$1"
+NEW_NAME="$2"
+BASE_DIR="$HOME/.claude/output/saas"
+
+if [ -z "$OLD_NAME" ] || [ -z "$NEW_NAME" ]; then
+  echo "Usage: ./rename-project.sh <old-name> <new-name>"
+  exit 1
+fi
+
+OLD_DIR="$BASE_DIR/$OLD_NAME"
+NEW_DIR="$BASE_DIR/$NEW_NAME"
+
+if [ ! -d "$OLD_DIR" ]; then
+  echo "❌ Project not found: $OLD_DIR"
+  exit 1
+fi
+
+if [ -d "$NEW_DIR" ]; then
+  echo "❌ Target already exists: $NEW_DIR"
+  exit 1
+fi
+
+echo "🔄 Renaming project: $OLD_NAME → $NEW_NAME"
+
+# Update project_id in all markdown files
+for file in "$OLD_DIR"/*.md "$OLD_DIR"/tasks/*.md; do
+  if [ -f "$file" ] && grep -q "project_id:" "$file"; then
+    sed -i '' "s/project_id: $OLD_NAME/project_id: $NEW_NAME/g" "$file"
+    echo "  ✓ Updated: $(basename "$file")"
+  fi
+done
+
+# Rename folder
+mv "$OLD_DIR" "$NEW_DIR"
+
+echo "✅ Done: $NEW_DIR"

package/src/config/claude-code-config/skills/aibuilder-create-saas/scripts/setup.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# SaaS Setup Script - Creates output folder structure
+# Usage: ./setup.sh [project-name]
+
+set -e
+
+PROJECT_NAME="${1:-01-to-be-defined}"
+TIMESTAMP=$(date +%Y-%m-%d)
+OUTPUT_DIR="$HOME/.claude/output/saas/$PROJECT_NAME"
+
+echo "🚀 Setting up SaaS project: $PROJECT_NAME"
+
+mkdir -p "$OUTPUT_DIR/tasks"
+
+cat > "$OUTPUT_DIR/idea.md" << EOF
+---
+project_id: $PROJECT_NAME
+created: $TIMESTAMP
+status: discovery
+---
+
+# SaaS Idea
+
+*To be defined during discovery.*
+EOF
+
+cat > "$OUTPUT_DIR/discovery.md" << EOF
+---
+project_id: $PROJECT_NAME
+created: $TIMESTAMP
+---
+
+# Discovery Notes
+
+## User Context
+*Who is the user? What's their background?*
+
+## Discovery Answers
+
+### Manual Tasks
+*Tasks they do manually that could be automated*
+
+### Work/School Pain Points
+*Problems they've seen in professional/educational settings*
+
+### Paid Tools
+*Tools they pay for that could be simplified*
+
+### Community Problems
+*Issues in communities they're part of*
+
+### Spreadsheet Systems
+*Complex spreadsheets/Notion that could become apps*
+
+## Key Insights
+*Patterns and insights from the discovery conversation*
+
+## Selected Direction
+*Which problem/idea was chosen and why*
+EOF
+
+cat > "$OUTPUT_DIR/prd.md" << EOF
+---
+project_id: $PROJECT_NAME
+created: $TIMESTAMP
+status: pending
+---
+
+# Product Requirements Document
+
+*To be created after idea validation.*
+EOF
+
+cat > "$OUTPUT_DIR/archi.md" << EOF
+---
+project_id: $PROJECT_NAME
+created: $TIMESTAMP
+status: pending
+---
+
+# Technical Architecture
+
+*To be created after PRD.*
+EOF
+
+cat > "$OUTPUT_DIR/marketing.md" << EOF
+---
+project_id: $PROJECT_NAME
+created: $TIMESTAMP
+status: pending
+---
+
+# Marketing Strategy
+
+*To be defined during validation.*
+EOF
+
+cat > "$OUTPUT_DIR/tasks/README.md" << EOF
+# Tasks
+
+*To be created after architecture.*
+EOF
+
+echo "✅ Created: $OUTPUT_DIR"

package/src/config/claude-code-config/skills/aibuilder-create-saas/steps/step-00-init.md

@@ -0,0 +1,174 @@
+---
+name: step-00-init
+description: Initialize workflow - parse flags, detect language, create output folder structure
+next_step: steps/step-01-discovery.md
+---
+
+# Step 0: Initialization
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+- 🛑 NEVER skip folder creation when save_mode is true
+- ✅ ALWAYS detect user's language from their input
+- 📋 YOU ARE A setup assistant, not an idea generator
+- 💬 FOCUS on initialization only - don't start discovery yet
+- 🚫 FORBIDDEN to ask idea questions in this step
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Parse arguments first, then create folders
+- 💾 Create output structure: `~/.claude/output/saas/{project_id}/`
+- 📖 Initialize all output files with frontmatter
+- 🚫 FORBIDDEN to load step-01 until init complete
+
+## CONTEXT BOUNDARIES:
+
+- No previous context exists - this is the entry point
+- User's language will be detected from their greeting/input
+- All subsequent steps will respond in user's detected language
+
+## YOUR TASK:
+
+Initialize the SaaS creation workflow by parsing input, detecting language, and creating the output folder structure.
+
+---
+
+## DEFAULTS CONFIGURATION:
+
+```yaml
+save_mode: true    # -s: Save outputs to files (default ON)
+auto_mode: false   # -a: Skip confirmations (default OFF)
+base_output_dir: ~/.claude/output/saas
+```
+
+---
+
+## INITIALIZATION SEQUENCE:
+
+### 1. Parse Arguments and Flags
+
+**Parse from user input:**
+- `{project_name}` = first argument (optional)
+- `{save_mode}` = true (default) | false if -S flag
+- `{auto_mode}` = false (default) | true if -a flag
+- `{continue_mode}` = false (default) | true if -c flag
+- `{continue_project}` = project-id after -c flag
+
+**Generate {project_id}:**
+- If `-c <project-id>` → use that project-id
+- If `{project_name}` provided → kebab-case it
+- If nothing → use `01-to-be-defined`
+
+### 2. Detect User Language
+
+**Analyze user's input to detect language:**
+- French indicators: "bonjour", "salut", "je", "un", "une", accents
+- English indicators: "hello", "hi", "I", "a", "the"
+- Default to English if unclear
+
+**Store as `{user_language}`** for all subsequent responses
+
+### 3. Handle Continue Mode OR Create New Project
+
+**If `{continue_mode}` = true:**
+
+1. Read all existing files from `~/.claude/output/saas/{continue_project}/`:
+   - `discovery.md` → Load into context
+   - `idea.md` → Load into context
+   - `prd.md` → Load into context (if not empty)
+   - `archi.md` → Load into context (if not empty)
+
+2. Determine which step to resume from:
+   - If `idea.md` is empty → Resume at step-01 (discovery)
+   - If `idea.md` has content but `prd.md` empty → Resume at step-03 (validate) or step-04 (prd)
+   - If `prd.md` has content but `archi.md` empty → Resume at step-05 (architecture)
+   - If `archi.md` has content → Resume at step-06 (tasks)
+
+3. Display in `{user_language}`:
+   ```
+   📂 Loaded project: {continue_project}
+
+   Found:
+   - discovery.md: {status}
+   - idea.md: {status}
+   - prd.md: {status}
+   - archi.md: {status}
+
+   Resuming from: {step_name}
+   ```
+
+**If `{continue_mode}` = false (new project):**
+
+Run setup script with Bash tool:
+```bash
+~/.claude/skills/create-saas/scripts/setup.sh {project_id}
+```
+
+### 4. Confirm Initialization
+
+**Display in `{user_language}`:**
+```
+✅ SaaS Creation Workflow Initialized
+
+📁 Output folder: ~/.claude/output/saas/{project_id}/
+📄 Files created: idea.md, prd.md, archi.md, marketing.md
+
+⚙️ Configuration:
+- Save mode: {save_mode}
+- Auto mode: {auto_mode}
+
+Ready to start the discovery phase!
+```
+
+### 5. Proceed to Discovery
+
+**If `{auto_mode}` = true:**
+→ Load step-01-discovery.md immediately
+
+**If `{auto_mode}` = false:**
+Use AskUserQuestion:
+```yaml
+questions:
+  - header: "Start"
+    question: "Ready to start discovering your SaaS idea?" # Translate to user's language
+    options:
+      - label: "Let's go! (Recommended)"
+        description: "Start the discovery phase"
+      - label: "Change settings"
+        description: "Modify configuration before starting"
+    multiSelect: false
+```
+
+---
+
+## SUCCESS METRICS:
+
+✅ User language correctly detected
+✅ Project ID generated or parsed
+✅ Output folder created (if save_mode)
+✅ All 4 output files created with proper frontmatter
+✅ Configuration confirmed with user
+
+## FAILURE MODES:
+
+❌ Proceeding without creating output folder when save_mode is true
+❌ Not detecting user language
+❌ Starting to ask discovery questions in this step
+❌ **CRITICAL**: Not using AskUserQuestion for confirmation
+
+## INIT PROTOCOLS:
+
+- Always respond in the detected user language
+- Keep initialization message concise
+- Don't overwhelm with technical details
+- Focus on getting ready to start, not on the SaaS idea itself
+
+---
+
+## NEXT STEP:
+
+After user confirms via AskUserQuestion, load `./step-01-discovery.md`
+
+<critical>
+Remember: This step is ONLY about setup - don't start asking about SaaS ideas here!
+</critical>