get-noesisgen-light 0.1.1

package/bin/index.js

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+
+import { readFileSync, readdirSync, cpSync, chmodSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import { execFileSync } from 'child_process';
+import { homedir, platform } from 'os';
+
+// Detect system language (macOS: AppleLanguages, Linux: $LANG)
+function getSystemLang() {
+  try {
+    if (platform() === 'darwin') {
+      const out = execFileSync('defaults', ['read', '-g', 'AppleLanguages'], { encoding: 'utf8' });
+      const match = out.match(/"?([a-z]{2})/i);
+      if (match) return match[1].toLowerCase();
+    }
+  } catch {}
+  const lang = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || '';
+  const match = lang.match(/^([a-z]{2})/i);
+  return match ? match[1].toLowerCase() : 'en';
+}
+
+// i18n strings
+const strings = {
+  en: {
+    preflight: 'Preflight checks',
+    whereLive: 'Where should NOESIS Light live?',
+    choices: ['Desktop/Noesis', 'Documents/Noesis', 'Custom path'],
+    chooseLocation: 'Choose a location:',
+    customPath: 'Enter path:',
+    alreadyExists: 'already exists. Overwrite? (y/N)',
+    cancelled: 'Installation cancelled.',
+    installing: 'Installing NOESIS Light',
+    creatingVault: 'Creating vault structure...',
+    vaultDone: 'Vault structure created (USER.ENV / SHARED.ENV / AI.ENV)',
+    settingScripts: 'Setting up background scripts...',
+    scriptsDone: (n) => `${n} background scripts ready`,
+    installingSkills: 'Installing skills...',
+    skillsDone: (n) => `${n} skills installed (/bonjour /status /recap /sync /task /deepwork /profile-deep)`,
+    configuringSubs: 'Configuring subagents...',
+    subsDone: '2 subagents configured (analyzer, voice-analyzer)',
+    preparingAgents: 'Preparing background agents...',
+    agentsDone: '4 background agent templates ready (digest, session, watcher, maintenance)',
+    settingGamif: 'Setting up gamification...',
+    gamifDone: 'Gamification ready (18 levels, 3 acts, 48h grace period)',
+    installedTo: (dest) => `NOESIS Light installed to ${dest}`,
+    setupWill: 'Everything is ready. The setup agent will personalize it for you:',
+    setupItems: [
+      'Your profile, portrait, and voice analysis',
+      'Your projects (detected from your files)',
+      'Background agents (scheduled to your rhythm)',
+      "Your system's name and shell aliases",
+    ],
+    next: 'Next:',
+    copied: 'Copied to clipboard — just paste and press Enter.',
+    sayHello: 'Then just say hello — the setup agent will guide you from there.',
+  },
+  fr: {
+    preflight: 'Vérifications préliminaires',
+    whereLive: 'Où installer NOESIS Light ?',
+    choices: ['Desktop/Noesis', 'Documents/Noesis', 'Chemin personnalisé'],
+    chooseLocation: 'Choisir un emplacement :',
+    customPath: 'Entrer le chemin :',
+    alreadyExists: 'existe déjà. Écraser ? (o/N)',
+    cancelled: 'Installation annulée.',
+    installing: 'Installation de NOESIS Light',
+    creatingVault: 'Création de la structure vault...',
+    vaultDone: 'Structure vault créée (USER.ENV / SHARED.ENV / AI.ENV)',
+    settingScripts: 'Configuration des scripts...',
+    scriptsDone: (n) => `${n} scripts prêts`,
+    installingSkills: 'Installation des skills...',
+    skillsDone: (n) => `${n} skills installés (/bonjour /status /recap /sync /task /deepwork /profile-deep)`,
+    configuringSubs: 'Configuration des subagents...',
+    subsDone: '2 subagents configurés (analyzer, voice-analyzer)',
+    preparingAgents: 'Préparation des agents de fond...',
+    agentsDone: '4 agents de fond prêts (digest, session, watcher, maintenance)',
+    settingGamif: 'Configuration de la gamification...',
+    gamifDone: 'Gamification prête (18 niveaux, 3 actes, période de grâce 48h)',
+    installedTo: (dest) => `NOESIS Light installé dans ${dest}`,
+    setupWill: "Tout est prêt. L'agent de setup va tout personnaliser :",
+    setupItems: [
+      'Ton profil, portrait et analyse vocale',
+      'Tes projets (détectés depuis tes fichiers)',
+      'Les agents de fond (calés sur ton rythme)',
+      'Le nom et les alias shell de ton système',
+    ],
+    next: 'Suite :',
+    copied: 'Copié dans le presse-papiers — colle et appuie sur Entrée.',
+    sayHello: "Puis dis simplement bonjour — l'agent de setup prend le relais.",
+  },
+  es: {
+    preflight: 'Verificaciones previas',
+    whereLive: '¿Dónde instalar NOESIS Light?',
+    choices: ['Desktop/Noesis', 'Documents/Noesis', 'Ruta personalizada'],
+    chooseLocation: 'Elige una ubicación:',
+    customPath: 'Introduce la ruta:',
+    alreadyExists: 'ya existe. ¿Sobrescribir? (s/N)',
+    cancelled: 'Instalación cancelada.',
+    installing: 'Instalando NOESIS Light',
+    creatingVault: 'Creando estructura del vault...',
+    vaultDone: 'Estructura del vault creada (USER.ENV / SHARED.ENV / AI.ENV)',
+    settingScripts: 'Configurando scripts...',
+    scriptsDone: (n) => `${n} scripts listos`,
+    installingSkills: 'Instalando skills...',
+    skillsDone: (n) => `${n} skills instalados (/bonjour /status /recap /sync /task /deepwork /profile-deep)`,
+    configuringSubs: 'Configurando subagentes...',
+    subsDone: '2 subagentes configurados (analyzer, voice-analyzer)',
+    preparingAgents: 'Preparando agentes de fondo...',
+    agentsDone: '4 agentes de fondo listos (digest, session, watcher, maintenance)',
+    settingGamif: 'Configurando gamificación...',
+    gamifDone: 'Gamificación lista (18 niveles, 3 actos, período de gracia 48h)',
+    installedTo: (dest) => `NOESIS Light instalado en ${dest}`,
+    setupWill: 'Todo listo. El agente de setup lo personalizará todo:',
+    setupItems: [
+      'Tu perfil, retrato y análisis vocal',
+      'Tus proyectos (detectados en tus archivos)',
+      'Agentes de fondo (ajustados a tu ritmo)',
+      'El nombre y los alias shell de tu sistema',
+    ],
+    next: 'Siguiente:',
+    copied: 'Copiado al portapapeles — pega y presiona Enter.',
+    sayHello: 'Luego simplemente di hola — el agente de setup te guiará.',
+  },
+};
+
+function t(lang) {
+  return strings[lang] || strings.en;
+}
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_DIR = resolve(__dirname, '..', 'template');
+
+// Colors (with NO_COLOR support)
+const nc = !process.env.NO_COLOR && process.stdout.isTTY;
+const c = {
+  reset: nc ? '\x1b[0m' : '',
+  bold: nc ? '\x1b[1m' : '',
+  dim: nc ? '\x1b[2m' : '',
+  green: nc ? '\x1b[32m' : '',
+  cyan: nc ? '\x1b[36m' : '',
+  yellow: nc ? '\x1b[33m' : '',
+  red: nc ? '\x1b[31m' : '',
+};
+
+function getVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
+    return pkg.version;
+  } catch {
+    return '0.1.0';
+  }
+}
+
+function getBanner(version) {
+  try {
+    const banner = readFileSync(resolve(__dirname, '..', 'assets', 'banner.txt'), 'utf8');
+    return `${c.cyan}${banner}${c.reset}${c.dim}   v${version}${c.reset}\n`;
+  } catch {
+    return `${c.cyan}${c.bold}NOESIS Light${c.reset} ${c.dim}v${version}${c.reset}\n   Your cognitive operating system starter kit.\n`;
+  }
+}
+
+function fail(msg) {
+  console.error(`\n${c.red}✗ ${msg}${c.reset}\n`);
+  process.exit(1);
+}
+
+function ok(msg) {
+  console.log(`${c.green}✓${c.reset} ${msg}`);
+}
+
+// Animated spinner for a step
+function spinner(label) {
+  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let i = 0;
+  const interval = setInterval(() => {
+    process.stdout.write(`\r\x1b[K${c.cyan}${frames[i % frames.length]}${c.reset} ${label}`);
+    i++;
+  }, 80);
+
+  return {
+    done(msg) {
+      clearInterval(interval);
+      process.stdout.write(`\r\x1b[K${c.green}✓${c.reset} ${msg || label}\n`);
+    },
+    fail(msg) {
+      clearInterval(interval);
+      process.stdout.write(`\r\x1b[K${c.red}✗${c.reset} ${msg || label}\n`);
+    }
+  };
+}
+
+// Delay helper
+function wait(ms) {
+  return new Promise(r => setTimeout(r, ms));
+}
+
+// Preflight checks
+function preflight() {
+  const p = platform();
+  if (p !== 'darwin' && p !== 'linux') {
+    fail(`NOESIS Light requires macOS or Linux. Detected: ${p}`);
+  }
+
+  const nodeVersion = parseInt(process.version.slice(1));
+  if (nodeVersion < 18) {
+    fail(`Node.js 18+ required. You have ${process.version}`);
+  }
+  ok(`Node.js ${process.version}`);
+
+  try {
+    execFileSync('which', ['claude'], { stdio: 'ignore' });
+    ok('Claude CLI found');
+  } catch {
+    fail(`Claude CLI not found.\n\n  Install it: https://docs.anthropic.com/en/docs/claude-code\n\n  Then run this installer again.`);
+  }
+}
+
+// Prompt user for input
+function ask(question, defaultValue) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const prompt = defaultValue
+      ? `${question} ${c.dim}(${defaultValue})${c.reset} `
+      : `${question} `;
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim() || defaultValue || '');
+    });
+  });
+}
+
+// Choose from numbered list
+async function choose(question, options) {
+  console.log(`\n${question}`);
+  for (let i = 0; i < options.length; i++) {
+    console.log(`  ${c.cyan}${i + 1}.${c.reset} ${options[i]}`);
+  }
+  const answer = await ask(`\n${c.dim}(1-${options.length})${c.reset}`, '1');
+  const idx = parseInt(answer) - 1;
+  return idx >= 0 && idx < options.length ? idx : 0;
+}
+
+// Main
+async function main() {
+  const version = getVersion();
+  const lang = getSystemLang();
+  const s18n = t(lang);
+
+  console.log(getBanner(version));
+
+  // Preflight
+  console.log(`${c.bold}${s18n.preflight}${c.reset}`);
+  preflight();
+  console.log();
+
+  // Destination path with choices
+  const home = homedir();
+  const pathOptions = [
+    join(home, 'Desktop', 'Noesis'),
+    join(home, 'Documents', 'Noesis'),
+  ];
+
+  const choice = await choose(s18n.chooseLocation, [
+    ...s18n.choices.slice(0, 2).map((label, i) => `${label} ${c.dim}(${pathOptions[i]})${c.reset}`),
+    s18n.choices[2],
+  ]);
+
+  let dest;
+  if (choice < 2) {
+    dest = pathOptions[choice];
+  } else {
+    const customInput = await ask(s18n.customPath);
+    dest = resolve(customInput.replace(/^~/, home));
+  }
+
+  // Check if exists
+  if (existsSync(dest)) {
+    const confirmChar = lang === 'fr' ? 'o' : lang === 'es' ? 's' : 'y';
+    const overwrite = await ask(`${dest} ${s18n.alreadyExists}`, 'N');
+    if (overwrite.toLowerCase() !== confirmChar && overwrite.toLowerCase() !== 'y') {
+      console.log(`\n${c.dim}${s18n.cancelled}${c.reset}`);
+      process.exit(0);
+    }
+  }
+
+  console.log(`\n${c.bold}${s18n.installing}${c.reset}\n`);
+
+  // Step 1: Vault structure
+  let s = spinner(s18n.creatingVault);
+  mkdirSync(dest, { recursive: true });
+  cpSync(TEMPLATE_DIR, dest, { recursive: true });
+  await wait(400);
+  s.done(s18n.vaultDone);
+
+  // Step 2: Scripts
+  s = spinner(s18n.settingScripts);
+  const scriptsDir = join(dest, 'scripts');
+  let scriptCount = 0;
+  if (existsSync(scriptsDir)) {
+    try {
+      const scripts = readdirSync(scriptsDir).filter(f => f.endsWith('.sh'));
+      for (const script of scripts) {
+        chmodSync(join(scriptsDir, script), 0o755);
+      }
+      scriptCount = scripts.length;
+    } catch {}
+  }
+  await wait(300);
+  s.done(s18n.scriptsDone(scriptCount));
+
+  // Step 3: Skills
+  s = spinner(s18n.installingSkills);
+  const skillsDir = join(dest, '.claude', 'skills');
+  let skillCount = 0;
+  if (existsSync(skillsDir)) {
+    try {
+      skillCount = readdirSync(skillsDir).filter(d => {
+        return existsSync(join(skillsDir, d, 'SKILL.md'));
+      }).length;
+    } catch {}
+  }
+  await wait(350);
+  s.done(s18n.skillsDone(skillCount));
+
+  // Step 4: Subagents
+  s = spinner(s18n.configuringSubs);
+  await wait(250);
+  s.done(s18n.subsDone);
+
+  // Step 5: LaunchAgent templates
+  s = spinner(s18n.preparingAgents);
+  await wait(300);
+  s.done(s18n.agentsDone);
+
+  // Step 6: Gamification
+  s = spinner(s18n.settingGamif);
+  await wait(200);
+  s.done(s18n.gamifDone);
+
+  // Copy next command to clipboard
+  const nextCmd = `cd ${dest} && claude`;
+  try {
+    if (platform() === 'darwin') {
+      execFileSync('pbcopy', { input: nextCmd, stdio: ['pipe', 'ignore', 'ignore'] });
+    } else {
+      execFileSync('xclip', ['-selection', 'clipboard'], { input: nextCmd, stdio: ['pipe', 'ignore', 'ignore'] });
+    }
+  } catch {}
+
+  const copied = s18n.copied || 'Copied to clipboard — just paste and press Enter.';
+
+  // Summary
+  const items = s18n.setupItems.map(item => `  ${c.dim}•${c.reset} ${item}`).join('\n');
+  console.log(`
+${c.green}${c.bold}✓ ${s18n.installedTo(dest)}${c.reset}
+
+  ${c.dim}${s18n.setupWill}${c.reset}
+${items}
+
+${c.bold}${s18n.next}${c.reset}
+
+  ${c.cyan}${nextCmd}${c.reset}
+  ${c.dim}${copied}${c.reset}
+
+  ${c.dim}${s18n.sayHello}${c.reset}
+`);
+}
+
+main().catch((err) => {
+  console.error(`\n${c.red}Error: ${err.message}${c.reset}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "get-noesisgen-light",
+  "version": "0.1.1",
+  "description": "NOESIS Light — Your cognitive operating system starter kit. Install a personalized AI-powered second brain via Claude Code.",
+  "type": "module",
+  "bin": {
+    "get-noesisgen-light": "bin/index.js"
+  },
+  "files": [
+    "bin/",
+    "template/",
+    "assets/"
+  ],
+  "keywords": [
+    "noesis",
+    "claude-code",
+    "cognitive-system",
+    "second-brain",
+    "productivity",
+    "ai-assistant"
+  ],
+  "author": "Gino Fontana",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ginoftn/noesis-gen-light.git"
+  },
+  "homepage": "https://github.com/ginoftn/noesis-gen-light",
+  "bugs": {
+    "url": "https://github.com/ginoftn/noesis-gen/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/template/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(date *)",
+      "Bash(cat *)",
+      "Bash(wc *)",
+      "Bash(ls *)",
+      "Bash(launchctl *)",
+      "Read",
+      "Write",
+      "Edit",
+      "Glob",
+      "Grep"
+    ]
+  }
+}

package/template/.claude/skills/bonjour/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: bonjour
+description: First session of the day. Checks time, loads adapted context, presents the daily brief.
+user-invocable: true
+disable-model-invocation: false
+argument-hint: ""
+---
+
+# Bonjour -- First interactive session of the day
+
+This skill is for the FIRST session only. For subsequent sessions, use `/sync`.
+
+## Step 1: Check current time
+
+Run `date "+%Y-%m-%d %H:%M %A"` — MANDATORY, before anything else.
+
+Determine the moment:
+- 05h-11h59: `morning` — energetic greeting
+- 12h-17h59: `afternoon` — casual greeting
+- 18h-22h59: `evening` — focused, lighter context load
+- 23h-04h59: `night` — minimal, complicit
+
+## Step 2: Load context (adapted to time)
+
+### Always (any time of day)
+
+1. Today's daily note: `vault/SHARED.ENV/daily-notes/YYYY-MM-DD.md`
+2. Today's digest: `vault/AI.ENV/outputs/digest-latest.md` (if available)
+3. Active objectives: `vault/SHARED.ENV/registres/projets-actifs.md`
+
+### Morning or afternoon (before 18h) — full load
+
+4. Momentum: `vault/SHARED.ENV/registres/momentum.md`
+5. Annual + quarterly objectives: `vault/USER.ENV/objectifs/annuel.md` + `trimestriel.md`
+6. Today's agent outputs: `vault/AI.ENV/outputs/` (files from today)
+
+### Evening or night (18h+) — light load
+
+4. Momentum: "Current focus" section only
+5. Agent outputs only if new since last session
+6. DO NOT reload projets-actifs or annual objectives — too heavy for evening
+
+## Step 3: Check autonomous sessions
+
+If autonomous sessions (digest, auto session) have already run today:
+- Mention in 1 line what they produced
+- If no output visible, note it (not an anomaly if before scheduled time)
+
+## Step 4: Display the brief
+
+Format adapted to the moment, in the user's primary language:
+
+```
+## [Greeting] -- [day] [date], [time]
+
+### Today
+- [remaining schedule, key events]
+- [autonomous sessions if already run]
+
+### Active projects [EVENING: replace with "Tonight"]
+- [hot projects, 1 line each]
+- [XP streak if relevant]
+
+### What brings you here?
+```
+
+**Evening/night:** reduce "Active projects" to the strict minimum. No full panorama.
+
+## Step 5: Ask for invisible context
+
+Always end by asking what happened in spaces the system can't see (other tools, reflections, conversations, reading). Integrated in "What brings you here?" — no need for a separate question unless the day has been long.
+
+## Rules
+
+- **NEVER invoke this skill if an interactive session already happened today.** Use `/sync` instead.
+- USER.ENV files (profil, portrait, voice-dna) are loaded by CLAUDE.md at boot — don't re-read here.
+- Compact. Every line carries information. No filler.
+- Tone adapts to the moment: energetic morning, focused evening, complicit night.
+- Communicate in the user's primary language.

package/template/.claude/skills/deepwork/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: deepwork
+description: Deep work mode. Loads full project context, structures in pomodoros, auto-recap at the end.
+user-invocable: true
+disable-model-invocation: false
+argument-hint: "<PROJECT> [DURATION in minutes, default 60]"
+---
+
+# Deep Work -- Immersive session
+
+Start an immersive creative work session. Everything loaded, everything ready, minimize interruptions.
+
+## Prerequisites
+
+$ARGUMENTS must contain at least a project name. If absent, ask.
+Duration is optional (default 60 minutes).
+
+## Phase 1: Context loading (silent)
+
+Read everything without displaying details, just a loading message:
+
+1. Project file: `vault/SHARED.ENV/registres/projets/<PROJECT>.md`
+2. Latest daily note: `vault/SHARED.ENV/daily-notes/`
+3. Momentum: `vault/SHARED.ENV/registres/momentum.md`
+4. Voice-dna (project-relevant parts): `vault/USER.ENV/voice-dna.md`
+5. XP tracker: `vault/SHARED.ENV/gamification/xp-tracker.md`
+
+## Phase 2: Briefing (compact)
+
+```
++======================================================+
+|  DEEP WORK -- PROJECT (Xmin)                         |
++======================================================+
+|  CONTEXT                                              |
+|  Last activity: [date + what]                         |
+|  State: [completion + next step]                      |
+|  Estimated energy: [based on time + momentum]         |
+|                                                       |
+|  SESSION PLAN                                         |
+|  P1  [00:00-00:25]  [micro-objective 1]              |
+|  --  [5min break]                                     |
+|  P2  [00:30-00:55]  [micro-objective 2]              |
+|  [+ more if duration > 60min]                         |
+|                                                       |
+|  Ready? (or adjust the plan)                          |
++======================================================+
+```
+
+Pomodoro structure:
+- 30min → 1x25 + 5min break
+- 60min → 2x25 + 10min breaks
+- 90min → 3x25 + 15min breaks
+- 120min → 4x25 + breaks + long break
+
+## Phase 3: Work (focus)
+
+- Stay on the project. Don't suggest digressions.
+- If the user drifts, gently refocus: "Save that for after? Pomodoro is running."
+- No /status, no /sync during deep work.
+- Note off-topic ideas in an internal buffer for the recap.
+
+## Phase 4: Auto-recap (at the end)
+
+When the session ends (user says "stop" or time is up):
+
+```
++======================================================+
+|  END DEEP WORK -- PROJECT                            |
++======================================================+
+|  Actual duration: Xmin                                |
+|  Pomodoros completed: X/Y                             |
+|  XP earned: +XX                                       |
+|                                                       |
+|  WHAT WAS DONE                                        |
+|  [factual list]                                       |
+|                                                       |
+|  BUFFERED IDEAS (off-topic)                           |
+|  - [idea 1 -- save to captures?]                      |
+|  - [idea 2]                                           |
+|                                                       |
+|  NEXT DEEP WORK SUGGESTED                             |
+|  -> [next logical step + suggested duration]          |
++======================================================+
+```
+
+1. Update `vault/SHARED.ENV/gamification/xp-tracker.md` with earned XP
+2. Write the recap to today's daily note (same format as `/recap write`)
+3. Offer to save buffered ideas to `vault/SHARED.ENV/captures/`
+
+## Style
+
+- Compact briefing, no filler
+- During work: maximum focus, creation-oriented responses
+- Recap: factual, celebratory if productive, neutral otherwise
+- Never guilt-trip if deep work is shorter than planned
+- Communicate in the user's primary language

package/template/.claude/skills/profile-deep/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: profile-deep
+description: Enrich profile, portrait, and voice-dna by analyzing the user's writing and work patterns.
+user-invocable: true
+disable-model-invocation: false
+argument-hint: "[focus] -- no argument = full analysis, 'voice' = voice-dna only, 'patterns' = patterns only"
+---
+
+# Profile Deep -- Enrich your cognitive profile
+
+Analyze the user's files and writing to deepen the profile, portrait, and voice-dna. Can be run as many times as wanted — each pass adds depth.
+
+## What you do
+
+### Step 1: Scan for material
+
+Scan the user's project directories for text content:
+- Look for .md, .txt files modified in the last 90 days
+- Prioritize: long files (>500 words), creative writing, personal notes
+- Identify 5-10 candidate files across different projects
+- Show the list to the user: "I found these files. OK to analyze the style? I'll read how you write, not what you write."
+
+### Step 2: Voice analysis (via subagent)
+
+Launch the voice-analyzer subagent (`subagents/voice-analyzer-CLAUDE.md`) with the approved file list.
+
+The subagent analyzes:
+- Sentence length, register, recurring tics, rhythm, narrative voice
+- Patterns across files (not just within one)
+- What's absent from the writing
+
+Update `vault/USER.ENV/voice-dna.md` Part 2 with the results. If Part 2 already exists, enrich it (don't overwrite — add new observations, confirm or revise existing ones).
+
+### Step 3: Pattern analysis
+
+From the file scan + conversation history + daily notes, identify:
+- **Work patterns:** When does the user work? In bursts or steadily? Morning or night?
+- **Project patterns:** How many projects started vs finished? Common themes?
+- **Behavioral patterns:** Does the user start more than finish? Organize instead of do? Theorize instead of act?
+
+Update `vault/USER.ENV/portrait.md` with new observations. Show changes to the user before writing.
+
+### Step 4: Red threads
+
+Look across all detected projects for recurring themes — the deep connections:
+- Shared motifs, characters, ideas
+- Complementary projects (one explores what another avoids)
+- Evolution over time (what the user returns to)
+
+Update `vault/USER.ENV/voice-dna.md` Part 3 (Red threads). Show to user before writing.
+
+### Step 5: Profile summary
+
+If `vault/USER.ENV/profil.md` has empty sections or thin content, propose enrichments based on everything analyzed. Show diff to user before writing.
+
+## Modes
+
+### `/profile-deep` (full analysis)
+Runs all 5 steps.
+
+### `/profile-deep voice` (voice only)
+Runs steps 1-2 only. Quick voice-dna enrichment.
+
+### `/profile-deep patterns` (patterns only)
+Runs steps 3-4 only. No file reading, just analysis from existing data.
+
+## Rules
+
+- **Always ask before reading files.** Show the list, get approval.
+- **Analyze style, not content.** "Uses em dashes heavily" not "writes about loss."
+- **Show changes before writing.** The user validates every edit to USER.ENV.
+- **Additive, not destructive.** Each pass enriches, never overwrites previous analysis.
+- **Write in the user's primary language.**
+- This is the ONLY skill that writes to USER.ENV (besides the initial setup).