@a5c-ai/babysitter-openclaw 0.1.1-staging.45beae68

package/bin/install.cjs

@@ -0,0 +1,370 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PLUGIN_NAME = 'babysitter';
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const PACKAGE_JSON = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+
+// ── Directories ──────────────────────────────────────────────────────────
+
+function getUserHome() {
+  if (process.env.USERPROFILE) return path.resolve(process.env.USERPROFILE);
+  if (process.env.HOME) return path.resolve(process.env.HOME);
+  return os.homedir();
+}
+
+function getOpenClawHome() {
+  if (process.env.OPENCLAW_HOME) return path.resolve(process.env.OPENCLAW_HOME);
+  return path.join(getUserHome(), '.openclaw');
+}
+
+function getGlobalStateDir() {
+  if (process.env.BABYSITTER_GLOBAL_STATE_DIR) {
+    return path.resolve(process.env.BABYSITTER_GLOBAL_STATE_DIR);
+  }
+  return path.join(getUserHome(), '.a5c');
+}
+
+function getPluginRoot(workspace) {
+  if (workspace) {
+    return path.join(workspace, '.openclaw', 'plugins', PLUGIN_NAME);
+  }
+  return path.join(getOpenClawHome(), 'plugins', PLUGIN_NAME);
+}
+
+// ── Args ─────────────────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  let workspace = null;
+  for (let i = 2; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--workspace') {
+      const next = argv[i + 1];
+      workspace = next && !next.startsWith('-') ? path.resolve(argv[++i]) : process.cwd();
+      continue;
+    }
+    if (arg === '--global') {
+      workspace = null;
+      continue;
+    }
+    throw new Error(`unknown argument: ${arg}`);
+  }
+  return { workspace };
+}
+
+// ── File helpers ─────────────────────────────────────────────────────────
+
+function writeFileIfChanged(filePath, contents) {
+  if (fs.existsSync(filePath)) {
+    const current = fs.readFileSync(filePath, 'utf8');
+    if (current === contents) return false;
+  }
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, contents, 'utf8');
+  return true;
+}
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+
+function writeJson(filePath, value) {
+  writeFileIfChanged(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) return;
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+      if (['node_modules', '.git', 'test', '.a5c'].includes(entry)) continue;
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+    return;
+  }
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+function ensureExecutable(filePath) {
+  try {
+    fs.chmodSync(filePath, 0o755);
+  } catch {
+    // Best-effort: Windows may ignore mode changes.
+  }
+}
+
+// ── Plugin bundle ────────────────────────────────────────────────────────
+
+const PLUGIN_BUNDLE_ENTRIES = [
+  'plugin.json',
+  'openclaw.plugin.json',
+  'versions.json',
+  'hooks.json',
+  'hooks',
+  'extensions',
+  'skills',
+  'commands',
+];
+
+function copyPluginBundle(packageRoot, pluginRoot) {
+  if (path.resolve(packageRoot) === path.resolve(pluginRoot)) {
+    console.log('[babysitter] Source and target are the same directory; skipping copy.');
+    return;
+  }
+  // Idempotent: remove previous install and replace.
+  fs.rmSync(pluginRoot, { recursive: true, force: true });
+  fs.mkdirSync(pluginRoot, { recursive: true });
+  for (const entry of PLUGIN_BUNDLE_ENTRIES) {
+    const src = path.join(packageRoot, entry);
+    if (fs.existsSync(src)) {
+      copyRecursive(src, path.join(pluginRoot, entry));
+    }
+  }
+}
+
+// ── Hook registration ────────────────────────────────────────────────────
+
+function ensureHooksRegistered(pluginRoot) {
+  const hooksJsonSrc = path.join(PACKAGE_ROOT, 'hooks.json');
+  if (!fs.existsSync(hooksJsonSrc)) return;
+
+  const hooksJson = readJson(hooksJsonSrc);
+  const hooksDir = path.join(pluginRoot, 'hooks');
+
+  // Ensure hook scripts are executable
+  if (fs.existsSync(hooksDir)) {
+    for (const entry of fs.readdirSync(hooksDir)) {
+      if (entry.endsWith('.sh')) {
+        ensureExecutable(path.join(hooksDir, entry));
+      }
+    }
+  }
+
+  console.log(`[babysitter] Hook registration verified (${Object.keys(hooksJson.hooks || {}).length} event types).`);
+}
+
+// ── SDK dependency ───────────────────────────────────────────────────────
+
+function ensureSdkInstalled() {
+  try {
+    require.resolve('@a5c-ai/babysitter-sdk', { paths: [PACKAGE_ROOT] });
+    console.log('[babysitter] @a5c-ai/babysitter-sdk — OK');
+    return true;
+  } catch {
+    console.log('[babysitter] Installing @a5c-ai/babysitter-sdk...');
+    const sdkVersion = PACKAGE_JSON.dependencies?.['@a5c-ai/babysitter-sdk'] || 'latest';
+    const result = spawnSync('npm', ['install', '--no-save', `@a5c-ai/babysitter-sdk@${sdkVersion}`], {
+      cwd: PACKAGE_ROOT,
+      stdio: 'inherit',
+      env: process.env,
+      shell: true,
+    });
+    if ((result.status ?? 1) !== 0) {
+      console.warn('[babysitter] Warning: SDK installation failed. Some features may be unavailable.');
+      return false;
+    }
+    console.log('[babysitter] @a5c-ai/babysitter-sdk installed.');
+    return true;
+  }
+}
+
+// ── Process library ──────────────────────────────────────────────────────
+
+function resolveBabysitterCommand() {
+  if (process.env.BABYSITTER_SDK_CLI) {
+    return {
+      command: process.execPath,
+      argsPrefix: [path.resolve(process.env.BABYSITTER_SDK_CLI)],
+    };
+  }
+  try {
+    return {
+      command: process.execPath,
+      argsPrefix: [
+        require.resolve('@a5c-ai/babysitter-sdk/dist/cli/main.js', {
+          paths: [PACKAGE_ROOT],
+        }),
+      ],
+    };
+  } catch {
+    return { command: 'babysitter', argsPrefix: [] };
+  }
+}
+
+function ensureGlobalProcessLibrary() {
+  const resolved = resolveBabysitterCommand();
+  const result = spawnSync(
+    resolved.command,
+    [...resolved.argsPrefix, 'process-library:active', '--state-dir', getGlobalStateDir(), '--json'],
+    {
+      cwd: PACKAGE_ROOT,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      encoding: 'utf8',
+      env: process.env,
+    },
+  );
+  if (result.status === 0) {
+    try {
+      return JSON.parse(result.stdout);
+    } catch {
+      // Non-critical
+    }
+  }
+  console.log('[babysitter] Process library not yet active (will be set up on first run).');
+  return null;
+}
+
+// ── Marketplace entry (for babysitter plugin:install path) ───────────────
+
+function normalizeMarketplaceSourcePath(marketplacePath, pluginSourcePath) {
+  let next = pluginSourcePath;
+  if (path.isAbsolute(next)) {
+    next = path.relative(path.dirname(marketplacePath), next);
+  }
+  next = String(next || '').replace(/\\/g, '/');
+  if (!next.startsWith('./') && !next.startsWith('../')) {
+    next = `./${next}`;
+  }
+  return next;
+}
+
+function ensureMarketplaceEntry(pluginRoot) {
+  const marketplacePath = path.join(getUserHome(), '.a5c', 'marketplace', 'marketplace.json');
+  const defaultMarketplace = {
+    name: 'local-plugins',
+    interface: { displayName: 'Local Plugins' },
+    plugins: [],
+  };
+
+  const marketplace = fs.existsSync(marketplacePath)
+    ? readJson(marketplacePath)
+    : { ...defaultMarketplace };
+
+  marketplace.name = marketplace.name || defaultMarketplace.name;
+  marketplace.interface = marketplace.interface || defaultMarketplace.interface;
+  if (!Array.isArray(marketplace.plugins)) {
+    marketplace.plugins = [];
+  }
+
+  const nextEntry = {
+    name: PLUGIN_NAME,
+    source: {
+      source: 'local',
+      path: normalizeMarketplaceSourcePath(marketplacePath, pluginRoot),
+    },
+    policy: {
+      installation: 'AVAILABLE',
+      authentication: 'ON_INSTALL',
+    },
+    category: 'Coding',
+  };
+
+  const existingIndex = marketplace.plugins.findIndex((e) => e && e.name === PLUGIN_NAME);
+  if (existingIndex >= 0) {
+    marketplace.plugins[existingIndex] = nextEntry;
+  } else {
+    marketplace.plugins.push(nextEntry);
+  }
+
+  writeJson(marketplacePath, marketplace);
+  console.log(`[babysitter] Marketplace entry written: ${marketplacePath}`);
+}
+
+// ── OpenClaw config placement ────────────────────────────────────────────
+
+function ensureOpenClawConfig(workspace) {
+  const configDir = workspace
+    ? path.join(workspace, '.openclaw')
+    : getOpenClawHome();
+
+  const pluginsConfigPath = path.join(configDir, 'plugins.json');
+
+  let config;
+  if (fs.existsSync(pluginsConfigPath)) {
+    config = readJson(pluginsConfigPath);
+  } else {
+    config = { plugins: {} };
+  }
+
+  if (!config.plugins) config.plugins = {};
+
+  // Add or update babysitter plugin entry (idempotent)
+  config.plugins[PLUGIN_NAME] = {
+    enabled: true,
+    version: PACKAGE_JSON.version,
+    package: PACKAGE_JSON.name,
+  };
+
+  writeJson(pluginsConfigPath, config);
+  console.log(`[babysitter] OpenClaw plugin config updated: ${pluginsConfigPath}`);
+}
+
+// ── State directory ──────────────────────────────────────────────────────
+
+function ensureStateDirectory(workspace) {
+  const stateDir = workspace
+    ? path.join(workspace, '.a5c')
+    : getGlobalStateDir();
+  fs.mkdirSync(stateDir, { recursive: true });
+  return stateDir;
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────
+
+function main() {
+  const { workspace } = parseArgs(process.argv);
+  const pluginRoot = getPluginRoot(workspace);
+  const scope = workspace ? `project (${workspace})` : 'global';
+
+  console.log(`[babysitter] Installing babysitter plugin for OpenClaw (${scope})`);
+  console.log(`[babysitter]   plugin name: ${PLUGIN_NAME}`);
+  console.log(`[babysitter]   package: ${PACKAGE_JSON.name}@${PACKAGE_JSON.version}`);
+  console.log(`[babysitter]   target: ${pluginRoot}`);
+
+  try {
+    // 1. Copy plugin bundle
+    copyPluginBundle(PACKAGE_ROOT, pluginRoot);
+    console.log('[babysitter] Plugin bundle copied.');
+
+    // 2. Ensure SDK dependency
+    ensureSdkInstalled();
+
+    // 3. Register hooks
+    ensureHooksRegistered(pluginRoot);
+
+    // 4. OpenClaw config placement
+    ensureOpenClawConfig(workspace);
+
+    // 5. Marketplace entry (global only)
+    if (!workspace) {
+      ensureMarketplaceEntry(pluginRoot);
+    }
+
+    // 6. State directory
+    const stateDir = ensureStateDirectory(workspace);
+    console.log(`[babysitter] State directory: ${stateDir}`);
+
+    // 7. Process library (global only, best-effort)
+    if (!workspace) {
+      const active = ensureGlobalProcessLibrary();
+      if (active?.binding?.dir) {
+        console.log(`[babysitter] Process library: ${active.binding.dir}`);
+      }
+    }
+
+    console.log('[babysitter] Installation complete!');
+    console.log('[babysitter] Restart OpenClaw to pick up the installed plugin.');
+  } catch (err) {
+    console.error(`[babysitter] Failed to install plugin: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
+main();

package/bin/uninstall.cjs

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const PLUGIN_NAME = 'babysitter';
+
+// ── Directories ──────────────────────────────────────────────────────────
+
+function getUserHome() {
+  if (process.env.USERPROFILE) return path.resolve(process.env.USERPROFILE);
+  if (process.env.HOME) return path.resolve(process.env.HOME);
+  return os.homedir();
+}
+
+function getOpenClawHome() {
+  if (process.env.OPENCLAW_HOME) return path.resolve(process.env.OPENCLAW_HOME);
+  return path.join(getUserHome(), '.openclaw');
+}
+
+function getPluginRoot(workspace) {
+  if (workspace) {
+    return path.join(workspace, '.openclaw', 'plugins', PLUGIN_NAME);
+  }
+  return path.join(getOpenClawHome(), 'plugins', PLUGIN_NAME);
+}
+
+// ── Args ─────────────────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  let workspace = null;
+  for (let i = 2; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--workspace') {
+      const next = argv[i + 1];
+      workspace = next && !next.startsWith('-') ? path.resolve(argv[++i]) : process.cwd();
+      continue;
+    }
+    if (arg === '--global') {
+      workspace = null;
+      continue;
+    }
+    throw new Error(`unknown argument: ${arg}`);
+  }
+  return { workspace };
+}
+
+// ── File helpers ─────────────────────────────────────────────────────────
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+
+function writeJson(filePath, value) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+
+// ── Remove plugin directory ──────────────────────────────────────────────
+
+function removePluginDir(pluginRoot) {
+  if (!fs.existsSync(pluginRoot)) {
+    console.log(`[babysitter] Plugin directory not found: ${pluginRoot}`);
+    return false;
+  }
+  try {
+    fs.rmSync(pluginRoot, { recursive: true, force: true });
+    console.log(`[babysitter] Removed plugin directory: ${pluginRoot}`);
+    return true;
+  } catch (err) {
+    console.warn(`[babysitter] Warning: Could not remove ${pluginRoot}: ${err.message}`);
+    return false;
+  }
+}
+
+// ── Remove OpenClaw config entry ─────────────────────────────────────────
+
+function removeOpenClawConfig(workspace) {
+  const configDir = workspace
+    ? path.join(workspace, '.openclaw')
+    : getOpenClawHome();
+
+  const pluginsConfigPath = path.join(configDir, 'plugins.json');
+  if (!fs.existsSync(pluginsConfigPath)) return;
+
+  try {
+    const config = readJson(pluginsConfigPath);
+    if (config.plugins && config.plugins[PLUGIN_NAME]) {
+      delete config.plugins[PLUGIN_NAME];
+      writeJson(pluginsConfigPath, config);
+      console.log(`[babysitter] Removed plugin entry from: ${pluginsConfigPath}`);
+    }
+  } catch (err) {
+    console.warn(`[babysitter] Warning: Could not update config: ${err.message}`);
+  }
+}
+
+// ── Remove marketplace entry ─────────────────────────────────────────────
+
+function removeMarketplaceEntry() {
+  const marketplacePath = path.join(getUserHome(), '.a5c', 'marketplace', 'marketplace.json');
+  if (!fs.existsSync(marketplacePath)) return;
+
+  try {
+    const marketplace = readJson(marketplacePath);
+    if (!Array.isArray(marketplace.plugins)) return;
+
+    const before = marketplace.plugins.length;
+    marketplace.plugins = marketplace.plugins.filter((e) => e && e.name !== PLUGIN_NAME);
+    if (marketplace.plugins.length < before) {
+      writeJson(marketplacePath, marketplace);
+      console.log(`[babysitter] Removed marketplace entry: ${marketplacePath}`);
+    }
+  } catch (err) {
+    console.warn(`[babysitter] Warning: Could not update marketplace: ${err.message}`);
+  }
+}
+
+// ── Remove legacy hook scripts from OpenClaw hooks dir ───────────────────
+
+function removeLegacyHookScripts(workspace) {
+  const hooksDir = workspace
+    ? path.join(workspace, '.openclaw', 'hooks')
+    : path.join(getOpenClawHome(), 'hooks');
+
+  const legacyScripts = [
+    'babysitter-session-start.sh',
+    'babysitter-stop-hook.sh',
+  ];
+
+  for (const script of legacyScripts) {
+    const scriptPath = path.join(hooksDir, script);
+    if (fs.existsSync(scriptPath)) {
+      fs.rmSync(scriptPath, { force: true });
+      console.log(`[babysitter] Removed hook script: ${scriptPath}`);
+    }
+  }
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────
+
+function main() {
+  const { workspace } = parseArgs(process.argv);
+  const pluginRoot = getPluginRoot(workspace);
+  const scope = workspace ? `project (${workspace})` : 'global';
+
+  console.log(`[babysitter] Uninstalling babysitter plugin for OpenClaw (${scope})`);
+
+  // 1. Remove plugin directory
+  const removed = removePluginDir(pluginRoot);
+
+  // 2. Remove config entry
+  removeOpenClawConfig(workspace);
+
+  // 3. Remove marketplace entry (global only)
+  if (!workspace) {
+    removeMarketplaceEntry();
+  }
+
+  // 4. Remove legacy hook scripts
+  removeLegacyHookScripts(workspace);
+
+  if (removed) {
+    console.log('[babysitter] Uninstallation complete. Restart OpenClaw to apply changes.');
+  } else {
+    console.log('[babysitter] Plugin was not installed; cleaned up config entries if present.');
+  }
+}
+
+main();

package/commands/assimilate.md

@@ -0,0 +1,37 @@
+---
+description: Assimilate an external methodology, harness, or specification into babysitter process definitions with skills and agents.
+argument-hint: Target to assimilate (e.g. repo URL, harness name, or spec path)
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+Use the assimilation domain processes from the active process library to convert external sources into well-defined babysitter process definitions with accompanying skills/ and agents/ directories.
+
+If the workspace does not already have an active process-library binding, initialize it first through the shared global SDK binding:
+
+```bash
+babysitter process-library:active --json
+```
+
+Run the process after formalizing it.
+
+Available assimilation workflows:
+- **methodology-assimilation** (`specializations/meta/assimilation/workflows/methodology-assimilation`) - Learns an external methodology from its repo and converts procedural instructions, commands, and manual flows into babysitter processes with refactored skills and agents. Supports output as methodology or specialization.
+- **harness integration** (`specializations/meta/assimilation/harness/*`) - Integrates babysitter SDK with a specific AI coding harness (generic, codex, opencode, gemini-cli, openclaw, antigravity).
+
+During the interview phase, determine which assimilation workflow to use based on the user's target:
+- If the target is a **repo URL or methodology name** then use the methodology-assimilation workflow.
+- If the target is a **harness name** (e.g. codex, opencode, antigravity) then use the matching harness process.
+- If the target is a **specification or other source** then adapt the methodology-assimilation workflow for the spec format.
+- If unclear, ask the user to clarify the assimilation target and type.
+
+## After Assimilation: Contribute Back
+
+After successfully assimilating a methodology or harness integration, prompt the user to share it with the community. The assimilated process definitions, skills, and agents could benefit other babysitter users:
+
+- **Completed a methodology assimilation**: `/babysitter:contrib library contribution: assimilated [methodology-name] into babysitter process definitions`
+- **Completed a harness integration**: `/babysitter:contrib library contribution: [harness-name] harness integration`
+- **Hit issues during assimilation** (e.g. unsupported patterns, missing SDK features): `/babysitter:contrib bug report: assimilation of [target] failed because [description]` or `/babysitter:contrib feature request: [what the SDK needs to support]`
+
+Even just reporting that an assimilation didn't work well helps improve babysitter for everyone.

package/commands/babysit.md

@@ -0,0 +1,7 @@
+---
+description: Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)
+argument-hint: Optional arguments.
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).

package/commands/call.md

@@ -0,0 +1,7 @@
+---
+description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow.
+argument-hint: Specific instructions for the run.
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).

package/commands/cleanup.md

@@ -0,0 +1,20 @@
+---
+description: Clean up .a5c/runs and .a5c/processes directories. Aggregates insights from completed/failed runs into docs/run-history-insights.md, then removes old run data and orphaned process files.
+argument-hint: "[--dry-run] [--keep-days N] Optional flags. --dry-run shows what would be removed without deleting. --keep-days N keeps runs newer than N days (default 7)."
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+Create and run a cleanup process using the process at `skills\babysit\process\cradle\cleanup-runs.js/processes/cleanup-runs.js`.
+
+Implementation notes (for the process):
+- Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
+- The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
+- Always show the user what will be removed before removing (in interactive mode via breakpoints)
+- In non-interactive mode (yolo), proceed with cleanup using defaults
+- The insights file goes to docs/run-history-insights.md
+- Only remove terminal runs (completed/failed) older than the keep-days threshold
+- Never remove active/in-progress runs
+- Remove orphaned process files not referenced by remaining runs
+- After cleanup, show remaining run count and disk usage

package/commands/contrib.md

@@ -0,0 +1,33 @@
+---
+description: Submit feedback or contribute to babysitter project
+argument-hint: Specific instructions for the run.
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+## Process Routing
+
+Contribution processes live under the active process library's `cradle/` directory. Resolve the active library root with `babysitter process-library:active --json` and route based on arguments:
+
+### Issue-based (opens a GitHub issue in a5c-ai/babysitter)
+ * **Bug report** → `cradle/bug-report.js#process` — Report a bug in the SDK, CLI, process library, etc.
+ * **Feature request** → `cradle/feature-request.js#process` — Request a new feature or enhancement
+ * **Documentation question** → `cradle/documentation-question.js#process` — Ask about undocumented behavior or missing docs
+
+### PR-based (forks repo, creates branch, submits PR to a5c-ai/babysitter)
+ * **Bugfix** → `cradle/bugfix.js#process` — User already has the fix for a bug
+ * **Feature implementation** → `cradle/feature-implementation-contribute.js#process` — User already has a feature implementation
+ * **Harness integration** → `cradle/feature-harness-integration-contribute.js#process` — User has a harness (CI/CD, IDE, editor) integration
+ * **Library contribution** → `cradle/library-contribution.js#process` — New or improved process/skill/subagent for the library
+ * **Documentation answer** → `cradle/documentation-contribute-answer.js#process` — User has an answer for an unanswered docs question
+
+### Router (when arguments are empty or general)
+ * **Contribute** → `cradle/contribute.js#process` — Explains contribution types and routes to the specific process
+
+## Contribution Rules
+
+ * PR-based contributions: fork the babysitter repo (a5c-ai/babysitter) for the user, ask to star if not already starred, perform changes, submit PR
+ * Issue-based contributions: gather details, search for duplicates, review, then open an issue in a5c-ai/babysitter
+ * Add breakpoints (permissions) before ALL gh actions (fork, star, submit PR/issue) to allow user review and cancellation
+ * If arguments are empty: use the `contribute.js` router process to show options and route accordingly