start-vibing 4.4.13 → 4.4.15

package/dist/cli.js

@@ -130,7 +130,7 @@ var STALE_FILES = [
   {
     category: "agents",
     relPath: "research-web.md",
-    replacedBy: "research skill (scout \u2192 query \u2192 synthesize \u2192 verify)",
+    replacedBy: "research skill (scout → query → synthesize → verify)",
     staleChecksums: [
       "49d0cb862d199d1dcb59ed932ed04d8abd0064de3b65ef4f346268528dc21772",
       "72ba14b6cad76a2d8718234775883242e94e82497e4edeec7fb35faf24327d6a",
@@ -219,8 +219,7 @@ function tryDelete(claudeDir, locationLabel, stale, result) {
       location: locationLabel,
       replacedBy: stale.replacedBy
     });
-  } catch {
-  }
+  } catch {}
 }
 function cleanupStaleAgents(targetDir) {
   const result = { deleted: [], keptCustomized: [] };
@@ -240,8 +239,8 @@ function cleanupStaleAgents(targetDir) {
 }
 
 // src/cli.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5, appendFileSync, writeFileSync as writeFileSync5 } from "fs";
-import { join as join6, dirname as dirname2 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync6, appendFileSync as appendFileSync2, writeFileSync as writeFileSync6 } from "fs";
+import { join as join7, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { execSync as execSync3 } from "child_process";
 
@@ -359,8 +358,7 @@ function writeCache(latestVersion) {
       latestVersion
     };
     writeFileSync2(CACHE_FILE, JSON.stringify(entry, null, 2));
-  } catch {
-  }
+  } catch {}
 }
 function isCacheValid(entry) {
   if (!entry)
@@ -509,8 +507,7 @@ async function installClaudeWindows(shell) {
           stdio: "ignore",
           shell: "cmd.exe"
         });
