@rutvijsathe/ideate 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ideate contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,117 @@
-# Temporary Holding Version
+# /ideate
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An evidence-backed idea validation skill for Claude Code. Takes you from blank page to a BUILD / NARROW / PIVOT / KILL verdict and scoped MVP — without opinion, flattery, or made-up data.
+
+[![Version](https://img.shields.io/badge/version-0.1.0-blue)](CHANGELOG.md)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/rutvij26/ideate?style=flat)](https://github.com/rutvij26/ideate/stargazers)
+
+## Why
+
+Most ideation advice is vibes. /ideate forces every claim about demand, competitors, or pricing to have a source — or be labelled `ASSUMPTION`. It tries to kill your idea first, then validates what survives.
+
+Works for founders, OSS devs, internal-tool builders, researchers, and learners. Works offline too (with honest confidence caps).
+
+## Install
+
+```bash
+npx @rutvijsathe/ideate
+```
+
+Works on Unix, macOS, and Windows. Re-run to update.
+
+<details>
+<summary>No Node? Use curl / PowerShell instead</summary>
+
+**Unix / macOS**
+```bash
+curl -fsSL https://raw.githubusercontent.com/rutvij26/ideate/main/install.sh | bash
+```
+
+**Windows (PowerShell)**
+```powershell
+irm https://raw.githubusercontent.com/rutvij26/ideate/main/install.ps1 | iex
+```
+
+</details>
+
+## Quick Start
+
+```
+/ideate
+```
+
+That's it. The skill detects your intent and asks only what it needs.
+
+**Or be explicit:**
+
+| Command | What it does |
+|---|---|
+| `/ideate` | Auto-detect intent from context |
+| `/ideate validate` | Score a specific idea against demand/competition |
+| `/ideate ideate` | Generate ideas from pain signals |
+| `/ideate compete` | Map competitors and find gaps |
+| `/ideate scope` | Define MVP after a BUILD/NARROW verdict |
+| `/ideate compare` | Score 2–4 ideas side-by-side |
+| `/ideate full` | End-to-end pipeline with stage gates |
+
+## Sample Run (Offline Mode)
+
+```
+> /ideate validate "a CLI tool that explains git diffs in plain English"
+
+Goal type: Commercial
+
+[OFFLINE MODE — no search tools available]
+Confidence cap: LOW. All demand claims labelled ASSUMPTION.
+
+--- ADVERSARIAL PASS ---
+1. GitHub Copilot and similar tools already explain code inline; users won't switch for a standalone CLI
+2. The addressable market is developers comfortable enough with git to use a CLI but confused by diffs — this overlap may be small
+3. ASSUMPTION: developers will pay for this vs using a free LLM wrapper
+
+--- VERDICT ---
+NARROW — LOW confidence
+Weighted score: 3.2/5
+
+What would change this: find 3 independent posts where developers express frustration with understanding git diffs despite using existing tools. Use search string: "git diff confusing site:reddit.com"
+
+Files written: ideate/cli-git-diff-explainer/validation.md
+```
+
+## Philosophy
+
+**Evidence > Opinion.** Every claim about demand, competitors, or pricing needs a source URL, a short quote, and a date — or it is labelled `ASSUMPTION`.
+
+**Try to kill first.** The adversarial pass runs before any positive verdict. BUILD is only possible if the case for outweighs the case against.
+
+**No flattery, no hedging.** Verdicts are BUILD / NARROW / PIVOT / KILL. Confidence is HIGH / MEDIUM / LOW. The cheapest next experiment always has a pass/fail threshold.
+
+## Output
+
+All output is saved to `ideate/<slug>/` in your working directory. Each mode writes its own file:
+- `brief.md` — idea summary
+- `evidence.md` — evidence log with sources
+- `validation.md` — full verdict with score breakdown
+- `competitors.md` — competitive landscape
+- `mvp.md` — MVP scope and handoff prompt
+- `kill-debrief.md` — failure analysis and pivot hypotheses
+
+## User Config (Optional)
+
+Copy the templates and fill them in:
+```bash
+mkdir -p ~/.config/ideate
+cp modes/_profile.template.md ~/.config/ideate/_profile.md
+cp modes/_custom.template.md ~/.config/ideate/_custom.md
+```
+
+These files are not tracked by git (`git clean` safe).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). All contributions welcome — new modes, new goal types, new evidence sources, eval cases.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/bin/install.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+'use strict';
+
+const { execSync } = require('child_process');
+const path = require('path');
+
+const root = path.join(__dirname, '..');
+
+try {
+  if (process.platform === 'win32') {
+    execSync(
+      `powershell -ExecutionPolicy Bypass -File "${path.join(root, 'install.ps1')}"`,
+      { stdio: 'inherit' }
+    );
+  } else {
+    execSync(`bash "${path.join(root, 'install.sh')}"`, { stdio: 'inherit' });
+  }
+} catch (e) {
+  process.exit(e.status || 1);
+}

package/install.ps1

@@ -0,0 +1,43 @@
+$Target = Join-Path $env:USERPROFILE ".claude\skills\ideate"
+$Repo   = "https://github.com/rutvij26/ideate"
+$Branch = "main"
+
+# ── Update path ────────────────────────────────────────────────────────────────
+if (Test-Path (Join-Path $Target ".git")) {
+    Write-Host "/ideate is already installed at $Target"
+    $answer = Read-Host "Update to latest? [Y/n]"
+    if ($answer -match '^[nN]$') {
+        Write-Host "No changes made."
+        exit 0
+    }
+    Push-Location $Target
+    git pull --ff-only
+    Pop-Location
+    Write-Host "Updated. Restart Claude Code to pick up changes."
+    exit 0
+}
+
+# ── Fresh install ───────────────────────────────────────────────────────────────
+if (Test-Path $Target) {
+    $answer = Read-Host "$Target already exists. Overwrite? [y/N]"
+    if ($answer -notmatch '^[yY]$') {
+        Write-Host "Install cancelled."
+        exit 0
+    }
+    Remove-Item -Recurse -Force $Target
+}
+
+if (Get-Command git -ErrorAction SilentlyContinue) {
+    git clone --depth=1 --branch $Branch $Repo $Target
+} else {
+    Write-Host "git not found — downloading zip instead..."
+    $tmp = Join-Path $env:TEMP "ideate-install-$(Get-Random)"
+    New-Item -ItemType Directory -Force -Path $tmp | Out-Null
+    Invoke-WebRequest "$Repo/archive/refs/heads/$Branch.zip" -OutFile "$tmp\ideate.zip"
+    Expand-Archive "$tmp\ideate.zip" -DestinationPath $tmp -Force
+    Move-Item "$tmp\ideate-$Branch" $Target
+    Remove-Item -Recurse -Force $tmp
+}
+
+Write-Host ""
+Write-Host "Done. Restart Claude Code and run /ideate to get started."

package/install.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET="$HOME/.claude/skills/ideate"
+REPO="https://github.com/rutvij26/ideate"
+BRANCH="main"
+
+# ── Update path ────────────────────────────────────────────────────────────────
+if [ -d "$TARGET/.git" ]; then
+  echo "/ideate is already installed at $TARGET"
+  printf "Update to latest? [Y/n] "
+  read -r answer
+  case "${answer:-Y}" in
+    [nN]) echo "No changes made." && exit 0 ;;
+    *)
+      git -C "$TARGET" pull --ff-only
+      echo "Updated. Restart Claude Code to pick up changes."
+      exit 0
+      ;;
+  esac
+fi
+
+# ── Fresh install ───────────────────────────────────────────────────────────────
+if [ -e "$TARGET" ]; then
+  printf "%s already exists. Overwrite? [y/N] " "$TARGET"
+  read -r answer
+  case "$answer" in
+    [yY]) rm -rf "$TARGET" ;;
+    *) echo "Install cancelled." && exit 0 ;;
+  esac
+fi
+
+if command -v git &>/dev/null; then
+  git clone --depth=1 --branch "$BRANCH" "$REPO" "$TARGET"
+else
+  echo "git not found — downloading zip instead..."
+  TMP=$(mktemp -d)
+  trap 'rm -rf "$TMP"' EXIT
+  curl -fsSL "$REPO/archive/refs/heads/$BRANCH.zip" -o "$TMP/ideate.zip"
+  unzip -q "$TMP/ideate.zip" -d "$TMP"
+  mv "$TMP/ideate-$BRANCH" "$TARGET"
+fi
+
+echo ""
+echo "Done. Restart Claude Code and run /ideate to get started."

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "@rutvijsathe/ideate",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Evidence-backed idea validation skill for Claude Code",
+  "bin": {
+    "ideate": "bin/install.js"
+  },
+  "keywords": ["claude", "claude-code", "skill", "ideate", "idea-validation"],
+  "author": "rutvij26",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rutvij26/ideate"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "install.sh",
+    "install.ps1"
+  ]
+}