gitifact 0.8.6 → 0.9.0

package/dist/main.js

@@ -3381,7 +3381,7 @@ var program = new Command();
 import { createServer } from "node:http";
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { fileURLToPath } from "node:url";
-import { readFile as readFile8 } from "node:fs/promises";
+import { readFile as readFile6 } from "node:fs/promises";
 
 // ../../packages/core/dist/domain/repository-status.js
 function summarizeChanges(changes2) {
@@ -3510,9 +3510,8 @@ var messages_default = {
   "doc.DESIGN_OVERVIEW_REQUIRED": "\uC124\uACC4\uAC00 \uC788\uB294 \uAE30\uB2A5\uC5D0\uB294 design/overview.md\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: {feature}",
   "doc.FILE_TOO_LARGE": "\uBB38\uC11C \uD30C\uC77C\uC774 1MB\uB97C \uB118\uC5B4 \uC77D\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4: {path}",
   "doc.DOC_DRAFT": "new \uBA85\uB839\uC774 \uB9CC\uB4E0 \uCD08\uC548 \uD45C\uC2DC\uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4. \uBCF8\uBB38\uC744 \uB2E4 \uC4F4 \uB4A4 draft: true \uC904\uC744 \uC9C0\uC6B0\uC138\uC694: {path}",
-  "doc.INSTRUCTION_INDEX_REQUIRED": "\uC9C0\uCE68 \uD3F4\uB354\uC5D0 index.md\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: {path}",
-  "doc.WIKI_REMOVED": "\uC704\uD0A4\uB294 0.8.0\uC5D0\uC11C \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC73C\uB85C \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uC774 \uD398\uC774\uC9C0\uB97C .gitifact/instructions/\uB85C \uC62E\uAE30\uC138\uC694(gitifact guide show migrate): {path}",
-  "doc.INSTRUCTION_SPEC_LINK": "\uC9C0\uCE68\uC740 \uBA85\uC138\uB97C \uAC00\uB9AC\uD0A4\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC124\uACC4\uAC00 sources\uB85C \uC9C0\uCE68\uC744 \uAC00\uB9AC\uD0B5\uB2C8\uB2E4: {path}: {link}",
+  "doc.INSTRUCTION_MOVED": "0.9.0\uBD80\uD130 Gitifact\uB294 \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC744 \uAD00\uB9AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC774 \uC9C0\uCE68\uC744 \uC4F0\uB294 \uC5D0\uC774\uC804\uD2B8\uC758 \uC2A4\uD0AC \uD3F4\uB354\uB85C \uC62E\uAE30\uC138\uC694(gitifact guide show migrate): {path}",
+  "doc.WIKI_REMOVED": "\uC704\uD0A4\uB294 0.8.0\uC5D0\uC11C \uC5C6\uC5B4\uC84C\uC2B5\uB2C8\uB2E4. \uC774 \uD398\uC774\uC9C0\uB97C \uC5D0\uC774\uC804\uD2B8\uC758 \uC2A4\uD0AC \uD3F4\uB354\uB098 \uB2E4\uB978 \uBB38\uC11C\uB85C \uC62E\uAE30\uC138\uC694(gitifact guide show migrate): {path}",
   "warn.MISSING_LINK_TARGET": "\uB9C1\uD06C \uB300\uC0C1\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {path}: {link}",
   "warn.ASSET_SIZE": "\uC5D0\uC14B\uC774 \uAD8C\uC7A5 \uD06C\uAE30(1MB)\uB97C \uB118\uC2B5\uB2C8\uB2E4: {path} ({bytes}\uBC14\uC774\uD2B8)",
   "warn.ASSET_EXTENSION": "\uBE0C\uB77C\uC6B0\uC800\uAC00 \uBBF8\uB9AC \uBCF4\uC5EC \uC8FC\uC9C0 \uC54A\uB294 \uD655\uC7A5\uC790\uB77C \uB0B4\uB824\uBC1B\uAE30\uB85C\uB9CC \uC5F4\uB9BD\uB2C8\uB2E4: {path}",
@@ -3636,9 +3635,8 @@ var messages_default2 = {
   "doc.DESIGN_OVERVIEW_REQUIRED": "A feature with a design needs design/overview.md: {feature}",
   "doc.FILE_TOO_LARGE": "The document file exceeds 1 MB and was not read: {path}",
   "doc.DOC_DRAFT": "The draft mark a new command added is still there. Remove the draft: true line once the body is written: {path}",
-  "doc.INSTRUCTION_INDEX_REQUIRED": "An instruction folder needs an index.md: {path}",
-  "doc.WIKI_REMOVED": "The wiki became project instructions in 0.8.0. Move this page to .gitifact/instructions/ (gitifact guide show migrate): {path}",
-  "doc.INSTRUCTION_SPEC_LINK": "An instruction does not point at specs; designs name the instructions they follow in sources: {path}: {link}",
+  "doc.INSTRUCTION_MOVED": "Gitifact no longer keeps project instructions from 0.9.0. Move this instruction to the skills folder of the agent you use (gitifact guide show migrate): {path}",
+  "doc.WIKI_REMOVED": "The wiki went in 0.8.0. Move this page to the agent's skills folder or another document (gitifact guide show migrate): {path}",
   "warn.MISSING_LINK_TARGET": "The link target does not exist: {path}: {link}",
   "warn.ASSET_SIZE": "The asset is over the recommended size (1 MB): {path} ({bytes} bytes)",
   "warn.ASSET_EXTENSION": "The browser does not preview this extension and offers it only as a download: {path}",
@@ -3852,9 +3850,9 @@ function extractLinks(body2) {
         fence = void 0;
       continue;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       continue;
     }
     for (const m of line2.replace(/`[^`]*`/g, "").matchAll(/!?\[[^\]]*\]\((?:<([^>]+)>|([^)\s]+))(?:\s+"[^"]*")?\)/g))
@@ -4002,9 +4000,9 @@ function parseDesign(source2, specId) {
         fence = void 0;
       return line2;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       return line2;
     }
     if (/^#\s/.test(line2))
@@ -4047,9 +4045,9 @@ function parseDocument(path3, source2) {
         fence = void 0;
       continue;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       continue;
     }
     if (/^#\s/.test(line2))
@@ -4459,14 +4457,14 @@ function sections(raw, path3) {
       found.at(-1)?.lines.push(line2);
       continue;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
-    if (open6)
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
+    if (open5)
+      fence = { char: open5[1][0], size: open5[1].length };
     else if (/^#\s/.test(line2))
       throw new DocumentError("BODY_HEADING", path3, t("doc.BODY_HEADING", { path: path3 }));
     else if (/<!-- gitifact-/.test(line2))
       throw new DocumentError("BODY_MARKER", path3, t("doc.BODY_MARKER", { path: path3 }));
-    const heading = !open6 && /^##\s+(.+?)\s*#*\s*$/.exec(line2);
+    const heading = !open5 && /^##\s+(.+?)\s*#*\s*$/.exec(line2);
     if (heading) {
       const key = sectionKeyOf(heading[1]);
       if (!key || found.some((s) => s.key === key))
@@ -4550,6 +4548,8 @@ var HISTORY_PATH = ".gitifact/history.jsonl";
 var name = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var rootUpperName2 = /^[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*\.md$/;
 var isWikiPage = (path3) => path3.startsWith(WIKI_ROOT + "/") && path3.endsWith(".md");
+var isInstructionPath = (path3) => path3.startsWith(INSTRUCTIONS_ROOT + "/");
+var instructionFolderOf = (path3) => /^\.gitifact\/instructions\/[^/]+/.exec(path3)?.[0];
 function classifyDocPath(path3) {
   const unsupported = () => new DocumentError("PATH_UNSUPPORTED", path3, t("doc.PATH_UNSUPPORTED", { path: path3 }));
   if (path3 === HISTORY_PATH)
@@ -4650,9 +4650,9 @@ function body(raw, path3) {
         fence = void 0;
       continue;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       continue;
     }
     if (/^#\s/.test(line2))
@@ -4716,19 +4716,6 @@ function parseDocumentFile(path3, source2) {
   }
   return { kind: "design", feature: where.feature, order: order(), requirements: refs?.type === "list" ? refs.items : [], sources: sources(fields2, path3), ...common };
 }
-var isInstructionReference = (path3) => path3.endsWith(".md");
-function parseInstructionFile(path3, source2) {
-  if (source2.includes("\0") || /\r(?!\n)/.test(source2) || source2.charCodeAt(0) === 65279)
-    throw new DocumentError("INVALID_CHARACTERS", path3, t("doc.INVALID_CHARACTERS", { path: path3 }));
-  const { fields: fields2 } = parseFrontmatterBlock(source2.replace(/\r\n/g, "\n"), path3);
-  for (const key of fields2.keys())
-    if (key !== "title" && key !== "description")
-      throw new DocumentError("FRONTMATTER_UNKNOWN_KEY", path3, t("doc.FRONTMATTER_UNKNOWN_KEY", { path: path3, key }));
-  for (const key of ["title", "description"])
-    if (!fields2.has(key))
-      throw new DocumentError("FRONTMATTER_MISSING_KEY", path3, t("doc.FRONTMATTER_MISSING_KEY", { path: path3, key }));
-  return { title: text(fields2, "title", path3, 200), description: text(fields2, "description", path3, 300) };
-}
 function renderDocumentFile(doc) {
   const front = renderFrontmatterBlock([
     ["id", doc.id],
@@ -4773,17 +4760,18 @@ function checkDocuments(files) {
   const report = (code, path3, values = {}) => problems.push(docProblem(code, path3, values));
   const features = /* @__PURE__ */ new Set();
   const designFolders = /* @__PURE__ */ new Map();
-  const instructionFolders = /* @__PURE__ */ new Map();
-  const specLinks = (path3, body2) => {
-    for (const link3 of extractLinks(body2))
-      if (resolveLink(path3, link3)?.startsWith(SPEC_ROOT + "/"))
-        report("INSTRUCTION_SPEC_LINK", path3, { link: link3 });
-  };
+  const instructionFolders = /* @__PURE__ */ new Set();
   for (const [path3, source2] of [...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
     if (isWikiPage(path3)) {
       report("WIKI_REMOVED", path3);
       continue;
     }
+    if (isInstructionPath(path3)) {
+      const folder = instructionFolderOf(path3);
+      if (folder)
+        instructionFolders.add(folder);
+      continue;
+    }
     try {
       const where = classifyDocPath(path3);
       if (where.type === "ignored")
@@ -4796,16 +4784,8 @@ function checkDocuments(files) {
         records2.push(parseRecordFile(path3, source2));
         continue;
       }
-      if (where.type === "instruction-file") {
-        instructionFolders.set(where.name, instructionFolders.get(where.name) === true);
-        if (isInstructionReference(path3)) {
-          specLinks(path3, source2);
-          parseInstructionFile(path3, source2);
-        }
+      if (where.type !== "doc")
         continue;
-      }
-      if (where.kind === "instruction")
-        instructionFolders.set(where.name, true);
       if (where.kind === "requirement" || where.kind === "design")
         features.add(where.feature);
       if (where.kind === "design")
@@ -4821,9 +4801,6 @@ function checkDocuments(files) {
   for (const doc of documents)
     if (doc.draft)
       report("DOC_DRAFT", doc.path);
-  for (const doc of documents)
-    if (doc.kind === "instruction")
-      specLinks(doc.path, doc.body);
   for (const doc of documents) {
     const seen = byId.get(doc.id);
     if (seen)
@@ -4871,9 +4848,8 @@ function checkDocuments(files) {
   for (const [feature2, overview] of designFolders)
     if (!overview)
       report("DESIGN_OVERVIEW_REQUIRED", `.gitifact/spec/${feature2}/design/overview.md`, { feature: feature2 });
-  for (const [name2, hasFile] of instructionFolders)
-    if (!hasFile)
-      report("INSTRUCTION_INDEX_REQUIRED", `${INSTRUCTIONS_ROOT}/${name2}/${INSTRUCTION_FILE}`);
+  for (const folder of [...instructionFolders].sort())
+    report("INSTRUCTION_MOVED", folder);
   return { documents, records: records2, problems };
 }
 
@@ -4889,12 +4865,11 @@ function arrangeDocuments(documents) {
     return f;
   };
   const wiki = [];
-  const instructions2 = [];
   for (const doc of documents) {
     if (doc.kind === "wiki")
       wiki.push(doc);
     else if (doc.kind === "instruction")
-      instructions2.push(doc);
+      continue;
     else if (doc.kind === "feature")
       folder(doc.feature).index = doc;
     else if (doc.kind === "requirement")
@@ -4911,7 +4886,7 @@ function arrangeDocuments(documents) {
     }
     features.push({ index: f.index, requirements: f.requirements.sort(byOrder), designs: f.designs.sort(byOrder) });
   }
-  return { features, wiki: wiki.sort(byPath), instructions: instructions2.sort(byPath), orphans };
+  return { features, wiki: wiki.sort(byPath), orphans };
 }
 
 // ../../packages/core/dist/use-cases/compare-documents.js
@@ -4974,7 +4949,7 @@ function documentWarnings(documents, assets, existing) {
       referenced.add(target);
       continue;
     }
-    if ((!target.startsWith(".gitifact/") || target.startsWith(INSTRUCTIONS_ROOT + "/")) && existing.has(target))
+    if (!target.startsWith(".gitifact/") && existing.has(target))
       continue;
     warnings.push(docWarning("MISSING_LINK_TARGET", from, { link: link3, target }));
   }
@@ -25182,21 +25157,6 @@ var feature = external_exports.strictObject({
   contributors: external_exports.array(contributor),
   updatedAt: external_exports.string().nullable()
 });
-var instructionFile = external_exports.strictObject({ path: external_exports.string(), size: external_exports.number().int().nonnegative(), title: external_exports.string().optional(), description: external_exports.string().optional() });
-var instruction = external_exports.strictObject({
-  id: external_exports.string(),
-  name: external_exports.string(),
-  path: external_exports.string(),
-  title: external_exports.string(),
-  description: external_exports.string(),
-  body: external_exports.string(),
-  ...standing,
-  // Paths relative to the instruction folder, index.md left out; `limited` when the folder holds more than the list carries.
-  files: external_exports.array(instructionFile),
-  filesLimited: external_exports.boolean(),
-  updatedAt: external_exports.string().nullable()
-});
-var agents = external_exports.strictObject({ path: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
 var problem = external_exports.strictObject({ code: external_exports.string(), path: external_exports.string(), message: external_exports.string() });
 var oid2 = external_exports.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/);
 var indexFeature = external_exports.strictObject({
@@ -25207,17 +25167,16 @@ var indexFeature = external_exports.strictObject({
   requirements: external_exports.array(external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string() })),
   designs: external_exports.array(external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string() }))
 });
-var indexInstruction = external_exports.strictObject({ id: external_exports.string(), name: external_exports.string(), path: external_exports.string(), title: external_exports.string() });
-var browserCheckoutV1 = external_exports.strictObject({
+var browserCheckoutV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-checkout"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   head: oid2.nullable(),
   observedAt: external_exports.string(),
   working: external_exports.boolean(),
   stamp: external_exports.string(),
   problems: external_exports.array(problem),
-  index: external_exports.strictObject({ features: external_exports.array(indexFeature), instructions: external_exports.array(indexInstruction), people: external_exports.array(external_exports.strictObject({ name: external_exports.string(), email: external_exports.string() })) })
+  index: external_exports.strictObject({ features: external_exports.array(indexFeature), people: external_exports.array(external_exports.strictObject({ name: external_exports.string(), email: external_exports.string() })) })
 });
 var featureRow = external_exports.strictObject({
   id: external_exports.string(),
@@ -25245,13 +25204,6 @@ var browserFeaturesV1 = external_exports.strictObject({
   features: external_exports.array(featureRow)
 });
 var browserFeatureV2 = external_exports.strictObject({ contract: external_exports.literal("browser-feature"), version: external_exports.literal(2), sessionId: external_exports.string(), feature });
-var browserInstructionsV1 = external_exports.strictObject({
-  contract: external_exports.literal("browser-instructions"),
-  version: external_exports.literal(1),
-  sessionId: external_exports.string(),
-  instructions: external_exports.array(instruction),
-  agents: agents.nullable()
-});
 var browserContributorsV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-contributors"),
   version: external_exports.literal(1),
@@ -25334,20 +25286,20 @@ var browserHistorySummaryV5 = external_exports.strictObject({
   // The newest commits: a few of their changes each and how many there are in all.
   recent: external_exports.array(external_exports.strictObject({ commit: oid2, count: external_exports.number().int().positive(), events: external_exports.array(event) }))
 });
-var searchKind = external_exports.enum(["feature", "requirement", "design", "instruction", "record", "commit"]);
+var searchKind = external_exports.enum(["feature", "requirement", "design", "record", "commit"]);
 var searchHit = external_exports.strictObject({
   id: external_exports.string(),
   kind: searchKind,
   title: external_exports.string(),
   where: external_exports.string(),
   line: external_exports.string(),
-  // What the hit opens: a feature (with the requirement or design tab), an instruction, a record, or a commit.
+  // What the hit opens: a feature (with the requirement or design tab), a record, or a commit.
   featureId: external_exports.string().optional(),
   commit: oid2.optional()
 });
-var browserSearchV3 = external_exports.strictObject({
+var browserSearchV4 = external_exports.strictObject({
   contract: external_exports.literal("browser-search"),
-  version: external_exports.literal(3),
+  version: external_exports.literal(4),
   sessionId: external_exports.string(),
   query: external_exports.string(),
   groups: external_exports.array(external_exports.strictObject({ group: external_exports.union([searchKind, external_exports.literal("recent")]), total: external_exports.number().int().nonnegative(), next: external_exports.string().nullable(), hits: external_exports.array(searchHit) }))
@@ -25379,14 +25331,13 @@ var browserFeaturesQueryV1 = external_exports.strictObject({
 var browserFeatureQueryV1 = external_exports.strictObject({ id: featureId });
 var browserContributorsQueryV1 = external_exports.strictObject({ q: external_exports.string().max(200).optional(), after: external_exports.string().min(1).max(320).optional(), limit: count(50).pipe(external_exports.number().min(1)).optional() });
 var browserContributorQueryV1 = external_exports.strictObject({ email: external_exports.string().min(1).max(320) });
-var browserSearchQueryV2 = external_exports.strictObject({
+var browserSearchQueryV3 = external_exports.strictObject({
   q: external_exports.string().max(200),
   head: headQuery.optional(),
   group: searchKind.optional(),
   after: external_exports.string().min(1).max(200).optional(),
   limit: count(50).pipe(external_exports.number().min(1)).optional()
 });
-var browserInstructionFileQueryV1 = external_exports.strictObject({ id: external_exports.string().regex(/^I-[a-z2-7]{10}$/), path: external_exports.string().min(1).max(1e3) });
 var changelogQueryV1 = external_exports.strictObject({ lang: external_exports.string().regex(/^[a-z]{2}(?:-[A-Z]{2})?$/).optional() });
 var fileStatus = external_exports.enum(["added", "modified", "deleted", "renamed"]);
 var commitFile = external_exports.strictObject({
@@ -25475,17 +25426,6 @@ var browserDocumentHistoryQueryV1 = external_exports.strictObject({
   after: oid2.optional(),
   limit: count(50).pipe(external_exports.number().min(1)).optional()
 });
-var browserInstructionFileV1 = external_exports.strictObject({
-  contract: external_exports.literal("browser-instruction-file"),
-  version: external_exports.literal(1),
-  sessionId: external_exports.string(),
-  id: external_exports.string(),
-  path: external_exports.string(),
-  text: external_exports.string().nullable(),
-  size: external_exports.number().int().nonnegative(),
-  binary: external_exports.boolean(),
-  tooLarge: external_exports.boolean()
-});
 var workingChange = external_exports.strictObject({ id: external_exports.string(), kind, title: external_exports.string(), path: external_exports.string(), previousPath: external_exports.string().optional(), types: external_exports.array(changeType) });
 var pendingRecord = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), docs: external_exports.array(external_exports.string()), sections: external_exports.array(recordSection), draft: external_exports.boolean() });
 var browserWorkingV1 = external_exports.strictObject({
@@ -25586,7 +25526,8 @@ var updateV6 = external_exports.discriminatedUnion("ok", [
     // refreshed: blocks whose text differed were rewritten. current: every block already matched. kept: the project is on a
     // release newer than this CLI, so its blocks were left as they are.
     // not-initialized: no .gitifact config here, so only the version check ran. no-block: no file carries a block.
-    // missing: files `gitifact init` would add and update does not create, e.g. CLAUDE.md when only AGENTS.md has the block.
+    // missing: files `gitifact init` would add and update does not create. Always empty since 0.9.0, when init stopped adding
+    // a CLAUDE.md that imports AGENTS.md.
     agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "kept", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()), missing: external_exports.array(external_exports.string()) }),
     // written: .gitifact/config.json now names this release as `cli` and the block language. current: it already did.
     // cli is the project's release afterwards; one newer than cliVersion was kept, since an older CLI does not lower it.
@@ -25767,7 +25708,6 @@ var messages_default3 = {
   "server.recordNotFound": "\uC774 \uC774\uB825\uC5D0 \uADF8 \uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.documentNotFound": "\uC774 \uC774\uB825\uACFC \uC791\uC5C5 \uD3F4\uB354\uC5D0 \uADF8 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.commitFileNotFound": "\uADF8 \uCEE4\uBC0B\uC774 \uBC14\uAFBC \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4.",
-  "server.instructionFileNotFound": "\uC9C0\uCE68 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.specsUnreadable": "\uBA85\uC138\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "server.refreshOrigin": "\uC0C8\uB85C\uACE0\uCE68\uC5D0\uB294 \uAC19\uC740 \uCD9C\uCC98\uC758 Origin\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.",
   "server.fileNotFound": "\uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -25809,7 +25749,7 @@ var messages_default3 = {
   "init.text.storage": "\uC800\uC7A5 \uADDC\uC57D",
   "init.text.agentDocs": "\uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68",
   "init.text.lineEndings": "\uC904\uBC14\uAFC8: {path}\uB85C \uBB38\uC11C\uB97C LF\uB85C \uACE0\uC815\uD588\uC2B5\uB2C8\uB2E4. \uC774\uBBF8 \uC788\uB358 \uBB38\uC11C\uAC00 \uBCC0\uACBD\uC73C\uB85C \uBCF4\uC774\uBA74 \uC904\uBC14\uAFC8\uB9CC \uBC14\uB010 \uAC83\uC774\uB2C8 \uADF8 \uBB38\uC11C\uB4E4\uC744 \uD55C \uBC88 \uCEE4\uBC0B\uD574 \uC815\uB9AC\uD558\uC138\uC694.",
-  "init.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC124\uCE58\uD55C \uB4A4 gitifact update\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uC0C8 \uBC84\uC804\uC5D0 \uB9DE\uCD94\uC138\uC694.",
+  "init.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uC0C8 \uBC84\uC804\uC5D0 \uB9DE\uCD94\uC138\uC694.",
   "init.failed": "\uCD08\uAE30\uD654\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uD30C\uC77C \uC811\uADFC \uAD8C\uD55C\uACFC \uC0DD\uC131\uB41C \uC124\uC815\xB7\uC784\uC2DC \uD30C\uC77C\uC744 \uD655\uC778\uD558\uC138\uC694.",
   "config.storeNotDirectory": ".gitifact\uB294 \uB9C1\uD06C\uAC00 \uC544\uB2CC \uC77C\uBC18 \uB514\uB809\uD130\uB9AC\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "config.fileShape": "config.json\uC740 64 KiB \uC774\uD558\uC758 \uC77C\uBC18 \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
@@ -25844,14 +25784,13 @@ var messages_default3 = {
   "update.text.upToDate": "\uCD5C\uC2E0 \uBC84\uC804\uC744 \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.",
   "update.text.disabled": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC774 \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4.",
   "update.text.unavailable": "\uC0C8 \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.",
-  "update.text.install": "\uC124\uCE58 \uBA85\uB839: {command}",
-  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uACFC \uC9C0\uCE68\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uBC14\uB01D\uB2C8\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB3C4 \uC0C8 \uBC84\uC804\uC73C\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
+  "update.text.install": "\uC5C5\uB370\uC774\uD2B8 \uBA85\uB839: {command}",
+  "update.text.afterInstall": "\uC774 \uBA85\uB839\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uACFC \uC9C0\uCE68 \uBE14\uB85D, \uC2E4\uD589\uAE30(.gitifact/bin/cli.mjs)\uB97C \uBC14\uAFC9\uB2C8\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB3C4 \uC0C8 \uBC84\uC804\uC73C\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   "update.text.blockRefreshed": "\uC9C0\uCE68 \uBE14\uB85D \uAC31\uC2E0: {paths}",
   "update.text.blockCurrent": "\uC9C0\uCE68 \uBE14\uB85D\uC740 \uC774\uBBF8 \uD604\uC7AC \uBC84\uC804\uC785\uB2C8\uB2E4: {paths}",
   "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. gitifact init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
   "update.text.notInitialized": "\uCD08\uAE30\uD654\uB41C \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2C8\uC5B4\uC11C \uBC84\uC804\uB9CC \uD655\uC778\uD588\uC2B5\uB2C8\uB2E4.",
-  "update.text.missing": "{paths} \uD30C\uC77C\uC774 \uC5C6\uC5B4 Claude Code\uAC00 AGENTS.md\uC758 \uC9C0\uCE68\uC744 \uC77D\uC9C0 \uBABB\uD569\uB2C8\uB2E4. gitifact init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 AGENTS.md\uB97C \uAC00\uC838\uC624\uB294 \uD30C\uC77C\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.",
-  "update.text.migrationRequired": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBB38\uC11C\uB294 \uC544\uC9C1 0.7 \uC800\uC7A5 \uADDC\uC57D(schemaVersion 2)\uC785\uB2C8\uB2E4. \uC9C0\uCE68 \uBE14\uB85D\uC740 \uC0C8 \uBA85\uB839\uC744 \uC548\uB0B4\uD558\uC9C0\uB9CC \uC804\uD658 \uC804\uC5D0\uB294 specs\xB7instructions\xB7records\xB7check\xB7changes \uBA85\uB839\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. npx --yes gitifact@{version} guide show migrate\uC758 \uC808\uCC28\uB85C \uBB38\uC11C\uB97C \uC804\uD658\uD558\uC138\uC694.",
+  "update.text.migrationRequired": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBB38\uC11C\uB294 \uC544\uC9C1 0.7 \uC800\uC7A5 \uADDC\uC57D(schemaVersion 2)\uC785\uB2C8\uB2E4. \uC9C0\uCE68 \uBE14\uB85D\uC740 \uC0C8 \uBA85\uB839\uC744 \uC548\uB0B4\uD558\uC9C0\uB9CC \uC804\uD658 \uC804\uC5D0\uB294 specs\xB7records\xB7check\xB7changes \uBA85\uB839\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. npx --yes gitifact@{version} guide show migrate\uC758 \uC808\uCC28\uB85C \uBB38\uC11C\uB97C \uC804\uD658\uD558\uC138\uC694.",
   "update.text.committed": "\uC9C0\uCE68 \uBE14\uB85D \uCEE4\uBC0B: {commit} ({paths})",
   "update.text.commitNothing": "\uCEE4\uBC0B\uD560 \uC9C0\uCE68 \uBE14\uB85D \uBCC0\uACBD\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "update.text.commitSkipped.untracked": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. Git\uC774 \uCD94\uC801\uD558\uC9C0 \uC54A\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC785\uB2C8\uB2E4: {paths}",
@@ -25871,7 +25810,7 @@ var messages_default3 = {
   "help.guide": "\uC5D0\uC774\uC804\uD2B8\uC6A9 \uC791\uC131 \uC9C0\uCE68",
   "help.guideList": "\uC9C0\uCE68 \uBAA9\uB85D (\uC81C\uBAA9\uACFC \uC124\uBA85)",
   "help.guideShow": "\uC9C0\uCE68 \uD558\uB098\uB97C \uCD9C\uB825",
-  "help.guideTopic": "workflow, spec, design, instructions, records, writing, commit, migrate \uC911 \uD558\uB098",
+  "help.guideTopic": "workflow, spec, design, records, writing, commit, migrate \uC911 \uD558\uB098",
   "command.failed": "\uBA85\uB839\uC744 \uC2E4\uD589\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "project.notInitialized": "\uBA3C\uC800 gitifact init\uC73C\uB85C \uCD08\uAE30\uD654\uD558\uC138\uC694.",
   "input.file": "\uC785\uB825\uC740 1 MiB \uC774\uD558\uC758 JSON \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
@@ -25893,17 +25832,14 @@ var messages_default3 = {
   "docs.unknownDocument": "\uBB38\uC11C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: {ids}",
   "docs.references": "\uCC38\uC870",
   "docs.referencedBy": "\uAC00\uB9AC\uD0A4\uB294 \uBB38\uC11C",
-  "docs.files": "\uD30C\uC77C",
   "docs.invalidPath": "{kind} \uBB38\uC11C\uC758 \uACBD\uB85C\uAC00 \uC544\uB2D9\uB2C8\uB2E4: {path}. \uC608: {example}",
   "docs.pathExample.feature": "payment (.gitifact/spec/payment/index.md)",
   "docs.pathExample.requirement": "payment/cancel (.gitifact/spec/payment/requirements/cancel.md)",
   "docs.pathExample.design": "payment/api (.gitifact/spec/payment/design/api.md)",
-  "docs.pathExample.instruction": "cli-architecture (.gitifact/instructions/cli-architecture/index.md)",
   "docs.skeleton.feature": "(\uC774 \uAE30\uB2A5\uC774 \uBB34\uC5C7\uC774\uACE0 \uC5B4\uB514\uAE4C\uC9C0\uC778\uC9C0)",
   "docs.skeleton.requirement": "(\uC0AC\uC6A9\uC790)\uB85C\uC11C, (\uBAA9\uC801)\uC744 \uC704\uD574 (\uB3D9\uC791)\uC744 \uD558\uACE0 \uC2F6\uB2E4.\n\n### \uBC94\uC704\uC640 \uC81C\uC57D\n\n- (\uCC38\xB7\uAC70\uC9D3\uC744 \uAC00\uB9B4 \uC218 \uC788\uB294 \uADDC\uCE59 \uD55C \uBB38\uC7A5. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uC218\uC6A9 \uC870\uAC74\n\n1. \uC870\uAC74: (\uC0C1\uD669)\n   \uAE30\uB300 \uB3D9\uC791: (\uACB0\uACFC)",
   "docs.skeleton.requirementUsecase": "(\uC0AC\uC6A9\uC790)\uB85C\uC11C, (\uBAA9\uC801)\uC744 \uC704\uD574 (\uB3D9\uC791)\uC744 \uD558\uACE0 \uC2F6\uB2E4.\n\n### \uBC94\uC704\uC640 \uC81C\uC57D\n\n- (\uCC38\xB7\uAC70\uC9D3\uC744 \uAC00\uB9B4 \uC218 \uC788\uB294 \uADDC\uCE59 \uD55C \uBB38\uC7A5. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uC0AC\uC804 \uC870\uAC74\n\n- (\uC2DC\uC791 \uC804\uC5D0 \uCC38\uC774\uC5B4\uC57C \uD558\uB294 \uAC83. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uAE30\uBCF8 \uD750\uB984\n\n1. (\uD589\uC704\uC790)\uAC00 (\uB3D9\uC791)\uD55C\uB2E4.\n2. (\uC2DC\uC2A4\uD15C)\uC774 (\uACB0\uACFC)\uB97C \uBCF4\uC778\uB2E4.\n\n### \uB300\uCCB4 \uD750\uB984\n\n- **A1. (\uAC08\uB77C\uC9C0\uB294 \uC0C1\uD669)** (1\uB2E8\uACC4\uC5D0\uC11C)\n  1. (\uADF8\uB54C\uC758 \uB3D9\uC791)\n\n### \uC0AC\uD6C4 \uC870\uAC74\n\n- (\uB05D\uB09C \uB4A4 \uCC38\uC778 \uAC83. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uC218\uC6A9 \uC870\uAC74\n\n1. \uACBD\uB85C: \uAE30\uBCF8 \uD750\uB984\n   \uC870\uAC74: (\uC0C1\uD669)\n   \uAE30\uB300 \uB3D9\uC791: (\uACB0\uACFC)\n2. \uACBD\uB85C: \uAE30\uBCF8 \uD750\uB984, A1\n   \uC870\uAC74: (\uC0C1\uD669)\n   \uAE30\uB300 \uB3D9\uC791: (\uACB0\uACFC)",
   "docs.skeleton.design": "(\uC774 \uC124\uACC4\uAC00 \uB2E4\uB8E8\uB294 \uAD6C\uC870\uC640 \uCC98\uB9AC \uBC29\uC2DD)",
-  "docs.skeleton.instruction": "(\uC774 \uC791\uC5C5\uC744 \uD560 \uB54C \uC9C0\uD0AC \uADDC\uCE59\uACFC \uC808\uCC28. \uC790\uC138\uD55C \uB0B4\uC6A9\uC740 references/ \uC544\uB798 \uD30C\uC77C\uB85C \uB098\uB204\uACE0 \uC5EC\uAE30\uC11C \uB9C1\uD06C\uD55C\uB2E4)",
   "docs.exists": "\uC774\uBBF8 \uC788\uB294 \uD30C\uC77C\uC785\uB2C8\uB2E4: {path}",
   "docs.notFolder": "\uD3F4\uB354 \uC790\uB9AC\uC5D0 \uC77C\uBC18 \uD3F4\uB354\uAC00 \uC544\uB2CC \uAC83\uC774 \uC788\uC2B5\uB2C8\uB2E4: {path}",
   "docs.created": "\uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4: {path} ({id})",
@@ -25935,7 +25871,8 @@ var messages_default3 = {
   "changes.recordAltered": "\uCEE4\uBC0B\uB41C \uACB0\uC815\uAE30\uB85D\uC774 \uBC14\uB00C\uAC70\uB098 \uC9C0\uC6CC\uC9D0(\uCEE4\uBC0B\uC774 \uAC70\uBD80\uB428): {paths}",
   "commit.recordAltered": "\uC774\uBBF8 \uCEE4\uBC0B\uB41C \uACB0\uC815\uAE30\uB85D\uC740 \uACE0\uCE58\uAC70\uB098 \uC9C0\uC6B8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {paths}. HEAD\uB300\uB85C \uB418\uB3CC\uB9AC\uACE0, \uBC14\uB010 \uACB0\uC815\uC740 \uC0C8 \uAE30\uB85D(records new)\uC73C\uB85C \uC4F0\uC138\uC694.",
   "commit.selectMove": "\uC62E\uAE34 \uBB38\uC11C\uB294 \uC61B \uACBD\uB85C\uC640 \uC0C8 \uACBD\uB85C\uB97C \uD568\uAED8 \uC120\uD0DD\uD558\uC138\uC694: {ids}",
-  "records.invalidDocs": "--docs\uC5D0 \uB300\uC0C1 \uBB38\uC11C ID(S-\xB7R-\xB7D-\xB7I-)\uB97C \uD558\uB098 \uC774\uC0C1 \uC801\uC73C\uC138\uC694.",
+  "records.invalidDocs": "--docs\uC5D0 \uB300\uC0C1 \uBB38\uC11C ID(S-\xB7R-\xB7D-)\uB97C \uD558\uB098 \uC774\uC0C1 \uC801\uC73C\uC138\uC694.",
+  "records.notDocIds": "--docs\uC5D0 \uBB38\uC11C ID(S-\xB7R-\xB7D-)\uAC00 \uC544\uB2CC \uAC12\uC774 \uC788\uC2B5\uB2C8\uB2E4: {ids}",
   "records.skeleton": "(\uB0B4\uC6A9)",
   "records.createdNext": "\uC139\uC158\uC744 \uCC44\uC6B0\uACE0 draft: true \uC904\uC744 \uC9C0\uC6B4 \uB4A4, \uCEE4\uBC0B\uD560 \uB54C \uC774 \uD30C\uC77C\uC744 paths\uC5D0 \uB123\uC73C\uC138\uC694.",
   "records.unknown": "\uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {ids}",
@@ -25967,17 +25904,10 @@ var messages_default3 = {
   "help.specsNewStyle": "\uC694\uAD6C\uC0AC\uD56D \uD615\uC2DD(usecase, default). \uC5C6\uC73C\uBA74 \uC124\uC815\uC758 requirementStyle\uC744 \uB530\uB978\uB2E4",
   "help.newTitle": "\uBB38\uC11C \uC81C\uBAA9",
   "help.newDescription": "\uD55C \uC904 \uC124\uBA85",
-  "help.instructions": "\uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC758 \uBAA9\uB85D\xB7\uC6D0\uBB38\xB7\uC0DD\uC131",
-  "help.instructionsList": "AGENTS.md\uC640 \uC9C0\uCE68 \uBAA9\uB85D (\uC9C0\uCE68\uB9C8\uB2E4 \uB538\uB9B0 \uD30C\uC77C\uC758 \uC81C\uBAA9\uACFC \uC124\uBA85)",
-  "help.instructionsShow": "\uC9C0\uCE68 index.md \uC6D0\uBB38, \uB530\uB974\uB294 \uC124\uACC4, \uD3F4\uB354 \uD30C\uC77C \uBAA9\uB85D",
-  "help.instructionsShowTargets": "\uC9C0\uCE68 \uD3F4\uB354 \uC774\uB984\uC774\uB098 I- ID (\uC5EC\uB7EC \uAC1C \uAC00\uB2A5)",
-  "help.instructionsShowFile": "\uC9C0\uCE68 \uD3F4\uB354 \uC548\uC758 \uD30C\uC77C \uD558\uB098\uB97C \uC77D\uC74C (\uC608: references/code-style.md)",
-  "help.instructionsNew": "ID\uB97C \uBC1C\uAE09\uD558\uACE0 \uC9C0\uCE68 \uD3F4\uB354\uC640 index.md \uBF08\uB300 \uC0DD\uC131 (draft: true \uD45C\uC2DC)",
-  "help.instructionsNewName": "\uC9C0\uCE68 \uD3F4\uB354 \uC774\uB984 (\uC608: code-review)",
   "help.recordsList": "HEAD \uC774\uB825\uC758 \uACB0\uC815\uAE30\uB85D (\uCD5C\uC2E0\uC21C, \uCEE4\uBC0B \uC804 \uAE30\uB85D\uC774 \uBA3C\uC800)",
   "help.recordsListDoc": "\uD55C \uBB38\uC11C\uC758 \uACB0\uC815 \uD750\uB984: \uADF8 \uBB38\uC11C\uAC00 \uBC14\uB010 \uCEE4\uBC0B\uB9C8\uB2E4 \uACB0\uC815\uAE30\uB85D",
   "help.recordsListSince": "\uADF8 \uB0A0\uC9DC(YYYY-MM-DD)\uB098 \uCEE4\uBC0B \uB4A4\uC758 \uAC83\uB9CC",
-  "help.check": "\uBA85\uC138\xB7\uC9C0\uCE68\xB7\uCEE4\uBC0B \uC804 \uACB0\uC815\uAE30\uB85D \uC804\uCCB4\uC758 \uD615\uC2DD\xB7ID\xB7\uCC38\uC870\xB7\uCD08\uC548 \uD45C\uC2DC \uAC80\uC0AC (\uBB38\uC81C\uAC00 \uC788\uC73C\uBA74 \uC885\uB8CC \uCF54\uB4DC 1)",
+  "help.check": "\uBA85\uC138\xB7\uCEE4\uBC0B \uC804 \uACB0\uC815\uAE30\uB85D \uC804\uCCB4\uC758 \uD615\uC2DD\xB7ID\xB7\uCC38\uC870\xB7\uCD08\uC548 \uD45C\uC2DC \uAC80\uC0AC (\uBB38\uC81C\uAC00 \uC788\uC73C\uBA74 \uC885\uB8CC \uCF54\uB4DC 1)",
   "help.listQ": "\uC81C\uBAA9\xB7\uC124\uBA85\xB7\uBCF8\uBB38\uC5D0 \uC774 \uB9D0\uC774 \uC788\uB294 \uAC83\uB9CC",
   "help.listAuthor": "\uC774 Git \uC791\uC131\uC790(\uC774\uB984\uC774\uB098 \uC774\uBA54\uC77C)\uAC00 \uBC14\uAFBC \uAC83\uB9CC",
   "help.listSort": "\uC815\uB82C \uAE30\uC900",
@@ -25994,18 +25924,9 @@ var messages_default3 = {
   "list.features": "\uAE30\uB2A5",
   "list.commits": "\uCEE4\uBC0B",
   "list.records": "\uACB0\uC815\uAE30\uB85D",
-  "docs.otherResource": "\uC774 \uBA85\uB839\uC774 \uB2E4\uB8E8\uB294 \uBB38\uC11C\uAC00 \uC544\uB2D9\uB2C8\uB2E4: {ids}. {command}\uB85C \uC77D\uC73C\uC138\uC694.",
   "docs.noMatch": "\uC870\uAC74\uC5D0 \uB9DE\uB294 \uAC83\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "docs.requirement": "\uC694\uAD6C\uC0AC\uD56D",
   "docs.design": "\uC124\uACC4",
-  "instructions.agents": "AGENTS.md \u2014 \uBE14\uB85D \uBC16 \uC0C9\uC778\uC774 \uC5B4\uB5A4 \uC791\uC5C5\uC5D0 \uC5B4\uB290 \uC9C0\uCE68\uC744 \uC77D\uC744\uC9C0 \uC54C\uB9B0\uB2E4",
-  "instructions.noAgents": "AGENTS.md \uC5C6\uC74C \u2014 \uC9C0\uCE68\uC744 \uC5B8\uC81C \uC77D\uC744\uC9C0 \uC54C\uB9AC\uB294 \uC0C9\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4",
-  "instructions.filesLimited": "(\uD30C\uC77C\uC774 \uB354 \uC788\uC5B4 \uC55E {count}\uAC1C\uB9CC \uBCF4\uC785\uB2C8\uB2E4)",
-  "instructions.empty": "\uC9C0\uCE68\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. instructions new\uB85C \uB9CC\uB4DC\uC138\uC694.",
-  "instructions.fileWithOne": "--file\uC740 \uC9C0\uCE68 \uD558\uB098\uC640 \uD568\uAED8 \uC4F0\uBA70 --ref\uC640 \uD568\uAED8 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
-  "instructions.unknownFile": "\uC9C0\uCE68 {name} \uD3F4\uB354\uC5D0 \uADF8 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {path}",
-  "instructions.fileTooLarge": "(\uD30C\uC77C\uC774 \uCEE4\uC11C \uC6D0\uBB38\uC744 \uBCF4\uC774\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: {size}\uBC14\uC774\uD2B8)",
-  "instructions.fileBinary": "(\uD14D\uC2A4\uD2B8 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4: {size}\uBC14\uC774\uD2B8)",
   "records.empty": "\uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "records.moreDocs": "\uC678 {count}\uAC1C",
   "help.feedback": "Gitifact \uC790\uCCB4\uC758 \uBC84\uADF8\xB7\uAC1C\uC120\uC744 Gitifact \uC800\uC7A5\uC18C \uC774\uC288\uB85C \uBCF4\uB0C4 (gh\uAC00 \uC5C6\uC73C\uBA74 \uC774\uC288 \uC791\uC131 \uC8FC\uC18C \uCD9C\uB825)",
@@ -26021,11 +25942,11 @@ var messages_default3 = {
   "feedback.truncated": "\uBCF8\uBB38\uC774 \uAE38\uC5B4 \uC8FC\uC18C\uC5D0\uB294 \uC55E\uBD80\uBD84\uB9CC \uB2F4\uACBC\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC804\uCCB4 \uBCF8\uBB38\uC744 \uC791\uC131 \uD398\uC774\uC9C0\uC5D0 \uBD99\uC5EC \uB123\uC73C\uC138\uC694.",
   "feedback.title": "\uC81C\uBAA9: {title}",
   "update.text.projectWritten": "{path}\uC758 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC744 gitifact {version}\uC73C\uB85C \uC801\uC5C8\uC2B5\uB2C8\uB2E4.",
-  "update.text.projectAhead": "\uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC740 gitifact {project}\uC785\uB2C8\uB2E4. \uC774 CLI({version})\uAC00 \uB354 \uC624\uB798\uB418\uC5B4 \uB0AE\uCD94\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC62C\uB9AC\uC138\uC694.",
+  "update.text.projectAhead": "\uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC740 gitifact {project}\uC785\uB2C8\uB2E4. \uC774 CLI({version})\uAC00 \uB354 \uC624\uB798\uB418\uC5B4 \uB0AE\uCD94\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8\uC758 \uC2E4\uD589\uAE30 node .gitifact/bin/cli.mjs\uB85C \uC2E4\uD589\uD558\uC138\uC694.",
   "update.later.postponed": "{latest} \uC548\uB0B4\uB97C {until}\uAE4C\uC9C0 \uC27D\uB2C8\uB2E4. \uB354 \uC0C8 \uBC84\uC804\uC774 \uB098\uC624\uBA74 \uBC14\uB85C \uB2E4\uC2DC \uC548\uB0B4\uD569\uB2C8\uB2E4.",
   "update.later.nothing": "\uBBF8\uB8F0 \uC0C8 \uBC84\uC804 \uC548\uB0B4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}).",
-  "notice.release": "\uC0C8 \uBC84\uC804 {latest}\uAC00 \uC788\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}). \uC5C5\uB370\uC774\uD2B8: {command} \uD6C4 gitifact update \xB7 \uB098\uC911\uC5D0: gitifact update --later",
-  "notice.projectNewer": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 gitifact {project} \uAE30\uC900\uC785\uB2C8\uB2E4(\uC2E4\uD589 \uC911 {version}). {command}\uB85C \uC62C\uB9AC\uC138\uC694.",
+  "notice.release": "\uC0C8 \uBC84\uC804 {latest}\uAC00 \uC788\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}). \uC5C5\uB370\uC774\uD2B8: {command} \xB7 \uB098\uC911\uC5D0: gitifact update --later",
+  "notice.projectNewer": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 gitifact {project} \uAE30\uC900\uC785\uB2C8\uB2E4(\uC2E4\uD589 \uC911 {version}). \uD504\uB85C\uC81D\uD2B8\uC758 \uC2E4\uD589\uAE30 node .gitifact/bin/cli.mjs\uB85C \uC2E4\uD589\uD558\uC138\uC694.",
   "notice.projectOlder": "\uC774 CLI({version})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900({project})\uBCF4\uB2E4 \uC0C8 \uBC84\uC804\uC785\uB2C8\uB2E4. gitifact update\uB85C \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC744 \uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
   "help.updateLater": "\uC9C0\uAE08 \uC548\uB0B4\uB41C \uC0C8 \uBC84\uC804\uC744 24\uC2DC\uAC04 \uB3D9\uC548 \uC548\uB0B4\uD558\uC9C0 \uC54A\uC74C. \uB354 \uC0C8 \uBC84\uC804\uC740 \uBC14\uB85C \uC548\uB0B4",
   "update.text.blockKept": "\uD504\uB85C\uC81D\uD2B8\uAC00 \uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804 \uAE30\uC900\uC774\uB77C \uC9C0\uCE68 \uBE14\uB85D\uC744 \uADF8\uB300\uB85C \uB450\uC5C8\uC2B5\uB2C8\uB2E4: {paths}"
@@ -26086,7 +26007,6 @@ var messages_default4 = {
   "server.recordNotFound": "This history has no such decision record.",
   "server.documentNotFound": "Neither this history nor the working tree has that document.",
   "server.commitFileNotFound": "That commit did not change this file.",
-  "server.instructionFileNotFound": "The instruction file was not found.",
   "server.specsUnreadable": "Could not read specifications.",
   "server.refreshOrigin": "Refresh requires a same-origin Origin header.",
   "server.fileNotFound": "File not found.",
@@ -26128,7 +26048,7 @@ var messages_default4 = {
   "init.text.storage": "Storage convention",
   "init.text.agentDocs": "Agent instructions",
   "init.text.lineEndings": "Line endings: {path} keeps documents in LF. Documents that now show as changed differ only in line endings; commit them once to settle it.",
-  "init.text.updateAvailable": "Version {version} is available. Install it with {command}, then run gitifact update to move the project to it.",
+  "init.text.updateAvailable": "Version {version} is available. Move the project to it with {command}.",
   "init.failed": "Initialization failed. Check file permissions and the generated configuration and temporary files.",
   "config.storeNotDirectory": ".gitifact must be a regular directory, not a link.",
   "config.fileShape": "config.json must be a regular file no larger than 64 KiB.",
@@ -26163,14 +26083,13 @@ var messages_default4 = {
   "update.text.upToDate": "You are using the latest version.",
   "update.text.disabled": "Update checks are disabled.",
   "update.text.unavailable": "Could not check for updates. Check your network connection.",
-  "update.text.install": "Install command: {command}",
-  "update.text.afterInstall": "After installing, run gitifact update again to move the project and its instructions to the new version. Restart the browser with the new version too.",
+  "update.text.install": "Update command: {command}",
+  "update.text.afterInstall": "It moves the project, its instruction blocks and the launcher (.gitifact/bin/cli.mjs) to the new version. Restart the browser with the new version too.",
   "update.text.blockRefreshed": "Instruction blocks refreshed: {paths}",
   "update.text.blockCurrent": "Instruction blocks are already current: {paths}",
   "update.text.noBlock": "No instruction files contain a GITIFACT block. Run gitifact init to install one.",
   "update.text.notInitialized": "Only the version was checked because this project is not initialized.",
-  "update.text.missing": "{paths} is missing, so Claude Code cannot load the AGENTS.md instructions. Rerun gitifact init to create the import file.",
-  "update.text.migrationRequired": "This project's documents still use the 0.7 storage convention (schemaVersion 2). The blocks describe the new commands, but the specs, instructions, records, check and changes commands refuse to run until the documents are moved. Follow npx --yes gitifact@{version} guide show migrate to move them.",
+  "update.text.migrationRequired": "This project's documents still use the 0.7 storage convention (schemaVersion 2). The blocks describe the new commands, but the specs, records, check and changes commands refuse to run until the documents are moved. Follow npx --yes gitifact@{version} guide show migrate to move them.",
   "update.text.committed": "Instruction blocks committed: {commit} ({paths})",
   "update.text.commitNothing": "No instruction block changes to commit.",
   "update.text.commitSkipped.untracked": "Not committed. Instruction files are untracked: {paths}",
@@ -26190,7 +26109,7 @@ var messages_default4 = {
   "help.guide": "Writing guides for agents",
   "help.guideList": "List guides (title and description)",
   "help.guideShow": "Print one guide",
-  "help.guideTopic": "One of workflow, spec, design, instructions, records, writing, commit, migrate",
+  "help.guideTopic": "One of workflow, spec, design, records, writing, commit, migrate",
   "command.failed": "The command failed.",
   "project.notInitialized": "Initialize the project with gitifact init first.",
   "input.file": "The input must be a JSON file of 1 MiB or less.",
@@ -26212,17 +26131,14 @@ var messages_default4 = {
   "docs.unknownDocument": "Documents not found: {ids}",
   "docs.references": "References",
   "docs.referencedBy": "Referenced by",
-  "docs.files": "Files",
   "docs.invalidPath": "Not a path for a {kind} document: {path}. Example: {example}",
   "docs.pathExample.feature": "payment (.gitifact/spec/payment/index.md)",
   "docs.pathExample.requirement": "payment/cancel (.gitifact/spec/payment/requirements/cancel.md)",
   "docs.pathExample.design": "payment/api (.gitifact/spec/payment/design/api.md)",
-  "docs.pathExample.instruction": "cli-architecture (.gitifact/instructions/cli-architecture/index.md)",
   "docs.skeleton.feature": "(What this feature is and where it ends)",
   "docs.skeleton.requirement": "As (a user), I want to (act) so that (purpose).\n\n### Scope and constraints\n\n- (One rule that is either true or false. Remove this section if there is none)\n\n### Acceptance criteria\n\n1. Condition: (situation)\n   Expected: (result)",
   "docs.skeleton.requirementUsecase": "As (a user), I want to (act) so that (purpose).\n\n### Scope and constraints\n\n- (One rule that is either true or false. Remove this section if there is none)\n\n### Preconditions\n\n- (What holds before it starts. Remove this section if there is none)\n\n### Basic flow\n\n1. (The actor) (acts).\n2. (The system) shows (the result).\n\n### Alternative flows\n\n- **A1. (Where it branches)** (at step 1)\n  1. (What happens then)\n\n### Postconditions\n\n- (What holds when it ends. Remove this section if there is none)\n\n### Acceptance criteria\n\n1. Path: Basic flow\n   Condition: (situation)\n   Expected: (result)\n2. Path: Basic flow, A1\n   Condition: (situation)\n   Expected: (result)",
   "docs.skeleton.design": "(The structure and processing this design covers)",
-  "docs.skeleton.instruction": "(Rules and steps to follow for this kind of work. Put details in files under references/ and link them from here)",
   "docs.exists": "The file already exists: {path}",
   "docs.notFolder": "Something other than a plain folder stands where a folder is needed: {path}",
   "docs.created": "Created {path} ({id})",
@@ -26254,7 +26170,8 @@ var messages_default4 = {
   "changes.recordAltered": "Committed records edited or deleted (the commit is refused): {paths}",
   "commit.recordAltered": "Committed records cannot be edited or deleted: {paths}. Restore them from HEAD and write a changed decision as a new record (records new).",
   "commit.selectMove": "Select both the old and the new path of a moved document: {ids}",
-  "records.invalidDocs": "Give at least one target document ID (S-, R-, D-, I-) with --docs.",
+  "records.invalidDocs": "Give at least one target document ID (S-, R-, D-) with --docs.",
+  "records.notDocIds": "--docs has values that are not document IDs (S-, R-, D-): {ids}",
   "records.skeleton": "(Content)",
   "records.createdNext": "Fill in the sections, remove the draft: true line, and list this file in paths when you commit.",
   "records.unknown": "No such record: {ids}",
@@ -26286,17 +26203,10 @@ var messages_default4 = {
   "help.specsNewStyle": "Requirement shape (usecase, default). Defaults to the config requirementStyle",
   "help.newTitle": "Document title",
   "help.newDescription": "One-line description",
-  "help.instructions": "List, read and create project instructions",
-  "help.instructionsList": "AGENTS.md and the instructions (with the title and description of each file in their folders)",
-  "help.instructionsShow": "An instruction's index.md as written, the designs that follow it and its folder's files",
-  "help.instructionsShowTargets": "Instruction folder names or I- IDs (one or more)",
-  "help.instructionsShowFile": "Read one file of the instruction folder (e.g. references/code-style.md)",
-  "help.instructionsNew": "Create an instruction folder and index.md skeleton with an issued ID (marked draft: true)",
-  "help.instructionsNewName": "Instruction folder name (e.g. code-review)",
   "help.recordsList": "Decision records of HEAD's history (newest first, uncommitted ones first)",
   "help.recordsListDoc": "One document's decision flow: the records of each commit that changed it",
   "help.recordsListSince": "Only those after that date (YYYY-MM-DD) or commit",
-  "help.check": "Check the format, IDs, references and draft marks of all specs, instructions and uncommitted records (exit code 1 on problems)",
+  "help.check": "Check the format, IDs, references and draft marks of all specs and uncommitted records (exit code 1 on problems)",
   "help.listQ": "Only those whose title, description or text holds these words",
   "help.listAuthor": "Only those this Git author (name or email) changed",
   "help.listSort": "Sort key",
@@ -26313,18 +26223,9 @@ var messages_default4 = {
   "list.features": "Features",
   "list.commits": "Commits",
   "list.records": "Records",
-  "docs.otherResource": "Not a document this command reads: {ids}. Use {command}.",
   "docs.noMatch": "Nothing matches.",
   "docs.requirement": "requirement",
   "docs.design": "design",
-  "instructions.agents": "AGENTS.md \u2014 the index outside the block says which instruction to read for which work",
-  "instructions.noAgents": "No AGENTS.md \u2014 nothing tells when to read which instruction",
-  "instructions.filesLimited": "(the folder holds more; only the first {count} are shown)",
-  "instructions.empty": "No instructions yet. Create one with instructions new.",
-  "instructions.fileWithOne": "--file takes one instruction and does not go with --ref.",
-  "instructions.unknownFile": "The folder of instruction {name} has no such file: {path}",
-  "instructions.fileTooLarge": "(Too large to show: {size} bytes)",
-  "instructions.fileBinary": "(Not a text file: {size} bytes)",
   "records.empty": "No decision records yet.",
   "records.moreDocs": "and {count} more",
   "help.feedback": "Send a Gitifact bug or idea as an issue to Gitifact's repository (prints a new-issue address without gh)",
@@ -26340,11 +26241,11 @@ var messages_default4 = {
   "feedback.truncated": "The body is long, so the address holds only its beginning. Paste the full body below into the page.",
   "feedback.title": "Title: {title}",
   "update.text.projectWritten": "Set the project to gitifact {version} in {path}.",
-  "update.text.projectAhead": "The project is set to gitifact {project}. This CLI ({version}) is older, so it was not lowered. Install it with {command}.",
+  "update.text.projectAhead": "The project is set to gitifact {project}. This CLI ({version}) is older, so it was not lowered. Run it through the project's launcher, node .gitifact/bin/cli.mjs.",
   "update.later.postponed": "The notice for {latest} is quiet until {until}. A newer release is announced right away.",
   "update.later.nothing": "No newer release to postpone (running {version}).",
-  "notice.release": "Version {latest} is available (running {version}). Update: {command}, then gitifact update \xB7 Later: gitifact update --later",
-  "notice.projectNewer": "This project is set to gitifact {project} (running {version}). Install it with {command}.",
+  "notice.release": "Version {latest} is available (running {version}). Update: {command} \xB7 Later: gitifact update --later",
+  "notice.projectNewer": "This project is set to gitifact {project} (running {version}). Run it through the project's launcher, node .gitifact/bin/cli.mjs.",
   "notice.projectOlder": "This CLI ({version}) is newer than the project ({project}). Run gitifact update to move the project to it.",
   "help.updateLater": "Quiet the announced newer release for 24 hours; a release newer than it is announced right away",
   "update.text.blockKept": "The project is set to a newer release than this CLI, so the instruction blocks were left as they are: {paths}"
@@ -26699,7 +26600,7 @@ function storeReader(cwd) {
 import { DatabaseSync } from "node:sqlite";
 import { lstat, mkdir, rm, writeFile } from "node:fs/promises";
 import { join as join2 } from "node:path";
-var CACHE_FORMAT = 12;
+var CACHE_FORMAT = 13;
 var CACHE_DIR = ".gitifact/cache";
 var SCHEMA = `
   -- Working-tree files already read: the modification time and size decide whether a file is read again.
@@ -26885,6 +26786,7 @@ function createDocumentCache(root, database) {
   async function read(path3, seen) {
     try {
       if (isWikiPage(path3)) return { problem: docProblem("WIKI_REMOVED", path3) };
+      if (isInstructionPath(path3)) return path3.endsWith("/index.md") && classifyDocPath(path3).type === "doc" ? { problem: docProblem("INSTRUCTION_MOVED", instructionFolderOf(path3)) } : {};
       if (classifyDocPath(path3).type !== "doc") return {};
       if (seen.link) return { problem: docProblem("PATH_UNSUPPORTED", path3) };
       if (seen.size > FILE_LIMIT) return { problem: docProblem("FILE_TOO_LARGE", path3) };
@@ -26959,13 +26861,6 @@ function createDocumentCache(root, database) {
       return true;
     }
   };
-  const instructionFile3 = (path3) => {
-    try {
-      return classifyDocPath(path3).type === "instruction-file";
-    } catch {
-      return false;
-    }
-  };
   return {
     sync,
     /**
@@ -26982,7 +26877,7 @@ function createDocumentCache(root, database) {
       if (history) seen.set(HISTORY_PATH, { mtime: history.mtimeMs, size: history.size, link: history.isSymbolicLink() || !history.isFile() });
       const read2 = await Promise.all([...seen].map(async ([path3, s]) => {
         if (!readable(path3)) return { path: path3 };
-        if (instructionFile3(path3) && !path3.endsWith(".md")) return { path: path3, text: "" };
+        if (isInstructionPath(path3) && !path3.endsWith(".md")) return { path: path3, text: "" };
         if (s.link) return { path: path3, problem: docProblem("PATH_UNSUPPORTED", path3) };
         if (s.size > (path3 === HISTORY_PATH ? 64 * FILE_LIMIT : FILE_LIMIT)) return { path: path3, problem: docProblem("FILE_TOO_LARGE", path3) };
         try {
@@ -28079,88 +27974,6 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
   }
 }
 
-// src/adapters/filesystem/instruction-folder.ts
-import { lstat as lstat6, open as open3, readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
-import { join as join7 } from "node:path";
-var INSTRUCTION_FILE_LIMIT = 500;
-var INSTRUCTION_TEXT_LIMIT = 512 * 1024;
-var folderOf3 = (root, instructionPath) => join7(root, ...instructionPath.split("/").slice(0, -1));
-async function listInstructionFiles(root, instructionPath) {
-  const files = [];
-  let limited = false;
-  async function visit2(folder, prefix, depth) {
-    if (depth > 10) return;
-    const entries = await readdir4(folder, { withFileTypes: true }).catch(() => []);
-    for (const entry2 of entries.sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
-      if (files.length >= INSTRUCTION_FILE_LIMIT) {
-        limited = true;
-        return;
-      }
-      const path3 = prefix + entry2.name;
-      if (entry2.isDirectory()) await visit2(join7(folder, entry2.name), path3 + "/", depth + 1);
-      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat6(join7(folder, entry2.name))).size });
-    }
-  }
-  await visit2(folderOf3(root, instructionPath), "", 0);
-  return { files, limited };
-}
-var FRONTMATTER_WINDOW = 8 * 1024;
-async function describeFiles(root, instructionPath, files) {
-  const folder = folderOf3(root, instructionPath);
-  return Promise.all(files.map(async (file2) => {
-    if (!isInstructionReference(file2.path)) return file2;
-    let handle;
-    try {
-      handle = await open3(join7(folder, ...file2.path.split("/")), "r");
-      const buffer = Buffer.alloc(Math.min(FRONTMATTER_WINDOW, file2.size));
-      const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-      return { ...file2, ...parseInstructionFile(file2.path, buffer.subarray(0, bytesRead).toString("utf8")) };
-    } catch {
-      return file2;
-    } finally {
-      await handle?.close();
-    }
-  }));
-}
-async function readInstructionFiles(root, instructionPath) {
-  const { files, limited } = await listInstructionFiles(root, instructionPath);
-  return { files: await describeFiles(root, instructionPath, files), limited };
-}
-async function readInstructionFile(root, instructionPath, path3) {
-  const parts = path3.split("/");
-  if (parts.some((p) => !p || p === "." || p === ".." || /[\\:\0]/.test(p))) return void 0;
-  let full = folderOf3(root, instructionPath);
-  for (const [index, part] of parts.entries()) {
-    full = join7(full, part);
-    const info5 = await lstat6(full).catch(() => void 0);
-    if (!info5 || info5.isSymbolicLink() || (index < parts.length - 1 ? !info5.isDirectory() : !info5.isFile())) return void 0;
-  }
-  const size = (await lstat6(full)).size;
-  if (size > INSTRUCTION_TEXT_LIMIT) return { text: null, size, binary: false, tooLarge: true };
-  const bytes = await readFile5(full);
-  try {
-    if (bytes.includes(0)) throw new TypeError("binary");
-    return { text: new TextDecoder("utf-8", { fatal: true }).decode(bytes), size, binary: false, tooLarge: false };
-  } catch {
-    return { text: null, size, binary: true, tooLarge: false };
-  }
-}
-
-// src/adapters/filesystem/agents-file.ts
-import { lstat as lstat7, readFile as readFile6 } from "node:fs/promises";
-import { join as join8 } from "node:path";
-var LIMIT = 1024 * 1024;
-async function readAgentsFile(root) {
-  const file2 = join8(root, "AGENTS.md");
-  const info5 = await lstat7(file2).catch(() => void 0);
-  if (!info5?.isFile() || info5.size > LIMIT) return null;
-  try {
-    return new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(await readFile6(file2));
-  } catch {
-    return null;
-  }
-}
-
 // src/queries/document-states.ts
 var isDocument = (path3) => {
   try {
@@ -28229,8 +28042,8 @@ async function documentsAtHead(project, head, paths2) {
 
 // src/server/checkout/stamp.ts
 import { createHash as createHash2 } from "node:crypto";
-import { lstat as lstat8 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { lstat as lstat6 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 function createStampReader(root, inherited = process.env) {
   const runner = createGitRunner();
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_REPLACE_OBJECTS: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "0", LC_ALL: "C" };
@@ -28242,10 +28055,10 @@ function createStampReader(root, inherited = process.env) {
     ]);
     const paths2 = status.split("\0").filter(Boolean).map((entry2) => entry2.slice(3)).filter((path3) => !path3.startsWith(".gitifact/cache/"));
     const seen = await Promise.all(paths2.map(async (path3) => {
-      const info5 = await lstat8(join9(root, ...path3.split("/"))).catch(() => void 0);
+      const info5 = await lstat6(join7(root, ...path3.split("/"))).catch(() => void 0);
       return path3 + "	" + (info5 ? info5.mtimeMs + ":" + info5.size : "-");
     }));
-    const mailmap = await lstat8(join9(root, ".mailmap")).catch(() => void 0);
+    const mailmap = await lstat6(join7(root, ".mailmap")).catch(() => void 0);
     seen.push(".mailmap	" + (mailmap ? mailmap.mtimeMs + ":" + mailmap.size : "-"));
     return createHash2("sha256").update(head.trim() + "\n" + seen.sort().join("\n")).digest("hex").slice(0, 20);
   };
@@ -28258,7 +28071,7 @@ async function settled(reads) {
   if (failure2) throw failure2.reason;
   return results.map((r) => r.value);
 }
-var folderOf4 = (path3) => path3.split("/").slice(0, 3).join("/");
+var folderOf3 = (path3) => path3.split("/").slice(0, 3).join("/");
 function checkoutDocuments(states, authors) {
   const documents = states.documents;
   const standing2 = (id) => {
@@ -28273,7 +28086,7 @@ function checkoutDocuments(states, authors) {
   };
   const arranged = arrangeDocuments(documents);
   const features = arranged.features.map(({ index, requirements, designs }) => {
-    const entry2 = authors.get(folderOf4(index.path));
+    const entry2 = authors.get(folderOf3(index.path));
     return {
       id: index.id,
       path: index.path,
@@ -28298,17 +28111,7 @@ function checkoutDocuments(states, authors) {
       updatedAt: entry2?.latest ?? null
     };
   });
-  const instructions2 = arranged.instructions.map((k) => ({
-    id: k.id,
-    name: k.name,
-    path: k.path,
-    title: k.title,
-    description: k.description,
-    body: k.body,
-    ...standing2(k.id),
-    updatedAt: authors.get(folderOf4(k.path))?.latest ?? null
-  }));
-  return { features, instructions: instructions2, orphans: arranged.orphans };
+  return { features, orphans: arranged.orphans };
 }
 function createCheckoutReader(root, cache, inherited = process.env) {
   const reader = storeReader(root);
@@ -28337,16 +28140,15 @@ function createCheckoutReader(root, cache, inherited = process.env) {
       head ? cache.log.contributors(head) : Promise.resolve([])
     ]);
     const states = await documentStates({ head: async () => head, reader }, current3.documents);
-    const { features, instructions: instructions2, orphans } = checkoutDocuments(states, authors);
+    const { features, orphans } = checkoutDocuments(states, authors);
     const problems = [...current3.problems, ...orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
     if (await readHead() !== head) throw new StoreError(t2("specReader.projectChanged"));
     return {
       head,
       stamp,
       observedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      working: head ? !!dirty.trim() : features.length > 0 || instructions2.length > 0,
+      working: head ? !!dirty.trim() : features.length > 0,
       features,
-      instructions: instructions2,
       problems,
       people,
       folders: authors
@@ -28369,19 +28171,7 @@ function createCheckoutReader(root, cache, inherited = process.env) {
     }
     return value;
   };
-  return {
-    base,
-    /** Every instruction by name with the other files of its folder, and AGENTS.md: few enough to read whole. */
-    async instructions() {
-      const checkout = await base();
-      const instructions2 = await Promise.all([...checkout.instructions].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0).map(async (instruction2) => {
-        const { files, limited } = instruction2.state === "deleted" ? { files: [], limited: false } : await readInstructionFiles(root, instruction2.path);
-        return { ...instruction2, files, filesLimited: limited };
-      }));
-      const agentsText = await readAgentsFile(root);
-      return { instructions: instructions2, agents: agentsText === null ? null : { path: "AGENTS.md", body: agentsText, updatedAt: checkout.folders.get("AGENTS.md")?.latest ?? null } };
-    }
-  };
+  return { base };
 }
 
 // src/queries/paging.ts
@@ -28546,11 +28336,11 @@ async function workingChange2(source2, id) {
 }
 
 // src/queries/search.ts
-var SEARCH_GROUPS = ["feature", "requirement", "design", "instruction", "record", "commit"];
+var SEARCH_GROUPS = ["feature", "requirement", "design", "record", "commit"];
 var FIRST = 5;
 var RECENT = 6;
 var place2 = (path3) => path3.replace(/^\.gitifact\//, "");
-var folderOf5 = (path3) => path3.split("/").slice(0, 3).join("/");
+var folderOf4 = (path3) => path3.split("/").slice(0, 3).join("/");
 async function searchRecords(source2, request) {
   const head = request.head ?? await source2.head();
   const query = request.q.trim().toLowerCase();
@@ -28567,14 +28357,7 @@ async function searchRecords(source2, request) {
 var empty = () => ({ total: 0, next: null, hits: [] });
 async function recent(source2, head) {
   const [{ documents }, folders] = await Promise.all([source2.cache.documents.list(), head ? source2.cache.log.folders(head) : /* @__PURE__ */ new Map()]);
-  const hits = documents.filter((d) => d.kind === "feature" || d.kind === "instruction").map((d) => ({ doc: d, latest: folders.get(folderOf5(d.path))?.latest })).filter((d) => !!d.latest).sort((a, b) => Date.parse(b.latest) - Date.parse(a.latest) || a.doc.id.localeCompare(b.doc.id)).slice(0, RECENT).map(({ doc }) => ({
-    id: doc.id,
-    kind: doc.kind,
-    title: doc.title,
-    where: place2(doc.path),
-    line: doc.description,
-    ...doc.kind === "feature" ? { featureId: doc.id } : {}
-  }));
+  const hits = documents.filter((d) => d.kind === "feature").map((d) => ({ doc: d, latest: folders.get(folderOf4(d.path))?.latest })).filter((d) => !!d.latest).sort((a, b) => Date.parse(b.latest) - Date.parse(a.latest) || a.doc.id.localeCompare(b.doc.id)).slice(0, RECENT).map(({ doc }) => ({ id: doc.id, kind: "feature", title: doc.title, where: place2(doc.path), line: doc.description, featureId: doc.id }));
   return { group: "recent", total: hits.length, next: null, hits };
 }
 
@@ -28609,7 +28392,6 @@ function checkoutIndex(base) {
       requirements: f.requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description })),
       designs: f.designs.map((d) => ({ id: d.id, path: d.path, title: d.title }))
     })),
-    instructions: base.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title })),
     people: base.people.map((p) => ({ name: p.name, email: p.email }))
   };
 }
