cc-starter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lars Fanter
+
+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

@@ -0,0 +1,149 @@
+# cc-starter
+
+**Claude Code Project Kickstart** — One command to set up Claude Code like a pro.
+
+[![npm version](https://img.shields.io/npm/v/cc-starter)](https://www.npmjs.com/package/cc-starter)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+---
+
+## The Problem
+
+> You open Claude Code on a new project and start from scratch. No rules, no memory, no structure. Every session you re-explain the same things. You read entire files when you only need the types. You have no idea what your project costs.
+
+## The Solution
+
+```bash
+npx cc-starter
+```
+
+One command. Interactive wizard. Full setup in 30 seconds.
+
+---
+
+## 📦 What You Get
+
+| What | Description |
+|------|-------------|
+| `.claude/rules/` | Battle-tested working rules (task tracking, verification, git discipline) |
+| `.claude/memory/` | Persistent memory system — Claude remembers across sessions |
+| `CLAUDE.md` | Auto-generated project overview with detected tech stack |
+| `scripts/stats/vibe-code.js` | Token-saving extraction tool (types, tree, imports, functions) |
+| `scripts/stats/vibe-stats.js` | Track and measure your token savings |
+| `scripts/stats/cocomo.js` | COCOMO-II project cost estimation |
+| `scripts/stats/project-report.js` | Visual HTML statistics report |
+| Plugin presets | One-click installation of best Claude Code plugins |
+
+---
+
+## 🔥 Token Savings — The Killer Feature
+
+```
+Traditional: Read entire 500-line file          → ~2,000 tokens
+cc-starter:  Extract only types and signatures  → ~200 tokens
+
+That's 90% savings per file read. Over a session, that's thousands of tokens.
+```
+
+Instead of Claude reading entire files, `vibe-code.js` extracts only what matters:
+
+```bash
+node scripts/stats/vibe-code.js types src/api.ts      # Just the interfaces
+node scripts/stats/vibe-code.js tree src/              # Directory overview
+node scripts/stats/vibe-code.js imports src/app.tsx    # Dependency graph
+node scripts/stats/vibe-code.js functions lib/utils.ts # Function signatures
+```
+
+---
+
+## 📊 COCOMO Estimation
+
+Know what your project is worth — before the client asks.
+
+```
+COCOMO-II Project Estimation
+════════════════════════════════
+
+Lines of Code:
+  TypeScript    32,450
+  CSS            4,210
+  ─────────────────────────
+  Total         36,660
+
+Estimation (Semi-Detached):
+  Effort:        9.8 Person-Months
+  Schedule:      5.9 Months
+  Team Size:     1.7 Developers
+  Cost:       €47,040 (at €80/h)
+```
+
+---
+
+## 🔌 Plugin Presets
+
+| Preset | Plugins | Best For |
+|--------|---------|----------|
+| Minimal | superpowers | Solo devs, getting started |
+| Standard | + feature-dev, pr-review-toolkit | Most projects |
+| Full | + frontend-design, ui-ux-pro-max | Frontend-heavy projects |
+| Custom | Pick your own | Power users |
+
+Plugins are installed via `claude mcp add` — no manual config needed.
+
+---
+
+## 🚀 Installation
+
+```bash
+# New project
+mkdir my-app && cd my-app
+npx cc-starter
+
+# Existing project
+cd my-existing-project
+npx cc-starter
+```
+
+**Requirements:** Node.js 18+, Claude Code CLI (optional, for plugin installation)
+
+---
+
+## ⚔️ Comparison
+
+| Feature | cc-starter | TheDecipherist | serpro69 | cloudnative-co |
+|---------|:---:|:---:|:---:|:---:|
+| Token-saving scripts | ✅ | ❌ | ❌ | ❌ |
+| COCOMO estimation | ✅ | ❌ | ❌ | ❌ |
+| HTML project report | ✅ | ❌ | ❌ | ❌ |
+| Interactive wizard | ✅ | ✅ | ❌ | ✅ |
+| Plugin installation | ✅ | ❌ | ❌ | ❌ |
+| Memory system | ✅ | ❌ | ❌ | ❌ |
+| Tech stack detection | ✅ | ❌ | ❌ | ✅ |
+| Zero dependencies in output | ✅ | ✅ | ❌ | ✅ |
+
+---
+
+## 🔍 How It Works
+
+```
+npx cc-starter
+├─ Detect tech stack (TypeScript, Next.js, ...)
+├─ Interactive wizard (name, rate, plugins)
+├─ Scaffold .claude/ + scripts/ + CLAUDE.md
+├─ Install selected plugins
+└─ Ready to code!
+```
+
+The wizard detects your project's language, framework, and package manager — then generates a tailored `CLAUDE.md` and rule set. All output files are plain text with zero runtime dependencies.
+
+---
+
+## 🤝 Contributing
+
+PRs welcome. See [LICENSE](LICENSE) for details.
+
+---
+
+## Author
+
+Built by [Lars Fanter](https://www.linkedin.com/in/larsfanter/) — from real-world experience building production apps with Claude Code.

package/bin/cc-starter.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+import chalk from 'chalk';
+import { detect } from '../lib/detect.js';
+import { wizard } from '../lib/wizard.js';
+import { scaffold } from '../lib/scaffold.js';
+import { installPlugins } from '../lib/plugins.js';
+
+async function main() {
+  // 1. Banner
+  console.log(chalk.cyan.bold(`
+  ╔═══════════════════════════════════════╗
+  ║        cc-starter v1.0.0              ║
+  ║   Claude Code Project Kickstart       ║
+  ╚═══════════════════════════════════════╝
+  `));
+
+  // 2. Auto-detect tech stack
+  console.log(chalk.dim('  Detecting tech stack...'));
+  const techStack = detect(process.cwd());
+
+  if (techStack.languages.length > 0 || techStack.frameworks.length > 0) {
+    const detected = [...techStack.languages, ...techStack.frameworks].join(', ');
+    console.log(chalk.green(`  ✓ Found: ${detected}\n`));
+  } else {
+    console.log(chalk.dim('  No specific tech stack detected (empty or new project)\n'));
+  }
+
+  // 3. Interactive wizard
+  const config = await wizard(techStack);
+
+  // 4. Scaffold files
+  console.log(chalk.cyan('\n  Scaffolding project...\n'));
+  const result = await scaffold(config);
+
+  // 5. Install plugins
+  await installPlugins(config.plugins);
+
+  // 6. Summary
+  console.log(chalk.green.bold(`
+  ══════════════════════════════════════════
+  Done! Run 'claude' to start coding.
+
+  Quick commands:
+    node scripts/stats/cocomo.js          → Project cost estimate
+    node scripts/stats/vibe-code.js help  → Token-saving tools
+    node scripts/stats/project-report.js  → HTML statistics
+  ══════════════════════════════════════════
+  `));
+}
+
+main().catch(err => {
+  console.error(chalk.red(`\n  Error: ${err.message}\n`));
+  process.exit(1);
+});

package/lib/constants.js

@@ -0,0 +1,32 @@
+export const PLUGIN_PRESETS = {
+  minimal: [
+    { name: 'superpowers', source: 'superpowers-marketplace', desc: 'TDD, debugging, plans, brainstorming' }
+  ],
+  standard: [
+    { name: 'superpowers', source: 'superpowers-marketplace', desc: 'TDD, debugging, plans, brainstorming' },
+    { name: 'feature-dev', source: 'claude-code-plugins', desc: 'Code explorer, architect, reviewer agents' },
+    { name: 'pr-review-toolkit', source: 'claude-code-plugins', desc: 'PR reviews, silent-failure-hunter, type analyzer' }
+  ],
+  full: [
+    { name: 'superpowers', source: 'superpowers-marketplace', desc: 'TDD, debugging, plans, brainstorming' },
+    { name: 'feature-dev', source: 'claude-code-plugins', desc: 'Code explorer, architect, reviewer agents' },
+    { name: 'pr-review-toolkit', source: 'claude-code-plugins', desc: 'PR reviews, silent-failure-hunter, type analyzer' },
+    { name: 'frontend-design', source: 'claude-code-plugins', desc: 'UI/UX design skill for frontend projects' },
+    { name: 'ui-ux-pro-max', source: 'ui-ux-pro-max-skill', desc: 'AI design intelligence — 67 UI styles, 161 color palettes, 57 font pairings' }
+  ]
+};
+
+export const ALL_PLUGINS = [
+  { name: 'superpowers', source: 'superpowers-marketplace', desc: 'TDD, debugging, plans, brainstorming' },
+  { name: 'feature-dev', source: 'claude-code-plugins', desc: 'Code explorer, architect, reviewer agents' },
+  { name: 'pr-review-toolkit', source: 'claude-code-plugins', desc: 'PR reviews, silent-failure-hunter, type analyzer' },
+  { name: 'frontend-design', source: 'claude-code-plugins', desc: 'UI/UX design skill for frontend projects' },
+  { name: 'ui-ux-pro-max', source: 'ui-ux-pro-max-skill', desc: 'AI design intelligence — 67 UI styles, 161 color palettes, 57 font pairings' }
+];
+
+export const REPORT_STYLES = {
+  minimal: { label: 'Minimal — zero dependencies, plain HTML with CSS bars', packages: [] },
+  fancy: { label: 'Fancy — visual charts via chart.js CDN (no npm install needed)', packages: [] }
+};
+
+export const DEFAULT_HOURLY_RATE = 80;

package/lib/detect.js

@@ -0,0 +1,109 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Detect programming languages and frameworks in the given directory.
+ * @param {string} cwd - Directory to analyze
+ * @returns {{ languages: string[], frameworks: string[], raw: object }}
+ */
+export function detect(cwd) {
+  const languages = [];
+  const frameworks = [];
+  const raw = { files: [], packageJson: null, requirements: null, pyproject: null };
+
+  const exists = (file) => {
+    try { return fs.existsSync(path.join(cwd, file)); } catch { return false; }
+  };
+
+  const globMatch = (ext) => {
+    try {
+      const entries = fs.readdirSync(cwd);
+      return entries.some((e) => e.endsWith(ext));
+    } catch { return false; }
+  };
+
+  const readJson = (file) => {
+    try { return JSON.parse(fs.readFileSync(path.join(cwd, file), 'utf-8')); } catch { return null; }
+  };
+
+  const readText = (file) => {
+    try { return fs.readFileSync(path.join(cwd, file), 'utf-8'); } catch { return null; }
+  };
+
+  // ── Language detection ──────────────────────────────────────────────
+
+  const pkg = readJson('package.json');
+  if (pkg) raw.packageJson = pkg;
+
+  if (pkg || globMatch('.ts')) {
+    const hasTs = pkg?.devDependencies?.typescript || pkg?.dependencies?.typescript || globMatch('.ts');
+    languages.push(hasTs ? 'TypeScript' : 'JavaScript');
+  }
+
+  const hasPython = exists('requirements.txt') || exists('pyproject.toml') || exists('setup.py');
+  if (hasPython) languages.push('Python');
+
+  if (exists('go.mod'))        languages.push('Go');
+  if (exists('Cargo.toml'))    languages.push('Rust');
+  if (exists('pom.xml') || exists('build.gradle') || exists('build.gradle.kts')) languages.push('Java');
+  if (globMatch('.csproj') || globMatch('.sln')) languages.push('C# / .NET');
+  if (exists('Gemfile'))       languages.push('Ruby');
+  if (exists('composer.json')) languages.push('PHP');
+
+  // ── Framework detection (Node / package.json) ──────────────────────
+
+  if (pkg) {
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+
+    const nodeFw = [
+      ['next',                 'Next.js'],
+      ['react',                'React'],
+      ['vue',                  'Vue'],
+      ['@angular/core',        'Angular'],
+      ['svelte',               'Svelte'],
+      ['express',              'Express'],
+      ['fastify',              'Fastify'],
+      ['tailwindcss',          'Tailwind CSS'],
+      ['prisma',               'Prisma'],
+      ['drizzle-orm',          'Drizzle'],
+      ['@supabase/supabase-js','Supabase'],
+      ['mongoose',             'MongoDB'],
+    ];
+
+    for (const [dep, name] of nodeFw) {
+      if (allDeps[dep]) frameworks.push(name);
+    }
+  }
+
+  // ── Framework detection (Python) ───────────────────────────────────
+
+  if (hasPython) {
+    const reqTxt = readText('requirements.txt');
+    const pyproject = readText('pyproject.toml');
+    if (reqTxt) raw.requirements = reqTxt;
+    if (pyproject) raw.pyproject = pyproject;
+
+    const pythonSource = [reqTxt, pyproject].filter(Boolean).join('\n').toLowerCase();
+
+    const pyFw = [
+      ['fastapi', 'FastAPI'],
+      ['django',  'Django'],
+      ['flask',   'Flask'],
+    ];
+
+    for (const [pkg, name] of pyFw) {
+      if (pythonSource.includes(pkg)) frameworks.push(name);
+    }
+  }
+
+  // ── Collect notable files for raw output ───────────────────────────
+
+  const notable = [
+    'package.json', 'tsconfig.json', 'requirements.txt', 'pyproject.toml',
+    'setup.py', 'go.mod', 'Cargo.toml', 'pom.xml', 'build.gradle',
+    'build.gradle.kts', 'Gemfile', 'composer.json',
+  ];
+  raw.files = notable.filter(exists);
+
+  return { languages, frameworks, raw };
+}

package/lib/plugins.js

@@ -0,0 +1,74 @@
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+
+/**
+ * Check whether the `claude` CLI is available on this machine.
+ * @returns {boolean}
+ */
+function isClaudeAvailable() {
+  try {
+    execSync('claude --version', { stdio: 'ignore', timeout: 10000 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Install Claude Code plugins.
+ *
+ * - If no plugins are selected, prints a dim note and returns.
+ * - If the `claude` CLI is not found, prints manual-install instructions.
+ * - Otherwise attempts `claude plugins add` for each plugin, falling back
+ *   to manual instructions on failure.
+ *
+ * @param {Array<{ name: string, source: string }>} plugins
+ */
+export async function installPlugins(plugins) {
+  if (!plugins || plugins.length === 0) {
+    console.log(chalk.dim('  No plugins selected.'));
+    return;
+  }
+
+  // ── Pre-flight: is the CLI installed? ─────────────────────────────
+
+  if (!isClaudeAvailable()) {
+    console.log(chalk.yellow('\n  ⚠ Claude Code CLI not found. Skipping plugin installation.'));
+    console.log(chalk.dim('    Install Claude Code first: https://claude.ai/download'));
+    console.log(chalk.dim('    Then install plugins manually:\n'));
+    for (const p of plugins) {
+      console.log(chalk.dim(`    claude plugins add ${p.name}@${p.source}`));
+    }
+    return;
+  }
+
+  // ── Install each plugin ───────────────────────────────────────────
+
+  console.log(chalk.cyan('\n  Installing plugins...\n'));
+
+  let installed = 0;
+  let failed = 0;
+
+  for (const plugin of plugins) {
+    const ref = `${plugin.name}@${plugin.source}`;
+    try {
+      console.log(chalk.dim(`  Installing ${plugin.name}...`));
+      execSync(`claude plugins add ${ref}`, {
+        stdio: 'inherit',
+        timeout: 30000,
+      });
+      console.log(chalk.green(`  ✓ ${plugin.name} installed`));
+      installed++;
+    } catch {
+      console.log(chalk.yellow(`  ⚠ ${plugin.name} — manual install needed:`));
+      console.log(chalk.dim(`    claude plugins add ${ref}`));
+      failed++;
+    }
+  }
+
+  // ── Summary ───────────────────────────────────────────────────────
+
+  console.log('');
+  if (installed > 0) console.log(chalk.green(`  ${installed} plugin(s) installed`));
+  if (failed > 0)    console.log(chalk.yellow(`  ${failed} plugin(s) need manual installation`));
+}