@a5c-ai/babysitter-codex 5.0.1-staging.ffad3b46492e → 5.1.1-staging.00ceebd28cf2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "babysitter",
3
- "version": "5.0.1-staging.ffad3b46492e",
3
+ "version": "5.1.1-staging.00ceebd28cf2",
4
4
  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
5
5
  "author": {
6
6
  "name": "a5c.ai",
package/README.md CHANGED
@@ -11,9 +11,15 @@ This package ships a real Codex plugin bundle:
11
11
 
12
12
  It still uses the Babysitter SDK CLI and the shared `~/.a5c` process-library
13
13
  state. Global install writes the plugin bundle to `~/.agents/plugins/babysitter`
14
- and updates `~/.agents/plugins/marketplace.json` so Codex can load the plugin
15
- through its marketplace surface. Workspace install continues to materialize a
16
- workspace-local Codex surface for team setup.
14
+ and updates `.agents/plugins/marketplace.json` (primary) so Codex can load the
15
+ plugin through its marketplace surface. Codex also recognizes
16
+ `.claude-plugin/marketplace.json` as a legacy marketplace path. Workspace
17
+ install continues to materialize a workspace-local Codex surface for team setup.
18
+
19
+ Codex now ships an official marketplace CLI (`codex plugin marketplace`) that
20
+ supports `add`, `list`, `upgrade`, and `remove` subcommands. Plugin bundles
21
+ installed through the marketplace are cached under
22
+ `~/.codex/plugins/cache/$MARKETPLACE/$PLUGIN/$VERSION/`.
17
23
 
18
24
  ## Installation
19
25
 
@@ -40,6 +46,34 @@ npx --yes @a5c-ai/babysitter-codex install --global
40
46
  npx --yes @a5c-ai/babysitter-codex install --workspace /path/to/repo
41
47
  ```
42
48
 
49
+ Alternatively, use the official Codex marketplace CLI to add the babysitter
50
+ marketplace directly from GitHub:
51
+
52
+ ```bash
53
+ codex plugin marketplace add a5c-ai/babysitter --ref staging --sparse .agents/plugins
54
+ ```
55
+
56
+ Or from a local clone:
57
+
58
+ ```bash
59
+ codex plugin marketplace add ./path/to/babysitter
60
+ ```
61
+
62
+ Then browse and install:
63
+
64
+ ```bash
65
+ codex plugin list --source babysitter
66
+ codex plugin install babysitter --source babysitter
67
+ ```
68
+
69
+ Other marketplace commands:
70
+
71
+ ```bash
72
+ codex plugin marketplace list
73
+ codex plugin marketplace upgrade babysitter
74
+ codex plugin marketplace remove babysitter
75
+ ```
76
+
43
77
  Then open Codex and finish enabling the plugin from the plugin UI:
44
78
 
45
79
  ```text
@@ -64,6 +98,25 @@ The plugin provides:
64
98
  The process library is fetched and bound through the SDK CLI in
65
99
  `~/.a5c/active/process-library.json`.
66
100
 
101
+ ## Hook Environment Variables
102
+
103
+ Codex exposes the following environment variables to hook scripts:
104
+
105
+ | Variable | Description |
106
+ |---|---|
107
+ | `PLUGIN_ROOT` | Absolute path to the plugin root directory (native) |
108
+ | `PLUGIN_DATA` | Persistent data directory for the plugin (native) |
109
+ | `CLAUDE_PLUGIN_ROOT` | Compatibility alias for `PLUGIN_ROOT` |
110
+ | `CLAUDE_PLUGIN_DATA` | Compatibility alias for `PLUGIN_DATA` |
111
+
112
+ Hook scripts should prefer `PLUGIN_ROOT` / `PLUGIN_DATA` but can read the
113
+ `CLAUDE_PLUGIN_ROOT` / `CLAUDE_PLUGIN_DATA` aliases for cross-harness
114
+ compatibility with Claude Code plugins.
115
+
116
+ Codex auto-detects hooks via `./hooks/hooks.json`. The `hooks` field in
117
+ `.codex-plugin/plugin.json` accepts a path, an array of paths, an inline
118
+ object, or an array of objects.
119
+
67
120
  ## Workspace Output
68
121
 
69
122
  After `install --workspace`, the important files are:
@@ -29,7 +29,7 @@ function writeFileIfChanged(filePath, contents) {
29
29
  try {
30
30
  const existing = fs.readFileSync(filePath, 'utf8');
31
31
  if (existing === contents) return false;
32
- } catch {}
32
+ } catch (e) { process.stderr.write('[extensions-adapter] file read failed for ' + filePath + ', overwriting: ' + (e instanceof Error ? e.message : String(e)) + '\n'); }
33
33
  fs.mkdirSync(path.dirname(filePath), { recursive: true });
34
34
  fs.writeFileSync(filePath, contents);
35
35
  return true;
@@ -82,7 +82,7 @@ function writeJson(filePath, value) {
82
82
  function ensureExecutable(filePath) {
83
83
  try {
84
84
  fs.chmodSync(filePath, 0o755);
85
- } catch {}
85
+ } catch (e) { process.stderr.write('[extensions-adapter] chmod failed for ' + filePath + ': ' + (e instanceof Error ? e.message : String(e)) + '\n'); }
86
86
  }
87
87
 
88
88
  function normalizeMarketplaceSourcePath(source, marketplacePath) {
@@ -104,7 +104,7 @@ function ensureMarketplaceEntry(marketplacePath, pluginRoot) {
104
104
  name: PLUGIN_NAME,
105
105
  source: relSource,
106
106
  description: "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
107
- version: "5.0.1-staging.ffad3b46492e",
107
+ version: "5.1.1-staging.00ceebd28cf2",
108
108
  author: { name: "a5c.ai" },
109
109
  };
110
110
  if (idx >= 0) marketplace.plugins[idx] = entry;
@@ -130,7 +130,7 @@ function runPostInstall(pluginRoot) {
130
130
  if (fs.existsSync(postInstall)) {
131
131
  spawnSync(process.execPath, [postInstall], {
132
132
  cwd: pluginRoot, stdio: 'inherit',
133
- env: { ...process.env, PLUGIN_ROOT: pluginRoot },
133
+ env: { ...process.env, PLUGIN_ROOT: pluginRoot, CLAUDE_PLUGIN_ROOT: pluginRoot },
134
134
  });
135
135
  }
136
136
  }
@@ -147,7 +147,7 @@ function resolveCliCommand(packageRoot) {
147
147
  const versionsPath = path.join(packageRoot, 'versions.json');
148
148
  const versions = readJson(versionsPath) || {};
149
149
  const ver = versions.sdkVersion || 'latest';
150
- return `npx -y @a5c-ai/babysitter-sdk@${ver}`;
150
+ return `npm exec --yes --package @a5c-ai/babysitter-sdk@${ver} -- babysitter`;
151
151
  }
152
152
 
153
153
  function runCli(packageRoot, cliArgs, options = {}) {
@@ -1,7 +1,7 @@
1
1
  #!/bin/bash
2
2
  # Session Start — installs SDK if needed, then runs hook handler.
3
3
  set -euo pipefail
4
- PLUGIN_ROOT="${PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
4
+ PLUGIN_ROOT="${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}}"
5
5
  SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}" 2>/dev/null || echo "latest")
6
6
  if ! command -v babysitter &>/dev/null; then
7
7
  npm i -g "@a5c-ai/babysitter-sdk@${SDK_VERSION}" --loglevel=error 2>/dev/null || \
package/hooks.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "hooks": [
7
7
  {
8
8
  "type": "command",
9
- "command": "a5c-hooks-mux invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-session-start.sh\" --json"
9
+ "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-session-start.sh\" --json"
10
10
  }
11
11
  ]
12
12
  }
@@ -17,7 +17,7 @@
17
17
  "hooks": [
18
18
  {
19
19
  "type": "command",
20
- "command": "a5c-hooks-mux invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-stop.sh\" --json"
20
+ "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-stop.sh\" --json"
21
21
  }
22
22
  ]
23
23
  }
