strikethroo 3.22.0 → 3.22.1

package/templates/harness/skills/st-execute-blueprint/scripts/find-strikethroo-root.cjs

@@ -1,116 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/skill-scripts/find-strikethroo-root.ts
-var find_strikethroo_root_exports = {};
-__export(find_strikethroo_root_exports, {
-  main: () => main
-});
-module.exports = __toCommonJS(find_strikethroo_root_exports);
-
-// src/skill-scripts/shared/root.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 4 : 4;
-var isValidStrikethrooRoot = (strikethrooPath) => {
-  try {
-    if (!fs.existsSync(strikethrooPath)) return false;
-    if (!fs.lstatSync(strikethrooPath).isDirectory()) return false;
-    const metadataPath = path.join(strikethrooPath, ".init-metadata.json");
-    if (!fs.existsSync(metadataPath)) return false;
-    const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-    return metadata && typeof metadata === "object" && "version" in metadata;
-  } catch (_err) {
-    return false;
-  }
-};
-var getStrikethrooAt = (directory) => {
-  const strikethrooPath = path.join(directory, ".ai", "strikethroo");
-  return isValidStrikethrooRoot(strikethrooPath) ? strikethrooPath : null;
-};
-var getParentPaths = (currentPath, acc = []) => {
-  const absolutePath = path.resolve(currentPath);
-  const nextAcc = [...acc, absolutePath];
-  const parentPath = path.dirname(absolutePath);
-  if (parentPath === absolutePath) return nextAcc;
-  return getParentPaths(parentPath, nextAcc);
-};
-var checkWorkspaceSchema = (metadataPath) => {
-  let metadata;
-  try {
-    metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-  } catch {
-    return;
-  }
-  const actual = typeof metadata.workspaceSchemaVersion === "number" ? metadata.workspaceSchemaVersion : 1;
-  if (actual === EXPECTED_SCHEMA) return;
-  if (actual < EXPECTED_SCHEMA) {
-    process.stderr.write(
-      `Workspace schema v${actual} is older than this skill requires (v${EXPECTED_SCHEMA}). Re-run \`npx strikethroo init\` with the latest CLI to update.
-`
-    );
-  } else {
-    process.stderr.write(
-      `This skill (built for workspace schema v${EXPECTED_SCHEMA}) is older than the workspace (v${actual}). Re-run \`npx skills add e0ipso/strikethroo\` to update skills.
-`
-    );
-  }
-  process.exit(1);
-};
-var findStrikethrooRoot = (startPath = process.cwd()) => {
-  const paths = getParentPaths(startPath);
-  const found = paths.find((p) => getStrikethrooAt(p));
-  if (!found) return null;
-  const root = getStrikethrooAt(found);
-  if (root) checkWorkspaceSchema(path.join(root, ".init-metadata.json"));
-  return root;
-};
-
-// src/skill-scripts/find-strikethroo-root.ts
-var main = () => {
-  const startPath = process.argv[2] || process.cwd();
-  const root = findStrikethrooRoot(startPath);
-  if (!root) {
-    process.stderr.write(
-      `Could not find .ai/strikethroo root from ${startPath} or any parent directory.
-`
-    );
-    process.exit(1);
-  }
-  process.stdout.write(`${root}
-`);
-  process.exit(0);
-};
-if (require.main === module) {
-  main();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  main
-});

package/templates/harness/skills/st-execute-blueprint/scripts/validate-plan-blueprint.cjs

