cc-starter 1.0.6 → 1.1.0

package/README.md

@@ -32,6 +32,7 @@ One command. Interactive wizard. Full setup in 30 seconds.
 | `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 |
+| AI Operating System | Optional developer profile — role, experience, communication style |
 | Plugin presets | One-click installation of best Claude Code plugins |
 
 ---
@@ -92,6 +93,14 @@ Plugins are installed via `claude mcp add` — no manual config needed.
 
 ---
 
+## 🧠 AI Operating System (optional)
+
+Personalize Claude to your working style. The wizard asks for your role, experience level, and communication preference — then auto-derives smart defaults (no beginner explanations for seniors, architecture focus for tech leads, etc.).
+
+Saved as `.claude/memory/user_profile.md` — not committed to git.
+
+---
+
 ## 🚀 Installation
 
 ```bash
@@ -120,6 +129,7 @@ npx cc-starter
 | Memory system | ✅ | ❌ | ❌ | ❌ |
 | Tech stack detection | ✅ | ❌ | ❌ | ✅ |
 | Zero dependencies in output | ✅ | ✅ | ❌ | ✅ |
+| AI Operating System | ✅ | ❌ | ❌ | ❌ |
 
 ---
 
@@ -129,6 +139,7 @@ npx cc-starter
 npx cc-starter
 ├─ Detect tech stack (TypeScript, Next.js, ...)
 ├─ Interactive wizard (name, rate, plugins)
+├─ Optional: personalize Claude (role, style)
 ├─ Scaffold .claude/ + scripts/ + CLAUDE.md
 ├─ Install selected plugins
 └─ Ready to code!

package/lib/constants.js

@@ -26,6 +26,30 @@ export const ALL_PLUGINS = [
   { name: 'claude-seo', source: 'claude-seo', desc: 'SEO audits, E-E-A-T analysis, schema markup, Core Web Vitals, AI search optimization' }
 ];
 
+export const ROLES = [
+  { value: 'frontend',  en: 'Frontend Developer',          de: 'Frontend Developer' },
+  { value: 'backend',   en: 'Backend Developer',           de: 'Backend Developer' },
+  { value: 'fullstack', en: 'Fullstack Developer',         de: 'Fullstack Developer' },
+  { value: 'techlead',  en: 'Tech Lead / Architect',       de: 'Tech Lead / Architect' },
+  { value: 'devops',    en: 'DevOps / SRE',                de: 'DevOps / SRE' },
+  { value: 'data',      en: 'Data Scientist / ML Engineer', de: 'Data Scientist / ML Engineer' },
+  { value: 'student',   en: 'Student / Learning',          de: 'Student / Lernend' },
+  { value: 'other',     en: 'Other',                       de: 'Andere' }
+];
+
+export const EXPERIENCE_LEVELS = [
+  { value: 'beginner',     en: 'Beginner (< 1 year)',      de: 'Einsteiger (< 1 Jahr)' },
+  { value: 'intermediate', en: 'Intermediate (1-3 years)',  de: 'Fortgeschritten (1-3 Jahre)' },
+  { value: 'experienced',  en: 'Experienced (3-7 years)',   de: 'Erfahren (3-7 Jahre)' },
+  { value: 'senior',       en: 'Senior (7+ years)',         de: 'Senior (7+ Jahre)' }
+];
+
+export const COMM_STYLES = [
+  { value: 'short',    en: 'Short & direct — code and results, minimal explanations',  de: 'Kurz & direkt — Code und Ergebnis, minimale Erklärungen' },
+  { value: 'balanced', en: 'Balanced — brief explanations when needed',                 de: 'Balanced — kurze Erklärungen wenn nötig' },
+  { value: 'detailed', en: 'Detailed — explain decisions and alternatives',             de: 'Ausführlich — Entscheidungen und Alternativen erklären' }
+];
+
 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: [] }