@@ -28,7 +28,7 @@
28
28
  "hooks": [
29
29
  {
30
30
  "type": "command",
31
- "command": "a5c-hooks-mux invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-user-prompt-submit.sh\" --json"
31
+ "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-user-prompt-submit.sh\" --json"
32
32
  }
33
33
  ]
34
34
  }
@@ -39,7 +39,7 @@
39
39
  "hooks": [
40
40
  {
41
41
  "type": "command",
42
- "command": "a5c-hooks-mux invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-pre-tool-use.sh\" --json"
42
+ "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-pre-tool-use.sh\" --json"
43
43
  }
44
44
  ]
45
45
  }
@@ -50,7 +50,7 @@
50
50
  "hooks": [
51
51
  {
52
52
  "type": "command",
53
- "command": "a5c-hooks-mux invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-post-tool-use.sh\" --json"
53
+ "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-post-tool-use.sh\" --json"
54
54
  }
55
55
  ]
56
56
  }
@@ -61,7 +61,7 @@
61
61
  "hooks": [
62
62
  {
63
63
  "type": "command",
64
- "command": "a5c-hooks-mux invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-session-end.sh\" --json"
64
+ "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-session-end.sh\" --json"
65
65
  }
66
66
  ]
67
67
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@a5c-ai/babysitter-codex",
3
- "version": "5.0.1-staging.ffad3b46492e",
3
+ "version": "5.1.1-staging.00ceebd28cf2",
4
4
  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