@@ -1,429 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/skill-scripts/validate-plan-blueprint.ts
-var validate_plan_blueprint_exports = {};
-__export(validate_plan_blueprint_exports, {
-  main: () => main
-});
-module.exports = __toCommonJS(validate_plan_blueprint_exports);
-
-// src/skill-scripts/shared/root.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 4 : 4;
-var isValidStrikethrooRoot = (strikethrooPath) => {
-  try {
-    if (!fs.existsSync(strikethrooPath)) return false;
-    if (!fs.lstatSync(strikethrooPath).isDirectory()) return false;
-    const metadataPath = path.join(strikethrooPath, ".init-metadata.json");
-    if (!fs.existsSync(metadataPath)) return false;
-    const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-    return metadata && typeof metadata === "object" && "version" in metadata;
-  } catch (_err) {
-    return false;
-  }
-};
-var getStrikethrooAt = (directory) => {
-  const strikethrooPath = path.join(directory, ".ai", "strikethroo");
-  return isValidStrikethrooRoot(strikethrooPath) ? strikethrooPath : null;
-};
-var getParentPaths = (currentPath, acc = []) => {
-  const absolutePath = path.resolve(currentPath);
-  const nextAcc = [...acc, absolutePath];
-  const parentPath = path.dirname(absolutePath);
-  if (parentPath === absolutePath) return nextAcc;
-  return getParentPaths(parentPath, nextAcc);
-};
-var checkWorkspaceSchema = (metadataPath) => {
-  let metadata;
-  try {
-    metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-  } catch {
-    return;
-  }
-  const actual = typeof metadata.workspaceSchemaVersion === "number" ? metadata.workspaceSchemaVersion : 1;
-  if (actual === EXPECTED_SCHEMA) return;
-  if (actual < EXPECTED_SCHEMA) {
-    process.stderr.write(
-      `Workspace schema v${actual} is older than this skill requires (v${EXPECTED_SCHEMA}). Re-run \`npx strikethroo init\` with the latest CLI to update.
-`
-    );
-  } else {
-    process.stderr.write(
-      `This skill (built for workspace schema v${EXPECTED_SCHEMA}) is older than the workspace (v${actual}). Re-run \`npx skills add e0ipso/strikethroo\` to update skills.
-`
-    );
-  }
-  process.exit(1);
-};
-var findStrikethrooRoot = (startPath = process.cwd()) => {
-  const paths = getParentPaths(startPath);
-  const found = paths.find((p) => getStrikethrooAt(p));
-  if (!found) return null;
-  const root = getStrikethrooAt(found);
-  if (root) checkWorkspaceSchema(path.join(root, ".init-metadata.json"));
-  return root;
-};
-
-// src/skill-scripts/shared/plan-scan.ts
-var fs2 = __toESM(require("fs"));
-var path2 = __toESM(require("path"));
-
-// src/skill-scripts/shared/frontmatter.ts
-var ID_PATTERNS = [
-  /^\s*["']?id["']?\s*:\s*["']?([+-]?\d+)["']?\s*(?:#.*)?$/im,
-  /^\s*id\s*:\s*([+-]?\d+)\s*(?:#.*)?$/im,
-  /^\s*["']?id["']?\s*:\s*"([+-]?\d+)"\s*(?:#.*)?$/im,
-  /^\s*["']?id["']?\s*:\s*'([+-]?\d+)'\s*(?:#.*)?$/im,
-  /^\s*["']id["']\s*:\s*([+-]?\d+)\s*(?:#.*)?$/im,
-  /^\s*id\s*:\s*[|>]\s*([+-]?\d+)\s*$/im
-];
-var validateId = (rawId) => {
-  const id = parseInt(rawId, 10);
-  if (Number.isNaN(id) || id < 0 || id > Number.MAX_SAFE_INTEGER) return null;
-  return id;
-};
-var extractIdFromMarkdown = (content) => {
-  const frontmatterMatch = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
-  if (!frontmatterMatch || !frontmatterMatch[1]) return null;
-  const block = frontmatterMatch[1];
-  for (const pattern of ID_PATTERNS) {
-    const match = block.match(pattern);
-    if (match && match[1]) {
-      const id = validateId(match[1]);
-      if (id !== null) return id;
-    }
-  }
-  return null;
-};
-var extractPlanId = (content, _filePath) => {
-  return extractIdFromMarkdown(content);
-};
-
-// src/skill-scripts/shared/plan-scan.ts
-var PLAN_EXTENSIONS = [".md"];
-var scanPlanDir = (planDirPath, dirName, isArchive) => {
-  let entries;
-  try {
-    entries = fs2.readdirSync(planDirPath, { withFileTypes: true });
-  } catch (_err) {
-    return [];
-  }
-  return entries.filter((e) => e.isFile() && PLAN_EXTENSIONS.some((ext) => e.name.endsWith(ext))).flatMap((e) => {
-    const filePath = path2.join(planDirPath, e.name);
-    try {
-      const content = fs2.readFileSync(filePath, "utf8");
-      const id = extractPlanId(content, filePath);
-      if (id === null) return [];
-      return [{ id, file: filePath, dir: planDirPath, isArchive, name: dirName }];
-    } catch (_err) {
-      return [];
-    }
-  });
-};
-var getAllPlans = (taskManagerRoot) => {
-  const sources = [
-    { dir: path2.join(taskManagerRoot, "plans"), isArchive: false },
-    { dir: path2.join(taskManagerRoot, "archive"), isArchive: true }
-  ];
-  return sources.flatMap(({ dir, isArchive }) => {
-    if (!fs2.existsSync(dir)) return [];
-    let entries;
-    try {
-      entries = fs2.readdirSync(dir, { withFileTypes: true });
-    } catch (_err) {
-      return [];
-    }
-    return entries.filter((e) => e.isDirectory()).flatMap((e) => scanPlanDir(path2.join(dir, e.name), e.name, isArchive));
-  });
-};
-
-// src/skill-scripts/shared/plan-resolve.ts
-var fs3 = __toESM(require("fs"));
-var path3 = __toESM(require("path"));
-var isValidRootDir = (strikethrooPath) => {
-  try {
-    if (!fs3.existsSync(strikethrooPath)) return false;
-    if (!fs3.lstatSync(strikethrooPath).isDirectory()) return false;
-    const metadataPath = path3.join(strikethrooPath, ".init-metadata.json");
-    if (!fs3.existsSync(metadataPath)) return false;
-    const metadata = JSON.parse(fs3.readFileSync(metadataPath, "utf8"));
-    return metadata && typeof metadata === "object" && "version" in metadata;
-  } catch (_err) {
-    return false;
-  }
-};
-var checkStandardRootShortcut = (filePath) => {
-  const planDir = path3.dirname(filePath);
-  const parentDir = path3.dirname(planDir);
-  const possibleRoot = path3.dirname(parentDir);
-  const parentBase = path3.basename(parentDir);
-  if (parentBase !== "plans" && parentBase !== "archive") return null;
-  if (path3.basename(possibleRoot) !== "strikethroo") return null;
-  const dotAiDir = path3.dirname(possibleRoot);
-  if (path3.basename(dotAiDir) !== ".ai") return null;
-  return isValidRootDir(possibleRoot) ? possibleRoot : null;
-};
-var resolveByPath = (absolutePath) => {
-  let content;
-  try {
-    content = fs3.readFileSync(absolutePath, "utf8");
-  } catch (_err) {
-    return null;
-  }
-  const planId = extractPlanId(content, absolutePath);
-  if (planId === null) return null;
-  const tmRoot = checkStandardRootShortcut(absolutePath) || findStrikethrooRoot(path3.dirname(absolutePath));
-  if (!tmRoot) return null;
-  return {
-    planFile: absolutePath,
-    planDir: path3.dirname(absolutePath),
-    strikethrooRoot: tmRoot,
-    planId
-  };
-};
-var resolveByIdInAncestry = (planId, startPath, searched = /* @__PURE__ */ new Set()) => {
-  const tmRoot = findStrikethrooRoot(startPath);
-  if (!tmRoot) return null;
-  const normalized = path3.normalize(tmRoot);
-  if (searched.has(normalized)) return null;
-  searched.add(normalized);
-  const plans = getAllPlans(tmRoot);
-  const match = plans.find((p) => p.id === planId);
-  if (match) {
-    return {
-      planFile: match.file,
-      planDir: match.dir,
-      strikethrooRoot: tmRoot,
-      planId
-    };
-  }
-  const parentOfRoot = path3.dirname(path3.dirname(tmRoot));
-  if (parentOfRoot === tmRoot) return null;
-  return resolveByIdInAncestry(planId, parentOfRoot, searched);
-};
-var resolvePlan = (input, startPath = process.cwd()) => {
-  if (input === null || input === void 0 || input === "") return null;
-  const inputStr = String(input);
-  if (inputStr.startsWith("/")) {
-    return resolveByPath(inputStr);
-  }
-  const planId = parseInt(inputStr, 10);
-  if (Number.isNaN(planId)) return null;
-  return resolveByIdInAncestry(planId, startPath);
-};
-
-// src/skill-scripts/shared/blueprint-detection.ts
-var fs4 = __toESM(require("fs"));
-var hasExecutionBlueprint = (planFile) => {
-  try {
-    const content = fs4.readFileSync(planFile, "utf8");
-    return /^## Execution Blueprint/m.test(content);
-  } catch (_err) {
-    return false;
-  }
-};
-
-// src/skill-scripts/shared/task-count.ts
-var fs5 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
-var countTaskFiles = (planDir) => {
-  const tasksDir = path4.join(planDir, "tasks");
-  if (!fs5.existsSync(tasksDir)) return 0;
-  try {
-    const stat = fs5.lstatSync(tasksDir);
-    if (!stat.isDirectory()) return 0;
-    return fs5.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
-  } catch (_err) {
-    return 0;
-  }
-};
-
-// src/skill-scripts/shared/task-complexity.ts
-var fs6 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
-
-// src/skill-scripts/shared/complexity-score.ts
-var validateComplexityScore = (value) => {
-  const trimmed = value.trim();
-  if (!/^\d+$/.test(trimmed)) {
-    return { valid: false, reason: "non-integer" };
-  }
-  const parsed = Number.parseInt(trimmed, 10);
-  if (parsed < 1 || parsed > 10) {
-    return { valid: false, reason: "out-of-range", value: parsed };
-  }
-  return { valid: true, value: parsed };
-};
-
-// src/skill-scripts/shared/task-file.ts
-var extractFrontmatter = (content) => {
-  const match = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
-  return match && match[1] ? match[1] : null;
-};
-
-// src/skill-scripts/shared/task-complexity.ts
-var validateTaskComplexityScores = (planDir) => {
-  const tasksDir = path5.join(planDir, "tasks");
-  if (!fs6.existsSync(tasksDir)) return [];
-  let files;
-  try {
-    if (!fs6.lstatSync(tasksDir).isDirectory()) return [];
-    files = fs6.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).sort();
-  } catch (_err) {
-    return [];
-  }
-  const invalid = [];
-  for (const file of files) {
-    let content;
-    try {
-      content = fs6.readFileSync(path5.join(tasksDir, file), "utf8");
-    } catch (_err) {
-      invalid.push(`${file}: unreadable`);
-      continue;
-    }
-    const frontmatter = extractFrontmatter(content);
-    const match = frontmatter ? frontmatter.match(/^\s*complexity_score\s*:\s*(.*?)\s*(?:#.*)?$/im) : null;
-    if (!match || match[1] === void 0) {
-      invalid.push(`${file}: missing complexity_score`);
-      continue;
-    }
-    const raw = match[1].trim();
-    const result = validateComplexityScore(raw);
-    if (result.valid) continue;
-    if (result.reason === "non-integer") {
-      invalid.push(`${file}: non-integer complexity_score "${raw}"`);
-      continue;
-    }
-    invalid.push(`${file}: complexity_score ${result.value} out of range 1-10`);
-  }
-  return invalid;
-};
-
-// src/skill-scripts/validate-plan-blueprint.ts
-var VALID_FIELDS = [
-  "planFile",
-  "planDir",
-  "taskCount",
-  "blueprintExists",
-  "strikethrooRoot",
-  "planId",
-  "complexityScoresValid",
-  "invalidComplexityTasks"
-];
-var usage = () => {
-  const lines = [
-    "Plan ID or absolute path is required",
-    "",
-    "Usage: node validate-plan-blueprint.cjs <plan-id-or-path> [field-name]",
-    "",
-    "Examples:",
-    "  node validate-plan-blueprint.cjs 47",
-    "  node validate-plan-blueprint.cjs /path/to/plan.md",
-    "  node validate-plan-blueprint.cjs 47 planFile",
-    "  node validate-plan-blueprint.cjs 47 blueprintExists"
-  ];
-  lines.forEach((l) => process.stderr.write(`[ERROR] ${l}
-`));
-};
-var listAvailablePlans = (startPath) => {
-  const tmRoot = findStrikethrooRoot(startPath);
-  if (!tmRoot) return [];
-  const plans = getAllPlans(tmRoot);
-  return plans.map((p) => p.name).sort((a, b) => {
-    const aMatch = a.match(/^(\d+)--/);
-    const bMatch = b.match(/^(\d+)--/);
-    if (!aMatch || !bMatch || !aMatch[1] || !bMatch[1]) return 0;
-    return parseInt(aMatch[1], 10) - parseInt(bMatch[1], 10);
-  });
-};
-var main = () => {
-  const inputId = process.argv[2];
-  const fieldName = process.argv[3];
-  if (!inputId) {
-    usage();
-    process.exit(1);
-  }
-  const numericInput = parseInt(inputId, 10);
-  const isNumeric = !Number.isNaN(numericInput);
-  const isAbsolutePath = inputId.startsWith("/");
-  if (!isNumeric && !isAbsolutePath) {
-    process.stderr.write(`[ERROR] Invalid plan ID: "${inputId}" is not a valid number
-`);
-    process.exit(1);
-  }
-  const resolved = resolvePlan(inputId);
-  if (!resolved) {
-    process.stderr.write(`[ERROR] Plan ID ${inputId} not found or invalid
-`);
-    process.stderr.write("[ERROR] \n");
-    const available = listAvailablePlans(process.cwd());
-    if (available.length > 0) {
-      process.stderr.write("[ERROR] Available plans:\n");
-      available.forEach((name) => process.stderr.write(`[ERROR]   ${name}
-`));
-    }
-    process.exit(1);
-  }
-  const invalidComplexity = validateTaskComplexityScores(resolved.planDir);
-  const result = {
-    planFile: resolved.planFile,
-    planDir: resolved.planDir,
-    strikethrooRoot: resolved.strikethrooRoot,
-    planId: resolved.planId,
-    taskCount: countTaskFiles(resolved.planDir),
-    blueprintExists: hasExecutionBlueprint(resolved.planFile) ? "yes" : "no",
-    complexityScoresValid: invalidComplexity.length === 0 ? "yes" : "no",
-    invalidComplexityTasks: invalidComplexity.join("; ")
-  };
-  if (fieldName) {
-    if (!VALID_FIELDS.includes(fieldName)) {
-      process.stderr.write(`[ERROR] Invalid field name: ${fieldName}
-`);
-      process.stderr.write(`[ERROR] Valid fields: ${VALID_FIELDS.join(", ")}
-`);
-      process.exit(1);
-    }
-    const value = result[fieldName];
-    process.stdout.write(`${String(value)}
-`);
-  } else {
-    process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
-  }
-  process.exit(0);
-};
-if (require.main === module) {
-  main();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  main
-});

package/templates/harness/skills/st-execute-task/SKILL.md

@@ -1,154 +0,0 @@
----
-name: st-execute-task
-description: Use when the user asks to run, execute, or implement one specific task ID within a Strikethroo plan in this repository — triggers include execute task, run task, implement task, do task N. Do not use to execute a whole plan or blueprint, to generate tasks, or for generic development outside Strikethroo.
----
-
-# st-execute-task
-
-## Critical Rules
-
-1. **Maintain status integrity** — update task status throughout the execution lifecycle.
-2. **Document execution** — record all outcomes and issues encountered.
-
-## Inputs
-
-The user supplies the numeric plan ID and task ID conversationally.
-
-## Operating Procedure
-
-### 1. Locate the strikethroo root
-
-Run `scripts/find-strikethroo-root.cjs` from the user's working directory. If
-it exits non-zero, stop and ask the user to run `npx strikethroo init`.
-
-Treat the path it prints as `<root>` for every subsequent step.
-
-Delegated execution workers skip this step and do not emit update notices.
-
-Run `scripts/check-for-updates.cjs "<root>"` as a separate command using this
-skill's script path. Keep the user's working directory. Read the one JSON line
-on stdout. When `notice` is present, retain its exact text for the final
-user-facing response. Never pause for permission and never run an update.
-
-### 2. Resolve the plan
-
-Run `scripts/validate-plan-blueprint.cjs <plan-id> planFile` for the plan
-file's absolute path. Another field name prints that field instead.
-
-If the script exits non-zero, stop and ask the user to confirm the plan ID.
-Do not guess a different ID.
-
-Run `scripts/validate-plan-blueprint.cjs <plan-id> planDir` and treat the
-printed path as `<plan-dir>`.
-
-### 3. Validate the task file
-
-Look for `<plan-dir>/tasks/<task-id>--*.md`, then for the zero-padded
-`<plan-dir>/tasks/0<task-id>--*.md`. If neither matches, list the files in
-`<plan-dir>/tasks/` and stop. Treat the match as `<task-file>`.
-
-### 4. Check task status
-
-Read `status` from the `<task-file>` frontmatter.
-
-- `completed`, `in-progress`, or `needs-clarification`: stop, and name the way
-  out (re-execute a completed task through execute-blueprint, answer the open
-  clarification questions first).
-- `pending` or `failed`: execute.
-- Missing or unrecognized: proceed with caution and note the ambiguity.
-
-### 5. Validate dependencies
-
-Run `scripts/check-task-dependencies.cjs <plan-id> <task-id>`. If it exits 1,
-stop and report that unresolved dependencies block the task. Do not proceed
-until they are satisfied.
-
-### 6. Agent selection
-
-Read `<root>/config/hooks/PRE_TASK_ASSIGNMENT.md` and follow its instructions
-for selecting the appropriate agent or skill set for this task.
-
-### 7. Update status to in-progress
-
-Rewrite the YAML frontmatter of `<task-file>`, setting `status: "in-progress"`.
-Preserve all other frontmatter fields exactly.
-
-### 8. Execute the task
-
-Resolve the route before deploying any agent; resolution launches no task
-work:
-
-```text
-scripts/dispatch-task-execution.cjs resolve <task-file> <current-harness> <workspace> <plan-id> <task-id>
-```
-
-External execution uses:
-
-```text
-scripts/dispatch-task-execution.cjs execute <handoff> <task-file> <current-harness> <workspace> <plan-id> <task-id>
-```
-
-`<current-harness>` is the exact supported harness identifier running this
-skill; `<workspace>` is the project working directory.
-
-Interpret the one-line JSON result and act on its `kind` exactly once:
-
-| `kind` | Required action |
-| --- | --- |
-| `native-default` | Dispatch natively with no execution-setting prose. |
-| `native-override` | Dispatch natively, explicitly requiring the exact returned `model`. Require the returned `reasoningEffort` only when that property is present. |
-| `external-override` | Run the `execute` command with the returned `handoff`, then read its result against this same table. |
-| `fallback` | Nothing launched. Record the returned `reason` and `detail` visibly, then dispatch natively with no execution-setting prose. |
-| `launched-success` | The external process exited zero. Do not dispatch natively; review status and evidence as you would for a native agent. |
-| `launched-failure` | A failed task. Set its status to `failed` and run `<root>/config/hooks/POST_ERROR_DETECTION.md`. Never retry it natively. |
-| `infrastructure-failure` | Handle exactly as the preceding row. |
-
-Handoff rules:
-
-- Pass the exact opaque `handoff` string the resolver returned for that task. Never reconstruct one.
-- Never reuse a handoff for another task, and never rerun resolution after launches begin.
-
-Steps 9–11 are this skill's failed-status and error-hook path.
-
-For a native dispatch, deploy an agent using your internal Task tool. The agent
-must read and execute `<root>/config/hooks/PRE_TASK_EXECUTION.md` before any
-implementation work, then read the complete `<task-file>` and implement it.
-Do not run `scripts/check-for-updates.cjs`; delegated workers do not consume update notices.
-
-### 9. Update status to completed or failed
-
-After the agent finishes, rewrite the YAML frontmatter of `<task-file>` based
-on the outcome:
-
-- Set `status: "completed"` if the task was implemented successfully and
-  all acceptance criteria are met.
-- Set `status: "failed"` if the task could not be completed, acceptance
-  criteria were not met, or an unrecoverable error occurred.
-
-Preserve all other frontmatter fields exactly.
-
-### 10. Document noteworthy events
-
-If anything significant occurred during execution — decisions made, issues
-encountered, deviations from the plan, or follow-up actions required —
-append a "Noteworthy Events" section to the end of `<task-file>`:
-
-```markdown
-## Noteworthy Events
-- [YYYY-MM-DD] [Event description with sufficient context for the orchestrator]
-```
-
-### 11. Error handling
-
-If any error occurred during execution, read
-`<root>/config/hooks/POST_ERROR_DETECTION.md` and execute its instructions.
-Document the error in Noteworthy Events and ensure the task status is set to
-`failed` if it is not already.
-
-When the retained update `notice` is present, append that exact sentence after
-the structured summary block, or after your final response when this skill emits
-no summary block. Nothing may follow the notice.
-
-## Failure Modes
-
-- **Execution errors.** If a task fails, read `<root>/config/hooks/POST_ERROR_DETECTION.md`, document the error in Noteworthy Events, and ensure the task status is set to `failed`.