@@ -28703,12 +28485,12 @@ function recordRoutes(root, sessionId, env) {
   const cursorGone2 = () => new HttpError(404, "NOT_FOUND", t2("server.cursorNotFound"));
   return [
     // The checkout a part at a time, each shaped by the query layer (`queries/checkout.ts`): the frame every screen reads
-    // first, the feature list and one feature, the instructions, and the contributors.
+    // first, the feature list and one feature, and the contributors.
     route({ method: "GET", path: "/api/v1/checkout", session: true, unreadable: unreadable2, handle: async () => {
       const base = await checkout.base();
-      return ok(browserCheckoutV1.parse({
+      return ok(browserCheckoutV2.parse({
         contract: "browser-checkout",
-        version: 1,
+        version: 2,
         sessionId,
         head: base.head,
         observedAt: base.observedAt,
@@ -28728,7 +28510,6 @@ function recordRoutes(root, sessionId, env) {
       if (!feature2) throw new HttpError(404, "NOT_FOUND", t2("server.featureNotFound"));
       return ok(browserFeatureV2.parse({ contract: "browser-feature", version: 2, sessionId, feature: feature2 }));
     } }),
-    route({ method: "GET", path: "/api/v1/instructions", session: true, unreadable: unreadable2, handle: async () => ok(browserInstructionsV1.parse({ contract: "browser-instructions", version: 1, sessionId, ...await checkout.instructions() })) }),
     route({ method: "GET", path: "/api/v1/contributors", session: true, query: browserContributorsQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
       const page = listContributors(await checkout.base(), query.q, { after: query.after, limit: query.limit ?? PAGE });
       if (!page) throw cursorGone2();
@@ -28821,35 +28602,28 @@ function recordRoutes(root, sessionId, env) {
       if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.commitFileNotFound"));
       return ok(browserCommitFileV1.parse({ contract: "browser-commit-file", version: 1, sessionId, commit: query.commit, ...found }));
     } }),
-    // One file of an instruction folder, read from the working tree when the reader opens it; the checkout lists the files.
-    route({ method: "GET", path: "/api/v1/instructions/file", session: true, query: browserInstructionFileQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
-      const instruction2 = (await cache.documents.list()).documents.find((d) => d.id === query.id && d.kind === "instruction");
-      const found = instruction2 && await readInstructionFile(root, instruction2.path, query.path);
-      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.instructionFileNotFound"));
-      return ok(browserInstructionFileV1.parse({ contract: "browser-instruction-file", version: 1, sessionId, id: query.id, path: query.path, ...found }));
-    } }),
     // The search box's groups as the query layer works them out (`queries/search.ts`); the browser only draws them.
-    route({ method: "GET", path: "/api/v1/search", session: true, query: browserSearchQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
+    route({ method: "GET", path: "/api/v1/search", session: true, query: browserSearchQueryV3, unreadable: unreadable2, handle: async ({ query }) => {
       const groups = await searchRecords(source2, query);
       if (!groups) throw cursorGone2();
-      return ok(browserSearchV3.parse({ contract: "browser-search", version: 3, sessionId, query: query.q, groups }));
+      return ok(browserSearchV4.parse({ contract: "browser-search", version: 4, sessionId, query: query.q, groups }));
     } })
   ];
 }
 
 // src/server/routes/asset-routes.ts
-import { lstat as lstat9, readFile as readFile7 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { lstat as lstat7, readFile as readFile5 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 function assetRoutes(root) {
   return [
     route({ method: "GET", path: "/api/v1/assets/*", session: false, handle: async ({ path: path3, response }) => {
       const relative = path3.slice("/api/v1/assets/".length);
       const assetPath = ASSETS_DIR + "/" + relative;
       if (!isAssetPath(assetPath)) throw new HttpError(404, "NOT_FOUND", t2("server.assetNotFound"));
-      const file2 = join10(root, ...assetPath.split("/"));
-      const stat3 = await lstat9(file2).catch(() => void 0);
+      const file2 = join8(root, ...assetPath.split("/"));
+      const stat3 = await lstat7(file2).catch(() => void 0);
       if (!stat3?.isFile() || stat3.isSymbolicLink() || stat3.size > 20 * 1024 * 1024) throw new HttpError(404, "NOT_FOUND", t2("server.assetNotFound"));
-      const bytes = await readFile7(file2);
+      const bytes = await readFile5(file2);
       const extension = assetExtension(relative);
       const inline = ["png", "jpg", "jpeg", "gif", "webp", "svg"].includes(extension);
       response.writeHead(200, {
@@ -28866,7 +28640,7 @@ function assetRoutes(root) {
 }
 
 // src/server/browser-server.ts
-var readBundledChangelog = (language) => readFile8(new URL("./i18n/" + language + "/changelog.md", import.meta.url), "utf8").catch((error62) => {
+var readBundledChangelog = (language) => readFile6(new URL("./i18n/" + language + "/changelog.md", import.meta.url), "utf8").catch((error62) => {
   if (error62.code === "ENOENT") return null;
   throw error62;
 });
@@ -28996,14 +28770,14 @@ async function runBrowser(options, version2) {
 }
 
 // src/commands/spec-init.ts
-import { readdir as readdir5 } from "node:fs/promises";
-import { join as join14 } from "node:path";
+import { readdir as readdir4 } from "node:fs/promises";
+import { join as join13 } from "node:path";
 
 // src/adapters/git/init-repository.ts
 import { createHash as createHash3 } from "node:crypto";
-import { lstat as lstat10, readFile as readFile9 } from "node:fs/promises";
-import { join as join11 } from "node:path";
-var markerPresent = (path3) => lstat10(path3).then(() => true, (error62) => {
+import { lstat as lstat8, readFile as readFile7 } from "node:fs/promises";
+import { join as join9 } from "node:path";
+var markerPresent = (path3) => lstat8(path3).then(() => true, (error62) => {
   if (error62.code === "ENOENT") return false;
   throw error62;
 });
@@ -29026,10 +28800,10 @@ function initRepository(cwd, inherited = process.env) {
       const gitDir = locations.length === 2 ? locations[0] : decodeGitLine(await git(["rev-parse", "--absolute-git-dir"], root));
       const indexPath = locations.length === 2 ? locations[1] : decodeGitLine(await git(["rev-parse", "--path-format=absolute", "--git-path", "index"], root));
       for (const marker2 of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"]) {
-        if (await markerPresent(join11(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+        if (await markerPresent(join9(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
       }
       if (state2.changes.some((change2) => change2.kind === "unmerged")) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
-      const index = await readFile9(indexPath).catch((error62) => {
+      const index = await readFile7(indexPath).catch((error62) => {
         if (error62.code === "ENOENT") return Buffer.alloc(0);
         throw error62;
       });
@@ -29064,14 +28838,14 @@ function initRepository(cwd, inherited = process.env) {
 
 // src/adapters/filesystem/document-file.ts
 import { randomBytes } from "node:crypto";
-import { lstat as lstat11, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { lstat as lstat9, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 var generateId = (prefix) => prefix + "-" + [...randomBytes(10)].map((n) => "abcdefghijklmnopqrstuvwxyz234567"[n & 31]).join("");
 async function createDocumentFile(root, path3, text4) {
   const parts = path3.split("/");
   for (let i = 1; i < parts.length; i++) {
-    const folder = join12(root, ...parts.slice(0, i));
-    const info5 = await lstat11(folder).catch((error62) => {
+    const folder = join10(root, ...parts.slice(0, i));
+    const info5 = await lstat9(folder).catch((error62) => {
       if (error62.code === "ENOENT") return void 0;
       throw error62;
     });
@@ -29081,7 +28855,7 @@ async function createDocumentFile(root, path3, text4) {
     }
     if (!info5.isDirectory() || info5.isSymbolicLink()) throw Object.assign(new Error(folder), { code: "ENOTDIR" });
   }
-  await writeFile2(join12(root, ...parts), text4, { flag: "wx" });
+  await writeFile2(join10(root, ...parts), text4, { flag: "wx" });
 }
 var LINE_ENDINGS_PATH = ".gitifact/.gitattributes";
 var LINE_ENDINGS = "# Written by gitifact init: documents keep LF on every OS, so what Git holds and the files read the same.\n* text=auto eol=lf\n";
@@ -29095,19 +28869,50 @@ async function writeLineEndings(root) {
   }
 }
 
+// src/adapters/filesystem/launcher-file.ts
+import { lstat as lstat10, mkdir as mkdir4, readFile as readFile8, writeFile as writeFile3 } from "node:fs/promises";
+import { join as join11 } from "node:path";
+var LAUNCHER_PATH = ".gitifact/bin/cli.mjs";
+var readBundledLauncher = () => readFile8(new URL("./launcher/cli.mjs", import.meta.url), "utf8").catch((error62) => {
+  if (error62.code === "ENOENT") return void 0;
+  throw error62;
+});
+async function refreshLauncher(root) {
+  const text4 = await readBundledLauncher();
+  return text4 === void 0 ? false : writeLauncher(root, text4.replace(/\r\n/g, "\n"));
+}
+async function writeLauncher(root, text4) {
+  const folder = join11(root, ".gitifact", "bin");
+  const file2 = join11(folder, "cli.mjs");
+  const folderInfo = await lstat10(folder).catch((error62) => {
+    if (error62.code === "ENOENT") return void 0;
+    throw error62;
+  });
+  if (folderInfo && (!folderInfo.isDirectory() || folderInfo.isSymbolicLink())) throw Object.assign(new Error(folder), { code: "ENOTDIR" });
+  if (!folderInfo) await mkdir4(folder);
+  const info5 = await lstat10(file2).catch((error62) => {
+    if (error62.code === "ENOENT") return void 0;
+    throw error62;
+  });
+  if (info5 && (!info5.isFile() || info5.isSymbolicLink())) throw Object.assign(new Error(file2), { code: "ENOTDIR" });
+  if (info5 && (await readFile8(file2, "utf8")).replace(/\r\n/g, "\n") === text4) return false;
+  await writeFile3(file2, text4);
+  return true;
+}
+
 // src/adapters/filesystem/managed-file.ts
-import { open as open4, readFile as readFile10, mkdir as mkdir4, realpath as realpath2, rename as rename2, link as link2, unlink as unlink2 } from "node:fs/promises";
-import { join as join13, dirname } from "node:path";
+import { open as open3, readFile as readFile9, mkdir as mkdir5, realpath as realpath2, rename as rename2, link as link2, unlink as unlink2 } from "node:fs/promises";
+import { join as join12, dirname } from "node:path";
 import { randomUUID as randomUUID4 } from "node:crypto";
 var DEFAULT_LIMIT = 1024 * 1024;
 async function managedPath(root, path3, create = false) {
   let full = root;
   const parts = path3.split("/");
   for (let i = 0; i < parts.length; i++) {
-    full = join13(full, parts[i]);
+    full = join12(full, parts[i]);
     let info5 = await fileInfo(full);
     if (!info5 && create && i < parts.length - 1) {
-      await mkdir4(full).catch((error62) => {
+      await mkdir5(full).catch((error62) => {
         if (error62.code !== "EEXIST") throw error62;
       });
       info5 = await fileInfo(full);
@@ -29123,7 +28928,7 @@ async function managedRead(root, path3, limit = DEFAULT_LIMIT) {
   const before = await fileInfo(full);
   if (!before) return null;
   if (before.size > limit) throw new InitError("FILE_TOO_LARGE", t2("managedFile.tooLarge", { kib: limit / 1024, path: path3 }));
-  const bytes = await readFile10(full);
+  const bytes = await readFile9(full);
   await managedPath(root, path3);
   const after = await fileInfo(full);
   if (!after || before.ino !== after.ino || before.dev !== after.dev || before.mtimeMs !== after.mtimeMs || bytes.length > limit) {
@@ -29152,8 +28957,8 @@ async function managedWrite(root, path3, previous, next, recheck) {
     if (previous !== null) await unlink2(full);
     return;
   }
-  const temp = join13(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
-  const handle = await open4(temp, "wx", 384);
+  const temp = join12(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
+  const handle = await open3(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
     try {
@@ -29164,7 +28969,7 @@ async function managedWrite(root, path3, previous, next, recheck) {
     }
     await recheck();
     await unchanged();
-    if (await managedRead(root, path3) !== previous || await readFile10(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", t2("managedFile.publishTargetChanged", { path: path3 }));
+    if (await managedRead(root, path3) !== previous || await readFile9(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", t2("managedFile.publishTargetChanged", { path: path3 }));
     if (previous === null) await link2(temp, full);
     else await rename2(temp, full);
   } finally {
@@ -29175,10 +28980,10 @@ async function managedWrite(root, path3, previous, next, recheck) {
 }
 
 // src/commands/agent-block.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 
 // src/commands/guide.ts
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 
 // src/commands/output.ts
 var formats = ["text", "json"];
@@ -29213,9 +29018,9 @@ var section = (label, lines2, indent = "  ") => lines2.length ? [label, ...lines
 var text2 = (lines2) => lines2.join("\n") + "\n";
 
 // src/commands/guide.ts
-var guideTopics = ["workflow", "spec", "design", "instructions", "records", "writing", "commit", "migrate"];
+var guideTopics = ["workflow", "spec", "design", "records", "writing", "commit", "migrate"];
 var isGuideTopic = (value) => guideTopics.includes(value);
-var readBundledGuide = (name2, lang) => readFile11(new URL("./i18n/" + lang + "/docs/" + name2 + ".md", import.meta.url), "utf8");
+var readBundledGuide = (name2, lang) => readFile10(new URL("./i18n/" + lang + "/docs/" + name2 + ".md", import.meta.url), "utf8");
 function guideSummary(source2) {
   const { fields: fields2 } = parseFrontmatterBlock(source2.replace(/\r\n/g, "\n"), "guide");
   const value = (key) => {
@@ -29256,7 +29061,7 @@ function boilerplateFor(path3) {
   const name2 = path3 === "AGENTS.md" ? path3 : path3.split("/").pop().replace(/^\./, "").replace(/\.md$/, "");
   return "# " + name2 + "\n\nProject-specific guidance for AI coding agents.\n";
 }
-var readBundledBlock = (lang) => readFile12(new URL("./i18n/" + lang + "/block.md", import.meta.url), "utf8");
+var readBundledBlock = (lang) => readFile11(new URL("./i18n/" + lang + "/block.md", import.meta.url), "utf8");
 async function renderAgentBlock(controls = {}, lang = getLanguage()) {
   const body2 = await (controls.readBlock ?? readBundledBlock)(lang);
   return AGENT_START + "\n" + body2.trimEnd().replace(/\{topics\}/g, guideTopics.join(", ")) + "\n" + AGENT_END;
@@ -29285,15 +29090,9 @@ function isWrapperFile(text4) {
   return lines2.length > 0 && lines2.every((line2) => /^@(?:\.\/)?[^\s]+$/.test(line2) && candidatePaths.includes(line2.replace(/^@(?:\.\/)?/, "")));
 }
 var CLAUDE_WRAPPER_PATH = "CLAUDE.md";
-function claudeWrapperFor(agents2) {
-  return "@AGENTS.md" + eolOf(agents2);
-}
 function isGeneratedClaudeWrapper(text4) {
   return text4.trim() === "@AGENTS.md";
 }
-function lacksClaudeFile(existing) {
-  return !existing.has("CLAUDE.md") && !existing.has(".claude/CLAUDE.md");
-}
 function resolveAgentPaths(preset, existing) {
   if (preset && preset !== "all") {
     const order = agentPresets[preset];
@@ -29327,7 +29126,7 @@ function removeBlock(text4, boilerplate) {
 }
 
 // src/commands/agent-docs.ts
-var skippedAgentDocs = (language = explicitLanguage() ?? getLanguage()) => ({ mode: "skip", paths: [], writes: [], missing: [], language });
+var skippedAgentDocs = (language = explicitLanguage() ?? getLanguage()) => ({ mode: "skip", paths: [], writes: [], language });
 var blockOf = (text4) => {
   try {
     const found = findBlock(text4);
@@ -29362,7 +29161,7 @@ async function planAgentDocs(root, options) {
       paths2.push(CLAUDE_WRAPPER_PATH);
       writes.push({ path: CLAUDE_WRAPPER_PATH, previous: wrapper, next: null });
     }
-    return { mode: "remove", paths: paths2, writes, missing: [], language };
+    return { mode: "remove", paths: paths2, writes, language };
   }
   let block;
   const blockFor = async () => block ??= await renderAgentBlock(options, language);
@@ -29377,19 +29176,11 @@ async function planAgentDocs(root, options) {
     paths2.push(create);
     writes.push({ path: create, previous: null, next: injectBlock(null, await blockFor(), boilerplateFor(create)) });
   }
-  const missing2 = [];
-  if (paths2.includes("AGENTS.md") && lacksClaudeFile(existing)) {
-    if (options.onlyExisting) missing2.push(CLAUDE_WRAPPER_PATH);
-    else {
-      paths2.push(CLAUDE_WRAPPER_PATH);
-      writes.push({ path: CLAUDE_WRAPPER_PATH, previous: null, next: claudeWrapperFor(existing.get("AGENTS.md") ?? null) });
-    }
-  }
   for (const [path3, text4] of existing) {
     if (paths2.includes(path3) || !isWrapperFile(text4) || !findBlock(text4)) continue;
     writes.push({ path: path3, previous: text4, next: removeBlock(text4, boilerplateFor(path3)) });
   }
-  return { mode: "install", paths: paths2, writes, missing: missing2, language };
+  return { mode: "install", paths: paths2, writes, language };
 }
 async function applyAgentDocs(root, plan, recheck) {
   for (const write of plan.writes) await managedWrite(root, write.path, write.previous, write.next, recheck);
@@ -29498,6 +29289,7 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
       current2 = next;
     }
     await applyAgentDocs(root, docsPlan, unchanged);
+    if (agentDocs && !(config3.cli && isNewerRelease(config3.cli, agentDocs.version))) await refreshLauncher(root);
     return result(settled2.config, "already-initialized", await writeLineEndings(root));
   };
   const base = { schemaVersion: SCHEMA_VERSION, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
@@ -29509,13 +29301,14 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
     };
     await published();
     await applyAgentDocs(root, docsPlan, published);
+    if (agentDocs) await refreshLauncher(root);
     return result(config2, outcome, await writeLineEndings(root));
   };
   const old = await readConfigFile(root);
   if (old !== void 0) return existing(old);
   if (first.trackedConfig) throw new InitError("CONFIG_DELETED", t2("init.configDeleted"));
   const checkRecords = async () => {
-    const entries = await readdir5(join14(root, ".gitifact")).catch((e) => {
+    const entries = await readdir4(join13(root, ".gitifact")).catch((e) => {
       if (e.code === "ENOENT") return [];
       throw e;
     });
@@ -29553,22 +29346,22 @@ var fetchLatestVersion = async (signal) => {
 };
 
 // src/adapters/filesystem/user-cache.ts
-import { mkdir as mkdir5, readFile as readFile13, rename as rename3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir6, readFile as readFile12, rename as rename3, unlink as unlink3, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join14 } from "node:path";
 import { randomUUID as randomUUID5 } from "node:crypto";
 function userCacheDirectory(env = process.env, platform = process.platform, home = homedir()) {
   if (env.GITIFACT_CACHE_DIR) return env.GITIFACT_CACHE_DIR;
-  if (platform === "win32") return join15(env.LOCALAPPDATA || join15(home, "AppData", "Local"), "gitifact");
-  if (platform === "darwin") return join15(home, "Library", "Caches", "gitifact");
-  return join15(env.XDG_CACHE_HOME || join15(home, ".cache"), "gitifact");
+  if (platform === "win32") return join14(env.LOCALAPPDATA || join14(home, "AppData", "Local"), "gitifact");
+  if (platform === "darwin") return join14(home, "Library", "Caches", "gitifact");
+  return join14(env.XDG_CACHE_HOME || join14(home, ".cache"), "gitifact");
 }
-var cacheFile = (env) => join15(userCacheDirectory(env), "update.json");
+var cacheFile = (env) => join14(userCacheDirectory(env), "update.json");
 var isTime = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
 async function readUpdateCache(env = process.env) {
   let value;
   try {
-    value = JSON.parse(await readFile13(cacheFile(env), "utf8"));
+    value = JSON.parse(await readFile12(cacheFile(env), "utf8"));
   } catch {
     return {};
   }
@@ -29583,11 +29376,11 @@ async function readUpdateCache(env = process.env) {
 }
 async function changeUpdateCache(env, change2) {
   const directory = userCacheDirectory(env);
-  const temporary = join15(directory, "update-" + randomUUID5() + ".tmp");
+  const temporary = join14(directory, "update-" + randomUUID5() + ".tmp");
   try {
     const next = change2(await readUpdateCache(env));
-    await mkdir5(directory, { recursive: true });
-    await writeFile3(temporary, JSON.stringify(next) + "\n", "utf8");
+    await mkdir6(directory, { recursive: true });
+    await writeFile4(temporary, JSON.stringify(next) + "\n", "utf8");
     await rename3(temporary, cacheFile(env));
   } catch {
     await unlink3(temporary).catch(() => {
@@ -29616,7 +29409,7 @@ async function runInit(options, version2) {
     await recordUpdateCheck(process.env, dto.update);
     const docs = dto.agentDocs.mode === "skip" ? t2("init.text.skipped") : dto.agentDocs.paths.join(", ") + (dto.agentDocs.mode === "remove" ? " (" + t2("init.text.blockRemoved") + ")" : dto.outcome === "planned" ? " (" + t2("init.text.blockPlanned") + ")" : " (" + t2("init.text.blockUpdated") + ")");
     const lineEndings = dto.lineEndings.created ? t2("init.text.lineEndings", { path: dto.lineEndings.path }) + "\n" : "";
-    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npmGlobal }) + "\n" : "";
+    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npx }) + "\n" : "";
     process.stdout.write(options.format === "text" ? `${dto.outcome}: ${dto.rootPath}/.gitifact/config.json
 ${t2("init.text.storage")}: schemaVersion ${dto.schemaVersion}
 ${t2("init.text.agentDocs")}: ${docs}
@@ -29631,17 +29424,17 @@ ${lineEndings}${newer}` : JSON.stringify(dto) + "\n");
 }
 
 // src/commands/documents.ts
-import { readFile as readFile14 } from "node:fs/promises";
-import { join as join17 } from "node:path";
+import { readFile as readFile13 } from "node:fs/promises";
+import { join as join16 } from "node:path";
 
 // src/commands/project.ts
-import { join as join16 } from "node:path";
+import { join as join15 } from "node:path";
 var operations = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
 async function openProject(cwd, options = {}) {
   const reader = storeReader(cwd);
   const location = await reader.location();
   if (options.writing) {
-    for (const marker2 of operations) if (await fileInfo(join16(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join15(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await reader.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
   }
   const raw = await readConfigFile(location.root);
@@ -29800,12 +29593,11 @@ var stateLabel = {
 };
 var stateMark = (state2) => state2 === "committed" ? "" : " (" + stateLabel[state2]() + ")";
 var line = (doc) => `${doc.id} ${doc.title}${draftMark(doc)} \u2014 ${doc.description}`;
-var fileLine = (f) => f.title ? `${f.path} ${f.title} \u2014 ${f.description}` : f.path;
 async function working(project) {
   const { documents } = await project.cache.documents.list();
   return {
     byId: new Map(documents.map((d) => [d.id, d])),
-    read: (path3) => readFile14(join17(project.root, ...path3.split("/")), "utf8"),
+    read: (path3) => readFile13(join16(project.root, ...path3.split("/")), "utf8"),
     referencing: async (id) => [...new Set((await project.cache.documents.referencing(id)).map((r) => r.from))]
   };
 }
@@ -29818,12 +29610,12 @@ async function committed(project, commit) {
     referencing: async (id) => documents.filter((d) => d.kind === "design" && (d.requirements.includes(id) || d.sources.some((s) => "id" in s && s.id === id))).map((d) => d.id)
   };
 }
-async function showDocuments(project, ids, at, kinds, otherResource) {
+async function showDocuments(project, ids, at, kinds) {
   const view = at === void 0 ? await working(project) : await committed(project, at);
   const unknown2 = ids.filter((id) => !view.byId.has(id));
   if (unknown2.length) throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.unknownDocument", { ids: unknown2.join(", ") }));
   const other = ids.filter((id) => !kinds.includes(view.byId.get(id).kind));
-  if (other.length) throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.otherResource", { ids: other.join(", "), command: otherResource }));
+  if (other.length) throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.unknownDocument", { ids: other.join(", ") }));
   const shown = await Promise.all([...new Set(ids)].map(async (id) => {
     const doc = view.byId.get(id);
     const references = doc.kind === "design" ? [
@@ -29831,34 +29623,30 @@ async function showDocuments(project, ids, at, kinds, otherResource) {
       ...doc.sources.map((s) => "id" in s ? { id: s.id, title: view.byId.get(s.id)?.title ?? null } : { title: s.title, url: s.url })
     ] : [];
     const referencedBy = (await view.referencing(id)).map((from) => ({ id: from, title: view.byId.get(from)?.title ?? null }));
-    const files = doc.kind === "instruction" && at === void 0 ? { files: (await readInstructionFiles(project.root, doc.path)).files } : {};
-    return { id, kind: doc.kind, path: doc.path, title: doc.title, text: await view.read(doc.path), references, referencedBy, ...files };
+    return { id, kind: doc.kind, path: doc.path, title: doc.title, text: await view.read(doc.path), references, referencedBy };
   }));
   const named = (r) => r.id ? r.id + " " + (r.title ?? "(" + t2("docs.missing") + ")") : r.title + " <" + r.url + ">";
   const blocks = shown.map((d) => [
     `== ${d.id} ${d.path}${at ? " @ " + at.slice(0, 7) : ""}`,
     d.text.replace(/\n$/, ""),
     ...section("-- " + t2("docs.references"), d.references.map(named)),
-    ...section("-- " + t2("docs.referencedBy"), d.referencedBy.map(named)),
-    ...section("-- " + t2("docs.files"), (d.files ?? []).map(fileLine))
+    ...section("-- " + t2("docs.referencedBy"), d.referencedBy.map(named))
   ].join("\n"));
   return { json: { ...at ? { commit: at } : {}, documents: shown }, text: blocks.join("\n\n") + "\n" };
 }
 var pathExample = {
   feature: () => t2("docs.pathExample.feature"),
   requirement: () => t2("docs.pathExample.requirement"),
-  design: () => t2("docs.pathExample.design"),
-  instruction: () => t2("docs.pathExample.instruction")
+  design: () => t2("docs.pathExample.design")
 };
 var skeleton = {
   feature: () => t2("docs.skeleton.feature"),
   requirement: () => t2("docs.skeleton.requirement"),
-  design: () => t2("docs.skeleton.design"),
-  instruction: () => t2("docs.skeleton.instruction")
+  design: () => t2("docs.skeleton.design")
 };
 function newPath(kind2, path3) {
-  const target = kind2 === "feature" ? `${SPEC_ROOT}/${path3}/index.md` : kind2 === "instruction" ? `${INSTRUCTIONS_ROOT}/${path3}/${INSTRUCTION_FILE}` : `${SPEC_ROOT}/${path3.split("/")[0]}/${kind2 === "requirement" ? "requirements" : "design"}/${path3.split("/").slice(1).join("/")}.md`;
-  const shape = kind2 === "feature" || kind2 === "instruction" ? /^[^/]+$/ : /^[^/]+\/[^/]+$/;
+  const target = kind2 === "feature" ? `${SPEC_ROOT}/${path3}/index.md` : `${SPEC_ROOT}/${path3.split("/")[0]}/${kind2 === "requirement" ? "requirements" : "design"}/${path3.split("/").slice(1).join("/")}.md`;
+  const shape = kind2 === "feature" ? /^[^/]+$/ : /^[^/]+\/[^/]+$/;
   let where;
   try {
     where = shape.test(path3) ? classifyDocPath(target) : void 0;
@@ -29881,7 +29669,7 @@ async function createDocument(project, kind2, path3, options) {
   const taken = new Set(documents.map((d) => d.id));
   let id;
   do
-    id = generateId({ feature: "S", requirement: "R", design: "D", instruction: "I" }[kind2]);
+    id = generateId({ feature: "S", requirement: "R", design: "D" }[kind2]);
   while (taken.has(id));
   const folder = target.slice(0, target.lastIndexOf("/") + 1);
   const siblings = documents.filter((d) => (d.kind === "requirement" || d.kind === "design") && d.path.startsWith(folder) && !d.path.slice(folder.length).includes("/"));
@@ -29889,7 +29677,7 @@ async function createDocument(project, kind2, path3, options) {
   const body2 = style2 === "usecase" ? t2("docs.skeleton.requirementUsecase") : skeleton[kind2]();
   const base = { id, path: target, title: options.title.trim(), description: options.description.trim(), body: body2, draft: true };
   const feature2 = target.split("/")[2];
-  const doc = kind2 === "feature" ? { kind: kind2, feature: feature2, ...base } : kind2 === "instruction" ? { kind: kind2, name: path3, ...base } : kind2 === "requirement" ? { kind: kind2, feature: feature2, order, ...styleKey, ...base } : { kind: kind2, feature: feature2, order, requirements: [], sources: [], ...base };
+  const doc = kind2 === "feature" ? { kind: kind2, feature: feature2, ...base } : kind2 === "requirement" ? { kind: kind2, feature: feature2, order, ...styleKey, ...base } : { kind: kind2, feature: feature2, order, requirements: [], sources: [], ...base };
   const rendered = renderDocumentFile(doc);
   parseDocumentFile(target, rendered);
   try {
@@ -29912,11 +29700,11 @@ function parseLimit(value) {
   if (!/^[1-9]\d{0,5}$/.test(value)) throw new InvalidArgumentError(t2("list.limit"));
   return Number(value);
 }
-var parseFields = (value) => value.split(",").map((f) => f.trim()).filter(Boolean);
-function checkFields(fields2, columns3) {
+var parseFields = (value) => value.split(/[\s,]+/).filter(Boolean);
+function checkFields(fields2, columns2) {
   if (!fields2) return void 0;
-  const unknown2 = fields2.filter((f) => !columns3.includes(f));
-  if (unknown2.length || !fields2.length) throw new CommandError("INVALID_VALUE", t2("list.unknownFields", { fields: unknown2.join(", "), columns: columns3.join(", ") }));
+  const unknown2 = fields2.filter((f) => !columns2.includes(f));
+  if (unknown2.length || !fields2.length) throw new CommandError("INVALID_VALUE", t2("list.unknownFields", { fields: unknown2.join(", "), columns: columns2.join(", ") }));
   return [...new Set(fields2)];
 }
 function cell(value) {
@@ -30004,120 +29792,14 @@ var runSpecsList = (options) => runCommand("specs", options.format, async () =>
 var runSpecsShow = (ids, options) => runCommand("specs", options.format, async () => {
   const project = await openProject(process.cwd());
   const at = options.ref === void 0 ? void 0 : await project.reader.resolve(options.ref);
-  return showDocuments(project, ids, at, specKinds, "instructions show");
+  return showDocuments(project, ids, at, at === void 0 ? specKinds : [...specKinds, "instruction"]);
 });
 var runSpecsNew = (kind2, path3, options) => runCommand("specs", options.format, async () => createDocument(await openProject(process.cwd()), kind2, path3, options));
 
-// src/queries/instructions.ts
-import { lstat as lstat12 } from "node:fs/promises";
-import { join as join18 } from "node:path";
-var AGENTS = "AGENTS.md";
-async function listInstructions(source2, options, request) {
-  const listed3 = await source2.cache.documents.list();
-  const problems = listed3.problems;
-  const states = await documentStates(source2, listed3.documents);
-  const documents = states.documents;
-  const agents2 = { path: AGENTS, exists: !!(await lstat12(join18(source2.root, AGENTS)).catch(() => void 0))?.isFile() };
-  const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!options.withUpdated;
-  const latest = /* @__PURE__ */ new Map();
-  const newest = /* @__PURE__ */ new Map();
-  let touched;
-  if (historyNeeded) {
-    const head = await source2.head();
-    const changes2 = head ? await source2.cache.history.changesOf(head) : [];
-    changes2.forEach((c, rank) => {
-      if (!latest.has(c.id)) {
-        latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
-        newest.set(c.id, rank);
-      }
-    });
-    if (options.author !== void 0) {
-      const by = byAuthor(options.author);
-      touched = new Set(changes2.filter(by).map((c) => c.id));
-    }
-  }
-  const matched = options.q !== void 0 ? await source2.cache.documents.matching(options.q) : void 0;
-  const instructions2 = documents.filter((d) => d.kind === "instruction").filter((d) => (!touched || touched.has(d.id)) && (!matched || matched.has(d.id))).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
-  const rows = await Promise.all(instructions2.map(async (d) => {
-    const state2 = states.state(d.id);
-    const { files, limited } = state2 === "deleted" ? { files: [], limited: false } : await readInstructionFiles(source2.root, d.path);
-    return {
-      id: d.id,
-      name: d.name,
-      path: d.path,
-      title: d.title,
-      description: d.description,
-      ...d.draft ? { draft: true } : {},
-      state: state2,
-      ...states.previousPath(d.id) ? { previousPath: states.previousPath(d.id) } : {},
-      files,
-      ...limited ? { filesLimited: true } : {},
-      ...historyNeeded ? { updated: latest.get(d.id) ?? null } : {},
-      ...matched ? { line: matched.get(d.id) } : {}
-    };
-  }));
-  if (options.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
-  const page = pageOf(rows, (r) => r.id, request);
-  if (!page) return void 0;
-  return { agents: agents2, problems, page };
-}
-
-// src/commands/instructions.ts
-var instructionSorts = ["name", "updated"];
-var columns2 = ["id", "name", "path", "title", "description", "draft", "state", "previousPath", "files", "updated", "line"];
-var runInstructionsList = (options) => runCommand("instructions", options.format, async () => {
-  const fields2 = checkFields(options.fields, columns2);
-  const project = await openProject(process.cwd());
-  const listed3 = await listInstructions(project, { ...options, withUpdated: !!fields2?.includes("updated") }, options) ?? cursorGone(options);
-  const { agents: agents2, problems, page } = listed3;
-  const shown = page.rows;
-  const paging = { total: page.total, next: page.next, unit: "instruction" };
-  const unreadable2 = problems.filter((p) => p.path.startsWith(INSTRUCTIONS_ROOT + "/"));
-  if (fields2) {
-    const picked = selected(shown, fields2);
-    return {
-      json: { agents: agents2, instructions: picked.json, problems: unreadable2, page: paging },
-      text: selected(shown.map((r) => ({ ...r, files: r.files.map((f) => f.path) })), fields2).text + aside(options.format, pageLine(page))
-    };
-  }
-  const out = [agents2.exists ? t2("instructions.agents") : t2("instructions.noAgents")];
-  for (const r of shown) {
-    const when = r.updated ? ` \xB7 ${r.updated.date.slice(0, 10)} ${r.updated.author}` : "";
-    out.push(`${r.id} ${r.title}${draftMark(r)}${stateMark(r.state)} (${r.name}) \u2014 ${r.description}${when}`, ...r.line ? ["  " + r.line] : []);
-    out.push(...r.files.map((f) => "  " + fileLine(f)), ...r.filesLimited ? ["  " + t2("instructions.filesLimited", { count: r.files.length })] : []);
-  }
-  if (!shown.length) out.push(options.q !== void 0 || options.author !== void 0 ? t2("docs.noMatch") : t2("instructions.empty"));
-  out.push(...pageLine(page));
-  if (unreadable2.length) out.push(t2("docs.unreadable", { count: unreadable2.length }));
-  return { json: { agents: agents2, instructions: shown, problems: unreadable2, page: paging }, text: text2(out) };
-});
-async function resolveInstructions(project, targets, at) {
-  const view = at === void 0 ? await working(project) : await committed(project, at);
-  const byName = new Map([...view.byId.values()].filter((d) => d.kind === "instruction").map((d) => [d.name, d.id]));
-  return targets.map((target) => byName.get(target) ?? target);
-}
-var runInstructionsShow = (targets, options) => runCommand("instructions", options.format, async () => {
-  const project = await openProject(process.cwd());
-  if (options.file !== void 0 && (targets.length !== 1 || options.ref !== void 0)) throw new CommandError("INVALID_VALUE", t2("instructions.fileWithOne"));
-  const at = options.ref === void 0 ? void 0 : await project.reader.resolve(options.ref);
-  const ids = await resolveInstructions(project, targets, at);
-  if (options.file === void 0) return showDocuments(project, ids, at, ["instruction"], "specs show");
-  const instruction2 = (await working(project)).byId.get(ids[0]);
-  if (instruction2?.kind !== "instruction") throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.unknownDocument", { ids: targets[0] }));
-  const found = await readInstructionFile(project.root, instruction2.path, options.file);
-  if (!found) throw new CommandError("UNKNOWN_FILE", t2("instructions.unknownFile", { path: options.file, name: instruction2.name }));
-  const note = found.text !== null ? [] : [found.tooLarge ? t2("instructions.fileTooLarge", { size: found.size }) : t2("instructions.fileBinary", { size: found.size })];
-  return {
-    json: { id: instruction2.id, name: instruction2.name, file: { path: options.file, ...found } },
-    text: text2([`== ${instruction2.id} ${instruction2.name}/${options.file}`, ...found.text !== null ? [found.text.replace(/\n$/, "")] : note])
-  };
-});
-var runInstructionsNew = (name2, options) => runCommand("instructions", options.format, async () => createDocument(await openProject(process.cwd()), "instruction", name2, options));
-
 // src/adapters/filesystem/document-warnings.ts
-import { lstat as lstat13, readdir as readdir6 } from "node:fs/promises";
-import { join as join19 } from "node:path";
-var info2 = async (path3) => lstat13(path3).catch((e) => {
+import { lstat as lstat11, readdir as readdir5 } from "node:fs/promises";
+import { join as join17 } from "node:path";
+var info2 = async (path3) => lstat11(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -30125,20 +29807,20 @@ var posix = (path3) => path3.split("\\").join("/");
 async function listAssets(root) {
   const out = [];
   async function visit2(relative, depth) {
-    const stat3 = await info2(join19(root, relative));
+    const stat3 = await info2(join17(root, relative));
     if (!stat3 || stat3.isSymbolicLink()) return;
     if (stat3.isDirectory()) {
       if (depth > 8 || out.length > 4e3) return;
-      for (const name2 of (await readdir6(join19(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
+      for (const name2 of (await readdir5(join17(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
     } else if (stat3.isFile()) out.push({ path: posix(relative), bytes: stat3.size });
   }
   await visit2(ASSETS_DIR, 0);
   return out;
 }
 async function readDocumentWarnings(root, documents) {
-  const outside = [...new Set(documentBodyLinks(documents).map((l) => l.target).filter((t3) => !t3.startsWith(".gitifact/") || t3.startsWith(INSTRUCTIONS_ROOT + "/")))];
+  const outside = [...new Set(documentBodyLinks(documents).map((l) => l.target).filter((t3) => !t3.startsWith(".gitifact/")))];
   const existing = /* @__PURE__ */ new Set();
-  for (const target of outside) if ((await info2(join19(root, ...target.split("/"))))?.isFile()) existing.add(target);
+  for (const target of outside) if ((await info2(join17(root, ...target.split("/"))))?.isFile()) existing.add(target);
   return documentWarnings(documents, await listAssets(root), existing);
 }
 
@@ -30162,31 +29844,31 @@ var runCheck = (options) => runCommand("check", options.format, async () => {
 
 // src/commands/changes.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
-import { mkdir as mkdir7, open as open5, readFile as readFile17, rename as rename4, rmdir, unlink as unlink5, writeFile as writeFile5 } from "node:fs/promises";
-import { join as join22 } from "node:path";
+import { mkdir as mkdir8, open as open4, readFile as readFile16, rename as rename4, rmdir, unlink as unlink5, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join20 } from "node:path";
 
 // src/adapters/filesystem/agent-inputs.ts
 import { createHash as createHash4, randomBytes as randomBytes2 } from "node:crypto";
-import { lstat as lstat14, mkdir as mkdir6, readdir as readdir7, realpath as realpath3, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
+import { lstat as lstat12, mkdir as mkdir7, readdir as readdir6, realpath as realpath3, unlink as unlink4, writeFile as writeFile5 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, dirname as dirname2, join as join20 } from "node:path";
+import { basename, dirname as dirname2, join as join18 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
-var info3 = (path3) => lstat14(path3).catch((e) => {
+var info3 = (path3) => lstat12(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
 var comparable = (path3) => process.platform === "win32" ? path3.toLowerCase() : path3;
 async function candidates(root, controls) {
   const key = createHash4("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
-  return { system: join20((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join20(root, ".gitifact", "tmp") };
+  return { system: join18((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join18(root, ".gitifact", "tmp") };
 }
 async function writable(directory) {
   try {
-    await mkdir6(directory, { recursive: true });
+    await mkdir7(directory, { recursive: true });
     const stat3 = await info3(directory);
     if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
-    const probe = join20(directory, ".probe-" + randomBytes2(8).toString("hex"));
-    await writeFile4(probe, "", { flag: "wx" });
+    const probe = join18(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    await writeFile5(probe, "", { flag: "wx" });
     await unlink4(probe);
     return true;
   } catch {
@@ -30199,18 +29881,18 @@ async function prepareAgentInputs(root, controls = {}) {
   if (await writable(system)) directory = system;
   else if (await writable(project)) {
     directory = project;
-    await writeFile4(join20(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+    await writeFile5(join18(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
   if (!directory) return void 0;
   const now = (controls.now ?? Date.now)();
-  for (const name2 of await readdir7(directory).catch(() => [])) {
+  for (const name2 of await readdir6(directory).catch(() => [])) {
     if (name2 === ".gitignore") continue;
-    const stat3 = await info3(join20(directory, name2)).catch(() => void 0);
-    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join20(directory, name2)).catch(() => void 0);
+    const stat3 = await info3(join18(directory, name2)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join18(directory, name2)).catch(() => void 0);
   }
-  return { commit: join20(directory, "commit.json") };
+  return { commit: join18(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
@@ -30232,17 +29914,17 @@ async function discardAgentInput(root, file2, controls = {}) {
 
 // src/commands/commit-files.ts
 import { createHash as createHash5 } from "node:crypto";
-import { lstat as lstat15, readFile as readFile15 } from "node:fs/promises";
-import { join as join21 } from "node:path";
+import { lstat as lstat13, readFile as readFile14 } from "node:fs/promises";
+import { join as join19 } from "node:path";
 var fail3 = (message) => {
   throw new CommandError("INVALID_COMMIT", message);
 };
 var hash2 = (value) => createHash5("sha256").update(value).digest("hex");
-var optional2 = (path3) => readFile15(path3).catch((e) => {
+var optional2 = (path3) => readFile14(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info4 = (path3) => lstat15(path3).catch((e) => {
+var info4 = (path3) => lstat13(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -30254,7 +29936,7 @@ var record3 = (path3) => {
     return false;
   }
 };
-var instructionFile2 = (path3) => {
+var instructionFile = (path3) => {
   try {
     return classifyDocPath(path3).type === "instruction-file";
   } catch {
@@ -30268,14 +29950,14 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join21(root, ...parts.slice(0, i));
+    const target = join19(root, ...parts.slice(0, i));
     const stat3 = await info4(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail3(t2("commitFiles.linkOrDirectory"));
-    if (i < parts.length && await info4(join21(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info4(join19(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail3(t2("commitFiles.hardLinkOrSize"));
-      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile15(target)]));
+      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile14(target)]));
     }
   }
   return null;
@@ -30302,16 +29984,16 @@ function policyPaths(files) {
   }
   return [...all].sort();
 }
-var storeFiles = /* @__PURE__ */ new Set([".gitifact/config.json", LINE_ENDINGS_PATH]);
+var storeFiles = /* @__PURE__ */ new Set([".gitifact/config.json", LINE_ENDINGS_PATH, LAUNCHER_PATH]);
 function checkStoreSelection(selected2) {
   for (const p of selected2.filter((p2) => p2.startsWith(".gitifact/") && !record3(p2) && !storeFiles.has(p2))) {
-    if (!isAssetPath(p) && !instructionFile2(p)) fail3(t2("commitFiles.notRecord", { path: p }));
+    if (!isAssetPath(p) && !instructionFile(p)) fail3(t2("commitFiles.notRecord", { path: p }));
   }
 }
 
 // src/commands/input.ts
-import { readFile as readFile16, stat as stat2 } from "node:fs/promises";
-var LIMIT2 = 1024 * 1024;
+import { readFile as readFile15, stat as stat2 } from "node:fs/promises";
+var LIMIT = 1024 * 1024;
 async function readJsonInput(file2, stdin = process.stdin) {
   const bytes = file2 === "-" ? await readStdin(stdin) : await readInputFile(file2);
   try {
@@ -30322,15 +30004,15 @@ async function readJsonInput(file2, stdin = process.stdin) {
 }
 async function readInputFile(path3) {
   const source2 = await stat2(path3).catch(() => void 0);
-  if (!source2?.isFile() || source2.size > LIMIT2) throw new CommandError("INVALID_INPUT", t2("input.file"));
-  return readFile16(path3);
+  if (!source2?.isFile() || source2.size > LIMIT) throw new CommandError("INVALID_INPUT", t2("input.file"));
+  return readFile15(path3);
 }
 async function readStdin(stream) {
   const chunks = [];
   let size = 0;
   for await (const chunk of stream) {
     size += chunk.length;
-    if (size > LIMIT2) throw new CommandError("INVALID_INPUT", t2("input.size"));
+    if (size > LIMIT) throw new CommandError("INVALID_INPUT", t2("input.size"));
     chunks.push(chunk);
   }
   return Buffer.concat(chunks);
@@ -30404,7 +30086,7 @@ async function commitChanges(cwd, input2, dryRun) {
   if (Object.keys(authorization).sort().join(",") !== "basis,evidence" || !["user-request", "project-policy"].includes(String(authorization.basis))) fail3(t2("commit.authorizationRequired"));
   text3(authorization.evidence, 2e3);
   const message = text3(request.message, 4e3);
-  if (/^\s*Gitifact-/im.test(message)) fail3(t2("commit.trailerInMessage"));
+  if (/^[ \t]*Gitifact-[A-Za-z0-9-]+[ \t]*:/im.test(message)) fail3(t2("commit.trailerInMessage"));
   if (request.migration !== void 0 && request.migration !== true) fail3(t2("commit.migrationFlag"));
   const project = await openProject(cwd, { writing: true });
   const { root, gitDir, indexPath, objectFormat } = project;
@@ -30430,7 +30112,7 @@ async function commitChanges(cwd, input2, dryRun) {
     ...stdin ? { input: stdin } : {}
   });
   const staged = async (index) => (await git(["diff", "--cached", "--ita-visible-in-index", "--name-only", "--no-renames", "-z"], index)).toString("utf8").split("\0").filter(Boolean).sort();
-  const busy = join22(gitDir, "gitifact-changes-commit.lock");
+  const busy = join20(gitDir, "gitifact-changes-commit.lock");
   if (await info4(busy)) fail3(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail3(t2("commit.existingStaging"));
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
@@ -30470,7 +30152,7 @@ async function commitChanges(cwd, input2, dryRun) {
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     return { outcome: "dry-run", committed: false, ...summary, commit: void 0 };
   }
-  const temporary = join22(gitDir, "gitifact-commit-index-" + randomUUID6());
+  const temporary = join20(gitDir, "gitifact-commit-index-" + randomUUID6());
   let owned = false;
   let uncertain = false;
   let commitStarted = false;
@@ -30478,20 +30160,20 @@ async function commitChanges(cwd, input2, dryRun) {
   let committed2;
   try {
     try {
-      await mkdir7(busy);
+      await mkdir8(busy);
       owned = true;
     } catch (e) {
       if (e.code === "EEXIST") fail3(t2("commit.busy", { path: busy }));
       throw e;
     }
-    const lock = indexLock = await open5(indexPath + ".lock", "wx", 384);
+    const lock = indexLock = await open4(indexPath + ".lock", "wx", 384);
     const original = await optional2(indexPath);
     if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail3(t2("commit.indexChanged"));
     const before = await hashes([...started.keys()]);
     for (const [path3, value] of started) if (before.get(path3) !== value) fail3(t2("commit.fileChangedRunning", { path: path3 }));
-    await writeFile5(join22(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
+    await writeFile6(join20(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
     const locked = await hashes([.../* @__PURE__ */ new Set([...selected2, ...contextPaths])]);
-    if (original) await writeFile5(temporary, original, { flag: "wx" });
+    if (original) await writeFile6(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
     await git(["add", "--pathspec-from-file=-", "--pathspec-file-nul"], temporary, Buffer.from(stageable.join("\0")));
     const actual = await staged(temporary);
@@ -30506,14 +30188,14 @@ async function commitChanges(cwd, input2, dryRun) {
         const size = Number(header[2]);
         if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail3(t2("commit.stagedUnreadable", { path: path3 }));
         const blob = output2.subarray(end + 1, end + 1 + size);
-        const file2 = await readFile17(join22(root, path3));
+        const file2 = await readFile16(join20(root, path3));
         if (!blob.equals(file2) && !blob.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail3(t2("commit.filterChanged"));
         offset = end + size + 2;
       }
     }
     const again = await hashes([...locked.keys()]);
     for (const [path3, value] of locked) if (again.get(path3) !== value) fail3(t2("commit.fileChangedPreparing", { path: path3 }));
-    for (const name2 of integration) if (await info4(join22(gitDir, name2))) fail3(t2("commit.integrationStarted"));
+    for (const name2 of integration) if (await info4(join20(gitDir, name2))) fail3(t2("commit.integrationStarted"));
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
     commitStarted = true;
@@ -30528,7 +30210,7 @@ async function commitChanges(cwd, input2, dryRun) {
     if (headers[0] !== "tree " + tree || after.branch !== base.branch || !same2(parents, base.head ? [base.head] : []) || trailers.some((line2) => !body2.split(/\r?\n/).includes(line2))) fail3(t2("commit.resultAltered"));
     if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== indexHash) fail3(t2("commit.indexChangedAfter"));
     if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail3(t2("commit.hookChangedStaging"));
-    await lock.writeFile(await readFile17(temporary));
+    await lock.writeFile(await readFile16(temporary));
     await lock.sync();
     await lock.close();
     await rename4(indexPath + ".lock", indexPath);
@@ -30553,7 +30235,7 @@ async function commitChanges(cwd, input2, dryRun) {
       await unlink5(temporary).catch(() => {
       });
       if (owned) {
-        await unlink5(join22(busy, "recovery.json")).catch(() => {
+        await unlink5(join20(busy, "recovery.json")).catch(() => {
         });
         await rmdir(busy);
       }
@@ -30563,12 +30245,14 @@ async function commitChanges(cwd, input2, dryRun) {
 }
 
 // src/commands/records.ts
-import { readFile as readFile18 } from "node:fs/promises";
-import { join as join23 } from "node:path";
+import { readFile as readFile17 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 var runRecordsNew = (options) => runCommand("records", options.format, async () => {
   if (/[\r\n]/.test(options.title)) throw new CommandError("INVALID_VALUE", t2("docs.singleLine", { field: "title" }));
-  const docs = [...new Set(options.docs.flatMap((d) => d.split(",")).map((d) => d.trim()).filter(Boolean))];
-  if (!docs.length || docs.some((d) => !docIdPattern.test(d))) throw new CommandError("INVALID_VALUE", t2("records.invalidDocs"));
+  const docs = [...new Set(options.docs.flatMap((d) => d.split(/[\s,]+/)).filter(Boolean))];
+  if (!docs.length) throw new CommandError("INVALID_VALUE", t2("records.invalidDocs"));
+  const invalid2 = docs.filter((d) => !docIdPattern.test(d));
+  if (invalid2.length) throw new CommandError("INVALID_VALUE", t2("records.notDocIds", { ids: invalid2.join(", ") }));
   const project = await openProject(process.cwd());
   let id;
   do
@@ -30600,7 +30284,7 @@ var runRecordsShow = (ids, options) => runCommand("records", options.format, asy
   const shown = await Promise.all([...new Set(ids)].map(async (id) => {
     const path3 = await findRecord(project.root, id);
     if (!path3) return { id, missing: true };
-    const source2 = await readFile18(join23(project.root, ...path3.split("/")), "utf8");
+    const source2 = await readFile17(join21(project.root, ...path3.split("/")), "utf8");
     const log = project.reader.decode(await project.reader.run(["log", "-1", "--diff-filter=A", "--format=%H%x00%aN%x00%aI", "--", path3])).trim();
     const [commit, author, date5] = log.split("\0");
     return { id, path: path3, text: source2, commit: commit ? { commit, author, date: date5 } : null };
@@ -30764,11 +30448,11 @@ function newIssueUrl(title, body2, marker2) {
 }
 
 // src/shared/project-config.ts
-import { readFile as readFile19 } from "node:fs/promises";
-import { dirname as dirname3, join as join24 } from "node:path";
+import { readFile as readFile18 } from "node:fs/promises";
+import { dirname as dirname3, join as join22 } from "node:path";
 async function findProjectConfig(from) {
   for (let folder = from; ; folder = dirname3(folder)) {
-    const text4 = await readFile19(join24(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
+    const text4 = await readFile18(join22(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
     if (text4 !== void 0) return { root: folder, text: text4 };
     if (dirname3(folder) === folder) return void 0;
   }
@@ -30830,8 +30514,8 @@ var runFeedback = (options, version2, run) => runCommand("feedback", options.for
 });
 
 // src/commands/update.ts
-import { readFile as readFile20 } from "node:fs/promises";
-import { join as join25 } from "node:path";
+import { readFile as readFile19 } from "node:fs/promises";
+import { join as join23 } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 
 // src/adapters/git/agent-docs-commit.ts
@@ -30855,6 +30539,10 @@ function agentDocsGit(root, inherited = process.env) {
     async commitOnly(paths2, message) {
       await git(["commit", "--only", "-m", message, "--", ...paths2]);
     },
+    // A file Git does not know yet (the launcher on its first update) is marked so `--only` can take it.
+    async intendToAdd(paths2) {
+      await git(["add", "--intent-to-add", "--", ...paths2]);
+    },
     async changedPaths(commit) {
       return (await git(["diff-tree", "--no-commit-id", "--name-only", "--no-renames", "-r", "-z", "--root", commit])).toString("utf8").split("\0").filter(Boolean).sort();
     },
@@ -30868,7 +30556,7 @@ function agentDocsGit(root, inherited = process.env) {
 var CONFIG_PATH = ".gitifact/config.json";
 var updateCommitMessage = (version2) => "chore(gitifact): update project to gitifact v" + version2;
 var commitState = (state2, extra = {}) => ({ state: state2, commit: null, paths: [], message: null, reason: null, detail: null, ...extra });
-var notInitialized = { docs: { state: "not-initialized", paths: [], missing: [] }, project: { state: "not-initialized", cli: null } };
+var notInitialized = { docs: { state: "not-initialized", paths: [] }, project: { state: "not-initialized", cli: null } };
 async function refreshProject(cwd, version2, env, controls) {
   const repo = initRepository(cwd, env);
   let first;
@@ -30884,13 +30572,12 @@ async function refreshProject(cwd, version2, env, controls) {
   const root = first.state.repository.rootPath;
   const parsed2 = needsMigration(config2) ? void 0 : parseManagedConfig(config2);
   const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, language: parsed2?.language, ...controls });
-  const { missing: missing2 } = plan;
-  if (parsed2?.cli && isNewerRelease(parsed2.cli, version2)) return { docs: { state: "kept", paths: plan.paths, missing: missing2, root }, project: { state: "current", cli: parsed2.cli } };
+  if (parsed2?.cli && isNewerRelease(parsed2.cli, version2)) return { docs: { state: "kept", paths: plan.paths, root }, project: { state: "current", cli: parsed2.cli } };
   let current2 = config2;
   const unchanged = async () => {
     if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== current2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
   };
-  const docs = plan.paths.length === 0 ? { state: "no-block", paths: [], missing: missing2, root } : plan.writes.length === 0 ? { state: "current", paths: plan.paths, missing: missing2, root, candidates: plan.paths } : { state: "refreshed", paths: await applyAgentDocs(root, plan, unchanged), missing: missing2, root, candidates: plan.paths };
+  const docs = plan.paths.length === 0 ? { state: "no-block", paths: [], root } : plan.writes.length === 0 ? { state: "current", paths: plan.paths, root, candidates: plan.paths } : { state: "refreshed", paths: await applyAgentDocs(root, plan, unchanged), root, candidates: plan.paths };
   if (!parsed2) return { docs, project: { state: "current", cli: null } };
   const settled2 = settleConfig(parsed2, version2, plan.language);
   if (settled2.changed) {
@@ -30898,6 +30585,7 @@ async function refreshProject(cwd, version2, env, controls) {
     await publishConfig(root, next, unchanged, void 0, true);
     current2 = next;
   }
+  await refreshLauncher(root);
   return { docs: { ...docs, root }, project: { state: settled2.changed ? "written" : "current", cli: settled2.config.cli ?? null } };
 }
 function outsideBlock(text4) {
@@ -30932,7 +30620,7 @@ async function commitUpdate(docs, version2, env) {
     if (before === null || before !== outsideBlock(working2)) return commitState("skipped", { paths: [path3], reason: "other-changes" });
     changed.push(path3);
   }
-  const workingConfig = await readFile20(join25(docs.root, CONFIG_PATH), "utf8").catch(() => null);
+  const workingConfig = await readFile19(join23(docs.root, CONFIG_PATH), "utf8").catch(() => null);
   const committedConfig = head ? await git.committed(head, CONFIG_PATH) : null;
   if (workingConfig !== null && committedConfig?.replace(/\r\n/g, "\n") !== workingConfig.replace(/\r\n/g, "\n")) {
     if (committedConfig === null) return commitState("skipped", { paths: [CONFIG_PATH], reason: "untracked" });
@@ -30940,10 +30628,14 @@ async function commitUpdate(docs, version2, env) {
     if (before === null || !isDeepStrictEqual(before, withoutSettings(workingConfig))) return commitState("skipped", { paths: [CONFIG_PATH], reason: "other-changes" });
     changed.push(CONFIG_PATH);
   }
+  const workingLauncher = await readFile19(join23(docs.root, ...LAUNCHER_PATH.split("/")), "utf8").catch(() => null);
+  const committedLauncher = head ? await git.committed(head, LAUNCHER_PATH) : null;
+  if (workingLauncher !== null && committedLauncher?.replace(/\r\n/g, "\n") !== workingLauncher.replace(/\r\n/g, "\n")) changed.push(LAUNCHER_PATH);
   if (changed.length === 0) return commitState("nothing");
   const message = updateCommitMessage(version2);
   let failure2;
   try {
+    if (workingLauncher !== null && committedLauncher === null) await git.intendToAdd([LAUNCHER_PATH]);
     await git.commitOnly(changed, message);
   } catch (error62) {
     failure2 = error62;
@@ -30970,7 +30662,8 @@ async function updateCommand(cwd, version2, env = process.env, controls = {}) {
     cliVersion: version2,
     update,
     install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
-    agentDocs: { state: docs.state, paths: docs.paths, missing: docs.missing },
+    // missing stays in the v6 result but is always empty since 0.9.0: init no longer adds a CLAUDE.md.
+    agentDocs: { state: docs.state, paths: docs.paths, missing: [] },
     project,
     commit,
     migrationRequired: config2 !== void 0 && needsMigration(config2)
@@ -30986,11 +30679,10 @@ async function runUpdate(options, version2) {
     }
     const lines2 = [t2("update.text.current", { version: dto.cliVersion })];
     lines2.push(dto.update.status === "available" ? t2("update.text.available", { version: dto.update.latestVersion }) : dto.update.status === "up-to-date" ? t2("update.text.upToDate") : dto.update.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable"));
-    if (dto.install) lines2.push(t2("update.text.install", { command: dto.install.npmGlobal }), t2("update.text.afterInstall"));
+    if (dto.install) lines2.push(t2("update.text.install", { command: npxUpdate(dto.update.latestVersion) }), t2("update.text.afterInstall"));
     lines2.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "kept" ? t2("update.text.blockKept", { paths: dto.agentDocs.paths.join(", ") || "-" }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock") : t2("update.text.notInitialized"));
-    if (dto.agentDocs.missing.length) lines2.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", ") }));
     if (dto.project.state === "written") lines2.push(t2("update.text.projectWritten", { path: CONFIG_PATH, version: dto.project.cli ?? dto.cliVersion }));
-    if (dto.project.cli && isNewerRelease(dto.project.cli, dto.cliVersion)) lines2.push(t2("update.text.projectAhead", { project: dto.project.cli, version: dto.cliVersion, command: npmGlobalInstall(dto.project.cli) }));
+    if (dto.project.cli && isNewerRelease(dto.project.cli, dto.cliVersion)) lines2.push(t2("update.text.projectAhead", { project: dto.project.cli, version: dto.cliVersion }));
     if (dto.migrationRequired) lines2.push(t2("update.text.migrationRequired", { version: dto.cliVersion }));
     const { commit } = dto;
     if (commit.state === "committed") lines2.push(t2("update.text.committed", { commit: commit.commit.slice(0, 12), paths: commit.paths.join(", ") }));
@@ -31033,7 +30725,7 @@ async function runUpdateCheck(format2, version2) {
     t2("update.text.current", { version: dto.cliVersion }),
     state2.status === "available" ? t2("update.text.available", { version: state2.latestVersion }) : state2.status === "up-to-date" ? t2("update.text.upToDate") : state2.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable")
   ];
-  if (state2.status === "available") lines2.push(t2("update.text.install", { command: npmGlobalInstall(state2.latestVersion) }), t2("update.text.afterInstall"));
+  if (state2.status === "available") lines2.push(t2("update.text.install", { command: npxUpdate(state2.latestVersion) }), t2("update.text.afterInstall"));
   process.stdout.write(lines2.join("\n") + "\n");
 }
 
@@ -31054,8 +30746,8 @@ function chooseNotice(running2, project, cache, now, scope = { release: true, pr
   return null;
 }
 function noticeText(notice, running2) {
-  if (notice.kind === "project-newer") return t2("notice.projectNewer", { project: notice.project, version: running2, command: npmGlobalInstall(notice.project) });
-  if (notice.kind === "release") return t2("notice.release", { latest: notice.latest, version: running2, command: npmGlobalInstall(notice.latest) });
+  if (notice.kind === "project-newer") return t2("notice.projectNewer", { project: notice.project, version: running2 });
+  if (notice.kind === "release") return t2("notice.release", { latest: notice.latest, version: running2, command: npxUpdate(notice.latest) });
   return t2("notice.projectOlder", { project: notice.project, version: running2 });
 }
 var needsRefresh = (cache, now) => !(cache.checkedAt && now - Date.parse(cache.checkedAt) < REFRESH_AFTER_MS) && !(cache.checkingSince && now - Date.parse(cache.checkingSince) < CHECKING_WINDOW_MS);
@@ -31109,17 +30801,17 @@ for (let i = 0; i < languageArgs.length; i++) {
   if (value === "ko" || value === "en") selectedLanguage = value;
 }
 configureLanguage(selectedLanguage ?? environmentLanguage(), selectedLanguage);
-var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.6").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.9.0").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 program2.hook("preAction", async (_program, action) => {
   let top = action;
   while (top.parent && top.parent !== program2) top = top.parent;
-  if (top.name() !== REFRESH_COMMAND) await noticeVersion("0.8.6", top.name());
+  if (top.name() !== REFRESH_COMMAND) await noticeVersion("0.9.0", top.name());
 });
-program2.command(REFRESH_COMMAND, { hidden: true }).allowExcessArguments(false).action(() => refreshUpdateCache("0.8.6"));
+program2.command(REFRESH_COMMAND, { hidden: true }).allowExcessArguments(false).action(() => refreshUpdateCache("0.9.0"));
 var format = () => new Option("--format <format>", t2("help.format")).choices(formats).default("text");
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.6"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.6"));
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).addOption(new Option("--later", t2("help.updateLater")).conflicts(["check", "commit"])).action((options) => options.later ? runUpdateLater(options.format, "0.8.6") : options.check ? runUpdateCheck(options.format, "0.8.6") : runUpdate(options, "0.8.6"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.9.0"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.9.0"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).addOption(new Option("--later", t2("help.updateLater")).conflicts(["check", "commit"])).action((options) => options.later ? runUpdateLater(options.format, "0.9.0") : options.check ? runUpdateCheck(options.format, "0.9.0") : runUpdate(options, "0.9.0"));
 var listed2 = (command, sorts) => {
   command.allowExcessArguments(false).option("--q <words>", t2("help.listQ")).option("--author <name>", t2("help.listAuthor"));
   if (sorts) command.addOption(new Option("--sort <key>", t2("help.listSort")).choices([...sorts]).default(sorts[0]));
@@ -31129,10 +30821,6 @@ var specs = program2.command("specs").description(t2("help.specs"));
 listed2(specs.command("list").description(t2("help.specsList")).addOption(new Option("--type <kind>", t2("help.specsListType")).choices([...specKinds])).option("--feature <folder>", t2("help.specsListFeature")).option("--without-design", t2("help.specsListWithoutDesign")).option("--uncovered", t2("help.specsListUncovered")).option("--draft", t2("help.specsListDraft")).option("--changed-since <date|commit>", t2("help.specsListChangedSince")), specSorts).action((o) => runSpecsList(o));
 specs.command("show").description(t2("help.specsShow")).argument("<ids...>", t2("help.specsShowIds")).option("--ref <commit>", t2("help.showRef")).addOption(format()).action((ids, o) => runSpecsShow(ids, o));
 specs.command("new").description(t2("help.specsNew")).allowExcessArguments(false).addArgument(new Argument("<kind>", t2("help.specsNewKind")).choices(specKinds)).argument("<path>", t2("help.specsNewPath")).requiredOption("--title <title>", t2("help.newTitle")).requiredOption("--description <text>", t2("help.newDescription")).addOption(new Option("--style <style>", t2("help.specsNewStyle")).choices(specStyles)).addOption(format()).action((kind2, path3, o) => runSpecsNew(kind2, path3, o));
-var instructions = program2.command("instructions").description(t2("help.instructions"));
-listed2(instructions.command("list").description(t2("help.instructionsList")), instructionSorts).action((o) => runInstructionsList(o));
-instructions.command("show").description(t2("help.instructionsShow")).argument("<targets...>", t2("help.instructionsShowTargets")).option("--ref <commit>", t2("help.showRef")).option("--file <path>", t2("help.instructionsShowFile")).addOption(format()).action((targets, o) => runInstructionsShow(targets, o));
-instructions.command("new").description(t2("help.instructionsNew")).allowExcessArguments(false).argument("<name>", t2("help.instructionsNewName")).requiredOption("--title <title>", t2("help.newTitle")).requiredOption("--description <text>", t2("help.newDescription")).addOption(format()).action((name2, o) => runInstructionsNew(name2, o));
 var records = program2.command("records").description(t2("help.records"));
 listed2(records.command("list").description(t2("help.recordsList")).option("--doc <id>", t2("help.recordsListDoc")).option("--since <date|commit>", t2("help.recordsListSince"))).action((o) => runRecordsList(o));
 records.command("show").description(t2("help.recordsShow")).argument("<ids...>", t2("help.recordsShowId")).addOption(format()).action((ids, o) => runRecordsShow(ids, o));
@@ -31141,7 +30829,7 @@ program2.command("check").description(t2("help.check")).allowExcessArguments(fal
 var changes = program2.command("changes").description(t2("help.changes"));
 changes.command("list").description(t2("help.changesList")).allowExcessArguments(false).addOption(format()).action((o) => runChangesList(o));
 changes.command("commit").description(t2("help.changesCommit")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.changesCommitFile")).option("--dry-run", t2("help.changesCommitDryRun")).addOption(format()).action((o) => runChangesCommit(o));
-program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.6"));
+program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.9.0"));
 var guide = program2.command("guide").description(t2("help.guide"));
 guide.command("list").description(t2("help.guideList")).allowExcessArguments(false).addOption(format()).action((o) => runGuideList(o));
 guide.command("show").description(t2("help.guideShow")).argument("<topic>", t2("help.guideTopic")).allowExcessArguments(false).addOption(format()).action((topic, o) => runGuideShow(topic, o));