5
5
  "scripts": {
6
6
  "test": "npm run validate:ci",
@@ -1,13 +1,25 @@
1
1
  ---
2
2
  name: babysit
3
- description: >-
4
- Execute via @babysitter. Use this skill when asked to babysit a task, do anything that is structured process-driven (even a loop) or whenever it is called explicitly. (babysit, babysitter, with a process, orchestrate, orchestrate a run, workflow, loop until, etc.)
3
+ description: Execute via @babysitter. Use this skill when asked to babysit a task, do anything that is structured process-driven (even a loop) or whenever it is called explicitly. (babysit, babysitter, with a process, orchestrate, orchestrate a run, workflow, loop until, etc.)
4
+ allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
+ version: 0.1.3
5
6
  ---
6
7
 
7
8
  # babysit
8
9
 
9
10
  Follow the commands below exactly. but apply judgement and creativity to get the job done. no matter how small or simple the task may seem, you must use the babysitter SDK and run lifecycle to execute it. This is non-negotiable. If you are asked to do something that seems like it could be done with a simple tool call, you must still use the babysitter SDK to create a run, define tasks, execute them, and complete the run. This is how you will learn and demonstrate mastery of the babysitter system. Always follow the full process, even for trivial tasks.
10
11
 
12
+ Subagents that need a scratch checkout or working directory must create it under
13
+ `/tmp/<descriptive-name>/`, not under `.a5c/runs/<runId>/work`. Before returning
14
+ deliverables, validate that no run-dir worktree was left behind, for example:
15
+
16
+ ```bash
17
+ find .a5c/runs -maxdepth 3 -name work -type d -print
18
+ ```
19
+
20
+ That command should print nothing. If it prints a non-empty work directory, move
21
+ or remove only the scratch data you created before returning.
22
+
11
23
  ## Dependencies
12
24
 
13
25
  ### Babysitter SDK and CLI
@@ -15,13 +27,19 @@ Follow the commands below exactly. but apply judgement and creativity to get the
15
27
  Read the SDK version from `versions.json` to ensure version compatibility:
16
28
 
17
29
  ```bash
18
- SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${CODEX_PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}")
19
- npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
20
-
21
- CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
30
+ SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}")
31
+ npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION || npm i -g @a5c-ai/babysitter-sdk@latest
32
+
33
+ if command -v babysitter >/dev/null 2>&1 && babysitter --version >/dev/null 2>&1; then
34
+ CLI="babysitter"
35
+ else
36
+ CLI="npm exec --yes --package @a5c-ai/babysitter-sdk@$SDK_VERSION -- babysitter"
37
+ fi
22
38
  ```
23
39
 
24
- If `babysitter` is already installed globally at the correct version, you may use `CLI="babysitter"` instead.
40
+ If the pinned version fails to install (e.g. not yet published), the fallback installs `latest`.
41
+
42
+ If a stale or broken global shim fails with `MODULE_NOT_FOUND`, repair it with `npm rm -g @a5c-ai/babysitter @a5c-ai/babysitter-sdk && npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION`, then re-run `babysitter --version`.
25
43
 
26
44
  ### jq
27
45
 
@@ -29,13 +47,13 @@ Make sure `jq` is installed and available in the path. If not, install it.
29
47
 
30
48
  ## Instructions
31
49
 
32
- Run the following command to get full orchestration instructions:
50
+ Run the following command to get full instructions:
33
51
 
34
52
  ```bash
35
53
  $CLI instructions:babysit-skill --harness codex --interactive
36
54
  ```
37
55
 
38
- For non-interactive runs (e.g., with `-p` flag or no question tool):
56
+ For non-interactive mode (running with `-p` flag or no AskUserQuestion tool):
39
57
 
40
58
  ```bash
41
59
  $CLI instructions:babysit-skill --harness codex --no-interactive
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: blueprints
3
+ description: manage Babysitter blueprints. Use this command to list installed blueprints, browse marketplaces, install, update, uninstall, configure, or create a new blueprint.
4
+ ---
5
+
6
+ # blueprints
7
+
8
+ This command installs and manages Babysitter blueprints. A blueprint is a version-managed package of contextual instructions or deterministic Babysitter processes, not a conventional software plugin.
9
+
10
+ If the command is run without arguments, list installed blueprints with their name, version, marketplace, installation date, and last update date. Also list configured marketplaces and show how to add the default marketplace when none exist.
11
+
12
+ Blueprints can be installed at two scopes:
13
+
14
+ - **global** (`--global`): stored under `~/.a5c/`, available for all projects
15
+ - **project** (`--project`): stored under `<projectDir>/.a5c/`, project-specific
16
+
17
+ ## Marketplace Management
18
+
19
+ Marketplaces are git repositories containing a `marketplace.json` manifest and blueprint package directories. The SDK clones new marketplaces to `.a5c/blueprints/marketplaces/` for the selected scope and reads legacy `.a5c/marketplaces/` clones for compatibility.
20
+
21
+ ### Add a marketplace
22
+
23
+ ```bash
24
+ babysitter blueprints:add-marketplace --marketplace-url <url> [--marketplace-path <relative-path>] [--marketplace-branch <ref>] [--force] --global|--project [--json]
25
+ ```
26
+
27
+ ### Update a marketplace
28
+
29
+ ```bash
30
+ babysitter blueprints:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] --global|--project [--json]
31
+ ```
32
+
33
+ ### List blueprints in a marketplace
34
+
35
+ ```bash
36
+ babysitter blueprints:list-blueprints --marketplace-name <name> --global|--project [--json]
37
+ ```
38
+
39
+ ## Blueprint Lifecycle
40
+
41
+ For `blueprint:install`, `blueprint:update`, `blueprint:configure`, and `blueprint:list-blueprints`, the `--marketplace-name` flag is auto-detected when only one marketplace is cloned for the selected scope.
42
+
43
+ ```bash
44
+ babysitter blueprints:install --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
45
+ babysitter blueprints:update --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
46
+ babysitter blueprints:configure --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
47
+ babysitter blueprints:uninstall --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
48
+ ```
49
+
50
+ The `--plugin-name` flag is preserved for CLI compatibility with existing marketplace manifests. User-facing docs should call the installable a blueprint.
51
+
52
+ ## Registry Management
53
+
54
+ ```bash
55
+ babysitter blueprints:list-installed --global|--project [--json]
56
+ babysitter blueprints:update-registry --plugin-name <name> --plugin-version <ver> --marketplace-name <mp> --global|--project [--json]
57
+ babysitter blueprints:remove-from-registry --plugin-name <name> --global|--project [--json]
58
+ ```
59
+
60
+ ## Deprecated Aliases
61
+
62
+ The old `plugin:*` commands remain available as deprecated aliases for one release. Prefer `blueprint:*` in new docs, skills, and process instructions.
63
+
64
+ ## Agent Plugins Are Separate
65
+
66
+ Do not rename or reinterpret agent harness plugins while handling blueprints. `CLAUDE_PLUGIN_ROOT`, `PI_PLUGIN_ROOT`, `.claude/plugins/`, hooks-adapter, extensions-adapter, and agent plugin manifests stay plugin-specific.
@@ -0,0 +1,69 @@
1
+ ---
2
+ name: check-forbidden-markers
3
+ description: Pre-deploy gate that scans built JS chunks for forbidden substring markers (saga-era / obsolete code paths) listed in a project-local forbidden-markers.txt
4
+ ---
5
+
6
+ # check-forbidden-markers
7
+
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Compose the gate from the shared helper at `library/processes/shared/forbidden-markers-scanner.js` (issue #477).
9
+
10
+ ## What this gate does
11
+
12
+ Reads a list of literal substring markers from `scripts/forbidden-markers.txt` (blank lines and `#`-prefixed comments stripped) and greps every `.js` chunk under `.vercel/output/static/_next/static/chunks/` (Next.js / Vercel default; configurable) for any occurrence. Reports structured hits per `(marker, chunk)` pair with occurrence counts. Designed to chain between `vercel build --prod` and `vercel deploy --prod`.
13
+
14
+ Use this gate when a refactor or restart-from-baseline replaced load-bearing code paths and you need a structural guarantee the obsolete symbols never re-ship. Burned-in evidence: cookbook VI-9 / VI-12 near-miss revivals during the 2026-05 iOS-Safari saga; the prototype lives at `cookbook/scripts/check-no-forbidden.mjs` and shipped two upstream contributions before being generalized as this gate.
15
+
16
+ ## When to use
17
+
18
+ - **Pre-deploy.** Insert after build, before deploy. Block the deploy when `ok: false`.
19
+ - **Post-restart.** After a baseline rollback + step-by-step re-add, snapshot the saga-era markers in `forbidden-markers.txt` and let CI hold the line.
20
+ - **Post-refactor.** When old helper / handler / module names must not coexist with the new ones in the same bundle.
21
+
22
+ ## Expected config locations
23
+
24
+ - `scripts/forbidden-markers.txt` — one marker per line, `#` for comments. The list is the contract; the gate is mechanical. Commit this file to source control.
25
+ - `.vercel/output/static/_next/static/chunks/` — default scan target. Override for non-Vercel frameworks via the `--chunks-dir` flag or the `chunksDir` task input.
26
+
27
+ A missing markers file is a no-op (`ok: true`, `reason: 'missing-markers-file'`) — misconfiguration is never a deploy block. A missing chunks directory is likewise a no-op (`reason: 'missing-chunks-dir'`) so the gate is safe to chain into `check:all` before the build runs.
28
+
29
+ ## Exit semantics
30
+
31
+ | Reason | `ok` | Deploy decision |
32
+ |-------------------------|--------|--------------------------------|
33
+ | `missing-markers-file` | true | Pass (no gate active) |
34
+ | `missing-chunks-dir` | true | Pass (run before build) |
35
+ | `empty-markers` | true | Pass (list is empty) |
36
+ | `no-chunks` | true | Pass (nothing to scan) |
37
+ | `clean` | true | Pass — proceed to deploy |
38
+ | `hits` | false | **BLOCK** — surface hits, ask for triage |
39
+
40
+ For each hit, the gate emits `{ marker, chunk, count }` so the operator sees the exact marker string, the absolute chunk path, and the number of occurrences in that chunk. Multiple hits across chunks for the same marker are reported separately.
41
+
42
+ ## Programmatic surface
43
+
44
+ ```js
45
+ import { scanForbiddenMarkers, checkForbiddenMarkersTask } from '@a5c-ai/babysitter-library/processes/shared';
46
+
47
+ // Direct call:
48
+ const result = await scanForbiddenMarkers({
49
+ markersFile: 'scripts/forbidden-markers.txt',
50
+ chunksDir: '.vercel/output/static/_next/static/chunks',
51
+ });
52
+ if (!result.ok) {
53
+ // result.hits: Array<{ marker, chunk, count }>
54
+ // result.reason === 'hits'
55
+ process.exit(1);
56
+ }
57
+
58
+ // Or dispatched as a babysitter task:
59
+ const gate = await ctx.task(checkForbiddenMarkersTask, {
60
+ projectDir: '.',
61
+ // markersFile / chunksDir are inferred from projectDir if omitted
62
+ });
63
+ ```
64
+
65
+ ## Reference
66
+
67
+ - Issue: https://github.com/a5c-ai/babysitter/issues/477
68
+ - Helper module: `library/processes/shared/forbidden-markers-scanner.js`
69
+ - Origin (cookbook prototype): `cookbook/scripts/check-no-forbidden.mjs` (81 lines)
@@ -7,7 +7,13 @@ description: Clean up .a5c/runs and .a5c/processes directories. Aggregates insig
7
7
 
