@jaybeeuu/agent-cortex 1.20.0

package/skills/planning/create-task/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: create-task
+description: Create a bead, classify it, and if AFK expand it into pipeline stage child beads plus a HITL PR gate task. Use when creating a new task that should be tracked and moved through implementation and human review gates.
+---
+
+# Create Task
+
+Create a bead, classify it via `classify-bead`, and — if AFK — expand it into child chore beads for each pipeline stage plus a child HITL PR gate task bead.
+
+## Inputs
+
+| Parameter   | Required | Description                          |
+|-------------|----------|--------------------------------------|
+| title       | yes      | Task title                           |
+| description | yes      | Task description                     |
+| priority    | no       | 0–3 (default 2)                      |
+| parent      | no       | Parent bead ID for `parent-child` dep |
+
+## Procedure
+
+### 1. Create the bead
+
+```bash
+bd create "<title>" --description "<description>" --priority <priority>
+```
+
+If a `parent` was provided, add a `parent-child` dependency:
+
+```bash
+bd dep add <new-id> <parent> --type parent-child
+```
+
+Record the new bead ID.
+
+### 2. Classify the bead
+
+Invoke the `classify-bead` skill on the new bead (as a subagent per that skill's invocation instructions). It returns `AFK` or `HITL`.
+
+### 3. Branch on classification
+
+**If HITL**: stop. Report the bead ID and classification to the caller. No further action.
+
+**If AFK**: continue to step 4.
+
+### 4. Expand into pipeline stage chores
+
+Run the `create-chores` script, which reads `pipeline.json` and deterministically creates all
+stage chores in one shot. They are plain (non-ephemeral) chores — `bd ready` must surface
+them without `--include-ephemeral` for ralph to discover them:
+
+```bash
+# Run from the TARGET project's directory (cwd must be inside the target's
+# .beads tree) — bd resolves its beads DB from cwd, not from the skill's
+# location. Do NOT use `pnpm --prefix <scripts> exec`, which changes cwd to
+# the scripts dir and makes bd pick the skill repo's own .beads instead of
+# the target project's.
+<skill-scripts>/node_modules/.bin/tsx \
+  <skill-scripts>/create-chores.ts \
+  --parent <parent-id> \
+  --priority <priority>
+```
+
+Where `<skill-scripts>` is the absolute path to this skill's own `scripts/` directory —
+resolve it from wherever this skill was actually loaded from (it varies by harness and
+install location; e.g. a Claude Code plugin cache dir vs. a Copilot
+`~/.copilot/installed-plugins/...` install vs. a local dev checkout). Do not hardcode
+one harness's path.
+
+The script outputs a JSON object mapping stage IDs to chore bead IDs, plus a HITL PR gate task bead ID, e.g.:
+
+```json
+{
+  "code": "abc123",
+  "verify": "def456",
+  "review": "ghi789",
+  "document": "jkl012",
+  "featurePrReview": "bd-mno345"
+}
+```
+
+Each stage chore is created with:
+- **type**: `chore`
+- **Title pattern**: `[<parent-id>] <stage title>` (e.g. `[abc-123] Code`)
+- **Labels**: `stage:<id>` (e.g. `stage:code`, `stage:verify`)
+- **Dependencies**: `parent-child` to parent bead; `blocks` between stages per `dependsOn`
+
+The PR gate bead is created with:
+- **type**: `task`
+- **Title**: `[<parent-id>] PR Review and Merge`
+- **Labels**: `implementation-type:hitl`, `lifecycle:feature-pr`
+- **Dependencies**: `parent-child` to parent bead; `blocks` on the final document stage chore
+ - **Purpose**: human review of the agent PR (agent-branch → feature branch)
+
+### 5. Report
+
+Return the parent bead ID, classification (`AFK`), and the list of created child bead IDs (including `featurePrReview`).

package/skills/planning/create-task/pipeline.json

@@ -0,0 +1,33 @@
+{
+  "maxFixRounds": 4,
+  "stages": [
+    {
+      "id": "code",
+      "title": "Code",
+      "description": "Implement the task using a test-driven approach.",
+      "template": "templates/code.md",
+      "dependsOn": []
+    },
+    {
+      "id": "verify",
+      "title": "Verify",
+      "description": "Run the project's test and lint commands and report the outcome.",
+      "template": "templates/verify.md",
+      "dependsOn": ["code"]
+    },
+    {
+      "id": "review",
+      "title": "Review",
+      "description": "Review the implementation for security, correctness, and alignment with task requirements.",
+      "template": "templates/review.md",
+      "dependsOn": ["verify"]
+    },
+    {
+      "id": "document",
+      "title": "Document",
+      "description": "Review changes and update documentation if key decisions, behaviour changes, or constraints were introduced.",
+      "template": "templates/document.md",
+      "dependsOn": ["review"]
+    }
+  ]
+}

package/skills/planning/create-task/scripts/create-chores.ts

@@ -0,0 +1,112 @@
+import { execSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+interface Stage {
+  id: string;
+  title: string;
+  description: string;
+  template: string;
+  dependsOn: string[];
+}
+
+interface Pipeline {
+  maxFixRounds: number;
+  stages: Stage[];
+}
+
+// ─── Args ─────────────────────────────────────────────────────────────────────
+
+function parseArgs(args: string[]): { parentId: string; priority: string } {
+  let parentId: string | undefined;
+  let priority = '2';
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--parent' && args[i + 1]) { parentId = args[++i]; }
+    else if (args[i] === '--priority' && args[i + 1]) { priority = args[++i]; }
+  }
+
+  if (!parentId) {
+    console.error('Usage: create-chores.ts --parent <bead-id> [--priority <0-4>]');
+    process.exit(1);
+  }
+
+  return { parentId, priority };
+}
+
+// ─── Exec ─────────────────────────────────────────────────────────────────────
+
+function run(args: string[]): string {
+  return execSync(args.join(' '), { encoding: 'utf-8' }).trim();
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const { parentId, priority } = parseArgs(process.argv.slice(2));
+
+const pipelinePath = resolve(__dirname, '..', 'pipeline.json');
+const pipeline: Pipeline = JSON.parse(readFileSync(pipelinePath, 'utf-8'));
+
+const stageToBeadId = new Map<string, string>();
+
+for (const stage of pipeline.stages) {
+  const title = `[${parentId}] ${stage.title}`;
+
+  const beadId = run([
+    'bd', 'create', JSON.stringify(title),
+    '--type', 'chore',
+    '--description', JSON.stringify(stage.description),
+    '--priority', priority,
+    '--labels', `stage:${stage.id}`,
+    '--parent', parentId,
+    '--silent',
+  ]);
+
+  stageToBeadId.set(stage.id, beadId);
+
+  for (const depStageId of stage.dependsOn) {
+    const depBeadId = stageToBeadId.get(depStageId);
+    if (!depBeadId) {
+      console.error(`Stage '${stage.id}' depends on '${depStageId}', but it has not been created yet. Check dependsOn ordering in pipeline.json.`);
+      process.exit(1);
+    }
+    run(['bd', 'dep', 'add', beadId, depBeadId, '--type', 'blocks']);
+  }
+}
+
+const finalStageId = pipeline.stages.at(-1)?.id;
+if (!finalStageId) {
+  console.error('No pipeline stages found in pipeline.json.');
+  process.exit(1);
+}
+
+const documentStageBeadId = stageToBeadId.get('document') ?? stageToBeadId.get(finalStageId);
+if (!documentStageBeadId) {
+  console.error('Could not resolve the final stage bead needed for PR gate dependency.');
+  process.exit(1);
+}
+
+const prGateBeadId = run([
+  'bd', 'create', JSON.stringify(`[${parentId}] PR Review and Merge`),
+  '--type', 'task',
+  '--description', JSON.stringify(
+    'Human review gate: review and merge the agent PR into the feature branch before closing this feature.',
+  ),
+  '--priority', priority,
+  '--labels', 'implementation-type:hitl,lifecycle:feature-pr',
+  '--parent', parentId,
+  '--silent',
+]);
+run(['bd', 'dep', 'add', prGateBeadId, documentStageBeadId, '--type', 'blocks']);
+
+const result: Record<string, string> = {
+  ...Object.fromEntries(stageToBeadId),
+  featurePrReview: prGateBeadId,
+};
+process.stdout.write(JSON.stringify(result, null, 2) + '\n');

package/skills/planning/create-task/scripts/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@agent-cortex/create-task-scripts",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/skills/planning/create-task/scripts/pnpm-lock.yaml

@@ -0,0 +1,342 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      '@types/node':
+        specifier: ^22.0.0
+        version: 22.19.18
+      tsx:
+        specifier: ^4.0.0
+        version: 4.21.0
+      typescript:
+        specifier: ^5.0.0
+        version: 5.9.3
+
+packages:
+
+  '@esbuild/aix-ppc64@0.27.7':
+    resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.27.7':
+    resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.27.7':
+    resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.27.7':
+    resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.27.7':
+    resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.27.7':
+    resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.27.7':
+    resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.27.7':
+    resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.27.7':
+    resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.27.7':
+    resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.27.7':
+    resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.27.7':
+    resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.27.7':
+    resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.27.7':
+    resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.27.7':
+    resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.27.7':
+    resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.27.7':
+    resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.27.7':
+    resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.27.7':
+    resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.27.7':
+    resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.27.7':
+    resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.27.7':
+    resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.27.7':
+    resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.27.7':
+    resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.27.7':
+    resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.27.7':
+    resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@types/node@22.19.18':
+    resolution: {integrity: sha512-9v00a+dn2yWVsYDEunWC4g/TcRKVq3r8N5FuZp7u0SGrPvdN9c2yXI9bBuf5Fl0hNCb+QTIePTn5pJs2pwBOQQ==}
+
+  esbuild@0.27.7:
+    resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  get-tsconfig@4.14.0:
+    resolution: {integrity: sha512-yTb+8DXzDREzgvYmh6s9vHsSVCHeC0G3PI5bEXNBHtmshPnO+S5O7qgLEOn0I5QvMy6kpZN8K1NKGyilLb93wA==}
+
+  resolve-pkg-maps@1.0.0:
+    resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
+  tsx@4.21.0:
+    resolution: {integrity: sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  undici-types@6.21.0:
+    resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
+
+snapshots:
+
+  '@esbuild/aix-ppc64@0.27.7':
+    optional: true
+
+  '@esbuild/android-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/android-arm@0.27.7':
+    optional: true
+
+  '@esbuild/android-x64@0.27.7':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/darwin-x64@0.27.7':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-arm@0.27.7':
+    optional: true
+
+  '@esbuild/linux-ia32@0.27.7':
+    optional: true
+
+  '@esbuild/linux-loong64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.27.7':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-s390x@0.27.7':
+    optional: true
+
+  '@esbuild/linux-x64@0.27.7':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.27.7':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.27.7':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/sunos-x64@0.27.7':
+    optional: true
+
+  '@esbuild/win32-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/win32-ia32@0.27.7':
+    optional: true
+
+  '@esbuild/win32-x64@0.27.7':
+    optional: true
+
+  '@types/node@22.19.18':
+    dependencies:
+      undici-types: 6.21.0
+
+  esbuild@0.27.7:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.27.7
+      '@esbuild/android-arm': 0.27.7
+      '@esbuild/android-arm64': 0.27.7
+      '@esbuild/android-x64': 0.27.7
+      '@esbuild/darwin-arm64': 0.27.7
+      '@esbuild/darwin-x64': 0.27.7
+      '@esbuild/freebsd-arm64': 0.27.7
+      '@esbuild/freebsd-x64': 0.27.7
+      '@esbuild/linux-arm': 0.27.7
+      '@esbuild/linux-arm64': 0.27.7
+      '@esbuild/linux-ia32': 0.27.7
+      '@esbuild/linux-loong64': 0.27.7
+      '@esbuild/linux-mips64el': 0.27.7
+      '@esbuild/linux-ppc64': 0.27.7
+      '@esbuild/linux-riscv64': 0.27.7
+      '@esbuild/linux-s390x': 0.27.7
+      '@esbuild/linux-x64': 0.27.7
+      '@esbuild/netbsd-arm64': 0.27.7
+      '@esbuild/netbsd-x64': 0.27.7
+      '@esbuild/openbsd-arm64': 0.27.7
+      '@esbuild/openbsd-x64': 0.27.7
+      '@esbuild/openharmony-arm64': 0.27.7
+      '@esbuild/sunos-x64': 0.27.7
+      '@esbuild/win32-arm64': 0.27.7
+      '@esbuild/win32-ia32': 0.27.7
+      '@esbuild/win32-x64': 0.27.7
+
+  fsevents@2.3.3:
+    optional: true
+
+  get-tsconfig@4.14.0:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
+  resolve-pkg-maps@1.0.0: {}
+
+  tsx@4.21.0:
+    dependencies:
+      esbuild: 0.27.7
+      get-tsconfig: 4.14.0
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  typescript@5.9.3: {}
+
+  undici-types@6.21.0: {}

package/skills/planning/create-task/scripts/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "strict": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "skipLibCheck": true
+  },
+  "include": ["*.ts"]
+}

package/skills/planning/create-task/templates/code.md

@@ -0,0 +1,40 @@
+## Project context
+<bd prime output — verbatim>
+
+## Task
+<bd show <id> output — verbatim>
+
+## Dependency context
+<summary of what prior completed beads delivered, if any>
+
+## Relevant files
+<list source files you read during context gathering>
+
+## Progress log
+Write progress to: `.agent-cortex/ralph/ralph-<bead-id>.log`
+Log stage start, test results, build errors, and stage complete (see Progress Logging in run-pipeline-stage skill).
+
+## Instructions
+Invoke the `style-code` skill before making any code changes.
+
+Implement the task described above using a test-driven approach:
+
+1. **Plan**: identify the discrete behaviors this task requires. List them before writing any code.
+2. **Vertical slices only** — do not write all tests first. Work one behavior at a time:
+   - Write one failing test (RED)
+   - Write the minimal code to make it pass (GREEN)
+   - Refactor if needed, keeping tests green
+   - Repeat for the next behavior
+3. **Tests must verify behavior through public interfaces** — not implementation details. A test should survive an internal refactor unchanged.
+4. **Do not add speculative code** — only what is needed to pass the current test.
+5. **Use context7** when working with any third-party library — fetch live docs to ensure you use the correct, up-to-date API for the version in this project.
+
+Make only the changes required to complete this task — do not refactor unrelated code.
+
+End your response with a ---REPORT--- block:
+---REPORT---
+BEAD_ID: <id>
+STAGE_COMPLETED: coding
+SUMMARY: <2–3 sentence summary of what was done>
+FILES_CHANGED: <comma-separated list, or "none">
+---

package/skills/planning/create-task/templates/document.md

@@ -0,0 +1,40 @@
+## Project context
+<bd prime output — verbatim>
+
+## Task completed
+<bead description — verbatim>
+
+## What was implemented
+<SUMMARY from the final coder/fixer REPORT>
+
+## Files changed
+<FILES_CHANGED from the final coder/fixer REPORT>
+
+## Progress log
+Write progress to: `.agent-cortex/ralph/ralph-<bead-id>.log`
+Log stage start and stage complete (see Progress Logging in run-pipeline-stage skill).
+
+## Instructions
+Invoke the `style-documentation` skill before making any documentation changes.
+
+Review the changes made and compare them against the existing documentation in the repository.
+
+1. Locate the project's `docs/` directory (or equivalent shared documentation space).
+2. Read any existing docs relevant to the changes made.
+3. Identify only the following worth documenting:
+   - A key decision was made (why this approach over another)
+   - Behaviour changed at a macro level (what the system now does that it didn't before)
+   - A constraint or trade-off exists that a future engineer needs to know
+4. If any of the above apply: update the most relevant existing doc. Only create a new file
+   (`docs/decisions/<topic>.md`) if no suitable home exists.
+5. If none of the above apply: do nothing. Leaving docs unchanged is the correct outcome
+   when no decisions or macro behaviour changed.
+6. Do not modify source code — documentation only.
+
+End your response with a ---REPORT--- block:
+---REPORT---
+BEAD_ID: <id>
+STAGE_COMPLETED: documenting
+SUMMARY: <2–3 sentence summary of what was documented, or "No documentation changes required">
+FILES_CHANGED: <comma-separated list of docs touched, or "none">
+---