@@ -45,7 +69,12 @@ export const I18N = {
       pluginPreset: 'Plugin-Auswahl:',
       selectPlugins: 'Plugins auswählen:',
       detectedStack: 'Erkannter Tech-Stack: ',
-      custom: 'Individuell — einzelne Plugins wählen'
+      custom: 'Individuell — einzelne Plugins wählen',
+      personalize: 'Claude personalisieren?',
+      role: 'Deine Rolle:',
+      specialization: 'Spezialisierung / Schwerpunkt (optional, max 100 Zeichen):',
+      experienceLevel: 'Erfahrungslevel:',
+      commStyle: 'Kommunikationsstil:'
     },
     scaffold: {
       scaffolding: 'Projekt wird eingerichtet...',
@@ -82,6 +111,27 @@ export const I18N = {
       costEstimate: 'Projekt-Kostenschätzung',
       tokenTools: 'Token-sparende Tools',
       htmlStats: 'HTML-Statistiken'
+    },
+    profile: {
+      title: 'Personalisierung',
+      headings: {
+        role: '## Rolle',
+        experience: '## Erfahrung',
+        commStyle: '## Kommunikationsstil',
+        preferences: '## Präferenzen'
+      },
+      preferences: {
+        noBeginnerExplanations: 'Keine Anfänger-Erklärungen bei Standardkonzepten',
+        noBasicsRepetition: 'Keine Wiederholung von Grundlagen, erwarte eigenständiges Urteil',
+        noSummaries: 'Keine Zusammenfassungen am Ende, keine Einleitungen',
+        showAlternatives: 'Alternativen und Trade-offs immer mitliefern',
+        explainConcepts: 'Konzepte erklären, Lernressourcen vorschlagen',
+        architectureFocus: 'Architektur-Perspektive priorisieren, Team-Impact berücksichtigen',
+        infraFocus: 'Infrastruktur, Sicherheit und Monitoring mitdenken'
+      },
+      existingProfile: 'Vorhandenes Profil gefunden. Was soll passieren?',
+      overwriteProfile: 'Überschreiben',
+      skipProfile: 'Überspringen'
     }
   },
   en: {
@@ -95,7 +145,12 @@ export const I18N = {
       pluginPreset: 'Plugin preset:',
       selectPlugins: 'Select plugins:',
       detectedStack: 'Detected tech stack: ',
-      custom: 'Custom — pick individual plugins'
+      custom: 'Custom — pick individual plugins',
+      personalize: 'Personalize Claude?',
+      role: 'Your role:',
+      specialization: 'Specialization / focus (optional, max 100 chars):',
+      experienceLevel: 'Experience level:',
+      commStyle: 'Communication style:'
     },
     scaffold: {
       scaffolding: 'Scaffolding project...',
@@ -132,6 +187,61 @@ export const I18N = {
       costEstimate: 'Project cost estimate',
       tokenTools: 'Token-saving tools',
       htmlStats: 'HTML statistics'
+    },
+    profile: {
+      title: 'Personalization',
+      headings: {
+        role: '## Role',
+        experience: '## Experience',
+        commStyle: '## Communication Style',
+        preferences: '## Preferences'
+      },
+      preferences: {
+        noBeginnerExplanations: 'No beginner explanations for standard concepts',
+        noBasicsRepetition: 'No repetition of basics, expect independent judgment',
+        noSummaries: 'No summaries at the end, no introductions',
+        showAlternatives: 'Always provide alternatives and trade-offs',
+        explainConcepts: 'Explain concepts, suggest learning resources',
+        architectureFocus: 'Prioritize architecture perspective, consider team impact',
+        infraFocus: 'Think about infrastructure, security, and monitoring'
+      },
+      existingProfile: 'Existing profile found. What should we do?',
+      overwriteProfile: 'Overwrite',
+      skipProfile: 'Skip'
     }
   }
 };
+
+export function derivePreferences(role, level, commStyle, lang) {
+  const prefs = [];
+  const t = I18N[lang]?.profile?.preferences || I18N.en.profile.preferences;
+
+  // Level-based
+  if (level === 'experienced' || level === 'senior') {
+    prefs.push(t.noBeginnerExplanations);
+  }
+  if (level === 'senior') {
+    prefs.push(t.noBasicsRepetition);
+  }
+
+  // Communication style
+  if (commStyle === 'short') {
+    prefs.push(t.noSummaries);
+  }
+  if (commStyle === 'detailed') {
+    prefs.push(t.showAlternatives);
+  }
+
+  // Role-based
+  if (role === 'student') {
+    prefs.push(t.explainConcepts);
+  }
+  if (role === 'techlead') {
+    prefs.push(t.architectureFocus);
+  }
+  if (role === 'devops') {
+    prefs.push(t.infraFocus);
+  }
+
+  return prefs;
+}