-      } catch {
-      }
+      } catch {}
     }
     return { success: true, alreadyInstalled: false };
   } catch (error) {
@@ -539,9 +536,15 @@ async function installClaudeUnix() {
 function encodeProjectPath(absolutePath) {
   return absolutePath.replace(/\\/g, "/").replace(/\//g, "-");
 }
+function getActiveClaudeDir() {
+  const fromEnv = process.env["CLAUDE_CONFIG_DIR"];
+  if (fromEnv && fromEnv.trim().length > 0)
+    return fromEnv;
+  return join4(homedir2(), ".claude");
+}
 function hasExistingSession(projectDir) {
   const encodedPath = encodeProjectPath(projectDir);
-  const sessionDir = join4(homedir2(), ".claude", "projects", encodedPath);
+  const sessionDir = join4(getActiveClaudeDir(), "projects", encodedPath);
   const indexFile = join4(sessionDir, "sessions-index.json");
   if (existsSync4(indexFile)) {
     try {
@@ -552,15 +555,13 @@ function hasExistingSession(projectDir) {
         if (mainSessions.length > 0)
           return true;
       }
-    } catch {
-    }
+    } catch {}
   }
   if (existsSync4(sessionDir)) {
     try {
       const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.jsonl$/;
       return readdirSync2(sessionDir).some((f) => uuidPattern.test(f));
-    } catch {
-    }
+    } catch {}
   }
   return false;
 }
@@ -597,8 +598,7 @@ function launchClaude(cwd, options = {}) {
 }
 function ensureHooksEnabled() {
   try {
-    const home = homedir2();
-    const globalSettingsPath = join4(home, ".claude", "settings.json");
+    const globalSettingsPath = join4(getActiveClaudeDir(), "settings.json");
     if (!existsSync4(globalSettingsPath)) {
       return { modified: false };
     }
@@ -801,9 +801,12 @@ async function installPlugin(plugin) {
     let stdout = "";
     let stderr = "";
     if (proc.stdin) {
-      proc.stdin.write("y\n");
-      proc.stdin.write("y\n");
-      proc.stdin.write("y\n");
+      proc.stdin.write(`y
+`);
+      proc.stdin.write(`y
+`);
+      proc.stdin.write(`y
+`);
       proc.stdin.end();
     }
     proc.stdout?.on("data", (data) => {
@@ -938,6 +941,12 @@ function getRecommendedSkills() {
   return RECOMMENDED_SKILLS;
 }
 
+// src/profile.ts
+import { spawn as spawn4, spawnSync as spawnSync4 } from "child_process";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync5, appendFileSync, writeFileSync as writeFileSync5 } from "fs";
+import { join as join6, dirname as dirname2 } from "path";
+import { homedir as homedir3 } from "os";
+
 // src/ui.ts
 var c = {
   reset: "\x1B[0m",
@@ -953,7 +962,7 @@ var c = {
   bgRed: "\x1B[41m",
   redBright: "\x1B[91m"
 };
-var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 function createBanner(version) {
   const date = new Date().toISOString().slice(0, 10);
   return `
@@ -963,7 +972,7 @@ ${c.cyan}  \\ \\  / /  | | |  _ \\  | | |  \\| || |  _
 ${c.cyan}   \\ \\/ /   | | | |_) | | | | |\\  || |_| |
 ${c.cyan}    \\__/   |___||____/ |___||_| \\_| \\____|${c.reset}
 
-${c.bright}  v${version}${c.reset}${c.dim}  \xB7  ${date}  \xB7  9 plugins  \xB7  17 skills  \xB7  8 MCPs${c.reset}
+${c.bright}  v${version}${c.reset}${c.dim}  ·  ${date}  ·  9 plugins  ·  17 skills  ·  8 MCPs${c.reset}
 `;
 }
 function createSpinner(initialText) {
@@ -984,13 +993,13 @@ function createSpinner(initialText) {
     succeed(finalText) {
       if (interval)
         clearInterval(interval);
-      process.stdout.write(`\r  ${c.green}\u2713${c.reset} ${finalText}\x1B[K
+      process.stdout.write(`\r  ${c.green}✓${c.reset} ${finalText}\x1B[K
 `);
     },
     fail(finalText) {
       if (interval)
         clearInterval(interval);
-      process.stdout.write(`\r  ${c.red}\u2717${c.reset} ${finalText}\x1B[K
+      process.stdout.write(`\r  ${c.red}✗${c.reset} ${finalText}\x1B[K
 `);
     },
     stop() {
@@ -1004,8 +1013,8 @@ function phaseHeader(step, total, label) {
   return `${c.dim}[${step}/${total}]${c.reset} ${label}`;
 }
 function treeItem(name, description, isLast, success) {
-  const branch = isLast ? "\u2514" : "\u251C";
-  const icon = success ? `${c.green}\u2713${c.reset}` : `${c.red}\u2717${c.reset}`;
+  const branch = isLast ? "└" : "├";
+  const icon = success ? `${c.green}✓${c.reset}` : `${c.red}✗${c.reset}`;
   return `        ${c.dim}${branch}${c.reset} ${c.cyan}${name.padEnd(21)}${c.reset}${icon}  ${c.dim}${description}${c.reset}`;
 }
 function formatElapsed(startMs) {
@@ -1015,27 +1024,159 @@ function formatElapsed(startMs) {
 function printOptionalMcps() {
   console.log("");
   console.log(`  ${c.dim}Optional MCPs (install manually):${c.reset}`);
-  console.log(`    ${c.cyan}github${c.reset}           ${c.dim}\xB7${c.reset}  claude mcp add --transport http -s user github https://api.githubcopilot.com/mcp/`);
-  console.log(`    ${c.cyan}sentry${c.reset}           ${c.dim}\xB7${c.reset}  claude mcp add --transport http -s user sentry https://mcp.sentry.dev/mcp`);
-  console.log(`    ${c.cyan}figma${c.reset}            ${c.dim}\xB7${c.reset}  claude mcp add --transport http -s user figma https://mcp.figma.com/mcp`);
-  console.log(`    ${c.cyan}linear${c.reset}           ${c.dim}\xB7${c.reset}  claude mcp add --transport http -s user linear https://mcp.linear.app/sse`);
-  console.log(`    ${c.cyan}stripe${c.reset}           ${c.dim}\xB7${c.reset}  claude mcp add --transport http -s user stripe https://mcp.stripe.com`);
-  console.log(`    ${c.cyan}vercel${c.reset}           ${c.dim}\xB7${c.reset}  claude mcp add --transport http -s user vercel https://mcp.vercel.com`);
+  console.log(`    ${c.cyan}github${c.reset}           ${c.dim}·${c.reset}  claude mcp add --transport http -s user github https://api.githubcopilot.com/mcp/`);
+  console.log(`    ${c.cyan}sentry${c.reset}           ${c.dim}·${c.reset}  claude mcp add --transport http -s user sentry https://mcp.sentry.dev/mcp`);
+  console.log(`    ${c.cyan}figma${c.reset}            ${c.dim}·${c.reset}  claude mcp add --transport http -s user figma https://mcp.figma.com/mcp`);
+  console.log(`    ${c.cyan}linear${c.reset}           ${c.dim}·${c.reset}  claude mcp add --transport http -s user linear https://mcp.linear.app/sse`);
+  console.log(`    ${c.cyan}stripe${c.reset}           ${c.dim}·${c.reset}  claude mcp add --transport http -s user stripe https://mcp.stripe.com`);
+  console.log(`    ${c.cyan}vercel${c.reset}           ${c.dim}·${c.reset}  claude mcp add --transport http -s user vercel https://mcp.vercel.com`);
+}
+
+// src/profile.ts
+var RESERVED_NAMES = new Set(["default", "main", "claude"]);
+var NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+function parseProfileArg(args) {
+  const idx = args.indexOf("--profile");
+  if (idx === -1)
+    return null;
+  const value = args[idx + 1];
+  if (!value || value.startsWith("--")) {
+    throw new Error("--profile requires a name (e.g. --profile work)");
+  }
+  if (RESERVED_NAMES.has(value.toLowerCase())) {
+    throw new Error(`Profile name "${value}" is reserved. Use a different name (e.g. work, personal, client-x).`);
+  }
+  if (!NAME_PATTERN.test(value)) {
+    throw new Error(`Profile name "${value}" is invalid. Use lowercase letters, digits, and hyphens (e.g. work, my-client).`);
+  }
+  return value;
+}
+function resolveProfileDir(name) {
+  const home = getHomeDir() || homedir3();
+  const dir = join6(home, `.claude-${name}`);
+  return { name, dir, isNew: !existsSync6(dir) };
+}
+function ensureProfileDir(dir) {
+  if (!existsSync6(dir)) {
+    mkdirSync4(dir, { recursive: true });
+  }
+}
+async function loginToProfile(name) {
+  console.log("");
+  console.log(`  ${c.cyan}First-time setup for profile "${name}"${c.reset}`);
+  console.log(`  ${c.dim}Claude needs to authenticate this profile. A browser will open for SSO login.${c.reset}`);
+  console.log(`  ${c.dim}When done, type ${c.bright}/quit${c.reset}${c.dim} (or close the window) to continue.${c.reset}`);
+  console.log("");
+  await new Promise((resolve2) => {
+    const proc = spawn4("claude", ["--dangerously-skip-permissions"], {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    proc.on("exit", () => resolve2());
+    proc.on("error", () => resolve2());
+  });
+  console.log("");
+  console.log(`  ${c.green}✓${c.reset} Login complete. Resuming setup...`);
+  console.log("");
+}
+function getShellConfigPath() {
+  const shell = detectShell();
+  const home = getHomeDir() || homedir3();
+  if (shell === "powershell") {
+    try {
+      const result = spawnSync4("powershell", ["-NoProfile", "-NonInteractive", "-Command", "$PROFILE"], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000 });
+      if (result.status === 0 && result.stdout) {
+        return { path: result.stdout.trim(), shell: "powershell" };
+      }
+    } catch {}
+    return {
+      path: join6(home, "Documents", "WindowsPowerShell", "Microsoft.PowerShell_profile.ps1"),
+      shell: "powershell"
+    };
+  }
+  if (shell === "zsh")
+    return { path: join6(home, ".zshrc"), shell: "zsh" };
+  if (shell === "bash")
+    return { path: join6(home, ".bashrc"), shell: "bash" };
+  return null;
+}
+function buildShellFunction(name, configDir, shell) {
+  const marker = `# start-vibing profile: ${name}`;
+  if (shell === "powershell") {
+    const dirLiteral = configDir.replace(/'/g, "''");
+    return [
+      "",
+      marker,
+      `function claude-${name} {`,
+      `    $env:CLAUDE_CONFIG_DIR = '${dirLiteral}'`,
+      `    claude @args`,
+      `}`,
+      ""
+    ].join(`
+`);
+  }
+  const home = getHomeDir() || homedir3();
+  const portable = configDir.startsWith(home) ? `$HOME${configDir.slice(home.length).replace(/\\/g, "/")}` : configDir.replace(/\\/g, "/");
+  return [
+    "",
+    marker,
+    `claude-${name}() {`,
+    `    CLAUDE_CONFIG_DIR="${portable}" claude "$@"`,
+    `}`,
+    ""
+  ].join(`
+`);
+}
+function injectShellFunction(name, configDir) {
+  const target = getShellConfigPath();
+  if (!target) {
+    return { injected: false, skipped: false, path: null, reloadHint: null };
+  }
+  const marker = `# start-vibing profile: ${name}`;
+  let existing = "";
+  if (existsSync6(target.path)) {
+    try {
+      existing = readFileSync5(target.path, "utf-8");
+    } catch {
+      existing = "";
+    }
+  }
+  if (existing.includes(marker)) {
+    return { injected: false, skipped: true, path: target.path, reloadHint: null };
+  }
+  const snippet = buildShellFunction(name, configDir, target.shell);
+  try {
+    const parent = dirname2(target.path);
+    if (!existsSync6(parent))
+      mkdirSync4(parent, { recursive: true });
+    if (existsSync6(target.path)) {
+      const prefix = existing.endsWith(`
+`) ? "" : `
+`;
+      appendFileSync(target.path, prefix + snippet, "utf-8");
+    } else {
+      writeFileSync5(target.path, snippet, "utf-8");
+    }
+  } catch {
+    return { injected: false, skipped: false, path: target.path, reloadHint: null };
+  }
+  const reload = target.shell === "powershell" ? ". $PROFILE" : target.shell === "zsh" ? "source ~/.zshrc" : "source ~/.bashrc";
+  return { injected: true, skipped: false, path: target.path, reloadHint: reload };
 }
 
 // src/cli.ts
 var __filename3 = fileURLToPath2(import.meta.url);
-var __dirname3 = dirname2(__filename3);
+var __dirname3 = dirname3(__filename3);
 var TOTAL_PHASES = 6;
 function getVersion() {
   try {
     const paths = [
-      join6(__dirname3, "..", "package.json"),
-      join6(__dirname3, "..", "..", "package.json")
+      join7(__dirname3, "..", "package.json"),
+      join7(__dirname3, "..", "..", "package.json")
     ];
     for (const pkgPath of paths) {
-      if (existsSync6(pkgPath)) {
-        const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+      if (existsSync7(pkgPath)) {
+        const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
         return pkg.version || "4.0.0";
       }
     }
@@ -1085,21 +1226,30 @@ function syncGitignore(targetDir) {
     else
       toIgnore.push(p);
   }
-  const gitignorePath = join6(targetDir, ".gitignore");
+  const gitignorePath = join7(targetDir, ".gitignore");
   const header = "# start-vibing (local Claude setup - not tracked in this repo)";
   let current = "";
-  if (existsSync6(gitignorePath))
-    current = readFileSync5(gitignorePath, "utf-8");
+  if (existsSync7(gitignorePath))
+    current = readFileSync6(gitignorePath, "utf-8");
   const existing = new Set(current.split(/\r?\n/).map((l) => l.trim()).filter(Boolean));
   const missing = toIgnore.filter((e) => !existing.has(e));
   if (missing.length === 0) {
     return { success: true, added: [], tracked, message: "Already in .gitignore" };
   }
   if (current.length === 0) {
-    writeFileSync5(gitignorePath, `${header}\n${missing.join("\n")}\n`, "utf-8");
+    writeFileSync6(gitignorePath, `${header}
+${missing.join(`
+`)}
+`, "utf-8");
   } else {
-    const prefix = current.endsWith("\n") ? "" : "\n";
-    appendFileSync(gitignorePath, `${prefix}\n${header}\n${missing.join("\n")}\n`, "utf-8");
+    const prefix = current.endsWith(`
+`) ? "" : `
+`;
+    appendFileSync2(gitignorePath, `${prefix}
+${header}
+${missing.join(`
+`)}
+`, "utf-8");
   }
   return {
     success: true,
@@ -1115,6 +1265,7 @@ var HELP = `${createBanner(VERSION)}
     npx start-vibing [options]
 
   ${c.bright}Options:${c.reset}
+    --profile <name>  Use a separate Claude account profile (~/.claude-<name>/)
     --new             Start fresh Claude session (default: resume last)
     --force           Overwrite all files (including custom domains)
     --no-claude       Skip Claude Code installation and launch
@@ -1124,6 +1275,12 @@ var HELP = `${createBanner(VERSION)}
     --help, -h        Show this help message
     --version, -v     Show version
 
+  ${c.bright}Profiles:${c.reset}
+    Each profile is an isolated Claude account (separate creds, MCPs, plugins).
+    First run on a new profile triggers SSO login before MCP/plugin install.
+    A shell function ${c.dim}claude-<name>${c.reset} is auto-injected for quick switching.
+    Reload your shell ($PROFILE / .bashrc / .zshrc) after first run.
+
   ${c.bright}What it does:${c.reset}
     [1] Copies template files (agents, skills, config)
     [2] Sets up Claude Code (install/migrate if needed)
@@ -1160,6 +1317,20 @@ async function main() {
   const newSession = args.includes("--new");
   const targetDir = process.cwd();
   const globalStart = Date.now();
+  let profile = null;
+  try {
+    const profileName = parseProfileArg(args);
+    if (profileName) {
+      profile = resolveProfileDir(profileName);
+      ensureProfileDir(profile.dir);
+      process.env["CLAUDE_CONFIG_DIR"] = profile.dir;
+    }
+  } catch (err) {
+    console.error("");
+    console.error(`  ${c.red}${err instanceof Error ? err.message : err}${c.reset}`);
+    console.error("");
+    process.exit(1);
+  }
   if (!skipUpdateCheck) {
     try {
       const updateResult = await checkForUpdates(VERSION);
@@ -1169,14 +1340,19 @@ async function main() {
         console.log(`  ${c.dim}Run: ${getUpdateCommand()}${c.reset}`);
         console.log("");
       }
-    } catch {
-    }
+    } catch {}
   }
   console.log(createBanner(VERSION));
   if (isRunningViaNpx()) {
     console.log(`  ${c.dim}TIP: npm install -g start-vibing for permanent access${c.reset}`);
     console.log("");
   }
+  if (profile) {
+    const verb = profile.isNew ? "Creating" : "Reusing";
+    const colour = profile.isNew ? c.cyan : c.green;
+    console.log(`  ${colour}→ ${verb} profile "${profile.name}"${c.reset} ${c.dim}at ${profile.dir}${c.reset}`);
+    console.log("");
+  }
   const phase1Start = Date.now();
   const spinner1 = createSpinner(phaseHeader(1, TOTAL_PHASES, "Copying template files..."));
   try {
@@ -1185,7 +1361,7 @@ async function main() {
     const ignoreResult = syncGitignore(targetDir);
     ensureHooksEnabled();
     const counts = `${result.agents} agents, ${result.skills} skills`;
-    spinner1.succeed(phaseHeader(1, TOTAL_PHASES, `Template files ${c.dim}${"\xB7".repeat(14)}${c.reset} ${counts}  ${c.dim}${formatElapsed(phase1Start)}${c.reset}`));
+    spinner1.succeed(phaseHeader(1, TOTAL_PHASES, `Template files ${c.dim}${"·".repeat(14)}${c.reset} ${counts}  ${c.dim}${formatElapsed(phase1Start)}${c.reset}`));
     if (ignoreResult.success && ignoreResult.added.length > 0) {
       console.log(`        ${c.dim}gitignored ${ignoreResult.added.length} path(s) not tracked upstream (remove from .gitignore to commit)${c.reset}`);
     }
@@ -1227,7 +1403,10 @@ async function main() {
     process.exit(1);
   }
   const claudeStatus = installResult.migrated ? "migrated to native" : installResult.alreadyInstalled ? "ready (native)" : "installed";
-  spinner2.succeed(phaseHeader(2, TOTAL_PHASES, `Claude Code ${c.dim}${"\xB7".repeat(18)}${c.reset} ${claudeStatus}  ${c.dim}${formatElapsed(phase2Start)}${c.reset}`));
+  spinner2.succeed(phaseHeader(2, TOTAL_PHASES, `Claude Code ${c.dim}${"·".repeat(18)}${c.reset} ${claudeStatus}  ${c.dim}${formatElapsed(phase2Start)}${c.reset}`));
+  if (profile && profile.isNew) {
+    await loginToProfile(profile.name);
+  }
   const phase3Start = Date.now();
   if (!skipMcp && isClaudeMcpReady()) {
     const spinner3 = createSpinner(phaseHeader(3, TOTAL_PHASES, "Installing MCP servers (parallel)..."));
@@ -1237,7 +1416,7 @@ async function main() {
     const mcpOk = mcpResult.installed + mcpResult.skipped;
     const mcpTotal = mcpOk + mcpResult.failed;
     const mcpSummary = `${mcpOk}/${mcpTotal} installed`;
-    spinner3.succeed(phaseHeader(3, TOTAL_PHASES, `MCP servers ${c.dim}${"\xB7".repeat(17)}${c.reset} ${mcpSummary}  ${c.dim}${formatElapsed(phase3Start)}${c.reset}`));
+    spinner3.succeed(phaseHeader(3, TOTAL_PHASES, `MCP servers ${c.dim}${"·".repeat(17)}${c.reset} ${mcpSummary}  ${c.dim}${formatElapsed(phase3Start)}${c.reset}`));
     const coreMcps = getCoreMcps();
     for (let i = 0;i < mcpResult.results.length; i++) {
       const r = mcpResult.results[i];
@@ -1248,9 +1427,9 @@ async function main() {
   } else {
     const spinner3 = createSpinner(phaseHeader(3, TOTAL_PHASES, "Installing MCP servers..."));
     if (skipMcp) {
-      spinner3.succeed(phaseHeader(3, TOTAL_PHASES, `MCP servers ${c.dim}${"\xB7".repeat(17)}${c.reset} skipped (--no-mcp)`));
+      spinner3.succeed(phaseHeader(3, TOTAL_PHASES, `MCP servers ${c.dim}${"·".repeat(17)}${c.reset} skipped (--no-mcp)`));
     } else {
-      spinner3.fail(phaseHeader(3, TOTAL_PHASES, `MCP servers ${c.dim}${"\xB7".repeat(17)}${c.reset} skipped (CLI not ready)`));
+      spinner3.fail(phaseHeader(3, TOTAL_PHASES, `MCP servers ${c.dim}${"·".repeat(17)}${c.reset} skipped (CLI not ready)`));
     }
   }
   const phase4Start = Date.now();
@@ -1262,7 +1441,7 @@ async function main() {
     const pluginOk = pluginResult.installed + pluginResult.skipped;
     const pluginTotal = pluginOk + pluginResult.failed;
     const pluginSummary = `${pluginOk}/${pluginTotal} installed`;
-    spinner4.succeed(phaseHeader(4, TOTAL_PHASES, `Plugins ${c.dim}${"\xB7".repeat(21)}${c.reset} ${pluginSummary}  ${c.dim}${formatElapsed(phase4Start)}${c.reset}`));
+    spinner4.succeed(phaseHeader(4, TOTAL_PHASES, `Plugins ${c.dim}${"·".repeat(21)}${c.reset} ${pluginSummary}  ${c.dim}${formatElapsed(phase4Start)}${c.reset}`));
     const plugins = getRecommendedPlugins();
     for (let i = 0;i < pluginResult.results.length; i++) {
       const r = pluginResult.results[i];
@@ -1272,7 +1451,7 @@ async function main() {
     }
   } else {
     const spinner4 = createSpinner(phaseHeader(4, TOTAL_PHASES, "Installing plugins..."));
-    spinner4.succeed(phaseHeader(4, TOTAL_PHASES, `Plugins ${c.dim}${"\xB7".repeat(21)}${c.reset} ${c.dim}deferred (will auto-prompt)${c.reset}`));
+    spinner4.succeed(phaseHeader(4, TOTAL_PHASES, `Plugins ${c.dim}${"·".repeat(21)}${c.reset} ${c.dim}deferred (will auto-prompt)${c.reset}`));
   }
   const phase5Start = Date.now();
   if (!skipSkills && isSkillInstallReady()) {
@@ -1281,7 +1460,7 @@ async function main() {
       spinner5.update(phaseHeader(5, TOTAL_PHASES, `Installing skills... ${c.dim}${current}/${total} done${c.reset}`));
     });
     const skillSummary = `${skillResult.installed}/${skillResult.installed + skillResult.failed} installed`;
-    spinner5.succeed(phaseHeader(5, TOTAL_PHASES, `Community skills ${c.dim}${"\xB7".repeat(11)}${c.reset} ${skillSummary}  ${c.dim}${formatElapsed(phase5Start)}${c.reset}`));
+    spinner5.succeed(phaseHeader(5, TOTAL_PHASES, `Community skills ${c.dim}${"·".repeat(11)}${c.reset} ${skillSummary}  ${c.dim}${formatElapsed(phase5Start)}${c.reset}`));
     const skills = getRecommendedSkills();
     for (let i = 0;i < skillResult.results.length; i++) {
       const r = skillResult.results[i];
@@ -1292,15 +1471,29 @@ async function main() {
   } else {
     const spinner5 = createSpinner(phaseHeader(5, TOTAL_PHASES, "Installing community skills..."));
     if (skipSkills) {
-      spinner5.succeed(phaseHeader(5, TOTAL_PHASES, `Community skills ${c.dim}${"\xB7".repeat(11)}${c.reset} skipped (--no-skills)`));
+      spinner5.succeed(phaseHeader(5, TOTAL_PHASES, `Community skills ${c.dim}${"·".repeat(11)}${c.reset} skipped (--no-skills)`));
     } else {
-      spinner5.fail(phaseHeader(5, TOTAL_PHASES, `Community skills ${c.dim}${"\xB7".repeat(11)}${c.reset} skipped (npx not found)`));
+      spinner5.fail(phaseHeader(5, TOTAL_PHASES, `Community skills ${c.dim}${"·".repeat(11)}${c.reset} skipped (npx not found)`));
+    }
+  }
+  if (profile) {
+    const injection = injectShellFunction(profile.name, profile.dir);
+    if (injection.injected && injection.path && injection.reloadHint) {
+      console.log("");
+      console.log(`  ${c.green}✓${c.reset} Shell function ${c.bright}claude-${profile.name}${c.reset} added to ${c.dim}${injection.path}${c.reset}`);
+      console.log(`        ${c.dim}Reload your shell with:${c.reset} ${c.bright}${injection.reloadHint}${c.reset}`);
+    } else if (injection.skipped && injection.path) {
+      console.log("");
+      console.log(`  ${c.dim}Shell function claude-${profile.name} already present in ${injection.path}${c.reset}`);
+    } else if (!injection.path) {
+      console.log("");
+      console.log(`  ${c.yellow}Could not detect shell config${c.reset}${c.dim} — set CLAUDE_CONFIG_DIR=${profile.dir} manually before running 'claude'.${c.reset}`);
     }
   }
   const sessionExists = hasExistingSession(targetDir);
   const willResume = !newSession && sessionExists;
   const launchMode = newSession ? "new session" : willResume ? "resuming last session" : "new session";
-  console.log(`  ${c.green}\u2713${c.reset} ${phaseHeader(6, TOTAL_PHASES, `Launching Claude Code ${c.dim}${"\xB7".repeat(7)}${c.reset} ${launchMode}`)}`);
+  console.log(`  ${c.green}✓${c.reset} ${phaseHeader(6, TOTAL_PHASES, `Launching Claude Code ${c.dim}${"·".repeat(7)}${c.reset} ${launchMode}`)}`);
   printOptionalMcps();
   console.log("");
   console.log(`  ${c.green}Setup complete${c.reset} in ${formatElapsed(globalStart)}`);

package/package.json

@@ -1,42 +1,42 @@
-{
-	"name": "start-vibing",
-	"version": "4.4.13",
-	"description": "Setup Claude Code with 9 plugins, 6 community skills, and 8 MCP servers. Parallel install, auto-accept, superpowers + ralph-loop. e2e-audit 0.2.0 refactor (skill-only, no agents): SessionStart hook + slash command make the skill keyword-invokable (\"e2e audit\", \"roda o e2e\", \"integration test\", \"test coverage gaps\"). Source-first discovery via detect-stack, discover-routes (Next app/pages/Remix/SvelteKit/Nuxt/Astro), discover-api-surface (HTTP handlers, tRPC procedures, GraphQL, server actions, middleware auth), inventory-existing-tests (preserve prior corpus + sha256 drift hash), and detect-uncovered (branch-diff vs origin/main finds changes not covered by existing specs). Report-then-ask between mapping and Playwright run; post-run-feedback report before writing findings. SHOT+TRACE+ASSERT+SOURCE evidence quad per non-meta finding; meta rules (coverage-gap-*, uncovered-*, test-drift, stack-detect, post-run-feedback) exempt. verify-audit.sh enforces schema + quad. Generic (no project leakage). super-design 0.7.0 carries over.",
-	"type": "module",
-	"bin": {
-		"start-vibing": "./dist/cli.js"
-	},
-	"files": [
-		"dist",
-		"template"
-	],
-	"scripts": {
-		"build": "bun build ./src/cli.ts --outdir ./dist --target node",
-		"dev": "bun run ./src/cli.ts",
-		"prepublishOnly": "bun run build"
-	},
-	"keywords": [
-		"claude",
-		"claude-code",
-		"ai",
-		"agents",
-		"skills",
-		"hooks",
-		"automation",
-		"workflow",
-		"cli"
-	],
-	"author": "joaov",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/LimaTechnologies/ai-development"
-	},
-	"engines": {
-		"node": ">=18.0.0"
-	},
-	"devDependencies": {
-		"@types/node": "^20.0.0",
-		"typescript": "^5.0.0"
-	}
-}
+{
+	"name": "start-vibing",
+	"version": "4.4.15",
+	"description": "Setup Claude Code with 9 plugins, 6 community skills, and 8 MCP servers. Parallel install, auto-accept, superpowers + ralph-loop. e2e-audit 0.2.0 refactor (skill-only, no agents): SessionStart hook + slash command make the skill keyword-invokable (\"e2e audit\", \"roda o e2e\", \"integration test\", \"test coverage gaps\"). Source-first discovery via detect-stack, discover-routes (Next app/pages/Remix/SvelteKit/Nuxt/Astro), discover-api-surface (HTTP handlers, tRPC procedures, GraphQL, server actions, middleware auth), inventory-existing-tests (preserve prior corpus + sha256 drift hash), and detect-uncovered (branch-diff vs origin/main finds changes not covered by existing specs). Report-then-ask between mapping and Playwright run; post-run-feedback report before writing findings. SHOT+TRACE+ASSERT+SOURCE evidence quad per non-meta finding; meta rules (coverage-gap-*, uncovered-*, test-drift, stack-detect, post-run-feedback) exempt. verify-audit.sh enforces schema + quad. Generic (no project leakage). super-design 0.7.0 carries over.",
+	"type": "module",
+	"bin": {
+		"start-vibing": "./dist/cli.js"
+	},
+	"files": [
+		"dist",
+		"template"
+	],
+	"scripts": {
+		"build": "bun build ./src/cli.ts --outdir ./dist --target node",
+		"dev": "bun run ./src/cli.ts",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"claude",
+		"claude-code",
+		"ai",
+		"agents",
+		"skills",
+		"hooks",
+		"automation",
+		"workflow",
+		"cli"
+	],
+	"author": "joaov",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/LimaTechnologies/ai-development"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"typescript": "^5.0.0"
+	}
+}

package/template/.claude/skills/typeui-web3-lp/SKILL.md

@@ -0,0 +1,407 @@
+---
+name: web3-lp
+description: Cyber-tactical landing-page system for Web3 token launches with real product behind them — sticky live-price bar, hex-grid scanline hero, animated track-record proof, floating buy pill, "WHAT IS $TICKER" reveal. Built for fair launches (pump.fun / fair-launch DEX) where the coin is fun but the tech is real. Use when user says "build a token LP", "coin launch page", "web3 LP", "memecoin site with tech", "$TICKER landing", "pump.fun launch site".
+license: MIT
+metadata:
+    author: deadodds-build
+    origin: 'Synthesized from sd-research audits of HyperLiquid, Pump.fun, dYdX, GMX, Mog, Brett, Ondo, Polymarket, Limitless, Drift, Kalshi, Birdeye, Jupiter — and the DeadOdds AI / $ODDS landing page (2026-04-28).'
+---
+
+# Web3-Launch Design System Skill (Universal)
+
+## Mission
+
+You are an expert design-system author for **Web3 token-launch landing pages** — coin LPs that have real tech (not pure memes) and want both degen credibility AND product credibility.
+
+The single hardest thing about a token-with-tech LP is balancing two audiences: degens scanning for ticker + chart + buy-button in <3 seconds, and serious users who need to verify the product works. This skill exists to resolve that tension.
+
+When unsure: prioritize **proof** over **polish**. Numbers > adjectives. Live data > marketing copy. Receipts > promises.
+
+## Brand North-Star
+
+> **The token is fun. The product is real.**
+
+Every section either hypes the coin OR proves the tech. Never both at once. Every claim has a number behind it. Every button has a destination. Nothing is decorative — the cyberpunk aesthetic is the brand voice, not a costume.
+
+## Style Foundations
+
+### Visual style
+
+- Dark base (`#050505` to `#0A0A0A`), single neon accent, monospace data, geometric display headlines
+- Hex-grid or terminal-scanline hero background (open territory; competitors use blob gradients or photography)
+- Glow-shadow CTAs (subtle 28px spread, 4px offset) — never flat
+- Sharp corners (4–8px radius); never rounded-full except for floating pills
+
+### Typography scale
+
+- **Display:** Rajdhani / Orbitron / Geist condensed bold, ALL CAPS, tight tracking
+- **Body:** Inter / Geist Sans, sentence case
+- **Numbers / data:** Geist Mono / JetBrains Mono / IBM Plex Mono, tabular-nums
+- **Scale:** 10/11/12/13.5/14.5/16/22/24/32/48/clamp-hero
+
+### Color palette (default — override if user has tokens)
+
+- `--brand-bg: #050505` (near-black surface)
+- `--brand-surface: #0A0A0A` (cards)
+- `--brand-accent: #7CFF3D` (neon — primary CTA + win signal)
+- `--brand-danger: #FF3D5C` (lose signal / warning)
+- `--brand-chrome: #C7CDD4` (secondary text)
+- `--brand-text: #FFFFFF` (primary text)
+- `--brand-text-muted: #64748B` (slate-500 — labels, captions)
+- `--brand-line: #1A1A1A` (1px borders)
+
+If the user has a token color (memecoin tradition: $MOG = gold, $BRETT = cyan, $PEPE = lime), keep `#7CFF3D` semantics for **GREEN/win** and use the user's color as a **secondary brand accent** for hero glow + token block emphasis. Never use 3+ accents.
+
+### Spacing scale
+
+- `4 / 8 / 12 / 16 / 20 / 24 / 32 / 48 / 64 / 80 / 112 / 144`
+- Section vertical rhythm: `py-20 lg:py-28` minimum between major blocks
+- Cards: `p-5 lg:p-7`
+- Compact UI (price bar, tickers): `py-2.5 px-4`
+
+### Border radius
+
+- Buttons / inputs / cards / pills: `rounded` (4px) — sharp, technical
+- Floating buy pill: `rounded-full` — only exception
+- Token block accent boxes: `rounded` (4–6px)
+- NEVER `rounded-2xl` / `rounded-3xl` — that's SaaS, not Web3-tactical
+
+## Section Playbook (the LP recipe)
+
+This is the canonical section order for a Web3-launch LP. Skip sections you don't have data for, but DO NOT reorder. The flow has been triangulated across 12 audited competitors.
+
+```
+01. PriceBar         — sticky top, h-9, live ticker + MCap + Vol + buy links
+02. MarketingHeader  — sticky top-9, wordmark + nav + social count badges + Launch App
+03. LiveTicker       — marquee of recent product events (signals / trades / mints)
+04. Hero             — hex-grid bg, headline, dual CTAs, contract row, in-hero proof row
+05. WhatIs           — full-screen reveal: "WHAT IS $TICKER?" with poetic 2-liner
+06. TrackRecord      — animated counters + sample resolved/historical data table
+07. HowItWorks       — 3 steps, numbered cards (01 / 02 / 03), big oversized digit watermark
+08. TechPreview      — "Not a meme. A weapon." — mock product UI screenshot or live embed
+09. TokenBlock       — contract card + tokenomics 2x2 grid + buy CTAs
+10. Community        — 3-card grid: Telegram / X / pump.fun (or chain-native exchange)
+11. FAQ              — <details> accordion, 5–7 questions, first item open
+12. FinalCta         — "stop guessing, start sniping" pattern
+13. MarketingFooter  — 4 columns (brand / Product / Token / Community)
+14. FloatingBuy      — fixed bottom-right pill, appears after hero scroll
+```
+
+### Section anatomy rules
+
+**01. PriceBar** (mandatory if token is launched; mock with `TBA` placeholders pre-launch)
+
+- Height `h-9` (36px), `sticky top-0 z-[60]`, `bg-black/95 backdrop-blur-md`
+- Left side: `· $TICKER $price ±change% | MCap $X | Vol 24h $Y | Holders N`
+- Right side: `pump.fun ↗ | Dexscreener ↗`
+- Pulsing dot before ticker for "live" signal (`animate-pulse` + accent glow)
+- Hide non-essential cells progressively at sm/md/lg breakpoints
+- ALWAYS connectable to the launchpad's public API once token is live
+
+**02. MarketingHeader**
+
+- `sticky top-9 z-50 h-14 lg:h-16`
+- Wordmark left, primary nav center, social-count badges + Launch App right
+- Social badges show actual follower counts (e.g. `4,221`) on desktop
+- Primary CTA = "Launch App" → links to the actual product, NOT to buy page
+- Buy CTA lives in PriceBar + FloatingBuy, never in the header
+
+**03. LiveTicker**
+
+- 60s loop marquee, full-width, `border-y border-line bg-surface`
+- Items show ACTUAL product events, not slogans (e.g. "AI: GREEN +14.2pp on [Trump 2028]" not "BUY $ODDS NOW")
+- Pause on hover (already in `globals.css`)
+
+**04. Hero** (the most important section)
+
+- Hex-grid + scanline background — see Motion Catalog
+- Eyebrow: "Fair-launching $TICKER on pump.fun" with pulsing dot
+- Headline: 2 lines, second line is the brand color with `textShadow: 0 0 28px <accent>45`
+- Add terminal-cursor blink (`_`) at end of color line — code-aesthetic signal
+- Sub-copy: 2 sentences max, bold the receipts ("EV-edge bets", "real time", "with receipts")
+- Dual CTA: Primary = "Buy $TICKER on pump.fun" (filled accent) · Secondary = "Launch Oracle/App" (ghost, `bg-black/50 backdrop-blur`)
+- ContractRow card directly below CTAs — NEVER bury contract address in token section
+- In-hero proof row (3 stats max) below contract — animated counters that fire on first paint
+- Stats accent: middle stat is the headline metric (win rate / TVL / users) in brand color
+
+**05. WhatIs** (the moment of poetry)
+
+- `min-h-[80vh]`, oversized type at `clamp(3rem, 11vw, 9rem)`
+- Eyebrow as terminal command: `> query: what_is_$ticker`
+- Headline structure: "WHAT IS" newline "$TICKER?" — second line in accent
+- 2–3 short statements (≤8 words each), the third in muted color as denouement
+- Two CTAs: "Buy $TICKER" + "See the receipts" (anchor to TrackRecord)
+
+**06. TrackRecord** (the onliness section — what no competitor has)
+
+- 4-stat grid (counters animate on scroll into view)
+- Resolved-events / sample-data table: desktop = `<table>`, mobile = card list (NEVER a horizontal scroll)
+- Header row: monospace eyebrow `▸ resolved_predictions · sample` + Brier score / best result on the right
+- Each row: market name + AI/your call + market consensus + resolution badge + edge captured
+- Footer link: "See live signal feed in the [product] ›"
+
+**07. HowItWorks**
+
+- 3 numbered cards in a `lg:grid-cols-3`
+- Big watermark digit (`01 / 02 / 03`) at top-right, opacity `0.025` → `0.10` on hover
+- Card eyebrow: "Step 01" in accent monospace
+- Card headline: ALL CAPS display, ≤3 words
+- Card body: 2 sentences max, plain language
+
+**08. TechPreview**
+
+- Two-column grid `lg:grid-cols-2 lg:items-center`
+- Left = copy + bullet list + CTA · Right = mock product UI in faux window chrome
+- Mock window chrome: 3 dots + tab label `<wordmark> · live signals`
+- 3 mock cards inside, one each: positive / negative / neutral signal — colored accent border
+- Headline pattern: "Not a meme. A weapon." (or domain equivalent — "Not a fork. A protocol.")
+
+**09. TokenBlock**
+
+- 2-column `lg:grid-cols-[1.1fr_1fr]`: hero card on left, tokenomics 2×2 on right
+- Hero card has accent radial blur top-right + ticker huge + chain badge + contract code-block + dual buy CTA
+- Tokenomics tiles: Supply / Launch / Liquidity / Tax — each with label + big number + 1-line caption
+- Default copy for fair launch: "Fair · 100% on pump.fun" / "Burned · LP locked at bond" / "0 / 0 · forever"
+
+**10. Community**
+
+- 3-card grid, each card = social platform with: brand-color icon, name, handle, blurb
+- Cards have subtle hover glow + arrow shifts right
+- Order: Telegram (community) · X (alpha) · pump.fun/Dexscreener (token)
+
+**11. FAQ**
+
+- Native `<details>` accordion (zero JS) inside `<dl>` semantics
+- First item `open` by default
+- "+" → "×" rotation on open via `group-open:rotate-45`
+- 5–7 questions; first MUST be "Is $TICKER required to use the app?" (or domain analog)
+
+**12. FinalCta**
+
+- Centered, `py-24 lg:py-32`, radial-gradient floor accent
+- Headline 2 lines, second line in brand color
+- Same dual CTAs as hero
+
+**13. Footer**
+
+- 4 columns: brand+blurb / Product / Token / Community
+- Disclaimer line: "Not financial advice. Markets are risky. Bet responsibly."
+- Right-aligned tagline: "Built on [chain] · Powered by [tech]"
+
+**14. FloatingBuy** (the conversion safety net)
+
+- Fixed `bottom-5 right-4 lg:bottom-7 lg:right-7`
+- Appears after `scrollY > 600`, hides when `nearFooter` (avoid double-CTA collision)
+- `rounded-full` (only exception to sharp-radius rule), accent-filled
+- Scale-up + glow-up on hover (`hover:scale-[1.03]`)
+
+## Motion Catalog
+
+Six approved motion patterns. **Use ALL of them — collectively they make the LP feel alive, individually they feel decorative. Skip any and the page reads dead.**
+
+1. **Hex-grid scanline** — hero background. CSS gradient hex pattern + radial mask + 1 horizontal scanline sweeping top→bottom over 7s. Open territory; no audited competitor uses it.
+2. **Marquee tickers** — `LiveTicker` (60s loop), pause on hover, `animation-play-state: paused` on hover.
+3. **Animated counters** — IntersectionObserver fires when stat enters viewport at 0.4 threshold; cubic-eased count-up over 1.4s; honors `prefers-reduced-motion`.
+4. **Terminal cursor blink** — single `_` char at end of hero accent line; 1.05s step-end. Reads as "command line", not decorative.
+5. **Floating-pill entrance** — translate-y(20px) + scale(0.9) → identity, 240ms ease-out. Plays each time the pill mounts.
+6. **CTA glow on hover** — primary CTAs gain `box-shadow: 0 0 40px -2px var(--accent)85` on hover, 150ms transition.
+
+**Do NOT add:** parallax (every Web3 LP has it; you'll look generic), full-page scroll-snapping, fade-in-on-scroll for every element (uncanny / slow), confetti, character mascots dancing.
+
+**MUST honor `prefers-reduced-motion: reduce`** — `animation: none` for marquee, scanline, counters, cursor blink. The page must still be navigable and beautiful without motion.
+
+## Copy / Voice
+
+### Tone (Aaker × NN/g)
+
+- **Sincere:** -1 (we're not earnest, we're sharp)
+- **Excitement:** +2 (degen-adjacent, but with restraint)
+- **Competence:** +2 (technical, precise, monospace numbers)
+- **Sophistication:** +1 (cyberpunk minimalism, not luxury)
+- **Ruggedness:** +1 (sniper / weapon / edge metaphors are OK)
+
+### Vocabulary
+
+- **PREFER:** alpha · edge · receipts · ship · sniper · oracle · signal · degen · fair launch · proof · live · win rate · EV (expected value) · Kelly · in the wild
+- **AVOID:** revolutionary · disrupting · ecosystem · empower · journey · mission · synergy · best-in-class · world's first (unless you can prove it)
+- **NEVER:** "leverage", "robust", "seamless", "unlock the future"
+
+### Headline patterns
+
+- 2 lines, second is brand-accent
+- Imperative or noun phrase (avoid passive)
+- Examples that work: "AI sniper for / prediction markets" · "Stop guessing. / Start sniping." · "Not a meme. / A weapon." · "Receipts on chain. / Edge in the wild."
+- Examples that don't: "Welcome to the future of X" · "The next generation of Y"
+
+### CTA copy
+
+- **Primary buy:** "Buy $TICKER" or "Buy $TICKER on pump.fun"
+- **Primary product:** "Launch App" / "Launch Oracle" — never "Get started"
+- **Secondary:** "See the receipts" / "Read docs" / "See live signal feed"
+- Always pair with a `›` arrow glyph (not `→` not lucide arrow)
+
+### Semantic voice
+
+- All numbers tabular-nums always
+- Wins/positive: brand-accent color
+- Losses/negative: `--brand-danger`
+- Neutral/pending: amber / slate-300
+- Status pills: `border-color/40 bg-color/10 text-color`
+
+## Reference LPs Audited
+
+This skill was synthesized from primary research on these sites (full evidence in any sd-research session that targets `web3-launch`):
+
+| Tier                     | Sites                             | What we stole                                                                      |
+| ------------------------ | --------------------------------- | ---------------------------------------------------------------------------------- |
+| Coin-with-tech (premium) | HyperLiquid, GMX, Ondo            | In-hero proof row · animated stat counters · 3-stat hero                           |
+| Pure meme + culture      | Mog, Brett                        | Sticky price bar · floating buy pill · "WTF IS X?" reveal · contract at hero level |
+| Prediction markets       | Polymarket, Kalshi, Limitless     | Live activity ticker · category code (dark + green/red) · marquee above nav        |
+| Solana DeFi              | Jupiter, Drift, Birdeye, Pump.fun | Card-grid layouts · monospace data · neon glow shadows                             |
+
+**Open territory we own:** serious + expressive + terminal/radar aesthetic. No audited competitor uses hex-grid + scanline as hero background. No audited competitor surfaces verifiable on-chain win-rate stats in the LP.
+
+## Default Onliness Pattern
+
+Use this template for the LP's positioning statement:
+
+> "$TICKER is the only [category] token with [verifiable proof] — [what we have], [where the proof lives], [the cultural energy]."
+
+Example: "$ODDS is the only prediction-market token with a verifiable on-chain win rate — AI signals, proof on-chain, degen energy."
+
+## Component Families (LP-scoped)
+
+- price ticker bar
+- marquee live feed
+- hero with motion background
+- contract address row (with copy + explorer + buy)
+- animated stat counter
+- track-record table (desktop) + card list (mobile)
+- numbered step cards
+- mock product preview card
+- token contract card
+- tokenomics tile grid
+- social platform card
+- accordion FAQ
+- floating buy pill
+- 4-column footer
+- terminal-style status header (`▸ command_name`)
+
+## Accessibility (non-negotiable)
+
+- WCAG 2.2 AA contrast on all text (verify accent on dark = 7.0+ for body sizes)
+- Visible focus rings: `focus-visible:outline-2 outline-offset-2 outline-[var(--brand-accent)]`
+- Touch targets `>= 44px` mobile (price bar links exempt; buy CTAs always)
+- `<details>` accordion is keyboard + screen-reader native — DON'T rebuild it as JS
+- All animations `prefers-reduced-motion: reduce` aware
+- Marquee tickers: `role="marquee"` + `aria-label` + pause-on-hover required
+- Contract row: `aria-label="Copy contract address"` on copy button; show `Copied` confirmation
+- Color is never the only signal — always pair with text label or icon (e.g. signal pill says "GREEN" not just green color)
+
+## Writing Tone (for the skill consumer)
+
+Confident, sharp, low-jargon. Short sentences. Active voice. Numbers > adjectives. Receipts > promises. Examples > descriptions.
+
+## Rules: Do
+
+- Lead with the number, not the claim ("73% win rate" before "AI is good")
+- One section = one job (hype OR proof, never both)
+- Use brand-accent only for: primary CTAs, win signals, pulsing live dots, key stats — anywhere else is brand dilution
+- Animate sparingly; every motion must serve recognition or recall
+- Surface the contract address in the hero — never hide it in a token section
+- Write CTAs as commands, not descriptions ("Buy $ODDS" not "Get $ODDS now")
+- Pair every screenshot with a caption that says what it is
+- Keep PriceBar + FloatingBuy as escape hatches so the user is never >300vh from a buy action
+- Pre-launch: use `TBA` placeholders inside the FINAL UI shell — don't omit the section. Users will see the structure they'll buy into
+
+## Rules: Don't
+
+- Don't use rounded-2xl/3xl on cards — that's SaaS, this is tactical
+- Don't write "revolutionary", "disrupt", "next-gen", "future of X"
+- Don't add parallax to the hero — it's the most overused Web3 LP move
+- Don't put 3+ CTAs in the hero — primary buy + secondary product, that's it
+- Don't decorate stats with glyphs/icons — the number IS the decoration
+- Don't make the FAQ a JS-controlled accordion — `<details>` is better
+- Don't ship without `prefers-reduced-motion` overrides on every animation
+- Don't translate the LP — degen audience reads English universally; translation dilutes voice
+- Don't add a "subscribe to newsletter" CTA — degen audiences reject email gates
+- Don't put more than 5 footer columns — 4 max (brand / Product / Token / Community)
+
+## Expected Behavior
+
+- Always restate the user's positioning in one onliness sentence before generating sections
+- Use the section playbook order; only skip sections, never reorder
+- Pre-launch: still ship all sections, fill with mock data shaped like the real data ("2,847 markets analyzed", "$1.42M MCap" — degen-realistic, not "Lorem ipsum")
+- For monorepos / multiple LPs (e.g. one per token), keep this skill as the shared brand floor and override `--brand-accent` per token
+- When a section has no data analog (e.g. a pure meme has no `TrackRecord`), substitute with the closest meme-tier proof (community stats, bridge/exchange listings, viral tweet count) — never delete the section silently
+
+## Guideline Authoring Workflow
+
+1. Restate the user's brand in one onliness sentence (use the template above).
+2. Define palette + type tokens; only override defaults if the user has source-of-truth tokens.
+3. Walk the Section Playbook in order; for each section, name the data the section will display and the CTA destination.
+4. List all 6 motion patterns and confirm `prefers-reduced-motion` overrides exist.
+5. Write the FAQ first (it forces clarity on what the project actually is) — then the rest of the copy.
+6. Run a "no decoration" pass: delete every UI element that isn't a CTA, a proof, or a navigation aid.
+
+## Required Output Structure
+
+When generating a Web3-launch LP, deliver:
+
+- One-line onliness statement
+- Token + brand tokens (palette, type, radius, spacing)
+- Per-section markup with: data shape, copy, CTA targets, motion notes
+- Mobile + desktop layout decisions per section
+- Accessibility checklist (focus rings, reduced-motion, touch targets, ARIA labels)
+- Anti-patterns explicitly avoided
+- QA checklist (see below)
+
+## QA Checklist
+
+- [ ] PriceBar shows live ticker + at least 2 of {MCap, Vol, Holders}; uses `TBA` if pre-launch
+- [ ] Hero contains: eyebrow + 2-line headline + sub-copy + 2 CTAs + contract row + 3-stat proof row — in that order
+- [ ] In-hero counters animate on first paint (or scroll into view), not stuck at 0
+- [ ] Contract row has: address (full or 4-char-truncated) + Copy button + Explorer link + Buy link
+- [ ] WhatIs section has min-h-80vh and oversized clamp(3rem, 11vw, 9rem) headline
+- [ ] TrackRecord stats animate on scroll-into-view via IntersectionObserver
+- [ ] TrackRecord has both desktop table AND mobile card list (NEVER horizontal scroll)
+- [ ] FloatingBuy appears after 600px scroll and disappears within 280px of footer
+- [ ] PriceBar (`top-0`) and Header (`top-9`) stack correctly with no overlap at any scroll
+- [ ] All marquees pause on hover via `[role="marquee"]:hover > div` selector
+- [ ] All animations have `@media (prefers-reduced-motion: reduce)` override
+- [ ] No `rounded-2xl` / `rounded-3xl` anywhere except FloatingBuy (intentional pill)
+- [ ] FAQ uses native `<details>` not JS accordion
+- [ ] Footer has 4 columns max, includes "Not financial advice" disclaimer
+- [ ] All numbers use `tabular-nums` and `font-mono` (Geist Mono / JetBrains Mono)
+- [ ] Brand accent used ONLY on: primary CTAs, win signals, live dots, eyebrow callouts, hero accent line
+- [ ] Touch targets >= 44px on mobile
+- [ ] No use of "revolutionary", "disrupt", "next-gen", "ecosystem", "empower"
+- [ ] If LP has multiple language audiences: ship English only — degen audience reads it universally
+
+## Component Rule Expectations
+
+For every component, define:
+
+- **Default state:** layout, tokens, copy
+- **Hover state:** glow-up if interactive, color shift if link
+- **Focus-visible:** outline ring with brand-accent
+- **Active state:** brief scale-down or color flash
+- **Loading / pre-launch:** show skeleton OR `TBA` placeholder inside final UI shell
+- **Error / empty:** monospace status header (`▸ no_data_yet`) + helpful next-action link
+- **Mobile collapse:** which cells/columns hide; which become card-stacks
+
+## Quality Gates
+
+- Every section must have a quantifiable success metric (CTA click rate / scroll depth / time-on-page) — if you can't name it, the section probably doesn't belong
+- Accent color usage audit: count occurrences. If `--brand-accent` appears more than 12 times in the rendered LP, you're over-using it
+- "No-JS pass": disable JS — the LP must still render readable, navigable, and convey the pitch. Only counters, marquees, and the floating-buy pill should degrade
+- Lighthouse: Performance ≥ 90, Accessibility ≥ 95, Best-Practices ≥ 95, SEO ≥ 95 on the LP
+
+## Migration Notes (when retrofitting an existing LP)
+
+1. Don't try to redesign in-place — fork the route into a route group like `(marketing)/` with its own layout
+2. Pull the dashboard / app out of `/` first; LP takes the root URL, app moves to `/dashboard` or `/app`
+3. Add PriceBar + FloatingBuy LAST, after sections render — they're the conversion safety net, not the structure
+4. The hex-grid scanline goes on the Hero only — don't bleed it into other sections (loses meaning)
+5. Replace any existing "fade up on scroll" decorative animations with the 6 approved motion patterns — quality > quantity
+ <!-- TYPEUI_SH_MANAGED_END -->