8
8
  Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
9
 
10
- Create and run a cleanup process using the process at `skills\babysit\process\cradle\cleanup-runs.js/processes/cleanup-runs.js`.
10
+ Resolve the active process library with:
11
+
12
+ ```bash
13
+ babysitter process-library:active --json
14
+ ```
15
+
16
+ Read `binding.dir` from that JSON and create/run the cleanup process from `cradle/cleanup-runs.js#process` relative to that active library root. Do not use plugin-cache-relative cradle paths.
11
17
 
12
18
  Implementation notes (for the process):
13
19
  - Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
@@ -5,30 +5,30 @@ description: Submit feedback or contribute to babysitter project
5
5
 
6
6
  # contrib
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
-
10
- ## Process Routing
11
-
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
+
10
+ ## Process Routing
11
+
12
12
  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:
13
-
14
- ### Issue-based (opens a GitHub issue in a5c-ai/babysitter)
15
- * **Bug report** → `cradle/bug-report.js#process` — Report a bug in the SDK, CLI, process library, etc.
16
- * **Feature request** → `cradle/feature-request.js#process` — Request a new feature or enhancement
17
- * **Documentation question** → `cradle/documentation-question.js#process` — Ask about undocumented behavior or missing docs
18
-
19
- ### PR-based (forks repo, creates branch, submits PR to a5c-ai/babysitter)
20
- * **Bugfix** → `cradle/bugfix.js#process` — User already has the fix for a bug
21
- * **Feature implementation** → `cradle/feature-implementation-contribute.js#process` — User already has a feature implementation
22
- * **Harness integration** → `cradle/feature-harness-integration-contribute.js#process` — User has a harness (CI/CD, IDE, editor) integration
23
- * **Library contribution** → `cradle/library-contribution.js#process` — New or improved process/skill/subagent for the library
24
- * **Documentation answer** → `cradle/documentation-contribute-answer.js#process` — User has an answer for an unanswered docs question
25
-
26
- ### Router (when arguments are empty or general)
27
- * **Contribute** → `cradle/contribute.js#process` — Explains contribution types and routes to the specific process
28
-
29
- ## Contribution Rules
30
-
31
- * PR-based contributions: fork the babysitter repo (a5c-ai/babysitter) for the user, ask to star if not already starred, perform changes, submit PR
32
- * Issue-based contributions: gather details, search for duplicates, review, then open an issue in a5c-ai/babysitter
33
- * Add breakpoints (permissions) before ALL gh actions (fork, star, submit PR/issue) to allow user review and cancellation
13
+
14
+ ### Issue-based (opens a GitHub issue in a5c-ai/babysitter)
15
+ * **Bug report** → `cradle/bug-report.js#process` — Report a bug in the SDK, CLI, process library, etc.
16
+ * **Feature request** → `cradle/feature-request.js#process` — Request a new feature or enhancement
17
+ * **Documentation question** → `cradle/documentation-question.js#process` — Ask about undocumented behavior or missing docs
18
+
19
+ ### PR-based (forks repo, creates branch, submits PR to a5c-ai/babysitter)
20
+ * **Bugfix** → `cradle/bugfix.js#process` — User already has the fix for a bug
21
+ * **Feature implementation** → `cradle/feature-implementation-contribute.js#process` — User already has a feature implementation
22
+ * **Harness integration** → `cradle/feature-harness-integration-contribute.js#process` — User has a harness (CI/CD, IDE, editor) integration
23
+ * **Library contribution** → `cradle/library-contribution.js#process` — New or improved process/skill/subagent for the library
24
+ * **Documentation answer** → `cradle/documentation-contribute-answer.js#process` — User has an answer for an unanswered docs question
25
+
26
+ ### Router (when arguments are empty or general)
27
+ * **Contribute** → `cradle/contribute.js#process` — Explains contribution types and routes to the specific process
28
+
29
+ ## Contribution Rules
30
+
31
+ * PR-based contributions: fork the babysitter repo (a5c-ai/babysitter) for the user, ask to star if not already starred, perform changes, submit PR
32
+ * Issue-based contributions: gather details, search for duplicates, review, then open an issue in a5c-ai/babysitter
33
+ * Add breakpoints (permissions) before ALL gh actions (fork, star, submit PR/issue) to allow user review and cancellation
34
34
  * If arguments are empty: use the `contribute.js` router process to show options and route accordingly
@@ -180,13 +180,13 @@ SECONDARY COMMANDS
180
180
  a fuzzy comparison step before strict assertion. Implement this fix?")
181
181
 
182
182
 
183
- /babysitter:plugins [action]
184
- Manage babysitter plugins: list installed plugins, browse marketplaces, install,
185
- update, configure, uninstall, or create new plugins. Plugins are version-managed
186
- instruction packages (not executable code) that guide the agent through install,
187
- configure, and uninstall steps via markdown files.
183
+ /babysitter:blueprints [action]
184
+ Manage Babysitter blueprints: list installed blueprints, browse marketplaces,
185
+ install, update, configure, uninstall, or create new blueprints. Blueprints are
186
+ version-managed instruction packages or process bundles that guide the agent
187
+ through install, configure, and uninstall steps.
188
188
 