package/lib/scaffold.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from 'url';
 import Handlebars from 'handlebars';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
-import { I18N } from './constants.js';
+import { I18N, derivePreferences, ROLES, EXPERIENCE_LEVELS, COMM_STYLES } from './constants.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_DIR = path.join(__dirname, '..', 'template');
@@ -95,6 +95,12 @@ export async function scaffold(config, cwd = process.cwd()) {
   filesCreated += 1;
   console.log(chalk.green('  ✓ .cc-starter.json') + chalk.dim(`        ${t.scaffold.created}`));
 
+  // ── 4b. Write user profile (if personalization was chosen) ────────
+  const profileResult = await writeUserProfile(config, claudeAction, cwd, lang, t);
+  if (profileResult.created) {
+    filesCreated += 1;
+  }
+
   // ── 5. Update .gitignore ───────────────────────────────────────────
   const gitignoreUpdated = updateGitignore(cwd);
   if (gitignoreUpdated) {
@@ -239,6 +245,16 @@ function updateGitignore(cwd) {
 
   const marker = '# cc-starter';
   if (content.includes(marker)) {
+    // Block exists — check if user_profile.md entry is present (upgrade path)
+    const profileEntry = '.claude/memory/user_profile.md';
+    if (!content.includes(profileEntry)) {
+      const updatedContent = content.replace(
+        'stats/report.html',
+        'stats/report.html\n' + profileEntry
+      );
+      fs.writeFileSync(gitignorePath, updatedContent, 'utf-8');
+      return true;
+    }
     return false;
   }
 
@@ -247,6 +263,7 @@ function updateGitignore(cwd) {
     '# cc-starter',
     '.vibe-stats.json',
     'stats/report.html',
+    '.claude/memory/user_profile.md',
     ''
   ].join('\n');
 
@@ -256,6 +273,93 @@ function updateGitignore(cwd) {
   return true;
 }
 
+/**
+ * Write .claude/memory/user_profile.md from profile config.
+ * Skipped if claudeAction is 'skip'.
+ * @returns {{ created: boolean }}
+ */
+async function writeUserProfile(config, claudeAction, cwd, lang, t) {
+  if (!config.profile || claudeAction === 'skip') {
+    return { created: false };
+  }
+
+  const profilePath = path.join(cwd, '.claude', 'memory', 'user_profile.md');
+  const profileExists = fs.existsSync(profilePath);
+
+  if (profileExists) {
+    const answer = await inquirer.prompt([{
+      type: 'list',
+      name: 'action',
+      message: t.profile.existingProfile,
+      choices: [
+        { name: t.profile.overwriteProfile, value: 'overwrite' },
+        { name: t.profile.skipProfile, value: 'skip' }
+      ]
+    }]);
+    if (answer.action === 'skip') {
+      console.log(chalk.yellow('  ⊘ user_profile.md') + chalk.dim(`         ${t.scaffold.skipped}`));
+      return { created: false };
+    }
+  }
+
+  const { role, specialization, level, commStyle } = config.profile;
+  const preferences = derivePreferences(role, level, commStyle, lang);
+  const h = t.profile.headings;
+
+  // Find display labels
+  const roleObj = ROLES.find(r => r.value === role);
+  const levelObj = EXPERIENCE_LEVELS.find(l => l.value === level);
+  const commObj = COMM_STYLES.find(c => c.value === commStyle);
+
+  const roleLabel = roleObj ? roleObj[lang] : role;
+  const levelLabel = levelObj ? levelObj[lang] : level;
+  const commLabel = commObj ? commObj[lang] : commStyle;
+
+  const roleLine = specialization ? `${roleLabel} — ${specialization}` : roleLabel;
+
+  const lines = [
+    '---',
+    'name: User Profile',
+    'description: Role, experience level, communication preferences and auto-derived guidelines',
+    'type: user',
+    '---',
+    '',
+    h.role,
+    roleLine,
+    '',
+    h.experience,
+    levelLabel,
+    '',
+    h.commStyle,
+    commLabel,
+  ];
+
+  if (preferences.length > 0) {
+    lines.push('', h.preferences);
+    for (const pref of preferences) {
+      lines.push(`- ${pref}`);
+    }
+  }
+
+  lines.push('');
+
+  fs.ensureDirSync(path.join(cwd, '.claude', 'memory'));
+  fs.writeFileSync(profilePath, lines.join('\n'), 'utf-8');
+  console.log(chalk.green('  ✓ user_profile.md') + chalk.dim(`         ${t.scaffold.created}`));
+
+  // Append to MEMORY.md if not already present (idempotency guard)
+  const memoryPath = path.join(cwd, '.claude', 'memory', 'MEMORY.md');
+  if (fs.existsSync(memoryPath)) {
+    const memoryContent = fs.readFileSync(memoryPath, 'utf-8');
+    if (!memoryContent.includes('user_profile.md')) {
+      const entry = '\n- [User Profile](user_profile.md) — Role, experience, communication preferences\n';
+      fs.appendFileSync(memoryPath, entry, 'utf-8');
+    }
+  }
+
+  return { created: true };
+}
+
 /**
  * Count files recursively in a directory.
  */

package/lib/wizard.js

@@ -7,7 +7,10 @@ import {
   ALL_PLUGINS,
   REPORT_STYLES,
   DEFAULT_HOURLY_RATE,
-  I18N
+  I18N,
+  ROLES,
+  EXPERIENCE_LEVELS,
+  COMM_STYLES
 } from './constants.js';
 
 /**
@@ -26,7 +29,7 @@ function detectProjectName() {
 /**
  * Interactive setup wizard.
  * @param {string[]} techStack - Auto-detected technologies (e.g. ['Node.js', 'TypeScript', 'React'])
- * @returns {Promise<{projectName: string, hourlyRate: number, reportStyle: string, plugins: object[], techStack: string[], lang: string}>}
+ * @returns {Promise<{projectName: string, hourlyRate: number, reportStyle: string, plugins: object[], techStack: string[], lang: string, profile?: {role: string, specialization: string, level: string, commStyle: string}}>}
  */
 export async function wizard(techStack = []) {
   // Language selection FIRST — before anything else
@@ -111,6 +114,56 @@ export async function wizard(techStack = []) {
     ? answers.customPlugins || []
     : PLUGIN_PRESETS[answers.pluginPreset];
 
+  // ── Optional personalization ──────────────────────────────────────
+  let profile = null;
+
+  const { wantsProfile } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'wantsProfile',
+    message: t.wizard.personalize,
+    default: false
+  }]);
+
+  if (wantsProfile) {
+    console.log();
+    console.log(chalk.bold.cyan('  ' + t.profile.title));
+    console.log();
+
+    const profileAnswers = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'role',
+        message: t.wizard.role,
+        choices: ROLES.map(r => ({ name: r[lang], value: r.value }))
+      },
+      {
+        type: 'input',
+        name: 'specialization',
+        message: t.wizard.specialization,
+        validate: (input) => input.length <= 100 || (lang === 'de' ? 'Max. 100 Zeichen' : 'Max 100 characters')
+      },
+      {
+        type: 'list',
+        name: 'level',
+        message: t.wizard.experienceLevel,
+        choices: EXPERIENCE_LEVELS.map(l => ({ name: l[lang], value: l.value }))
+      },
+      {
+        type: 'list',
+        name: 'commStyle',
+        message: t.wizard.commStyle,
+        choices: COMM_STYLES.map(c => ({ name: c[lang], value: c.value }))
+      }
+    ]);
+
+    profile = {
+      role: profileAnswers.role,
+      specialization: profileAnswers.specialization || '',
+      level: profileAnswers.level,
+      commStyle: profileAnswers.commStyle
+    };
+  }
+
   return {
     projectName: answers.projectName,
     projectDescription: answers.projectDescription || '',
@@ -118,6 +171,7 @@ export async function wizard(techStack = []) {
     reportStyle: answers.reportStyle,
     plugins,
     techStack,
-    lang
+    lang,
+    profile
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-starter",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Claude Code Project Kickstart — scaffolds an optimized dev environment with token-saving scripts, COCOMO estimation, and interactive plugin setup",
   "type": "module",
   "bin": {