@lifeaitools/rdc-skills 0.9.34 → 0.9.36

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.9.34",
+  "version": "0.9.36",
   "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
   "author": {
     "name": "LIFEAI",

package/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## v0.9.36 — Portable installer profiles and startup onboarding
+
+### Added
+
+- **Installer profiles.** `--profile core` installs clean-box-safe hooks only; `--profile lifeai` keeps the LIFEAI/regen-root cwd, clauth, Supabase, and overnight hooks. `auto` chooses `lifeai` only when a sibling `regen-root` project is detected.
+- **Managed startup guide.** New `guides/rdc-skills-startup.md` explains what RDC skills add, the active profiles, and where to find skills, commands, guides, hooks, and installer behavior.
+- **Optional startup block writer.** `--project-root <path> --write-startup-blocks` writes `.rdc/guides/rdc-skills-startup.md` plus managed RDC sections in project `CLAUDE.md` and `AGENTS.md`.
+- **Install welcome.** The installer now prints the selected profile, what it enables, and where to look next.
+
+### Changed
+
+- The default clean-box profile no longer wires regen-root-specific hooks such as cwd lock, Supabase work-item exit gate, rate-limit retry, or overnight open-epic guard.
+
+---
+
+## v0.9.35 — RDC output-contract hook enforcement
+
+### Added
+
+- **RDC slash-command marker hook.** `rdc-invocation-marker.js` marks direct `/rdc:*` skill invocations through `UserPromptExpansion`, with a `UserPromptSubmit` fallback for older runtimes, and injects the output/engineering contract reminder.
+- **RDC Stop gate.** `rdc-output-contract-gate.js` blocks completion for active RDC invocations until the final assistant message includes both a checklist row and a verdict line.
+- **Installer wiring and self-test coverage.** The Node and PowerShell installers now wire the RDC marker/gate hooks, and `self-test` fails when required hook files or installer references are missing.
+
+---
+
 ## 0.6.1 — Tier 2 stability + rdc:watch session watcher
 
 ### Added

package/README.md

@@ -45,6 +45,27 @@ rm -rf ~/.claude/plugins/cache/rdc-skills/rdc-skills/0.7.*
 
 Use **one method only**: plugin (Option A or B) OR manual install — never both.
 
+### Installer profiles
+
+`scripts/install-rdc-skills.js` supports profiles:
+
+```bash
+node scripts/install-rdc-skills.js --profile core
+node scripts/install-rdc-skills.js --profile lifeai
+```
+
+- `core` is safe for a clean machine with only rdc-skills installed. It wires portable hooks only: RDC output-contract enforcement, foreground-process policy, commit-message hygiene, and non-blocking work logging.
+- `lifeai` is for the LIFEAI/regen-root workstation. It additionally wires the regen-root cwd lock, clauth/Supabase work-item gates, overnight queue guard, and LIFEAI session hooks.
+- `auto` is the default. It chooses `lifeai` only when a sibling `regen-root` project is detected; otherwise it chooses `core`.
+
+To add managed startup instructions to a project:
+
+```bash
+node scripts/install-rdc-skills.js --project-root /path/to/project --write-startup-blocks
+```
+
+This writes `.rdc/guides/rdc-skills-startup.md` and managed RDC sections in `CLAUDE.md` and `AGENTS.md`.
+
 ### Legacy install scripts (deprecated since v0.6.0)
 
 `scripts/install.sh` and `scripts/install.ps1` copy files into `~/.claude/skills/user/`. These exist only for environments that cannot use the plugin system. Running them alongside the plugin creates duplicates. Do not use them if you have the plugin installed.
@@ -176,7 +197,7 @@ python3 -c "import json; print(json.load(open('package.json'))['version'])"
 /rdc:help
 ```
 
-Current version: **v0.9.25**
+Current version: **v0.9.36**
 
 ## Quick Start
 

package/guides/rdc-skills-startup.md

@@ -0,0 +1,30 @@
+# RDC Skills Startup Contract
+> Managed by `rdc-skills`. Keep local project-specific details in adjacent project guides.
+
+## What RDC Skills Adds
+
+- Slash commands for the RDC workflow: plan, build, review, report, design, deploy, release, status, and work item operations.
+- Output-contract enforcement for active `/rdc:*` turns: visible checklist rows plus a final verdict line.
+- Engineering behavior guidance: small scoped changes, explicit assumptions, evidence for completed work, and honest blockers.
+- Optional project integrations for work items, credentials, deployments, and release automation.
+
+## Agent Startup Rules
+
+1. Read the active project instructions first (`CLAUDE.md` for Claude Code, `AGENTS.md` for Codex).
+2. For any `/rdc:*` invocation, follow `.rdc/guides/output-contract.md` and `.rdc/guides/engineering-behavior.md`.
+3. Do not treat skill prose as proof. Completed work needs evidence: command output, test result, route probe, screenshot, SQL result, or source citation.
+4. If a project has its own approval gates, architecture rules, or credential model, those project rules override generic RDC defaults.
+5. When an RDC skill cannot access the required project services, stop with a specific blocker instead of inventing a fallback.
+
+## Profiles
+
+- `core`: portable defaults for a clean machine. No regen-root cwd lock, clauth requirement, Supabase exit gate, or LIFEAI deployment assumption.
+- `lifeai`: LIFEAI/regen-root defaults. Enables project-specific hooks and workflows for clauth, Supabase work items, deployment, and overnight queue behavior.
+
+## Where To Look
+
+- Skills: `skills/<name>/SKILL.md`
+- Commands: `commands/<name>.md`
+- Guides: `guides/*.md` and project copies under `.rdc/guides/`
+- Hooks: `hooks/*.js`
+- Installer: `scripts/install-rdc-skills.js`

package/hooks/rdc-invocation-marker.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * UserPromptExpansion/UserPromptSubmit hook — mark active rdc:* invocations.
+ *
+ * This does not enforce compliance. It primes the turn with the RDC contract
+ * and leaves a session marker for rdc-output-contract-gate.js to enforce at
+ * Stop time.
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const hookLog = require('./hook-logger');
+
+const RDC_COMMANDS = new Set([
+  'build',
+  'co-develop',
+  'collab',
+  'deploy',
+  'design',
+  'fixit',
+  'fs-mcp',
+  'handoff',
+  'help',
+  'overnight',
+  'plan',
+  'preplan',
+  'prototype',
+  'release',
+  'report',
+  'review',
+  'self-test',
+  'status',
+  'terminal-config',
+  'watch',
+  'workitems',
+]);
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let input = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { input += chunk; });
+    process.stdin.on('end', () => resolve(input));
+    process.stdin.resume();
+  });
+}
+
+function markerDir() {
+  return path.join(os.homedir(), '.claude', 'rdc-active');
+}
+
+function markerPath(sessionId) {
+  const safe = String(sessionId || 'unknown').replace(/[^a-zA-Z0-9_.-]/g, '_');
+  return path.join(markerDir(), `${safe}.json`);
+}
+
+function normalizeCommandName(value) {
+  return String(value || '')
+    .trim()
+    .replace(/^\/+/, '')
+    .replace(/^rdc[:-]/i, '')
+    .toLowerCase();
+}
+
+function detectRdc(raw) {
+  const event = raw.hook_event_name || '';
+  if (event === 'UserPromptExpansion') {
+    if (raw.command_source && raw.command_source !== 'plugin') return null;
+    const command = normalizeCommandName(raw.command_name);
+    if (command === 'help' && !/^\/rdc[:-]help\b/i.test(String(raw.prompt || ''))) return null;
+    if (RDC_COMMANDS.has(command)) return command;
+    return null;
+  }
+
+  if (event === 'UserPromptSubmit') {
+    const prompt = String(raw.prompt || '').trim();
+    const m = prompt.match(/^\/(?:rdc[:-])?([a-z][a-z0-9-]*)\b/i);
+    if (!m) return null;
+    const command = normalizeCommandName(m[1]);
+    if (RDC_COMMANDS.has(command)) return command;
+  }
+
+  return null;
+}
+
+function writeMarker(raw, command) {
+  fs.mkdirSync(markerDir(), { recursive: true });
+  const marker = {
+    session_id: raw.session_id || null,
+    command,
+    command_name: raw.command_name || null,
+    command_args: raw.command_args || null,
+    prompt: raw.prompt || null,
+    cwd: raw.cwd || null,
+    transcript_path: raw.transcript_path || null,
+    started_at: new Date().toISOString(),
+    hook_event_name: raw.hook_event_name || null,
+  };
+  fs.writeFileSync(markerPath(raw.session_id), JSON.stringify(marker, null, 2));
+  return marker;
+}
+
+function outputContext(eventName, command) {
+  const additionalContext = [
+    `RDC CONTRACT ACTIVE for /${command}.`,
+    'Before responding, follow the project-local guide contracts:',
+    '- .rdc/guides/output-contract.md: show one checklist for this invocation, update it as work progresses, and end with the required verdict line.',
+    '- .rdc/guides/engineering-behavior.md: assumptions, scope, evidence, deviations, blockers, and verification must be explicit.',
+    'Runtime enforcement is on emitted artifacts: the final assistant message must contain at least one checklist row and a verdict line.',
+  ].join('\n');
+
+  process.stdout.write(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: eventName,
+      additionalContext,
+    },
+  }));
+}
+
+async function main() {
+  let raw;
+  try { raw = JSON.parse(await readStdin()); } catch { process.exit(0); }
+  const command = detectRdc(raw);
+  if (!command) process.exit(0);
+
+  try {
+    const marker = writeMarker(raw, command);
+    hookLog('rdc-invocation-marker', raw.hook_event_name || 'unknown', 'marked', {
+      command,
+      session_id: marker.session_id,
+    });
+    outputContext(raw.hook_event_name || 'UserPromptExpansion', command);
+  } catch (e) {
+    hookLog('rdc-invocation-marker', raw.hook_event_name || 'unknown', 'error', {
+      command,
+      error: e.message,
+    });
+  }
+}
+
+main().catch(() => process.exit(0));

package/hooks/rdc-output-contract-gate.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Stop hook — enforce visible RDC output contract artifacts.
+ *
+ * Triggered only when rdc-invocation-marker.js has marked the session. It checks
+ * positive output patterns only: at least one checklist row and one verdict
+ * line. It intentionally does not police forbidden phrases.
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const hookLog = require('./hook-logger');
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let input = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { input += chunk; });
+    process.stdin.on('end', () => resolve(input));
+    process.stdin.resume();
+  });
+}
+
+function markerPath(sessionId) {
+  const safe = String(sessionId || 'unknown').replace(/[^a-zA-Z0-9_.-]/g, '_');
+  return path.join(os.homedir(), '.claude', 'rdc-active', `${safe}.json`);
+}
+
+function readMarker(sessionId) {
+  const p = markerPath(sessionId);
+  if (!fs.existsSync(p)) return null;
+  try {
+    return { path: p, data: JSON.parse(fs.readFileSync(p, 'utf8')) };
+  } catch {
+    return { path: p, data: { command: 'unknown' } };
+  }
+}
+
+function hasChecklist(text) {
+  return /(?:^|\n)\s*(?:[-*]\s*)?\[(?: |x|X|~|!|-)\]\s+\S/m.test(text || '');
+}
+
+function hasVerdict(text) {
+  return /(?:^|\n)\s*(?:✅|⚠️|❌)\s+\S/m.test(text || '');
+}
+
+function block(reason, details = {}) {
+  hookLog('rdc-output-contract-gate', 'Stop', 'block', details);
+  process.stdout.write(JSON.stringify({ decision: 'block', reason }));
+  process.exit(0);
+}
+
+function pass(marker) {
+  try { fs.unlinkSync(marker.path); } catch {}
+  hookLog('rdc-output-contract-gate', 'Stop', 'pass', {
+    command: marker.data.command || null,
+  });
+  process.exit(0);
+}
+
+async function main() {
+  let raw;
+  try { raw = JSON.parse(await readStdin()); } catch { process.exit(0); }
+  const marker = readMarker(raw.session_id);
+  if (!marker) process.exit(0);
+
+  const message = String(raw.last_assistant_message || '');
+  const checklist = hasChecklist(message);
+  const verdict = hasVerdict(message);
+  if (checklist && verdict) pass(marker);
+
+  const command = marker.data.command || 'rdc';
+  const missing = [];
+  if (!checklist) missing.push('a visible checklist row like `[ ] Step` or `[x] Step`');
+  if (!verdict) missing.push('a final verdict line beginning with ✅, ⚠️, or ❌');
+
+  block(
+    `RDC output contract incomplete for /${command}: missing ${missing.join(' and ')}. Continue the response by rendering the RDC checklist and verdict required by .rdc/guides/output-contract.md. Do not restart the task; correct the visible output contract.`,
+    { command, checklist, verdict, stop_hook_active: raw.stop_hook_active === true },
+  );
+}
+
+main().catch((e) => block(`RDC output contract gate crashed: ${e.message}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.9.34",
+  "version": "0.9.36",
   "description": "RDC typed-agent dispatch skill suite for Claude Code - plan, build, review, overnight builds",
   "keywords": [
     "claude-code",
@@ -19,7 +19,7 @@
     "type": "plugin",
     "skills": "skills/",
     "guides": "guides/",
-    "version": "0.9.34",
+    "version": "0.9.36",
     "commands": "commands/"
   },
   "scripts": {

package/scripts/install-rdc-skills.js

@@ -5,9 +5,12 @@
  * Usage:
  *   node scripts/install-rdc-skills.js                      ← standard
  *   node scripts/install-rdc-skills.js --skip-hooks         ← skip hook wiring
+ *   node scripts/install-rdc-skills.js --profile core       ← clean-box portable hooks
+ *   node scripts/install-rdc-skills.js --profile lifeai     ← LIFEAI/regen-root hooks
  *   node scripts/install-rdc-skills.js --claude-home <path> ← custom CLI home
  *   node scripts/install-rdc-skills.js --codex-root <path>  ← also install to .agents/skills/user/
  *   node scripts/install-rdc-skills.js --codex-skill-dir <path> ← also install to a Codex skill dir
+ *   node scripts/install-rdc-skills.js --project-root <path> --write-startup-blocks
  *   node scripts/install-rdc-skills.js --migrate <path>     ← migrate docs/ → .rdc/
  *
  * What it does:
@@ -32,11 +35,16 @@ const { execSync } = require('child_process');
 // ── Args ──────────────────────────────────────────────────────────────────────
 const args       = process.argv.slice(2);
 const skipHooks  = args.includes('--skip-hooks');
+const profileIdx = args.indexOf('--profile');
+const profileArg = profileIdx >= 0 ? String(args[profileIdx + 1] || '').toLowerCase() : 'auto';
 const homeIdx    = args.indexOf('--claude-home');
 const claudeHome = homeIdx >= 0 ? args[homeIdx + 1] : path.join(os.homedir(), '.claude');
 const migrateIdx = args.indexOf('--migrate');
 const doMigrate  = migrateIdx >= 0;
 const migratePath = doMigrate ? (args[migrateIdx + 1] || process.cwd()) : null;
+const projectIdx = args.indexOf('--project-root');
+const projectRootArg = projectIdx >= 0 ? path.resolve(args[projectIdx + 1]) : null;
+const shouldWriteStartupBlocks = args.includes('--write-startup-blocks');
 
 const repoRoot     = path.resolve(__dirname, '..');
 
@@ -44,6 +52,7 @@ const codexIdx   = args.indexOf('--codex-root');
 const codexRoot  = codexIdx >= 0
   ? path.resolve(args[codexIdx + 1])
   : (() => {
+      if (projectRootArg) return null;
       const sibling = path.resolve(repoRoot, '..', 'regen-root');
       return fs.existsSync(path.join(sibling, '.agents')) ? sibling : null;
     })();
@@ -54,6 +63,18 @@ const explicitCodexSkillDir = codexSkillDirIdx >= 0
 const hooksSrc     = path.join(repoRoot, 'hooks');
 const hooksDst     = path.join(claudeHome, 'hooks');
 const settingsPath = path.join(claudeHome, 'settings.json');
+const detectedLifeaiRoot = (() => {
+  const sibling = path.resolve(repoRoot, '..', 'regen-root');
+  return fs.existsSync(path.join(sibling, 'CLAUDE.md')) && fs.existsSync(path.join(sibling, '.rdc')) ? sibling : null;
+})();
+const installProfile = (() => {
+  if (profileArg === 'core' || profileArg === 'lifeai') return profileArg;
+  if (profileArg !== 'auto') {
+    console.log(`  \x1b[33m⚠\x1b[0m Unknown --profile "${profileArg}" — using auto`);
+  }
+  return detectedLifeaiRoot ? 'lifeai' : 'core';
+})();
+const projectRoot = projectRootArg || codexRoot || detectedLifeaiRoot;
 
 const PLUGIN_KEY   = 'rdc-skills@rdc-skills';
 const MARKETPLACE  = 'rdc-skills';
@@ -108,6 +129,7 @@ function copyMissingProjectGuides(projectRoot) {
   let copied = 0;
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+    if (entry.name === 'rdc-skills-startup.md') continue; // installed only by --write-startup-blocks
     const target = path.join(dst, entry.name);
     if (fs.existsSync(target)) continue;
     fs.copyFileSync(path.join(src, entry.name), target);
@@ -126,6 +148,53 @@ function writeJson(p, data, indent = 2) {
   fs.writeFileSync(p, JSON.stringify(data, null, indent));
 }
 
+function upsertManagedBlock(filePath, title, body) {
+  const begin = `<!-- BEGIN RDC-SKILLS:${title} -->`;
+  const end = `<!-- END RDC-SKILLS:${title} -->`;
+  const block = `${begin}\n${body.trim()}\n${end}\n`;
+  const current = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';
+  const re = new RegExp(`${begin.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${end.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n?`, 'm');
+  const next = re.test(current)
+    ? current.replace(re, block)
+    : `${current.replace(/\s*$/, '')}${current.trim() ? '\n\n' : ''}${block}`;
+  if (next !== current) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, next);
+    return true;
+  }
+  return false;
+}
+
+function writeStartupBlocks(targetRoot, profile) {
+  if (!targetRoot) return { wrote: 0, skipped: 'no-project-root' };
+  const startupSrc = path.join(repoRoot, 'guides', 'rdc-skills-startup.md');
+  const guidesDir = path.join(targetRoot, '.rdc', 'guides');
+  const startupDst = path.join(guidesDir, 'rdc-skills-startup.md');
+  fs.mkdirSync(guidesDir, { recursive: true });
+  fs.copyFileSync(startupSrc, startupDst);
+
+  let wrote = 1;
+  const claudeBody = [
+    '## RDC Skills',
+    '',
+    '@.rdc/guides/rdc-skills-startup.md',
+    '',
+    `Installed profile: \`${profile}\`.`,
+    'For `/rdc:*` work, follow `.rdc/guides/output-contract.md` and `.rdc/guides/engineering-behavior.md`.',
+  ].join('\n');
+  const agentsBody = [
+    '## RDC Skills',
+    '',
+    'Read `.rdc/guides/rdc-skills-startup.md` before using any `rdc:*` workflow.',
+    `Installed profile: \`${profile}\`.`,
+    'For `/rdc:*` work, follow `.rdc/guides/output-contract.md` and `.rdc/guides/engineering-behavior.md`.',
+  ].join('\n');
+
+  if (upsertManagedBlock(path.join(targetRoot, 'CLAUDE.md'), 'STARTUP', claudeBody)) wrote++;
+  if (upsertManagedBlock(path.join(targetRoot, 'AGENTS.md'), 'STARTUP', agentsBody)) wrote++;
+  return { wrote, skipped: null };
+}
+
 // ── Frontmatter parser ────────────────────────────────────────────────────────
 function readFrontmatter(filePath) {
   try {
@@ -546,7 +615,7 @@ function buildZip(version) {
 }
 
 // ── Hook config ───────────────────────────────────────────────────────────────
-function buildHooksConfig(hooksDir) {
+function buildHooksConfig(hooksDir, profile = 'core') {
   const base = hooksDir.replace(/\\/g, '/');
   const cmd  = (file, msg) => {
     const command = process.platform === 'win32'
@@ -556,15 +625,16 @@ function buildHooksConfig(hooksDir) {
     if (msg) entry.statusMessage = msg;
     return entry;
   };
-  return {
-    SessionStart: [{ hooks: [
-      cmd('check-cwd.js'),
-      cmd('check-stale-work-items.js', 'Checking for stale work items...'),
+  const config = {
+    UserPromptExpansion: [{ hooks: [
+      cmd('rdc-invocation-marker.js', 'Marking RDC slash command...'),
+    ]}],
+    UserPromptSubmit: [{ hooks: [
+      cmd('rdc-invocation-marker.js', 'Marking RDC prompt...'),
     ]}],
     PreToolUse: [
       { hooks: [
         cmd('foreground-process-gate.js', 'Checking foreground process policy...'),
-        cmd('work-item-exit-gate.js', 'Checking work item exit gates...'),
       ]},
       { matcher: 'Bash', hooks: [
         cmd('require-work-item-on-commit.js'),
@@ -573,19 +643,36 @@ function buildHooksConfig(hooksDir) {
     PostToolUse: [{ hooks: [
       cmd('check-services.js'),
     ]}],
-    PreCompact: [{ hooks: [
-      cmd('precompact-log.js'),
-    ]}],
-    PostCompact: [{ hooks: [
-      cmd('postcompact-log.js'),
-      cmd('restart-brief.js', 'Writing restart brief...'),
-    ]}],
     Stop: [{ hooks: [
-      cmd('rate-limit-retry.js',   'Checking for rate limits...'),
+      cmd('rdc-output-contract-gate.js', 'Checking RDC output contract...'),
       cmd('post-work-check.js',    'Checking for undocumented work...'),
-      cmd('no-stop-open-epics.js', 'Checking for open epics...'),
     ]}],
   };
+
+  if (profile === 'lifeai') {
+    config.SessionStart = [{ hooks: [
+      cmd('check-cwd.js'),
+      cmd('check-stale-work-items.js', 'Checking for stale work items...'),
+    ]}];
+    config.PreToolUse[0].hooks.push(
+      cmd('work-item-exit-gate.js', 'Checking work item exit gates...'),
+    );
+    config.PreCompact = [{ hooks: [
+      cmd('precompact-log.js'),
+    ]}];
+    config.PostCompact = [{ hooks: [
+      cmd('postcompact-log.js'),
+      cmd('restart-brief.js', 'Writing restart brief...'),
+    ]}];
+    config.Stop[0].hooks.unshift(
+      cmd('rate-limit-retry.js', 'Checking for rate limits...'),
+    );
+    config.Stop[0].hooks.push(
+      cmd('no-stop-open-epics.js', 'Checking for open epics...'),
+    );
+  }
+
+  return config;
 }
 
 // ── Preflight ─────────────────────────────────────────────────────────────────
@@ -675,6 +762,7 @@ async function main() {
   console.log('');
   console.log(`  CLAUDE_HOME : ${claudeHome}`);
   console.log(`  Plugin root : ${repoRoot}`);
+  console.log(`  Profile     : ${installProfile}${profileArg === 'auto' ? ' (auto)' : ''}`);
   console.log('');
 
   if (!fs.existsSync(claudeHome)) {
@@ -815,11 +903,20 @@ async function main() {
     info('[4/6] Hook wiring — skipped (--skip-hooks)');
   } else {
     const settings = readJson(settingsPath);
-    settings.hooks = buildHooksConfig(hooksDst);
+    settings.hooks = buildHooksConfig(hooksDst, installProfile);
     writeJson(settingsPath, settings);
     ok(`[4/6] Hook wiring — ${settingsPath}`);
   }
 
+  // 4.5 Optional startup blocks
+  if (shouldWriteStartupBlocks) {
+    const startup = writeStartupBlocks(projectRoot, installProfile);
+    if (startup.skipped) warn(`[4.5] Startup   — skipped (${startup.skipped})`);
+    else ok(`[4.5] Startup   — wrote managed startup guide/block(s) under ${projectRoot}`);
+  } else {
+    info('[4.5] Startup   — skipped (use --project-root <path> --write-startup-blocks)');
+  }
+
   // 5. Zip for claude.ai / distribution
   const zipPath = buildZip(version);
   if (zipPath) {
@@ -890,6 +987,15 @@ async function main() {
   console.log('  Cowork : restart Claude Desktop — /rdc:status in a new Cowork session');
   console.log('  claude.ai : no plugin install needed — use FS MCP to read commands on demand');
   console.log('            dist/rdc-skills-plugin-v' + version + '.zip available if needed');
+  console.log('');
+  console.log(`  Profile: ${installProfile}`);
+  if (installProfile === 'core') {
+    console.log('  Core hooks are portable: RDC output contract + foreground process + commit-message hygiene.');
+    console.log('  Project services are not provisioned. Configure work items, credentials, deploys, and project guides before using infrastructure-heavy skills.');
+  } else {
+    console.log('  LIFEAI hooks are active: regen-root cwd lock, Supabase work-item gates, clauth-aware checks, and overnight queue guard.');
+  }
+  console.log('  Startup blocks: run with --project-root <path> --write-startup-blocks to add managed CLAUDE.md/AGENTS.md sections.');
 
   listCommands();
 

package/scripts/install.ps1

@@ -7,10 +7,14 @@
 # Usage:
 #   ./install.ps1                  # standard install
 #   ./install.ps1 -SkipHooks       # skip hooks registration (e.g. if you manage hooks manually)
+#   ./install.ps1 -Profile core    # portable hooks only
+#   ./install.ps1 -Profile lifeai  # LIFEAI/regen-root hooks
 #   ./install.ps1 -ClaudeHome <path>  # custom CLAUDE_HOME
 
 param(
     [string]$ClaudeHome = "",
+    [ValidateSet("auto", "core", "lifeai")]
+    [string]$Profile = "auto",
     [switch]$SkipHooks = $false,
     [switch]$Force = $false
 )
@@ -22,6 +26,12 @@ if (-not $ClaudeHome) {
 
 $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $repoRoot  = Split-Path -Parent $scriptDir
+$lifeaiRoot = Join-Path (Split-Path -Parent $repoRoot) "regen-root"
+$installProfile = if ($Profile -eq "auto") {
+    if ((Test-Path (Join-Path $lifeaiRoot "CLAUDE.md")) -and (Test-Path (Join-Path $lifeaiRoot ".rdc"))) { "lifeai" } else { "core" }
+} else {
+    $Profile
+}
 
 Write-Host ""
 Write-Host "  rdc-skills Installer" -ForegroundColor Green
@@ -29,6 +39,7 @@ Write-Host "  ====================" -ForegroundColor Green
 Write-Host ""
 Write-Host "  CLAUDE_HOME : $ClaudeHome" -ForegroundColor Cyan
 Write-Host "  Plugin root : $repoRoot" -ForegroundColor Cyan
+Write-Host "  Profile     : $installProfile$(if ($Profile -eq 'auto') { ' (auto)' } else { '' })" -ForegroundColor Cyan
 Write-Host ""
 
 if (-not (Test-Path $ClaudeHome)) {
@@ -82,19 +93,24 @@ if ($SkipHooks) {
     $hooksBase = $hooksDir.Replace("\", "/")
 
     $hooksConfig = [PSCustomObject]@{
-        SessionStart = @(
+        UserPromptExpansion = @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-cwd.js`"" },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-stale-work-items.js`""; statusMessage = "Checking for stale work items..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC slash command..." }
+                )
+            }
+        )
+        UserPromptSubmit = @(
+            [PSCustomObject]@{
+                hooks = @(
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC prompt..." }
                 )
             }
         )
         PreToolUse = @(
             [PSCustomObject]@{
                 hooks   = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/foreground-process-gate.js`""; statusMessage = "Checking foreground process policy..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/work-item-exit-gate.js`""; statusMessage = "Checking work item exit gates..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/foreground-process-gate.js`""; statusMessage = "Checking foreground process policy..." }
                 )
             },
             [PSCustomObject]@{
@@ -111,30 +127,42 @@ if ($SkipHooks) {
                 )
             }
         )
-        PreCompact = @(
+        Stop = @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/precompact-log.js`"" }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-output-contract-gate.js`""; statusMessage = "Checking RDC output contract..." },
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/post-work-check.js`""; statusMessage = "Checking for undocumented work..." }
                 )
             }
         )
-        PostCompact = @(
+    }
+
+    if ($installProfile -eq "lifeai") {
+        $hooksConfig | Add-Member -NotePropertyName "SessionStart" -NotePropertyValue @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/postcompact-log.js`"" },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/restart-brief.js`""; statusMessage = "Writing restart brief..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-cwd.js`"" },
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-stale-work-items.js`""; statusMessage = "Checking for stale work items..." }
                 )
             }
         )
-        Stop = @(
+        $hooksConfig.PreToolUse[0].hooks += [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/work-item-exit-gate.js`""; statusMessage = "Checking work item exit gates..." }
+        $hooksConfig | Add-Member -NotePropertyName "PreCompact" -NotePropertyValue @(
+            [PSCustomObject]@{ hooks = @([PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/precompact-log.js`"" }) }
+        )
+        $hooksConfig | Add-Member -NotePropertyName "PostCompact" -NotePropertyValue @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rate-limit-retry.js`""; statusMessage = "Checking for rate limits..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/post-work-check.js`""; statusMessage = "Checking for undocumented work..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/no-stop-open-epics.js`""; statusMessage = "Checking for open epics..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/postcompact-log.js`"" },
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/restart-brief.js`""; statusMessage = "Writing restart brief..." }
                 )
             }
         )
+        $hooksConfig.Stop[0].hooks = @(
+            [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rate-limit-retry.js`""; statusMessage = "Checking for rate limits..." }
+        ) + $hooksConfig.Stop[0].hooks + @(
+            [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/no-stop-open-epics.js`""; statusMessage = "Checking for open epics..." }
+        )
     }
 
     # Add/replace hooks key
@@ -148,6 +176,8 @@ if ($SkipHooks) {
     $settings | ConvertTo-Json -Depth 20 | Set-Content $settingsPath -Encoding UTF8
     Write-Host "  [3/3] Hook wiring ✓  registered in $settingsPath" -ForegroundColor Green
 }
+}
+}
 
 # ── Summary ───────────────────────────────────────────────────────────────────
 
@@ -169,3 +199,4 @@ Write-Host "  4. Run /rdc:status in Claude Code to verify"
 Write-Host ""
 Write-Host "  Docs: https://github.com/LIFEAI/rdc-skills#readme" -ForegroundColor Cyan
 Write-Host ""
+}

package/scripts/self-test.mjs

@@ -699,6 +699,7 @@ function auditOrphanHooks(results) {
       })
       .map((f) => join(SKILLS_DIR, f, "SKILL.md")),
     join(REPO_ROOT, ".claude", "settings.json"),
+    join(REPO_ROOT, "scripts", "install-rdc-skills.js"),
     PLUGIN_MANIFEST,
   ];
   for (const src of sources) {
@@ -729,6 +730,78 @@ function auditOrphanHooks(results) {
   return findings;
 }
 
+function auditRequiredHookWiring() {
+  const findings = [];
+  const required = [
+    {
+      file: join(REPO_ROOT, "scripts", "install-rdc-skills.js"),
+      label: "scripts/install-rdc-skills.js",
+      tokens: [
+        "UserPromptExpansion",
+        "UserPromptSubmit",
+        "Stop",
+        "rdc-invocation-marker.js",
+        "rdc-output-contract-gate.js",
+      ],
+    },
+    {
+      file: join(REPO_ROOT, "scripts", "install.ps1"),
+      label: "scripts/install.ps1",
+      tokens: [
+        "UserPromptExpansion",
+        "UserPromptSubmit",
+        "Stop",
+        "rdc-invocation-marker.js",
+        "rdc-output-contract-gate.js",
+      ],
+    },
+  ];
+
+  for (const hookFile of [
+    "rdc-invocation-marker.js",
+    "rdc-output-contract-gate.js",
+  ]) {
+    if (!existsSync(join(HOOKS_DIR, hookFile))) {
+      findings.push({
+        level: "error",
+        code: "required-hook-missing",
+        message: `hooks/${hookFile} is required for RDC output-contract enforcement`,
+      });
+    }
+  }
+
+  for (const target of required) {
+    if (!existsSync(target.file)) {
+      findings.push({
+        level: "error",
+        code: "hook-installer-missing",
+        message: `${target.label} not found for RDC hook wiring audit`,
+      });
+      continue;
+    }
+    let text = "";
+    try { text = readFileSync(target.file, "utf8"); } catch (e) {
+      findings.push({
+        level: "error",
+        code: "hook-installer-unreadable",
+        message: `${target.label} unreadable: ${e.message}`,
+      });
+      continue;
+    }
+    for (const token of target.tokens) {
+      if (!text.includes(token)) {
+        findings.push({
+          level: "error",
+          code: "required-hook-wiring-missing",
+          message: `${target.label} must reference ${token}`,
+        });
+      }
+    }
+  }
+
+  return findings;
+}
+
 // ─── Tier 2 behavioral runner ──────────────────────────────────────────────
 
 async function runPool(items, concurrency, worker) {
@@ -1143,14 +1216,16 @@ function main() {
   // Cross-skill checks — deferred until all audits complete
   let duplicateFindings = [];
   let orphanHookFindings = [];
+  let requiredHookFindings = [];
   if (!ONLY_SKILL) {
     duplicateFindings = auditDuplicates(results);
     orphanHookFindings = auditOrphanHooks(results);
+    requiredHookFindings = auditRequiredHookWiring();
   }
 
-  if (duplicateFindings.length + orphanHookFindings.length > 0) {
+  if (duplicateFindings.length + orphanHookFindings.length + requiredHookFindings.length > 0) {
     console.log("\nglobal findings\n");
-    for (const f of [...duplicateFindings, ...orphanHookFindings]) {
+    for (const f of [...duplicateFindings, ...orphanHookFindings, ...requiredHookFindings]) {
       console.log(`  [${f.level}] ${f.code}: ${f.message}`);
     }
   }
@@ -1166,12 +1241,14 @@ function main() {
     ...manifestAudit.findings.filter((f) => f.level === "error"),
     ...duplicateFindings.filter((f) => f.level === "error"),
     ...orphanHookFindings.filter((f) => f.level === "error"),
+    ...requiredHookFindings.filter((f) => f.level === "error"),
     ...(guideValidatorResult ? guideValidatorResult.errors : []),
   ];
   const globalWarnings = [
     ...manifestAudit.findings.filter((f) => f.level === "warn"),
     ...duplicateFindings.filter((f) => f.level === "warn"),
     ...orphanHookFindings.filter((f) => f.level === "warn"),
+    ...requiredHookFindings.filter((f) => f.level === "warn"),
     ...(guideValidatorResult ? guideValidatorResult.warnings : []),
   ];