189
- Without arguments: shows installed plugins (name, version, marketplace, dates) and
189
+ Without arguments: shows installed blueprints (name, version, marketplace, dates) and
190
190
  available marketplaces. With arguments: routes to the specific action.
191
191
 
192
192
  Key actions:
@@ -194,11 +194,11 @@ SECONDARY COMMANDS
194
194
  - configure <name> --global|--project: fetch configure.md and walk through options
195
195
  - update <name> --global|--project: resolve migration chain via BFS and apply steps
196
196
  - uninstall <name> --global|--project: fetch uninstall.md and execute removal
197
- - create: scaffold a new plugin package with the meta/plugin-creation process
197
+ - create: scaffold a new blueprint package
198
198
 
199
- Example: /babysitter:plugins install sound-hooks --project
199
+ Example: /babysitter:blueprints install sound-hooks --project
200
200
  (fetches sound-hooks from marketplace, reads install.md, walks you through player
201
- detection, sound selection, hook configuration, and registers in plugin-registry.json)
201
+ detection, sound selection, hook configuration, and registers the blueprint)
202
202
 
203
203
 
204
204
  /babysitter:contrib [feedback]
@@ -5,4 +5,14 @@ description: Plan a babysitter run. use this command to plan a complex workflow,
5
5
 
6
6
  # plan
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). focus on creating the best process possible, but without creating and running the actual run.
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Focus on creating the best process possible, but without creating and running the actual run.
9
+
10
+ Before drafting the process, run Phase 0 -- REUSE-AUDIT: extract keyword nouns and verbs from the request, scan for matching existing migrations, API routes, environment variables, SDK dependencies, and imports, honor `.a5c/reuse-audit.json` when present, and put a `Reuse-audit findings (REVIEW BEFORE PROCEEDING)` block before Phase 1 of the plan.
11
+
12
+ ## Process Shape Selection
13
+
14
+ Choose the process shape before authoring `process.js`:
15
+
16
+ - Use a flat phase list when the spec is well-defined, the work is wiring or composition, the bug class is already known if this is a fix, and execution should proceed sequentially through clear phases.
17
+ - Use a HYPOTHESES tree when the bug class is unknown, forensics are required, multiple causal models compete, and each hypothesis needs its own observations, falsifying observations, and follow-up phases.
18
+ - Rule of thumb: if the first phase is "investigate", use HYPOTHESES-tree mode. If the first phase is "implement X", use flat-phase-list mode.
@@ -1,257 +1,24 @@
1
1
  ---
2
2
  name: plugins
3
- description: manage babysitter plugins. use this command to see the list of installed babysitter plugins, their status, and manage them (install, update, uninstall, list from marketplace, add marketplace, configure plugin, create new plugin, etc).
3
+ description: deprecated alias for the Babysitter blueprints command. Use /babysitter:blueprints for marketplace installables.
4
4
  ---
5
5
 
6
6
  # plugins
7
7
 
