strikethroo 3.22.0 → 3.23.0

package/templates/harness/skills/st-code-review/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-code-review/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-create-plan/SKILL.md

@@ -1,111 +0,0 @@
----
-name: st-create-plan
-description: Use when the user asks to draft, scope, or write up a new Strikethroo plan for a work order, feature, or initiative in this repository — triggers include create plan, new plan, plan this, scope a plan, strikethroo plan. Do not use to decompose an existing plan into tasks, to execute a plan, or for generic brainstorming outside Strikethroo.
----
-
-# st-create-plan
-
-## Inputs
-
-The user's request supplies the work order.
-
-## 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. Load project context
-
-Read `<root>/config/STRIKETHROO.md` for this project's directory conventions.
-Read `<root>/config/hooks/PRE_PLAN.md` and execute its instructions before
-proceeding. Read `<root>/config/templates/PLAN_TEMPLATE.md`; the plan must
-conform to it.
-
-Also read `<root>/config/shared/clarification-gate.md` and
-`<root>/config/shared/anti-rationalization.md`.
-
-### 3. Analyze the work order
-
-Identify:
-
-- Objective.
-- Scope and explicit boundaries.
-- Success criteria.
-- Dependencies, prerequisites, blockers.
-- Technical requirements and constraints.
-
-### 4. Clarification loop
-
-If any critical context is missing, ask the user targeted questions. Keep
-looping until you have no further questions. Explicitly confirm whether
-backwards compatibility is required. Never invent answers; never paper over
-a missing answer.
-
-If the user declines to clarify a blocking question, stop and report the
-plan as needing clarification. Do not produce a partial plan.
-
-Follow the clarification cadence in `<root>/config/shared/clarification-gate.md`.
-
-Apply `<root>/config/shared/anti-rationalization.md` to this rationalization table:
-
-| You catch yourself thinking… | The binding rule |
-| --- | --- |
-| "I can reasonably assume the answer." | An assumption is not an answer. Ask the question; never invent answers. |
-| "Asking again is annoying." | A question the user can decline is recoverable; a silent wrong assumption is not. Ask. |
-| "The user implied it, so it's settled." | An implication is not a confirmation. Surface it as a question and get an explicit answer. |
-
-### 5. Allocate the next plan ID
-
-Run `scripts/get-next-plan-id.cjs` for the next available plan ID. Compute its
-zero-padded form for the directory name (`{padded-id}--{slug}`) and use the
-unpadded integer in the plan frontmatter.
-
-### 6. Emit the plan
-
-Write the plan to
-`<root>/plans/{padded-id}--{slug}/plan-{padded-id}--{slug}.md`, conforming to
-`<root>/config/templates/PLAN_TEMPLATE.md` in both frontmatter and sections.
-Include no time estimates, task lists, or code samples; those belong to the
-task-generation step.
-
-Derive `<slug>` from the plan summary: lowercase, alphanumeric and hyphens
-only, collapsed, trimmed.
-
-### 7. Run post-plan hook
-
-Execute `<root>/config/hooks/POST_PLAN.md`.
-
-### 8. Emit the structured summary
-
-Conclude with exactly this block (a retained update notice, when present, follows separately):
-
-```
----
-
-Plan Summary:
-- Plan ID: [numeric-id]
-- Plan File: [absolute-path-to-plan-file]
-```
-
-The summary is consumed by downstream automation; keep the format exact.
-
-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
-
-- **Plan directory already exists for the allocated ID.** Re-run the
-  next-plan-id script and retry once. If the conflict persists, stop and
-  report.