@lifeaitools/rdc-skills 0.9.35 → 0.9.36

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.9.35",
+  "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,21 @@ 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

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.35**
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.9.35",
+  "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.35",
+    "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,21 +625,16 @@ function buildHooksConfig(hooksDir) {
     if (msg) entry.statusMessage = msg;
     return entry;
   };
-  return {
+  const config = {
     UserPromptExpansion: [{ hooks: [
       cmd('rdc-invocation-marker.js', 'Marking RDC slash command...'),
     ]}],
     UserPromptSubmit: [{ hooks: [
       cmd('rdc-invocation-marker.js', 'Marking RDC prompt...'),
     ]}],
-    SessionStart: [{ hooks: [
-      cmd('check-cwd.js'),
-      cmd('check-stale-work-items.js', 'Checking for stale work items...'),
-    ]}],
     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'),
@@ -579,20 +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 ─────────────────────────────────────────────────────────────────
@@ -682,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)) {
@@ -822,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) {
@@ -897,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)) {
@@ -96,19 +107,10 @@ if ($SkipHooks) {
                 )
             }
         )
-        SessionStart = @(
-            [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..." }
-                )
-            }
-        )
         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]@{
@@ -125,31 +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/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..." },
-                    [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
@@ -163,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 ───────────────────────────────────────────────────────────────────
 
@@ -184,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 ""
+}