8
- This command installs and manages plugins for babysitter. A plugin is a version-managed package of contextual instructions (for install, uninstall, configure, and update/migrate between versions), not a conventional software plugin.
9
-
10
- if the command is run without arguments, it lists all installed plugins with their name, version, marketplace, installation date, and last update date. as well as marketplaces added to the system. and instructions on how to install new plugins from marketplaces.
11
- if there are no marketplaces added, add the default marketplace:
12
- ```bash
13
- babysitter plugin:add-marketplace --marketplace-url https://github.com/a5c-ai/babysitter --marketplace-path plugins/a5c/marketplace/marketplace.json --global --json
14
- ```
15
-
16
- Plugins can be installed at two scopes:
17
- - **global** (`--global`): stored under `~/.a5c/`, available for all projects
18
- - **project** (`--project`): stored under `<projectDir>/.a5c/`, project-specific
19
-
20
- ## Marketplace Management
21
-
22
- Marketplaces are git repositories containing a `marketplace.json` manifest and plugin package directories. The SDK clones them locally with `--depth 1`.
23
-
24
- **Storage locations:**
25
- - Global: `~/.a5c/marketplaces/<name>/`
26
- - Project: `<projectDir>/.a5c/marketplaces/<name>/`
27
-
28
- The marketplace name is derived from the git URL's last path segment (stripping `.git` suffix and trailing slashes).
29
-
30
- ### Adding a marketplace
31
-
32
- ```bash
33
- babysitter plugin:add-marketplace --marketplace-url <url> [--marketplace-path <relative-path>] [--marketplace-branch <ref>] [--force] --global|--project [--json]
34
- ```
35
-
36
- Clones the marketplace repository to the local marketplaces directory. Use `--marketplace-path` to specify the relative path to `marketplace.json` within the repo (for monorepos or repos where the manifest is not at the root). Use `--marketplace-branch` to clone a specific branch, tag, or ref (defaults to the repo's default branch). Use `--force` to replace an existing marketplace clone (deletes and re-clones).
37
-
38
- ### Updating a marketplace
39
-
40
- ```bash
41
- babysitter plugin:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] --global|--project [--json]
42
- ```
43
-
44
- Runs `git pull` on the local marketplace clone to fetch latest changes. Use `--marketplace-branch` to switch to a different branch before pulling (works even with shallow clones).
45
-
46
- ### Listing plugins in a marketplace
47
-
48
- ```bash
49
- babysitter plugin:list-plugins --marketplace-name <name> --global|--project [--json]
50
- ```
51
-
52
- Reads the `marketplace.json` manifest and returns all available plugins sorted alphabetically by name. Each entry includes: name, description, latestVersion, versions array, packagePath, tags, and author.
53
-
54
- ## Plugin Installation
55
-
56
- **Note:** For `plugin:install`, `plugin:update`, `plugin:configure`, and `plugin:list-plugins`, the `--marketplace-name` flag is auto-detected when only one marketplace is cloned for the given scope. You can omit it if there's only one marketplace.
57
-
58
- ### Flow
59
-
60
- 1. Update the marketplace: `babysitter plugin:update-marketplace --marketplace-name <name> --global|--project`
61
- 2. Check current state: `babysitter plugin:list-installed --global|--project` to see installed plugins and versions
62
- 3. Install the plugin:
63
-
64
- ```bash
65
- babysitter plugin:install --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
66
- ```
67
-
68
- This command resolves the plugin package path from the marketplace manifest, reads `install.md` from the plugin package directory, and returns the installation instructions. If an `install-process.js` file exists, the instructions may reference it as an automated install process.
69
-
70
- 4. The agent performs the installation steps as defined in `install.md`
71
- 5. The agent updates the registry:
72
-
73
- ```bash
74
- babysitter plugin:update-registry --plugin-name <name> --plugin-version <ver> --marketplace-name <mp> --global|--project [--json]
75
- ```
76
-
77
- ## Plugin Update (with migrations)
78
-
79
- ```bash
80
- babysitter plugin:update --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
81
- ```
82
-
83
- This command:
84
- 1. Reads the currently installed version from the registry
85
- 2. Resolves the latest version from the marketplace manifest
86
- 3. Looks in the plugin package's `migrations/` directory for migration files
87
- 4. Uses BFS over the migration graph to find the shortest path from the installed version to the target version
88
- 5. Returns the ordered migration instructions (content of each migration file in sequence)
89
-
90
- **Migration filename format:** `<fromVersion>_to_<toVersion>.<ext>` where:
91
- - Versions may contain alphanumerics, dots, dashes (e.g. `1.0.0`, `2.0.0-beta`)
92
- - Extensions: `.md` for markdown instructions, `.js` for executable process files
93
- - Examples: `1.0.0_to_1.1.0.md`, `2.0.0-beta_to_2.0.0.js`
94
-
95
- After performing the migration steps, update the registry:
96
-
97
- ```bash
98
- babysitter plugin:update-registry --plugin-name <name> --plugin-version <new-ver> --marketplace-name <mp> --global|--project [--json]
99
- ```
100
-
101
- ## Plugin Uninstallation
102
-
103
- ```bash
104
- babysitter plugin:uninstall --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
105
- ```
106
-
107
- Reads `uninstall.md` from the plugin package directory and returns the uninstall instructions. After performing the uninstall steps, remove from registry:
108
-
109
- ```bash
110
- babysitter plugin:remove-from-registry --plugin-name <name> --global|--project [--json]
111
- ```
112
-
113
- ## Plugin Configuration
114
-
115
- ```bash
116
- babysitter plugin:configure --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
117
- ```
118
-
119
- Reads `configure.md` from the plugin package directory and returns configuration instructions.
120
-
121
- ## Registry Management
122
-
123
- The plugin registry (`plugin-registry.json`) tracks installed plugins with schema version `2026.01.plugin-registry-v1`. Writes use atomic file operations (temp + rename) for crash safety.
124
-
125
- **Storage locations:**
126
- - Global: `~/.a5c/plugin-registry.json`
127
- - Project: `<projectDir>/.a5c/plugin-registry.json`
128
-
129
- ### List installed plugins
130
-
131
- ```bash
132
- babysitter plugin:list-installed --global|--project [--json]
133
- ```
134
-
135
- Returns all installed plugins sorted alphabetically. In `--json` mode, returns an array of registry entries. In human mode, displays a formatted table with name, version, marketplace, and timestamps.
136
-
137
- ### Remove from registry
138
-
139
- ```bash
140
- babysitter plugin:remove-from-registry --plugin-name <name> --global|--project [--json]
141
- ```
142
-
143
- Removes a plugin entry from the registry. Returns error if the plugin is not present.
144
-
145
- ## Plugin Creation
146
-
147
- To create a new plugin package from scratch, use the `meta/plugin-creation` babysitter process. This process guides you through requirements analysis, structure design, instruction authoring, optional process file generation, validation, and marketplace integration.
148
-
149
- ### Using the plugin creation process
150
-
151
- Orchestrate a babysitter run with the plugin creation process:
152
-
153
- ```bash
154
- # Create inputs file
155
- cat > /tmp/plugin-inputs.json << 'EOF'
156
- {
157
- "pluginName": "my-plugin",
158
- "description": "What the plugin does — be specific about install/configure/uninstall behavior",
159
- "scope": "project",
160
- "outputDir": "./plugins",
161
- "components": {
162
- "installProcess": false,
163
- "configureProcess": false,
164
- "uninstallProcess": false,
165
- "migrations": false,
166
- "processFiles": false
167
- },
168
- "marketplace": {
169
- "name": "my-marketplace",
170
- "author": "my-org",
171
- "tags": ["category1", "category2"]
172
- }
173
- }
174
- EOF
175
-
176
- # Create and run
177
- babysitter run:create \
178
- --process-id meta/plugin-creation \
179
- --entry library/specializations/meta/plugin-creation.js#process \
180
- --inputs /tmp/plugin-inputs.json \
181
- --prompt "Create a new babysitter plugin package" \
182
- --json
183
- ```
184
-
185
- ### What the process generates
186
-
187
- The process creates a complete plugin package directory:
188
-
189
- | File | Description |
190
- |------|-------------|
191
- | `install.md` | Agent-readable installation instructions with numbered steps |
192
- | `uninstall.md` | Reversal instructions for clean removal |
193
- | `configure.md` | Configuration options table and adjustment instructions |
194
- | `install-process.js` | *(optional)* Automated babysitter process for complex install steps |
195
- | `configure-process.js` | *(optional)* Automated configuration process |
196
- | `process/main.js` | *(optional)* Main process the plugin contributes |
197
- | `marketplace-entry.json` | Ready-to-use marketplace.json entry for publishing |
198
-
199
- ### Process phases
200
-
201
- 1. **Requirements Analysis** — Analyzes plugin purpose, prerequisites, config options, file structure
202
- 2. **Structure Design** — Plans directory layout and file inventory (with review breakpoint)
203
- 3. **Instruction Authoring** — Writes install.md, uninstall.md, configure.md
204
- 4. **Process Files** — Creates optional babysitter process files (install-process.js, configure-process.js, process/main.js)
205
- 5. **Validation** — Verifies package completeness, instruction quality, path correctness
206
- 6. **Marketplace Integration** — Generates marketplace.json entry for publishing
207
-
208
- ### Quick creation (without orchestration)
209
-
210
- For simple plugins that only need instruction files, you can create the package manually following the structure below and the [Plugin Author Guide](docs/plugins/plugin-author-guide.md).
211
-
212
- ## Plugin Package Structure
213
-
214
- ```
215
- my-plugin/
216
- package.json # Optional (name field used as plugin ID, falls back to directory name)
217
- install.md # Markdown instructions for installation
218
- uninstall.md # Markdown instructions for removal
219
- configure.md # Markdown instructions for configuration
220
- install-process.js # Optional automated install process
221
- uninstall-process.js # Optional automated uninstall process
222
- configure-process.js # Optional automated configure process
223
- migrations/ # Version migration files
224
- 1.0.0_to_1.1.0.md
225
- 1.1.0_to_2.0.0.js
226
- process/ # Process definition files (collected recursively)
227
- main.js
228
- ```
229
-
230
- ## All CLI Commands Summary
231
-
232
- All commands accept `--json` for machine-readable output and `--global|--project`.
233
-
234
- | Command | Required Flags | Description |
235
- |---------|---------------|-------------|
236
- | `plugin:add-marketplace` | `--marketplace-url`, `--global\|--project` [`--marketplace-path`, `--marketplace-branch`, `--force`] | Clone a marketplace repository |
237
- | `plugin:update-marketplace` | `--marketplace-name`, `--global\|--project` [`--marketplace-branch`] | Pull latest marketplace changes (optionally switch branch) |
238
- | `plugin:list-plugins` | `--marketplace-name`, `--global\|--project` | List available plugins in a marketplace |
239
- | `plugin:install` | `--plugin-name`, `--marketplace-name`, `--global\|--project` | Get install instructions for a plugin |
240
- | `plugin:uninstall` | `--plugin-name`, `--marketplace-name`, `--global\|--project` | Get uninstall instructions for a plugin |
241
- | `plugin:update` | `--plugin-name`, `--marketplace-name`, `--global\|--project` | Resolve migration chain and get update instructions |
242
- | `plugin:configure` | `--plugin-name`, `--marketplace-name`, `--global\|--project` | Get configuration instructions for a plugin |
243
- | `plugin:list-installed` | `--global\|--project` | List all installed plugins |
244
- | `plugin:update-registry` | `--plugin-name`, `--plugin-version`, `--marketplace-name`, `--global\|--project` | Register or update a plugin entry |
245
- | `plugin:remove-from-registry` | `--plugin-name`, `--global\|--project` | Remove a plugin entry from the registry |
246
-
247
- ## After Plugin Work: Contribute Back
248
-
249
- After working with plugins, prompt the user to share improvements or report issues:
250
-
251
- - **Improved a plugin's install/configure/uninstall instructions**: `/babysitter:contrib library contribution: improved [plugin-name] [install|configure|uninstall] instructions`
252
- - **Created a new plugin**: `/babysitter:contrib library contribution: new plugin [plugin-name] -- [description]`
253
- - **Found a bug in a plugin or the plugin system**: `/babysitter:contrib bug report: [description, e.g. "plugin:update-registry fails when marketplace hasn't been cloned"]`
254
- - **Plugin install/configure instructions were confusing or wrong**: `/babysitter:contrib bug report: [plugin-name] install instructions [description of what was wrong]`
255
- - **Have an idea for a new plugin**: `/babysitter:contrib feature request: plugin idea -- [description]`
256
-
257
- Even reporting that a plugin's instructions were unclear helps improve it for the next user.
8
+ This command is a deprecated alias for `/babysitter:blueprints`.
9
+
10
+ For Babysitter marketplace installables, use blueprints terminology and the `babysitter blueprints:*` CLI command family:
11
+
12
+ ```bash
13
+ babysitter blueprints:list-installed --global|--project [--json]
14
+ babysitter blueprints:add-marketplace --marketplace-url <url> [--marketplace-path <relative-path>] --global|--project [--json]
15
+ babysitter blueprints:list-blueprints --marketplace-name <name> --global|--project [--json]
16
+ babysitter blueprints:install --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
17
+ babysitter blueprints:update --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
18
+ babysitter blueprints:configure --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
19
+ babysitter blueprints:uninstall --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
20
+ ```
21
+
22
+ The `--plugin-name` flag remains for CLI compatibility with existing marketplace manifests. Describe the installable as a blueprint in user-facing text.
23
+
24
+ Agent harness plugins are not renamed. `CLAUDE_PLUGIN_ROOT`, `PI_PLUGIN_ROOT`, `.claude/plugins/`, hooks-adapter, extensions-adapter, and agent plugin manifests remain plugin concepts.
@@ -5,8 +5,8 @@ description: Set up a project for babysitting. Guides you through onboarding a n
5
5
 
6
6
  # project-install
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
-
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
+
10
10
  Before using the process library, resolve the active library root through the SDK CLI. If no binding exists yet, initialize the shared global SDK binding with:
11
11
 
12
12
  ```bash
@@ -14,5 +14,5 @@ babysitter process-library:active --json
14
14
  ```
15
15
 
16
16
  Then use the `cradle/project-install` process from the active process library.
17
-
17
+
18
18
  When the run completes, end with a friendly message that includes a polite and humorous ask to star the repo on GitHub: https://github.com/a5c-ai/babysitter
@@ -5,5 +5,5 @@ description: Resume orchestrating of a babysitter run. use this command to resum
5
5
 
6
6
  # resume
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). to resume a run.
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). to resume a run.
9
9
  if no run was given, discover the runs and suggest which incomplete run to resume based on the run's status, inputs, process , etc.
@@ -5,52 +5,52 @@ description: Analysis for a run and its results, process, suggestions for proces
5
5
 
6
6
  # retrospect
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
-
10
- create and run a retrospect process:
11
-
12
- ### Run Selection
13
-
14
- - `--all` or "all runs": list all completed/failed runs and analyze collectively
15
- - Multiple run IDs: analyze each specified run
16
- - Single run ID or no ID: existing behavior (latest run)
17
- - In interactive mode with no run specified: ask user whether to analyze latest, select specific runs, or all runs
18
-
19
- ### Cross-Run Analysis (multi-run mode)
20
-
21
- When analyzing multiple runs, the retrospect process should additionally cover:
22
- - Common failure patterns across runs
23
- - Velocity trends (tasks/time across runs)
24
- - Process evolution (how processes changed)
25
- - Repeated breakpoint patterns
26
- - Aggregate quality metrics
27
-
28
- implementations notes (for the process):
29
- - The process should analyze the run, the process that was followed, and provide suggestions for improvements, optimizations, and fixes.
30
- - The process should such have many breakpoints where the user can steer the process, provide feedback, and make decisions about how to proceed with the retrospect.
31
- - The process should be designed to be flexible and adaptable to different types of runs, projects, and goals, and should be able to provide insights and suggestions that are relevant and actionable for the user. (modification to the process, skills, etc.)
32
- - The process should be designed to be iterative, allowing the user to go through multiple rounds of analysis and improvement, and should be able to track the changes and improvements made over time.
33
- - The process should cover:
34
- - Analysis of the run and its results, including what went well, what didn't go well, and what could be improved.
35
- - Analysis of the process that was followed, including what steps were taken, what tools were used, and how effective they were.
36
- - Suggestions for improvements, optimizations, and fixes for both the run and the process.
37
- - Implementing the improvements, optimizations, and fixes, and tracking the changes made over time.
38
- ### Cleanup Suggestion
39
-
40
- After retrospect analysis, suggest running `/babysitter:cleanup` to clean up old run data and reclaim disk space.
41
-
42
- - Ending by explicitly prompting the user to contribute back -- even just reporting an issue is valuable, they don't need to implement the fix themselves. After analysis, display a clear call-to-action:
43
-
44
- "You've identified [specific insight/improvement]. This could help other babysitter users too. Run `/babysitter:contrib` to share it upstream -- you can either report it as an issue or submit a PR with the fix."
45
-
46
- Route to the specific contrib workflow based on what the user wants to do:
47
-
48
- **Just reporting (no code changes needed):**
49
- - Found a bug or weakness in a process -> `/babysitter:contrib bug report: [description of what went wrong]`
50
- - Found missing or confusing documentation -> `/babysitter:contrib documentation question: [what was unclear]`
51
- - Have an idea for improvement but don't want to implement it -> `/babysitter:contrib feature request: [description]`
52
-
53
- **Contributing code changes:**
54
- - Process/skill/agent improvements -> `/babysitter:contrib library contribution: [description]`
55
- - Bug fixes in SDK or CLI -> `/babysitter:contrib bugfix: [description]`
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
+
10
+ create and run a retrospect process:
11
+
12
+ ### Run Selection
13
+
14
+ - `--all` or "all runs": list all completed/failed runs and analyze collectively
15
+ - Multiple run IDs: analyze each specified run
16
+ - Single run ID or no ID: existing behavior (latest run)
17
+ - In interactive mode with no run specified: ask user whether to analyze latest, select specific runs, or all runs
18
+
19
+ ### Cross-Run Analysis (multi-run mode)
20
+
21
+ When analyzing multiple runs, the retrospect process should additionally cover:
22
+ - Common failure patterns across runs
23
+ - Velocity trends (tasks/time across runs)
24
+ - Process evolution (how processes changed)
25
+ - Repeated breakpoint patterns
26
+ - Aggregate quality metrics
27
+
28
+ implementations notes (for the process):
29
+ - The process should analyze the run, the process that was followed, and provide suggestions for improvements, optimizations, and fixes.
30
+ - The process should such have many breakpoints where the user can steer the process, provide feedback, and make decisions about how to proceed with the retrospect.
31
+ - The process should be designed to be flexible and adaptable to different types of runs, projects, and goals, and should be able to provide insights and suggestions that are relevant and actionable for the user. (modification to the process, skills, etc.)
32
+ - The process should be designed to be iterative, allowing the user to go through multiple rounds of analysis and improvement, and should be able to track the changes and improvements made over time.
33
+ - The process should cover:
34
+ - Analysis of the run and its results, including what went well, what didn't go well, and what could be improved.
35
+ - Analysis of the process that was followed, including what steps were taken, what tools were used, and how effective they were.
36
+ - Suggestions for improvements, optimizations, and fixes for both the run and the process.
37
+ - Implementing the improvements, optimizations, and fixes, and tracking the changes made over time.
38
+ ### Cleanup Suggestion
39
+
40
+ After retrospect analysis, suggest running `/babysitter:cleanup` to clean up old run data and reclaim disk space.
41
+
42
+ - Ending by explicitly prompting the user to contribute back -- even just reporting an issue is valuable, they don't need to implement the fix themselves. After analysis, display a clear call-to-action:
43
+
44
+ "You've identified [specific insight/improvement]. This could help other babysitter users too. Run `/babysitter:contrib` to share it upstream -- you can either report it as an issue or submit a PR with the fix."
45
+
46
+ Route to the specific contrib workflow based on what the user wants to do:
47
+
48
+ **Just reporting (no code changes needed):**
49
+ - Found a bug or weakness in a process -> `/babysitter:contrib bug report: [description of what went wrong]`
50
+ - Found missing or confusing documentation -> `/babysitter:contrib documentation question: [what was unclear]`
51
+ - Have an idea for improvement but don't want to implement it -> `/babysitter:contrib feature request: [description]`
52
+
53
+ **Contributing code changes:**
54
+ - Process/skill/agent improvements -> `/babysitter:contrib library contribution: [description]`
55
+ - Bug fixes in SDK or CLI -> `/babysitter:contrib bugfix: [description]`
56
56
  - Plugin instruction improvements -> `/babysitter:contrib library contribution: improved [plugin-name] [install|configure|uninstall] instructions`
@@ -5,8 +5,8 @@ description: Set up babysitter for yourself. Guides you through onboarding — i
5
5
 
6
6
  # user-install
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
-
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
+
10
10
  Before using the process library, resolve the active library root through the SDK CLI. If no binding exists yet, initialize the shared global SDK binding with:
11
11
 
12
12
  ```bash
@@ -14,5 +14,5 @@ babysitter process-library:active --json
14
14
  ```
15
15
 
16
16
  Then use the `cradle/user-install` process from the active process library.
17
-
17
+
18
18
  When the run completes, end with a friendly message that includes a polite and humorous ask to star the repo on GitHub: https://github.com/a5c-ai/babysitter
@@ -5,7 +5,7 @@ description: Orchestrate a babysitter run. use this command to start babysitting
5
5
 
6
6
  # yolo
7
7
 
8
- Run the Babysitter orchestration instructions directly through the CLI, without any user interaction or breakpoints. In Claude Code, use Bash to run `babysitter instructions:babysit-skill --harness claude-code --no-interactive`; in Codex, run `babysitter instructions:babysit-skill --harness codex --no-interactive`; in other harnesses, use the same command with that harness id. Then follow the returned instructions in this same turn until completion proof is produced. Do not stop after reading the instructions, do not invoke the Skill tool first, and use the non-interactive/no-breakpoints path when the instructions offer a mode choice.
8
+ Run the Babysitter orchestration instructions directly through the CLI, without any user interaction or breakpoints. Use Bash to run `babysitter instructions:babysit-skill --harness codex --no-interactive`, then follow the returned instructions in this same turn until completion proof is produced. Do not stop after reading the instructions, do not invoke the Skill tool first, and use the non-interactive/no-breakpoints path when the instructions offer a mode choice.
9
9
 
10
10
  User arguments for this command:
11
11