gitifact 0.1.0 → 0.3.0

package/dist/main.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 var __defProp = Object.defineProperty;
-var __export = (target2, all) => {
+var __export = (target, all) => {
   for (var name in all)
-    __defProp(target2, name, { get: all[name], enumerable: true });
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
 
 // scripts/node-require.mjs
@@ -1635,9 +1635,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @param {string} invalidArgumentMessage
    * @private
    */
-  _callParseArg(target2, value, previous, invalidArgumentMessage) {
+  _callParseArg(target, value, previous, invalidArgumentMessage) {
     try {
-      return target2.parseArg(value, previous);
+      return target.parseArg(value, previous);
     } catch (err) {
       if (err.code === "commander.invalidArgument") {
         const message = `${invalidArgumentMessage} ${err.message}`;
@@ -1926,13 +1926,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @param {string} source - expected values are default/config/env/cli/implied
    * @return {Command} `this` command for chaining
    */
-  setOptionValueWithSource(key, value, source2) {
+  setOptionValueWithSource(key, value, source) {
     if (this._storeOptionsAsProperties) {
       this[key] = value;
     } else {
       this._optionValues[key] = value;
     }
-    this._optionValueSources[key] = source2;
+    this._optionValueSources[key] = source;
     return this;
   }
   /**
@@ -1953,13 +1953,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @return {string}
    */
   getOptionValueSourceWithGlobals(key) {
-    let source2;
+    let source;
     this._getCommandAndAncestors().forEach((cmd) => {
       if (cmd.getOptionValueSource(key) !== void 0) {
-        source2 = cmd.getOptionValueSource(key);
+        source = cmd.getOptionValueSource(key);
       }
     });
-    return source2;
+    return source;
   }
   /**
    * Get user arguments from implied or explicit arguments.
@@ -2826,10 +2826,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
       const optionKey = option2.attributeName();
       const optionValue = this.getOptionValue(optionKey);
       const negativeOption = this.options.find(
-        (target2) => target2.negate && optionKey === target2.attributeName()
+        (target) => target.negate && optionKey === target.attributeName()
       );
       const positiveOption = this.options.find(
-        (target2) => !target2.negate && optionKey === target2.attributeName()
+        (target) => !target.negate && optionKey === target.attributeName()
       );
       if (negativeOption && (negativeOption.presetArg === void 0 && optionValue === false || negativeOption.presetArg !== void 0 && optionValue === negativeOption.presetArg)) {
         return negativeOption;
@@ -2839,8 +2839,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
     const getErrorMessage = (option2) => {
       const bestOption = findBestOptionFromValue(option2);
       const optionKey = bestOption.attributeName();
-      const source2 = this.getOptionValueSource(optionKey);
-      if (source2 === "env") {
+      const source = this.getOptionValueSource(optionKey);
+      if (source === "env") {
         return `environment variable '${bestOption.envVar}'`;
       }
       return `option '${bestOption.flags}'`;
@@ -3492,12 +3492,36 @@ function parseManagedConfig(text2) {
 var SpecPreviewError = class extends Error {
   code = "INVALID_SPEC_PREVIEW";
 };
+var DOCUMENT_KINDS = ["product", "guide"];
+var DOCUMENT_DIRS = { product: ".gitifact/product", guide: ".gitifact/guides" };
+var documentHistoryPath = (kind) => DOCUMENT_DIRS[kind] + "/history.jsonl";
+var PRODUCT_PATH = ".gitifact/product/PRODUCT.md";
+var PRODUCT_ASSET_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,120}\.(?:png|jpe?g|gif|svg|webp)$/i;
+function isProductAssetPath(path3) {
+  const match = /^\.gitifact\/product\/([^/]+)$/.exec(path3);
+  return !!match && PRODUCT_ASSET_NAME.test(match[1]);
+}
 var token = "[a-z2-7]{10}";
 var STORE_DIR = ".gitifact";
 var LEGACY_STORE_DIR = ".tryce";
 var STORE_DIRS = [STORE_DIR, LEGACY_STORE_DIR];
 var marker = "(?:gitifact|tryce)";
-var recordPathPattern = /^\.(?:gitifact|tryce)\/spec\/[^/]+\/(?:requirements\.md|design\.md|history\.jsonl)$/;
+var recordPathPattern = /^(?:\.(?:gitifact|tryce)\/spec\/[^/]+\/(?:requirements\.md|design\.md|history\.jsonl)|\.gitifact\/(?:product|guides)\/(?:(?:[^/]+\/)*[^/]+\.md|history\.jsonl))$/;
+var documentPathPattern = /^\.gitifact\/(product|guides)\/((?:[^/]+\/)*[^/]+\.md)$/;
+var documentHistoryPattern = /^\.gitifact\/(product|guides)\/history\.jsonl$/;
+var kindOfDir = (dir) => dir === "product" ? "product" : "guide";
+var nameToken = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function validateDocumentRelativePath(relative) {
+  const parts = relative.split("/");
+  if (relative.length > 200 || parts.length > 8)
+    fail("\uBB38\uC11C \uACBD\uB85C \uAE4A\uC774 \uB610\uB294 \uAE38\uC774 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4: " + relative);
+  const file2 = parts.pop();
+  if (!file2.endsWith(".md") || !nameToken.test(file2.slice(0, -3)))
+    fail("\uBB38\uC11C \uD30C\uC77C \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uACFC .md\uC5EC\uC57C \uD569\uB2C8\uB2E4: " + relative);
+  for (const part of parts)
+    if (!nameToken.test(part) || part.length > 80)
+      fail("\uBB38\uC11C \uD3F4\uB354 \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: " + relative);
+}
 var storeRelative = (path3) => path3.replace(/^\.(?:gitifact|tryce)\//, "");
 var reqId = new RegExp(`^R-${token}$`);
 var fail = (message) => {
@@ -3512,10 +3536,10 @@ function renderDesignPreview(id, design) {
 ${design.body}
 `;
 }
-function parseDesignPreview(source2, specId) {
-  if (source2.includes("\0") || /\r(?!\n)/.test(source2))
+function parseDesignPreview(source, specId) {
+  if (source.includes("\0") || /\r(?!\n)/.test(source))
     fail("\uC798\uBABB\uB41C \uC124\uACC4 \uBB38\uC790\uC785\uB2C8\uB2E4.");
-  const lines = normalized(source2).split("\n");
+  const lines = normalized(source).split("\n");
   if (!new RegExp(`^<!-- ${marker}-design: ${specId} -->$`).test(lines.shift() ?? ""))
     fail("\uC124\uACC4\uC758 gitifact-design ID\uB294 \uAC19\uC740 \uAE30\uB2A5\uC758 S-ID\uC5EC\uC57C \uD569\uB2C8\uB2E4.");
   while (lines[0] === "")
@@ -3556,27 +3580,138 @@ function parseDesignPreview(source2, specId) {
     fail("\uC124\uACC4 \uCF54\uB4DC \uBE14\uB85D\uC774 \uB2EB\uD788\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
   return { title, body, requirements: [...references] };
 }
+function renderDocument(doc) {
+  return `<!-- gitifact-${doc.kind}: ${doc.id} -->
+
+# ${doc.title}
+
+${doc.body}
+`;
+}
+function parseDocument(path3, source) {
+  const match = documentPathPattern.exec(path3);
+  if (!match)
+    fail("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBB38\uC11C \uACBD\uB85C: " + path3);
+  const kind = kindOfDir(match[1]);
+  if (kind === "product") {
+    if (path3 !== PRODUCT_PATH)
+      fail("\uC81C\uD488 \uD3F4\uB354\uC5D0\uB294 PRODUCT.md \uD558\uB098\uB9CC \uB461\uB2C8\uB2E4: " + path3);
+  } else
+    validateDocumentRelativePath(match[2]);
+  if (source.includes("\0") || /\r(?!\n)/.test(source))
+    fail("\uC798\uBABB\uB41C \uBB38\uC11C \uBB38\uC790: " + path3);
+  const lines = normalized(source).split("\n");
+  const id = new RegExp(`^<!-- gitifact-${kind}: ([PG]-${token}) -->$`).exec(lines.shift() ?? "")?.[1];
+  if (!id || id[0] !== (kind === "product" ? "P" : "G"))
+    return fail(`\uCCAB \uC904\uC5D0 \uC720\uD6A8\uD55C gitifact-${kind} \uC8FC\uC11D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: ` + path3);
+  while (lines[0] === "")
+    lines.shift();
+  const heading = lines.shift();
+  if (!heading?.startsWith("# ") || !heading.slice(2).trim())
+    fail("\uBB38\uC11C \uC81C\uBAA9\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: " + path3);
+  const title = heading.slice(2).trim();
+  const body = normalized(lines.join("\n"));
+  if (!body)
+    fail("\uBB38\uC11C \uBCF8\uBB38\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: " + path3);
+  let fence;
+  for (const line of body.split("\n")) {
+    if (fence) {
+      if (new RegExp(`^ {0,3}${fence.char}{${fence.size},}\\s*$`).test(line))
+        fence = void 0;
+      continue;
+    }
+    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+    if (open6) {
+      fence = { char: open6[1][0], size: open6[1].length };
+      continue;
+    }
+    if (/^#\s/.test(line))
+      fail("\uBB38\uC11C \uCD5C\uC0C1\uC704 \uC81C\uBAA9\uC740 \uD558\uB098\uB9CC \uC501\uB2C8\uB2E4: " + path3);
+    if (/<!-- (?:gitifact|tryce)-/.test(line))
+      fail("\uBB38\uC11C \uBCF8\uBB38\uC5D0\uB294 gitifact \uC8FC\uC11D\uC744 \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + path3);
+  }
+  if (fence)
+    fail("\uBB38\uC11C \uCF54\uB4DC \uBE14\uB85D\uC774 \uB2EB\uD788\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4: " + path3);
+  return { id, kind, path: path3, title, body };
+}
+function parseDocumentFiles(files) {
+  const sets = DOCUMENT_KINDS.map((kind) => ({ kind, documents: [], history: parsePreviewHistory(files.get(documentHistoryPath(kind)) ?? "", "documents") }));
+  for (const [path3, source] of files) {
+    if (!documentPathPattern.test(path3))
+      continue;
+    const doc = parseDocument(path3, source);
+    sets.find((s) => s.kind === doc.kind).documents.push(doc);
+  }
+  for (const set2 of sets)
+    set2.documents.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+  validateDocumentSets(sets);
+  return sets;
+}
+function validateDocumentSets(sets) {
+  const ids = /* @__PURE__ */ new Set();
+  const paths2 = /* @__PURE__ */ new Set();
+  const historyIds = /* @__PURE__ */ new Set();
+  if (sets.map((s) => s.kind).sort().join(",") !== "guide,product")
+    fail("\uBB38\uC11C \uC885\uB958 \uC9D1\uD569\uC774 \uC798\uBABB\uB410\uC2B5\uB2C8\uB2E4.");
+  for (const set2 of sets) {
+    for (const d of set2.documents) {
+      if (d.kind !== set2.kind)
+        fail("\uBB38\uC11C \uC885\uB958\uAC00 \uD3F4\uB354\uC640 \uB2E4\uB985\uB2C8\uB2E4: " + d.path);
+      if (ids.has(d.id))
+        fail("\uC800\uC7A5\uC18C \uB0B4 \uC911\uBCF5 \uBB38\uC11C ID: " + d.id);
+      ids.add(d.id);
+      const lower = d.path.toLowerCase();
+      if (paths2.has(lower))
+        fail("\uB300\uC18C\uBB38\uC790\uB9CC \uB2E4\uB978 \uBB38\uC11C \uACBD\uB85C: " + d.path);
+      paths2.add(lower);
+    }
+    for (const h of set2.history) {
+      if (historyIds.has(h.id))
+        fail("\uC800\uC7A5\uC18C \uB0B4 \uC911\uBCF5 \uBCF4\uC870 \uAE30\uB85D ID: " + h.id);
+      historyIds.add(h.id);
+    }
+  }
+}
+var emptyDocumentSets = () => DOCUMENT_KINDS.map((kind) => ({ kind, documents: [], history: [] }));
+var asBundle = (value) => Array.isArray(value) ? { specs: value, documents: emptyDocumentSets() } : value;
+function parsePreviewBundle(files) {
+  const bundle = { specs: parsePreviewFiles(files), documents: parseDocumentFiles(files) };
+  validateBundle(bundle);
+  return bundle;
+}
+function validateBundle(bundle) {
+  validatePreviewSnapshot(bundle.specs);
+  validateDocumentSets(bundle.documents);
+  const ids = /* @__PURE__ */ new Set();
+  for (const h of [...bundle.specs.flatMap((s) => s.history), ...bundle.documents.flatMap((d) => d.history)]) {
+    if (ids.has(h.id))
+      fail("\uC800\uC7A5\uC18C \uB0B4 \uC911\uBCF5 \uBCF4\uC870 \uAE30\uB85D ID: " + h.id);
+    ids.add(h.id);
+  }
+}
 function designReferenceWarnings(specs) {
   const known = new Set(specs.flatMap((s) => s.requirements.map((r) => r.id)));
   return specs.flatMap((s) => (s.design?.requirements ?? []).filter((id) => !known.has(id)).map((id) => ({ specId: s.id, requirement: id, code: "MISSING_DESIGN_REFERENCE" })));
 }
 function parsePreviewFiles(files) {
   const specs = [];
-  for (const [path3, source2] of files) {
+  for (const [path3, source] of files) {
+    if (documentPathPattern.test(path3) || documentHistoryPattern.test(path3))
+      continue;
     if (path3.endsWith("/requirements.md")) {
-      specs.push(parseSpecPreview(path3, source2, files.get(path3.replace(/requirements\.md$/, "history.jsonl")) ?? "", files.get(path3.replace(/requirements\.md$/, "design.md"))));
+      specs.push(parseSpecPreview(path3, source, files.get(path3.replace(/requirements\.md$/, "history.jsonl")) ?? "", files.get(path3.replace(/requirements\.md$/, "design.md"))));
     } else if (!files.has(path3.replace(/(?:history\.jsonl|design\.md)$/, "requirements.md")))
       fail("\uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C \uC5C6\uB294 \uC124\uACC4 \uB610\uB294 \uC774\uC720 \uD30C\uC77C: " + path3);
   }
   validatePreviewSnapshot(specs);
   return specs;
 }
-function parseSpecPreview(path3, source2, history = "", designSource) {
+function parseSpecPreview(path3, source, history = "", designSource) {
   if (!/^\.(?:gitifact|tryce)\/spec\/[^/]+\/requirements\.md$/.test(path3))
     fail("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBA85\uC138 \uACBD\uB85C: " + path3);
-  if (source2.includes("\0") || source2.includes("\r") && /\r(?!\n)/.test(source2))
+  if (source.includes("\0") || source.includes("\r") && /\r(?!\n)/.test(source))
     fail("\uC798\uBABB\uB41C \uBA85\uC138 \uBB38\uC790: " + path3);
-  const lines = normalized(source2).split("\n");
+  const lines = normalized(source).split("\n");
   const specMatch = new RegExp(`^<!-- ${marker}-spec: (S-${token}) -->$`).exec(lines[0] ?? "");
   if (!specMatch)
     fail("\uCCAB \uC904\uC5D0 \uC720\uD6A8\uD55C gitifact-spec \uC8FC\uC11D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: " + path3);
@@ -3651,10 +3786,11 @@ function parseSpecPreview(path3, source2, history = "", designSource) {
   }
   return { id: specMatch[1], path: path3, title, description: normalized(description), requirements, history: parsePreviewHistory(history), ...designSource === void 0 ? {} : { design: parseDesignPreview(designSource, specMatch[1]) } };
 }
-function parsePreviewHistory(source2) {
+function parsePreviewHistory(source, scope = "spec") {
   const records = [];
   const ids = /* @__PURE__ */ new Set();
-  for (const line of source2.replace(/\r\n/g, "\n").split("\n")) {
+  const shapes = scope === "spec" ? ["id,reason,requirements", "designs,id,reason,requirements"] : ["documents,id,reason,requirements"];
+  for (const line of source.replace(/\r\n/g, "\n").split("\n")) {
     if (!line.trim())
       continue;
     let value;
@@ -3666,10 +3802,10 @@ function parsePreviewHistory(source2) {
     if (!value || typeof value !== "object" || Array.isArray(value))
       fail("\uC798\uBABB\uB41C \uBCF4\uC870 \uAE30\uB85D\uC785\uB2C8\uB2E4.");
     const r = value;
-    if (!["id,reason,requirements", "designs,id,reason,requirements"].includes(Object.keys(r).sort().join(",")) || typeof r.id !== "string" || !new RegExp(`^H-${token}$`).test(r.id) || ids.has(r.id) || typeof r.reason !== "string" || !r.reason.trim() || !Array.isArray(r.requirements) || !r.requirements.length && !Array.isArray(r.designs) || r.designs !== void 0 && (!Array.isArray(r.designs) || !r.designs.length || r.designs.some((id) => typeof id !== "string" || !/^S-[a-z2-7]{10}$/.test(id)) || new Set(r.designs).size !== r.designs.length) || r.requirements.some((id) => typeof id !== "string" || !reqId.test(id)) || new Set(r.requirements).size !== r.requirements.length)
+    if (!shapes.includes(Object.keys(r).sort().join(",")) || typeof r.id !== "string" || !new RegExp(`^H-${token}$`).test(r.id) || ids.has(r.id) || typeof r.reason !== "string" || !r.reason.trim() || !Array.isArray(r.requirements) || !r.requirements.length && !Array.isArray(r.designs) && !Array.isArray(r.documents) || r.documents !== void 0 && (r.requirements.length || !Array.isArray(r.documents) || !r.documents.length || r.documents.some((id) => typeof id !== "string" || !/^[PG]-[a-z2-7]{10}$/.test(id)) || new Set(r.documents).size !== r.documents.length) || r.designs !== void 0 && (!Array.isArray(r.designs) || !r.designs.length || r.designs.some((id) => typeof id !== "string" || !/^S-[a-z2-7]{10}$/.test(id)) || new Set(r.designs).size !== r.designs.length) || r.requirements.some((id) => typeof id !== "string" || !reqId.test(id)) || new Set(r.requirements).size !== r.requirements.length)
       fail("\uBCF4\uC870 \uAE30\uB85D\uC758 \uD544\uB4DC\xB7ID\xB7\uB300\uC0C1\uC774 \uC798\uBABB\uB410\uC2B5\uB2C8\uB2E4.");
     ids.add(r.id);
-    records.push({ id: r.id, requirements: r.requirements, ...r.designs === void 0 ? {} : { designs: r.designs }, reason: r.reason });
+    records.push({ id: r.id, requirements: r.requirements, ...r.designs === void 0 ? {} : { designs: r.designs }, ...r.documents === void 0 ? {} : { documents: r.documents }, reason: r.reason });
   }
   return records;
 }
@@ -3743,6 +3879,50 @@ function compareSpecPreviews(before, after) {
   });
   return { specChanges, changes };
 }
+function compareDocumentSets(before, after) {
+  validateDocumentSets(before);
+  validateDocumentSets(after);
+  const index = (sets) => new Map(sets.flatMap((s) => s.documents.map((d) => [d.id, { id: d.id, title: d.title, body: d.body, specId: d.kind, path: d.path }])));
+  const prev = index(before);
+  const next = index(after);
+  const previousHistory = new Map(before.flatMap((s) => s.history.map((h) => [h.id, h])));
+  const reasons = after.flatMap((s) => s.history).filter((h) => {
+    const old = previousHistory.get(h.id);
+    if (old && JSON.stringify(old) !== JSON.stringify(h))
+      fail("\uAE30\uC874 \uBCF4\uC870 \uAE30\uB85D\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + h.id);
+    return !old;
+  });
+  const changes = [.../* @__PURE__ */ new Set([...prev.keys(), ...next.keys()])].sort().flatMap((id) => {
+    const from = prev.get(id) ?? null;
+    const to = next.get(id) ?? null;
+    const types = [];
+    if (!from)
+      types.push("created");
+    else if (!to)
+      types.push("deleted");
+    else {
+      if (from.path !== to.path)
+        types.push("moved");
+      if (from.title !== to.title || from.body !== to.body)
+        types.push("modified");
+    }
+    const kind = (to ?? from).specId;
+    return types.length ? [{ id, types, before: from, after: to, kind, reasons: reasons.filter((h) => (h.documents ?? []).includes(id)) }] : [];
+  });
+  const changed = new Set(changes.map((c) => c.id));
+  for (const h of reasons)
+    if ((h.documents ?? []).some((id) => !changed.has(id)))
+      fail("\uC0C8 \uBCF4\uC870 \uAE30\uB85D\uC774 \uC774\uBC88 \uBB38\uC11C \uBCC0\uACBD\uACFC \uC5F0\uACB0\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + h.id);
+  return changes;
+}
+function comparePreviewBundles(before, after) {
+  const a = asBundle(before);
+  const b = asBundle(after);
+  validateBundle(a);
+  validateBundle(b);
+  const specs = compareSpecPreviews(a.specs, b.specs);
+  return { specChanges: specs.specChanges, changes: [...specs.changes, ...compareDocumentSets(a.documents, b.documents)] };
+}
 
 // ../../packages/core/dist/use-cases/edit-spec-preview.js
 var fail2 = (message) => {
@@ -3769,9 +3949,11 @@ ${r.body}
 function editSpecPreview(original, input2, generate) {
   if (!Array.isArray(input2) || !input2.length || input2.length > 100)
     fail2("operations\uB294 1~100\uAC1C\uC5EC\uC57C \uD569\uB2C8\uB2E4.");
-  const specs = original.map((s) => ({ ...s, requirements: s.requirements.map((r) => ({ ...r })), history: s.history.map((h) => ({ ...h, requirements: [...h.requirements] })) }));
-  validatePreviewSnapshot(specs);
-  const used = new Set(specs.flatMap((s) => [s.id, ...s.requirements.map((r) => r.id)]));
+  const source = asBundle(original);
+  const specs = source.specs.map((s) => ({ ...s, requirements: s.requirements.map((r) => ({ ...r })), history: s.history.map((h) => ({ ...h, requirements: [...h.requirements] })) }));
+  const documents = source.documents.map((set2) => ({ ...set2, documents: set2.documents.map((d) => ({ ...d })), history: set2.history.map((h) => ({ ...h })) }));
+  validateBundle({ specs, documents });
+  const used = /* @__PURE__ */ new Set([...specs.flatMap((s) => [s.id, ...s.requirements.map((r) => r.id)]), ...documents.flatMap((d) => d.documents.map((x) => x.id))]);
   const allocate = (prefix) => {
     for (let attempt = 0; attempt < 100; attempt++) {
       const id = generate(prefix);
@@ -3796,7 +3978,13 @@ function editSpecPreview(original, input2, generate) {
       move: ["type", "id", "feature"],
       "rename-spec": ["type", "id", "title"],
       "set-design": ["type", "feature", "title", "body"],
-      "delete-design": ["type", "feature"]
+      "delete-design": ["type", "feature"],
+      "create-doc": ["type", "path", "title", "body"],
+      "update-doc": ["type", "id", "title", "body"],
+      "move-doc": ["type", "id", "path"],
+      "delete-doc": ["type", "id"],
+      "set-product": ["type", "title", "body"],
+      "delete-product": ["type"]
     };
     const type = String(op.type);
     const fields2 = schemas[type];
@@ -3812,10 +4000,63 @@ function editSpecPreview(original, input2, generate) {
         fail2("\uC798\uBABB\uB41C \uD3B8\uC9D1 \uBB38\uC790: " + key);
       return value;
     };
-    const target2 = () => {
+    const target = () => {
       const path3 = previewPath(str("feature"));
       return specs.find((s) => s.path === path3) ?? fail2("\uB300\uC0C1 \uBA85\uC138\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: " + path3);
     };
+    if (type === "set-product" || type === "delete-product") {
+      const set2 = documents.find((s) => s.kind === "product");
+      const existing = set2.documents[0];
+      if (type === "delete-product") {
+        if (!existing)
+          fail2("\uC0AD\uC81C\uD560 \uC81C\uD488 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+        set2.documents = [];
+        results.push({ type, id: existing.id });
+      } else {
+        const doc = { id: existing?.id ?? allocate("P"), kind: "product", path: PRODUCT_PATH, title: str("title"), body: str("body") };
+        set2.documents = [doc];
+        results.push({ type, id: doc.id });
+      }
+      continue;
+    }
+    if (type.endsWith("-doc")) {
+      const all = () => documents.filter((set2) => set2.kind === "guide").flatMap((set2) => set2.documents);
+      const documentPath = (kind, self) => {
+        const relative = str("path");
+        validateDocumentRelativePath(relative);
+        const path3 = `${DOCUMENT_DIRS[kind]}/${relative}`;
+        if (self && self.path === path3)
+          fail2("\uC774\uBBF8 \uAC19\uC740 \uACBD\uB85C\uC785\uB2C8\uB2E4.");
+        if (all().some((d) => d !== self && d.path.toLowerCase() === path3.toLowerCase()))
+          fail2("\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uBB38\uC11C \uACBD\uB85C\uC785\uB2C8\uB2E4: " + path3);
+        return path3;
+      };
+      const find = () => {
+        const id = str("id");
+        return all().find((d) => d.id === id) ?? fail2("\uC9C0\uCE68 \uBB38\uC11C ID\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: " + id);
+      };
+      if (type === "create-doc") {
+        const kind = "guide";
+        const doc = { id: allocate("G"), kind, path: documentPath(kind), title: str("title"), body: str("body") };
+        documents.find((s) => s.kind === kind).documents.push(doc);
+        results.push({ type, id: doc.id });
+      } else if (type === "update-doc") {
+        const doc = find();
+        doc.title = str("title");
+        doc.body = str("body");
+        results.push({ type, id: doc.id });
+      } else if (type === "move-doc") {
+        const doc = find();
+        doc.path = documentPath(doc.kind, doc);
+        results.push({ type, id: doc.id });
+      } else {
+        const doc = find();
+        const set2 = documents.find((s) => s.kind === doc.kind);
+        set2.documents = set2.documents.filter((d) => d.id !== doc.id);
+        results.push({ type, id: doc.id });
+      }
+      continue;
+    }
     if (type === "create") {
       const path3 = previewPath(str("feature"));
       if (specs.some((s) => s.path.toLowerCase() === path3.toLowerCase()))
@@ -3824,12 +4065,12 @@ function editSpecPreview(original, input2, generate) {
       specs.push(spec2);
       results.push({ type, id: spec2.id });
     } else if (type === "add") {
-      const spec2 = target2();
+      const spec2 = target();
       const req = { id: allocate("R"), title: str("title"), body: str("body") };
       spec2.requirements.push(req);
       results.push({ type, id: req.id });
     } else if (type === "set-design" || type === "delete-design") {
-      const spec2 = target2();
+      const spec2 = target();
       if (type === "delete-design") {
         if (!spec2.design)
           fail2("\uC0AD\uC81C\uD560 \uC124\uACC4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
@@ -3846,7 +4087,7 @@ function editSpecPreview(original, input2, generate) {
       const source2 = specs.find((s) => s.requirements.some((r) => r.id === id)) ?? fail2("\uC694\uAD6C\uC0AC\uD56D ID\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
       const req = source2.requirements.find((r) => r.id === id);
       if (type === "move") {
-        const destination = target2();
+        const destination = target();
         if (source2 === destination)
           fail2("\uC774\uBBF8 \uAC19\uC740 \uBA85\uC138\uC5D0 \uC18D\uD569\uB2C8\uB2E4.");
         source2.requirements = source2.requirements.filter((r) => r.id !== id);
@@ -3863,8 +4104,14 @@ function editSpecPreview(original, input2, generate) {
     if (JSON.stringify({ ...parsed, history: spec2.history }) !== JSON.stringify(spec2))
       fail2("\uBCF8\uBB38\uC774 \uBA85\uC138 \uAD6C\uC870\uB97C \uBCC0\uACBD\uD569\uB2C8\uB2E4.");
   }
-  validatePreviewSnapshot(specs);
-  return { specs, results };
+  for (const set2 of documents) {
+    set2.documents.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    for (const doc of set2.documents)
+      if (JSON.stringify(parseDocument(doc.path, renderDocument(doc))) !== JSON.stringify(doc))
+        fail2("\uBCF8\uBB38\uC774 \uBB38\uC11C \uAD6C\uC870\uB97C \uBCC0\uACBD\uD569\uB2C8\uB2E4: " + doc.path);
+  }
+  validateBundle({ specs, documents });
+  return { specs, documents, results };
 }
 
 // ../../packages/core/dist/use-cases/prepare-spec-preview.js
@@ -3873,27 +4120,50 @@ var fail3 = (message) => {
 };
 var equal = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 var historyPath = (s) => s.path.replace(/requirements\.md$/, "history.jsonl");
-function finalSpecPreviewChanges(before, current) {
-  validatePreviewSnapshot(before);
-  validatePreviewSnapshot(current);
-  for (const previous of before) {
-    const next = current.find((s) => s.id === previous.id);
+function pendingPreviewReasons(before, current) {
+  const a = asBundle(before);
+  const b = asBundle(current);
+  return [
+    ...b.specs.flatMap((s) => s.history.slice(a.specs.find((p) => p.id === s.id)?.history.length ?? 0).map((h) => ({ specId: s.id, path: historyPath(s), ...h }))),
+    ...b.documents.flatMap((d) => d.history.slice(a.documents.find((p) => p.kind === d.kind)?.history.length ?? 0).map((h) => ({ kind: d.kind, path: documentHistoryPath(d.kind), ...h })))
+  ];
+}
+function finalSpecPreviewChanges(beforeValue, currentValue) {
+  const before = asBundle(beforeValue);
+  const current = asBundle(currentValue);
+  validateBundle(before);
+  validateBundle(current);
+  for (const previous of before.specs) {
+    const next = current.specs.find((s) => s.id === previous.id);
     if (previous.history.length && !next)
       fail3("\uAE30\uC874 \uC774\uC720\uB97C \uBCF4\uC874\uD560 \uBE48 \uBA85\uC138\uB97C \uB0A8\uACA8\uC8FC\uC138\uC694: " + previous.id);
     if (next && !equal(next.history.slice(0, previous.history.length), previous.history))
       fail3("\uCEE4\uBC0B\uB41C \uC774\uC720\uC758 \uC218\uC815\xB7\uC0AD\uC81C\xB7\uC7AC\uBC30\uCE58\uB294 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + previous.id);
   }
-  const clean = current.map((s) => ({ ...s, history: before.find((p) => p.id === s.id)?.history ?? [] }));
-  return compareSpecPreviews(before, clean);
+  for (const previous of before.documents) {
+    const next = current.documents.find((s) => s.kind === previous.kind);
+    if (!equal(next.history.slice(0, previous.history.length), previous.history))
+      fail3("\uCEE4\uBC0B\uB41C \uBB38\uC11C \uC774\uC720\uC758 \uC218\uC815\xB7\uC0AD\uC81C\xB7\uC7AC\uBC30\uCE58\uB294 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + previous.kind);
+  }
+  const clean = {
+    specs: current.specs.map((s) => ({ ...s, history: before.specs.find((p) => p.id === s.id)?.history ?? [] })),
+    documents: current.documents.map((d) => ({ ...d, history: before.documents.find((p) => p.kind === d.kind)?.history ?? [] }))
+  };
+  return comparePreviewBundles(before, clean);
 }
-function prepareSpecPreview(before, current, baseFiles, currentFiles, input2, generate) {
-  const delta = finalSpecPreviewChanges(before, current);
+function prepareSpecPreview(beforeValue, currentValue, baseFiles, currentFiles, input2, generate) {
+  const beforeBundle = asBundle(beforeValue);
+  const currentBundle = asBundle(currentValue);
+  const before = beforeBundle.specs;
+  const current = currentBundle.specs;
+  const delta = finalSpecPreviewChanges(beforeBundle, currentBundle);
   if (!Array.isArray(input2) || input2.length > 100)
     fail3("reasons\uB294 \uCD5C\uB300 100\uAC1C\uC758 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.");
   const writes = /* @__PURE__ */ new Map();
   const pending = /* @__PURE__ */ new Map();
   const covered = /* @__PURE__ */ new Set();
-  const used = new Set([...before, ...current].flatMap((s) => s.history.map((h) => h.id)));
+  const used = new Set([...before.flatMap((s) => s.history), ...current.flatMap((s) => s.history), ...beforeBundle.documents.flatMap((d) => d.history), ...currentBundle.documents.flatMap((d) => d.history)].map((h) => h.id));
+  const documentPending = /* @__PURE__ */ new Map();
   const allocate = () => {
     for (let attempt = 0; attempt < 100; attempt++) {
       const id = generate();
@@ -3910,10 +4180,32 @@ function prepareSpecPreview(before, current, baseFiles, currentFiles, input2, ge
     if (!value || typeof value !== "object" || Array.isArray(value))
       fail3("\uC798\uBABB\uB41C \uC774\uC720 \uC785\uB825\uC785\uB2C8\uB2E4.");
     const raw = value;
-    if (!["reason,requirements", "designs,reason,requirements"].includes(Object.keys(raw).sort().join(",")) || typeof raw.reason !== "string" || !raw.reason.trim() || raw.reason.includes("\0") || raw.reason.length > 16e3 || !Array.isArray(raw.requirements) || raw.designs !== void 0 && !Array.isArray(raw.designs) || !(raw.requirements.length || raw.designs?.length))
+    const shape = Object.keys(raw).sort().join(",");
+    if (!["reason,requirements", "designs,reason,requirements", "documents,reason,requirements"].includes(shape) || typeof raw.reason !== "string" || !raw.reason.trim() || raw.reason.includes("\0") || raw.reason.length > 16e3 || !Array.isArray(raw.requirements) || raw.designs !== void 0 && !Array.isArray(raw.designs) || raw.documents !== void 0 && !Array.isArray(raw.documents) || !(raw.requirements.length || raw.designs?.length || raw.documents?.length))
       fail3("\uC774\uC720\uC640 \uB300\uC0C1 \uC694\uAD6C\uC0AC\uD56D\uC744 \uD655\uC778\uD558\uC138\uC694.");
     const reason = raw.reason.trim();
     const groups = /* @__PURE__ */ new Map();
+    if (raw.documents !== void 0) {
+      if (raw.requirements.length)
+        fail3("\uBB38\uC11C \uC774\uC720\uC5D0\uB294 \uC694\uAD6C\uC0AC\uD56D\uC744 \uD568\uAED8 \uC9C0\uC815\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+      const ids = raw.documents;
+      let kind;
+      for (const value2 of ids) {
+        if (typeof value2 !== "string" || !/^[PG]-[a-z2-7]{10}$/.test(value2) || covered.has(value2))
+          return fail3("\uBB38\uC11C \uC774\uC720 \uB300\uC0C1\uC774 \uC798\uBABB\uB410\uAC70\uB098 \uC911\uBCF5\uB429\uB2C8\uB2E4.");
+        const change2 = delta.changes.find((c) => c.id === value2) ?? fail3("\uCD5C\uC885 \uBCC0\uACBD\uC774 \uC5C6\uB294 \uBB38\uC11C\uC5D0 \uC774\uC720\uB97C \uBD99\uC77C \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: " + value2);
+        if (kind && change2.kind !== kind)
+          fail3("\uD55C \uC774\uC720\uB294 \uD55C \uC885\uB958\uC758 \uBB38\uC11C\uB9CC \uB300\uC0C1\uC73C\uB85C \uD569\uB2C8\uB2E4.");
+        kind = change2.kind;
+        covered.add(value2);
+      }
+      const documents = [...ids].sort();
+      const set2 = currentBundle.documents.find((d) => d.kind === kind);
+      const oldCount = beforeBundle.documents.find((d) => d.kind === kind)?.history.length ?? 0;
+      const reusable = set2.history.slice(oldCount).find((h) => h.reason === reason && equal([...h.documents ?? []].sort(), documents));
+      documentPending.set(kind, [...documentPending.get(kind) ?? [], { id: reusable?.id ?? allocate(), requirements: [], documents, reason }]);
+      continue;
+    }
     for (const value2 of [...raw.requirements, ...raw.designs ?? []]) {
       if (typeof value2 !== "string")
         fail3("\uC798\uBABB\uB41C \uC774\uC720 \uB300\uC0C1\uC785\uB2C8\uB2E4.");
@@ -3951,11 +4243,22 @@ function prepareSpecPreview(before, current, baseFiles, currentFiles, input2, ge
     if ((currentFiles.get(path3) ?? null) !== next)
       writes.set(path3, next);
   }
+  for (const set2 of currentBundle.documents) {
+    const path3 = documentHistoryPath(set2.kind);
+    const base = baseFiles.get(path3);
+    const records = (documentPending.get(set2.kind) ?? []).sort((a, b) => a.documents[0] < b.documents[0] ? -1 : 1);
+    let text2 = base ?? "";
+    if (records.length)
+      text2 += (text2 && !text2.endsWith("\n") ? "\n" : "") + records.map((h) => JSON.stringify(h) + "\n").join("");
+    const next = base !== void 0 || records.length ? text2 : null;
+    if ((currentFiles.get(path3) ?? null) !== next)
+      writes.set(path3, next);
+  }
   return {
     writes,
     changes: delta.changes,
     specChanges: delta.specChanges,
-    reasons: [...pending].flatMap(([specId, records]) => records.map((record3) => ({ specId, ...record3 }))),
+    reasons: [...[...pending].flatMap(([specId, records]) => records.map((record3) => ({ specId, ...record3 }))), ...[...documentPending].flatMap(([kind, records]) => records.map((record3) => ({ kind, ...record3 })))],
     withoutReason: delta.changes.filter((c) => !covered.has(c.id)).map((c) => c.id)
   };
 }
@@ -4908,10 +5211,10 @@ function cached(getter) {
 function nullish(input2) {
   return input2 === null || input2 === void 0;
 }
-function cleanRegex(source2) {
-  const start = source2.startsWith("^") ? 1 : 0;
-  const end = source2.endsWith("$") ? source2.length - 1 : source2.length;
-  return source2.slice(start, end);
+function cleanRegex(source) {
+  const start = source.startsWith("^") ? 1 : 0;
+  const end = source.endsWith("$") ? source.length - 1 : source.length;
+  return source.slice(start, end);
 }
 function floatSafeRemainder(val, step) {
   const ratio = val / step;
@@ -4947,8 +5250,8 @@ function defineLazy(object4, key, getter) {
 function objectClone(obj) {
   return Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj));
 }
-function assignProp(target2, prop, value) {
-  Object.defineProperty(target2, prop, {
+function assignProp(target, prop, value) {
+  Object.defineProperty(target, prop, {
     value,
     writable: true,
     enumerable: true,
@@ -4962,8 +5265,8 @@ function rawShape(def) {
 function sourceShape(schema) {
   return rawShape(schema._zod.def) ?? schema._zod.def.shape;
 }
-function deferProp(target2, key, getter) {
-  Object.defineProperty(target2, key, {
+function deferProp(target, key, getter) {
+  Object.defineProperty(target, key, {
     get() {
       const value = getter();
       assignProp(this, key, value);
@@ -4973,36 +5276,36 @@ function deferProp(target2, key, getter) {
     configurable: true
   });
 }
-function putProp(target2, key, value) {
-  if (key in target2)
-    assignProp(target2, key, value);
+function putProp(target, key, value) {
+  if (key in target)
+    assignProp(target, key, value);
   else
-    target2[key] = value;
+    target[key] = value;
 }
-function mirrorShape(target2, source2, keys2, wrap) {
-  const raw = sourceShape(source2);
+function mirrorShape(target, source, keys2, wrap) {
+  const raw = sourceShape(source);
   for (const key of keys2) {
     const desc = Object.getOwnPropertyDescriptor(raw, key);
     if (!desc.enumerable)
       continue;
     if (desc.get) {
-      deferProp(target2, key, () => {
-        const value = source2._zod.def.shape[key];
+      deferProp(target, key, () => {
+        const value = source._zod.def.shape[key];
         return wrap ? wrap(value, key) : value;
       });
     } else
-      putProp(target2, key, wrap ? wrap(desc.value, key) : desc.value);
+      putProp(target, key, wrap ? wrap(desc.value, key) : desc.value);
   }
 }
-function mirrorProps(target2, source2) {
-  for (const key of Reflect.ownKeys(source2)) {
-    const desc = Object.getOwnPropertyDescriptor(source2, key);
+function mirrorProps(target, source) {
+  for (const key of Reflect.ownKeys(source)) {
+    const desc = Object.getOwnPropertyDescriptor(source, key);
     if (!desc.enumerable)
       continue;
     if (desc.get)
-      deferProp(target2, key, () => source2[key]);
+      deferProp(target, key, () => source[key]);
     else
-      putProp(target2, key, desc.value);
+      putProp(target, key, desc.value);
   }
 }
 function mergeDefs(...defs) {
@@ -5181,35 +5484,35 @@ function normalizeParams(_params) {
   return params;
 }
 function createTransparentProxy(getter) {
-  let target2;
+  let target;
   return new Proxy({}, {
     get(_, prop, receiver) {
-      target2 ?? (target2 = getter());
-      return Reflect.get(target2, prop, receiver);
+      target ?? (target = getter());
+      return Reflect.get(target, prop, receiver);
     },
     set(_, prop, value, receiver) {
-      target2 ?? (target2 = getter());
-      return Reflect.set(target2, prop, value, receiver);
+      target ?? (target = getter());
+      return Reflect.set(target, prop, value, receiver);
     },
     has(_, prop) {
-      target2 ?? (target2 = getter());
-      return Reflect.has(target2, prop);
+      target ?? (target = getter());
+      return Reflect.has(target, prop);
     },
     deleteProperty(_, prop) {
-      target2 ?? (target2 = getter());
-      return Reflect.deleteProperty(target2, prop);
+      target ?? (target = getter());
+      return Reflect.deleteProperty(target, prop);
     },
     ownKeys(_) {
-      target2 ?? (target2 = getter());
-      return Reflect.ownKeys(target2);
+      target ?? (target = getter());
+      return Reflect.ownKeys(target);
     },
     getOwnPropertyDescriptor(_, prop) {
-      target2 ?? (target2 = getter());
-      return Reflect.getOwnPropertyDescriptor(target2, prop);
+      target ?? (target = getter());
+      return Reflect.getOwnPropertyDescriptor(target, prop);
     },
     defineProperty(_, prop, descriptor) {
-      target2 ?? (target2 = getter());
-      return Reflect.defineProperty(target2, prop, descriptor);
+      target ?? (target = getter());
+      return Reflect.defineProperty(target, prop, descriptor);
     }
   });
 }
@@ -5680,10 +5983,10 @@ function $constructor(name, initializer3, proto, params) {
       let up = own2;
       while (up && up !== ctorProto)
         up = Object.getPrototypeOf(up);
-      const target2 = up ?? own2;
-      if (!initialized.has(target2)) {
-        initialized.add(target2);
-        members(target2, protoMembers);
+      const target = up ?? own2;
+      if (!initialized.has(target)) {
+        initialized.add(target);
+        members(target, protoMembers);
       }
     }
     const proto2 = _.prototype;
@@ -6213,8 +6516,8 @@ var creditCard = /^\d(?:[ -]?\d){11,18}$/;
 var currencyCode = /^(?:AED|AFN|ALL|AMD|AOA|ARS|AUD|AWG|AZN|BAM|BBD|BDT|BHD|BIF|BMD|BND|BOB|BOV|BRL|BSD|BTN|BWP|BYN|BZD|CAD|CDF|CHE|CHF|CHW|CLF|CLP|CNY|COP|COU|CRC|CUP|CVE|CZK|DJF|DKK|DOP|DZD|EGP|ERN|ETB|EUR|FJD|FKP|GBP|GEL|GHS|GIP|GMD|GNF|GTQ|GYD|HKD|HNL|HTG|HUF|IDR|ILS|INR|IQD|IRR|ISK|JMD|JOD|JPY|KES|KGS|KHR|KMF|KPW|KRW|KWD|KYD|KZT|LAK|LBP|LKR|LRD|LSL|LYD|MAD|MDL|MGA|MKD|MMK|MNT|MOP|MRU|MUR|MVR|MWK|MXN|MXV|MYR|MZN|NAD|NGN|NIO|NOK|NPR|NZD|OMR|PAB|PEN|PGK|PHP|PKR|PLN|PYG|QAR|RON|RSD|RUB|RWF|SAR|SBD|SCR|SDG|SEK|SGD|SHP|SLE|SOS|SRD|SSP|STN|SVC|SYP|SZL|THB|TJS|TMT|TND|TOP|TRY|TTD|TWD|TZS|UAH|UGX|USD|USN|UYI|UYU|UYW|UZS|VED|VES|VND|VUV|WST|XAD|XAF|XAG|XAU|XBA|XBB|XBC|XBD|XCD|XCG|XDR|XOF|XPD|XPF|XPT|XSU|XTS|XUA|XXX|YER|ZAR|ZMW|ZWG)$/;
 var iban = /^[A-Z]{2}(?!00|01|99)\d{2}[A-Z0-9]{11,30}$/;
 var dateSource = `(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))`;
-function anchor(source2) {
-  return new RegExp(`^${source2}$`);
+function anchor(source) {
+  return new RegExp(`^${source}$`);
 }
 var date = /* @__PURE__ */ anchor(dateSource);
 function timeSource(args) {
@@ -9037,11 +9340,11 @@ var $ZodTemplateLiteral = /* @__PURE__ */ $constructor("$ZodTemplateLiteral", (i
   const regexParts = [];
   for (const part of def.parts) {
     if (typeof part === "object" && part !== null) {
-      const source2 = partPattern(part);
-      if (!source2) {
+      const source = partPattern(part);
+      if (!source) {
         throw new Error(`Invalid template literal part, no pattern found: ${[...part._zod.traits].shift()}`);
       }
-      regexParts.push(cleanRegex(source2));
+      regexParts.push(cleanRegex(source));
     } else if (part === null || primitiveTypes.has(typeof part)) {
       regexParts.push(escapeRegex(`${part}`));
     } else {
@@ -17167,9 +17470,9 @@ function withParser(schema, parser) {
     installCompiledUserMethods(clone2, schema, parser);
   return clone2;
 }
-function installCompiledUserMethods(target2, source2, parser) {
-  const targetAny = target2;
-  const sourceAny = source2;
+function installCompiledUserMethods(target, source, parser) {
+  const targetAny = target;
+  const sourceAny = source;
   if (typeof sourceAny.safeParse === "function") {
     const originalSafeParse = sourceAny.safeParse;
     targetAny.safeParse = (data, params) => {
@@ -19763,26 +20066,26 @@ function _stringFormat(Class2, format, fnOrRegex, _params = {}) {
 }
 
 // ../../node_modules/.pnpm/zod@4.6.4/node_modules/zod/v4/core/to-json-schema.js
-function assignProps(target2, ...sources) {
-  for (const source2 of sources) {
-    for (const key of Reflect.ownKeys(source2)) {
-      if (Object.prototype.propertyIsEnumerable.call(source2, key)) {
-        assignProp(target2, key, source2[key]);
+function assignProps(target, ...sources) {
+  for (const source of sources) {
+    for (const key of Reflect.ownKeys(source)) {
+      if (Object.prototype.propertyIsEnumerable.call(source, key)) {
+        assignProp(target, key, source[key]);
       }
     }
   }
-  return target2;
+  return target;
 }
 function initializeContext(params) {
-  let target2 = params?.target ?? "draft-2020-12";
-  if (target2 === "draft-4")
-    target2 = "draft-04";
-  if (target2 === "draft-7")
-    target2 = "draft-07";
+  let target = params?.target ?? "draft-2020-12";
+  if (target === "draft-4")
+    target = "draft-04";
+  if (target === "draft-7")
+    target = "draft-07";
   return {
     processors: params.processors ?? {},
     metadataRegistry: params?.metadata ?? globalRegistry,
-    target: target2,
+    target,
     unrepresentable: params?.unrepresentable ?? "throw",
     override: params?.override ?? (() => {
     }),
@@ -20285,8 +20588,8 @@ var createToJSONSchemaMethod = (schema, processors = {}) => (params) => {
   return finalize(ctx, schema);
 };
 var createStandardJSONSchemaMethod = (schema, io, processors = {}) => (params) => {
-  const { libraryOptions, target: target2 } = params ?? {};
-  const ctx = initializeContext({ ...libraryOptions ?? {}, target: target2, io, processors });
+  const { libraryOptions, target } = params ?? {};
+  const ctx = initializeContext({ ...libraryOptions ?? {}, target, io, processors });
   processSchema(schema, ctx);
   extractDefs(ctx, schema);
   return finalize(ctx, schema);
@@ -21480,8 +21783,8 @@ var ZodType = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   catch(params) {
     return _catch2(this, params);
   },
-  pipe(target2) {
-    return pipe(this, target2);
+  pipe(target) {
+    return pipe(this, target);
   },
   readonly() {
     return readonly(this);
@@ -23990,27 +24293,41 @@ var browserHttpErrorV1 = external_exports.strictObject({
   })
 });
 
-// ../../packages/contracts/dist/versions/skills-v1.js
-var skillsV1 = external_exports.discriminatedUnion("ok", [
+// ../../packages/contracts/dist/versions/project-init-v4.js
+var projectInitV4 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
-    contract: external_exports.literal("skills"),
-    version: external_exports.literal(1),
+    contract: external_exports.literal("project-init"),
+    version: external_exports.literal(4),
     ok: external_exports.literal(true),
-    outcome: external_exports.enum(["planned", "installed", "synced", "removed", "not-installed"]),
+    outcome: external_exports.enum(["planned", "created", "already-initialized"]),
     rootPath: external_exports.string(),
-    agent: external_exports.enum(["codex", "claude"]).nullable(),
-    source: external_exports.literal(".agents/skills/gitifact-workflow/SKILL.md"),
-    target: external_exports.literal(".claude/skills/gitifact-workflow/SKILL.md").nullable(),
-    sourcePreserved: external_exports.boolean(),
-    sessionState: external_exports.literal("not-observed")
+    configPath: external_exports.literal(".gitifact/config.json"),
+    schemaVersion: external_exports.literal(1),
+    baseline: external_exports.discriminatedUnion("kind", [
+      external_exports.strictObject({ kind: external_exports.literal("empty") }),
+      external_exports.strictObject({ kind: external_exports.literal("commit"), objectFormat: external_exports.enum(["sha1", "sha256"]), commit: external_exports.string() })
+    ]),
+    agentDocs: external_exports.strictObject({ mode: external_exports.enum(["install", "remove", "skip"]), paths: external_exports.array(external_exports.string()) })
   }),
-  external_exports.strictObject({ contract: external_exports.literal("skills"), version: external_exports.literal(1), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+  external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(4), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
 // ../../packages/contracts/dist/versions/browser-specs-v1.js
 var requirement = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), body: external_exports.string() });
-var feature = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string(), requirements: external_exports.array(requirement), design: external_exports.strictObject({ title: external_exports.string(), body: external_exports.string(), requirements: external_exports.array(external_exports.string()) }).optional() });
+var contributor = external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string() });
+var feature = external_exports.strictObject({
+  id: external_exports.string(),
+  path: external_exports.string(),
+  title: external_exports.string(),
+  description: external_exports.string(),
+  requirements: external_exports.array(requirement),
+  design: external_exports.strictObject({ title: external_exports.string(), body: external_exports.string(), requirements: external_exports.array(external_exports.string()) }).optional(),
+  // Authors of commits touching the feature folder (current or legacy store) and the latest such commit; empty until first committed.
+  contributors: external_exports.array(contributor),
+  updatedAt: external_exports.string().nullable()
+});
 var snapshot = requirement.extend({ specId: external_exports.string(), path: external_exports.string() }).nullable();
+var document = external_exports.strictObject({ id: external_exports.string(), kind: external_exports.enum(["product", "guide"]), path: external_exports.string(), title: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
 var browserSpecsV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-specs"),
   version: external_exports.literal(1),
@@ -24019,6 +24336,7 @@ var browserSpecsV1 = external_exports.strictObject({
   observedAt: external_exports.string(),
   working: external_exports.boolean(),
   features: external_exports.array(feature),
+  documents: external_exports.array(document).default([]),
   events: external_exports.array(external_exports.strictObject({
     key: external_exports.string(),
     commit: external_exports.string(),
@@ -24028,13 +24346,13 @@ var browserSpecsV1 = external_exports.strictObject({
     committer: external_exports.string(),
     message: external_exports.string(),
     id: external_exports.string(),
-    kind: external_exports.enum(["requirement", "design"]).optional(),
+    kind: external_exports.enum(["requirement", "design", "product", "guide"]).optional(),
     types: external_exports.array(external_exports.enum(["created", "modified", "moved", "deleted"])),
     before: snapshot,
     after: snapshot,
     reasons: external_exports.array(external_exports.string())
   })),
-  contributors: external_exports.array(external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string() })),
+  contributors: external_exports.array(contributor),
   contributorsLimited: external_exports.boolean(),
   nextCursor: external_exports.number().int().nonnegative().nullable(),
   boundary: external_exports.boolean()
@@ -24106,6 +24424,8 @@ async function runStatus(format) {
 import { createServer } from "node:http";
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { fileURLToPath } from "node:url";
+import { lstat as lstat3, readFile as readFile4 } from "node:fs/promises";
+import { join as join4 } from "node:path";
 
 // src/server/assets.ts
 import { readdir, readFile } from "node:fs/promises";
@@ -24135,6 +24455,9 @@ function contentType(path3) {
   if (path3.endsWith(".svg")) return "image/svg+xml";
   if (path3.endsWith(".woff2")) return "font/woff2";
   if (path3.endsWith(".png")) return "image/png";
+  if (/\.jpe?g$/.test(path3)) return "image/jpeg";
+  if (path3.endsWith(".gif")) return "image/gif";
+  if (path3.endsWith(".webp")) return "image/webp";
   return "application/octet-stream";
 }
 
@@ -24195,6 +24518,7 @@ function commandScoped(key, load) {
 }
 
 // src/adapters/git/spec-preview-reader.ts
+var RECORD_PATHSPECS = [...STORE_DIRS.map((d) => d + "/spec/"), ...Object.values(DOCUMENT_DIRS).map((d) => d + "/")];
 function specPreviewReader(cwd) {
   for (const key of Object.keys(process.env)) if (/^GIT_(DIR|WORK_TREE|COMMON_DIR|INDEX_FILE|OBJECT_DIRECTORY|ALTERNATE_OBJECT_DIRECTORIES|CONFIG_COUNT|CONFIG_PARAMETERS|CONFIG_KEY_\d+|CONFIG_VALUE_\d+)$/i.test(key)) {
     throw new SpecPreviewError("Git \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uB36E\uC5B4\uC4F0\uB294 \uD658\uACBD\uC5D0\uC11C\uB294 \uC870\uD68C\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
@@ -24218,14 +24542,17 @@ function specPreviewReader(cwd) {
   };
   return {
     async index() {
-      const output2 = decode5(await git(["ls-files", "--stage", "-z", "--", ...STORE_DIRS.map((d) => d + "/spec/")]));
+      const output2 = decode5(await git(["ls-files", "--stage", "-z", "--", ...RECORD_PATHSPECS]));
       const files = /* @__PURE__ */ new Map();
       for (const row of output2.split("\0").filter(Boolean)) {
         const match = /^(\d+) ([a-f0-9]+) ([0-3])\t([\s\S]+)$/.exec(row);
         if (!match) throw new SpecPreviewError("\uC798\uBABB\uB41C index \uD56D\uBAA9\uC785\uB2C8\uB2E4.");
         const [, mode, oid2, stage, path3] = match;
         if (!["100644", "100755"].includes(mode) || stage !== "0") throw new SpecPreviewError("\uBA85\uC138 staging\uC5D0 \uCDA9\uB3CC \uB610\uB294 \uB9C1\uD06C\uAC00 \uC788\uC2B5\uB2C8\uB2E4.");
-        if (!recordPathPattern.test(path3)) throw new SpecPreviewError("\uBA85\uC138 staging\uC5D0 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD30C\uC77C\uC774 \uC788\uC2B5\uB2C8\uB2E4.");
+        if (!recordPathPattern.test(path3)) {
+          if (/^\.gitifact\/(?:product|guides)\//.test(path3)) continue;
+          throw new SpecPreviewError("\uBA85\uC138 staging\uC5D0 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD30C\uC77C\uC774 \uC788\uC2B5\uB2C8\uB2E4.");
+        }
         files.set(path3, oid2);
       }
       return files;
@@ -24264,7 +24591,7 @@ function specPreviewReader(cwd) {
       return oid2;
     },
     async files(oid2, allowLegacyBaseline = false) {
-      const entries = decode5(await git(["ls-tree", "--full-tree", "-r", "-z", oid2, "--", ...STORE_DIRS.map((d) => d + "/spec/")]));
+      const entries = decode5(await git(["ls-tree", "--full-tree", "-r", "-z", oid2, "--", ...RECORD_PATHSPECS]));
       const files = /* @__PURE__ */ new Map();
       let legacy;
       for (const row of entries.split("\0").filter(Boolean)) {
@@ -24272,7 +24599,7 @@ function specPreviewReader(cwd) {
         if (!match) throw new SpecPreviewError("\uC798\uBABB\uB41C Git tree\uC785\uB2C8\uB2E4.");
         const [, mode, type, object4, path3] = match;
         if (!["100644", "100755"].includes(mode) || type !== "blob") throw new SpecPreviewError("\uBA85\uC138 \uC601\uC5ED\uC5D0 \uB9C1\uD06C \uB610\uB294 \uC11C\uBE0C\uBAA8\uB4C8\uC774 \uC788\uC2B5\uB2C8\uB2E4: " + path3);
-        if (!/(?:requirements\.md|design\.md|history\.jsonl|tryce\.json)$/.test(path3)) continue;
+        if (!recordPathPattern.test(path3) && !path3.endsWith("/tryce.json")) continue;
         if (path3.endsWith("/tryce.json")) {
           if (!allowLegacyBaseline) throw new SpecPreviewError("\uAE30\uC874 JSON \uD615\uC2DD\uC740 req \uBA85\uB839\uC73C\uB85C \uC870\uD68C\uD558\uC138\uC694. \uC774 \uBA85\uB839\uC740 \uC804\uD658\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
           legacy = path3.split("/")[0];
@@ -24311,6 +24638,9 @@ function specPreviewReader(cwd) {
     async read(oid2) {
       const files = await this.files(oid2);
       return parsePreviewFiles(files);
+    },
+    async readBundle(oid2) {
+      return parsePreviewBundle(await this.files(oid2));
     }
   };
 }
@@ -24421,18 +24751,18 @@ async function snapshot2(root) {
   if (!parent && await info(join3(root, ".tryce"))) fail4(".tryce \uC800\uC7A5\uC18C\uC785\uB2C8\uB2E4. gitifact migrate\uB85C .gitifact\uC5D0 \uC804\uD658\uD55C \uB4A4 \uC0AC\uC6A9\uD558\uC138\uC694.");
   const config2 = await readConfigFile(root);
   if (config2 !== void 0 && !("schemaVersion" in parseManagedConfig(config2)) || await info(join3(root, "specs"))) fail4("\uAE30\uC874 \uD504\uB85C\uC81D\uD2B8 \uD615\uC2DD\uC740 \uBCC4\uB3C4 \uC804\uD658\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.");
-  async function visit2(path3, depth) {
+  async function visit2(path3, depth, documents) {
     const stat3 = await info(join3(root, path3));
     if (!stat3) return;
     if (stat3.isSymbolicLink() || !stat3.isDirectory() && !stat3.isFile()) fail4("\uB9C1\uD06C\xB7\uD2B9\uC218 \uD30C\uC77C\uC740 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + path3);
     if (++count > 4e3) fail4("\uBA85\uC138 \uD30C\uC77C \uC218 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.");
     if (stat3.isDirectory()) {
-      if (depth > 1) fail4("\uC911\uCCA9 \uBA85\uC138 \uD3F4\uB354\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + path3);
-      for (const name of (await readdir2(join3(root, path3))).sort()) await visit2(path3 + "/" + name, depth + 1);
+      if (depth > (documents ? 8 : 1)) fail4("\uC911\uCCA9 \uD3F4\uB354 \uAE4A\uC774 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4: " + path3);
+      for (const name of (await readdir2(join3(root, path3))).sort()) await visit2(path3 + "/" + name, depth + 1, documents);
     } else {
       if (path3.endsWith("/tryce.json")) fail4("\uAE30\uC874 JSON \uD615\uC2DD\uC740 \uC804\uD658\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
-      if (!/\/(requirements\.md|design\.md|history\.jsonl)$/.test(path3)) return;
-      if (!/^\.gitifact\/spec\/[^/]+\/(requirements\.md|design\.md|history\.jsonl)$/.test(path3)) fail4("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBA85\uC138 \uACBD\uB85C\uC785\uB2C8\uB2E4.");
+      if (documents ? !(path3.endsWith(".md") || depth === 1 && path3.endsWith("/history.jsonl")) : !/\/(requirements\.md|design\.md|history\.jsonl)$/.test(path3)) return;
+      if (!recordPathPattern.test(path3) || path3.startsWith(".tryce/")) fail4("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBA85\uC138 \uACBD\uB85C\uC785\uB2C8\uB2E4: " + path3);
       if (stat3.nlink !== 1 || stat3.size > 1024 * 1024) fail4("\uD558\uB4DC \uB9C1\uD06C \uB610\uB294 1 MiB \uD55C\uB3C4\uB97C \uD655\uC778\uD558\uC138\uC694.");
       const raw = await readFile3(join3(root, path3));
       bytes += raw.length;
@@ -24440,9 +24770,10 @@ async function snapshot2(root) {
       files.set(path3, decode3(raw));
     }
   }
-  await visit2(".gitifact/spec", 0);
-  const specs = parsePreviewFiles(files);
-  return { files, specs, config: config2, stamp: digest(JSON.stringify([...files]) + (config2 ?? "")) };
+  await visit2(".gitifact/spec", 0, false);
+  for (const dir of Object.values(DOCUMENT_DIRS)) await visit2(dir, 0, true);
+  const bundle = parsePreviewBundle(files);
+  return { files, specs: bundle.specs, documents: bundle.documents, bundle, config: config2, stamp: digest(JSON.stringify([...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) + (config2 ?? "")) };
 }
 async function readWorkingPreviewState(cwd) {
   const { root, gitDir } = await specPreviewReader(cwd).location();
@@ -24455,21 +24786,29 @@ async function readWorkingPreviewState(cwd) {
   return first;
 }
 async function readWorkingPreview(cwd) {
-  const { stamp, specs } = await readWorkingPreviewState(cwd);
-  return { stamp, specs, warnings: designReferenceWarnings(specs) };
+  const { stamp, specs, documents } = await readWorkingPreviewState(cwd);
+  return { stamp, specs, documents, warnings: designReferenceWarnings(specs) };
 }
 async function saveWorkingPreview(cwd, input2, publish = rename) {
   if (!input2 || typeof input2 !== "object" || Array.isArray(input2)) fail4("\uC800\uC7A5 \uC785\uB825\uC774 \uC798\uBABB\uB410\uC2B5\uB2C8\uB2E4.");
   const request = input2;
   if (Object.keys(request).sort().join(",") !== "expected,operations" || typeof request.expected !== "string") fail4("expected\uC640 operations\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.");
   return previewTransaction(cwd, request.expected, async (before) => {
-    const result = editSpecPreview(before.specs, request.operations, generatePreviewId);
+    const result = editSpecPreview(before.bundle, request.operations, generatePreviewId);
     const writes = /* @__PURE__ */ new Map();
     for (const spec2 of result.specs) {
       const old = before.specs.find((s) => s.id === spec2.id);
       if (!old || renderSpecPreview(old) !== renderSpecPreview(spec2)) writes.set(spec2.path, renderSpecPreview(spec2));
       if (JSON.stringify(old?.design) !== JSON.stringify(spec2.design)) writes.set(spec2.path.replace(/requirements\.md$/, "design.md"), spec2.design ? renderDesignPreview(spec2.id, spec2.design) : null);
     }
+    const previousDocs = before.documents.flatMap((s) => s.documents);
+    const nextDocs = result.documents.flatMap((s) => s.documents);
+    for (const doc of nextDocs) {
+      const old = previousDocs.find((d) => d.id === doc.id);
+      if (old && old.path !== doc.path) writes.set(old.path, null);
+      if (!old || renderDocument(old) !== renderDocument(doc) || old.path !== doc.path) writes.set(doc.path, renderDocument(doc));
+    }
+    for (const old of previousDocs) if (!nextDocs.some((d) => d.id === old.id)) writes.set(old.path, null);
     return { writes, data: { results: result.results } };
   }, publish);
 }
@@ -24477,9 +24816,9 @@ var readLockedPreviewState = (root) => snapshot2(root);
 async function previewTransaction(cwd, expected2, build, publish = rename, afterPublish) {
   const { root, gitDir } = await specPreviewReader(cwd).location();
   await failOnLegacyLock(gitDir);
-  const lock2 = join3(gitDir, "gitifact-spec-preview.lock");
+  const lock = join3(gitDir, "gitifact-spec-preview.lock");
   try {
-    await mkdir2(lock2);
+    await mkdir2(lock);
   } catch (e) {
     if (e.code === "EEXIST") fail4("\uBA85\uC138 \uC800\uC7A5 \uC7A0\uAE08 \uB610\uB294 \uBCF5\uAD6C \uC790\uB8CC\uAC00 \uC788\uC2B5\uB2C8\uB2E4.");
     throw e;
@@ -24504,7 +24843,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     if (before.stamp !== expected2) fail4("\uC77D\uC740 \uB4A4 \uBA85\uC138\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. working\uC73C\uB85C \uB2E4\uC2DC \uC77D\uC73C\uC138\uC694.");
     const result = await build(before);
     for (const [path3, after2] of result.writes) {
-      if (!/^\.gitifact\/spec\/[^/]+\/(requirements\.md|design\.md|history\.jsonl)$/.test(path3) || path3.split("/").some((p) => p === ".." || p === "." || /[\\:\0]/.test(p))) fail4("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uC800\uC7A5 \uACBD\uB85C\uC785\uB2C8\uB2E4.");
+      if (!recordPathPattern.test(path3) || path3.startsWith(".tryce/") || path3.split("/").some((p) => p === ".." || p === "." || /[\\:\0]/.test(p))) fail4("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uC800\uC7A5 \uACBD\uB85C\uC785\uB2C8\uB2E4.");
       if (after2 !== null && Buffer.byteLength(after2) > 1024 * 1024) fail4("\uBA85\uC138 1 MiB \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.");
       changed.push({ path: path3, before: before.files.get(path3) ?? null, after: after2 });
     }
@@ -24514,7 +24853,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
       else finalFiles.set(c.path, c.after);
     }
     if (finalFiles.size > 2e3 || [...finalFiles.values()].reduce((n, s) => n + Buffer.byteLength(s), 0) > 16 * 1024 * 1024) fail4("\uBA85\uC138 \uC804\uCCB4 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.");
-    await writeFile(join3(lock2, "recovery.json"), JSON.stringify({ root, changed }), { flag: "wx" });
+    await writeFile(join3(lock, "recovery.json"), JSON.stringify({ root, changed }), { flag: "wx" });
     for (const c of changed) {
       if (c.after === null) {
         temporary.push("");
@@ -24540,7 +24879,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     if (after.stamp !== digest(JSON.stringify([...finalFiles].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) + (before.config ?? ""))) fail4("\uC800\uC7A5 \uC911 \uBA85\uC138 \uB610\uB294 \uC124\uC815\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
     await result.recheck?.();
     await afterPublish?.(after);
-    return { ...result.data, stamp: after.stamp, paths: changed.map((c) => c.path), specs: after.specs, warnings: designReferenceWarnings(after.specs) };
+    return { ...result.data, stamp: after.stamp, paths: changed.map((c) => c.path), specs: after.specs, documents: after.documents, warnings: designReferenceWarnings(after.specs) };
   } catch (error62) {
     if (error62 instanceof PreservedPreviewError) {
       keepRecovery = true;
@@ -24565,7 +24904,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
         keepRecovery = true;
       }
     }
-    if (keepRecovery) fail4("\uC790\uB3D9 \uBCF5\uAD6C\uB97C \uC644\uB8CC\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uB978 \uD3B8\uC9D1\uC744 \uBCF4\uC874\uD588\uC2B5\uB2C8\uB2E4. \uBCF5\uAD6C \uC790\uB8CC: " + lock2);
+    if (keepRecovery) fail4("\uC790\uB3D9 \uBCF5\uAD6C\uB97C \uC644\uB8CC\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uB978 \uD3B8\uC9D1\uC744 \uBCF4\uC874\uD588\uC2B5\uB2C8\uB2E4. \uBCF5\uAD6C \uC790\uB8CC: " + lock);
     throw error62;
   } finally {
     for (const path3 of temporary.filter(Boolean)) await unlink2(path3).catch((e) => {
@@ -24574,10 +24913,10 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     for (const path3 of [...createdDirs].reverse()) await rmdir(path3).catch(() => {
     });
     if (!keepRecovery) {
-      await unlink2(join3(lock2, "recovery.json")).catch((e) => {
+      await unlink2(join3(lock, "recovery.json")).catch((e) => {
         if (e.code !== "ENOENT") throw e;
       });
-      await rmdir(lock2);
+      await rmdir(lock);
     }
   }
 }
@@ -24598,7 +24937,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
   const snapshot3 = (oid2) => {
     let value = snapshots.get(oid2);
     if (!value) {
-      value = reader.read(oid2).catch((e) => {
+      value = reader.readBundle(oid2).catch((e) => {
         snapshots.delete(oid2);
         throw e;
       });
@@ -24615,12 +24954,39 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
     const base = { head: await readHead() };
     if (cursor > 0 && expectedHead !== base.head) throw new SpecPreviewError("\uC774\uB825\uC774 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uC0C8\uB85C\uACE0\uCE68 \uD6C4 \uB2E4\uC2DC \uC870\uD68C\uD558\uC138\uC694.");
     const current = await readWorkingPreviewState(root);
-    const features = current.specs.map(({ history: _history, ...s }) => s);
-    if (!base.head) return browserSpecsV1.parse({ contract: "browser-specs", version: 1, sessionId, head: null, observedAt: (/* @__PURE__ */ new Date()).toISOString(), working: features.length > 0, features, events: [], contributors: [], contributorsLimited: false, nextCursor: null, boundary: false });
+    const bare = current.specs.map(({ history: _history, ...s }) => ({ ...s, contributors: [], updatedAt: null }));
+    const bareDocuments = current.documents.flatMap((set2) => set2.documents).map((d) => ({ ...d, updatedAt: null }));
+    if (!base.head) return browserSpecsV1.parse({ contract: "browser-specs", version: 1, sessionId, head: null, observedAt: (/* @__PURE__ */ new Date()).toISOString(), working: bare.length > 0 || bareDocuments.length > 0, features: bare, documents: bareDocuments, events: [], contributors: [], contributorsLimited: false, nextCursor: null, boundary: false });
     const head = base.head;
+    const features = await Promise.all(bare.map(async (feature2) => {
+      const folder = feature2.path.replace(/^\.(?:gitifact|tryce)\/(spec\/[^/]+)\/requirements\.md$/, "$1");
+      const lines = (await git(["log", "--format=%aN%x00%aE%x00%aI", "--max-count=2000", head, "--", `.gitifact/${folder}`, `.tryce/${folder}`])).trim().split("\n").filter(Boolean);
+      const people = /* @__PURE__ */ new Map();
+      for (const line of lines) {
+        const [name, email3, latest] = line.split("\0");
+        if (!name || !email3 || !latest) throw new SpecPreviewError("Git \uC791\uC131\uC790\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.");
+        const person = people.get(email3);
+        if (person) person.commits++;
+        else people.set(email3, { name, email: email3, latest, commits: 1 });
+      }
+      return { ...feature2, contributors: [...people.values()].sort((a, b) => b.commits - a.commits), updatedAt: lines[0]?.split("\0")[2] ?? null };
+    }));
+    const documents = await Promise.all(bareDocuments.map(async (doc) => ({ ...doc, updatedAt: (await git(["log", "--format=%aI", "--max-count=1", head, "--", doc.path])).trim() || null })));
+    const documentDirs = Object.values(DOCUMENT_DIRS);
     const [rows, dirty] = await Promise.all([
-      git(["log", "--first-parent", "--date-order", "--format=%H%x00%P%x00%aN%x00%aE%x00%aI%x00%cN%x00%s", "--max-count=11", "--skip=" + cursor, head, "--", ...[".gitifact", ".tryce"].flatMap((d) => [`:(glob)${d}/spec/*/requirements.md`, `:(glob)${d}/spec/*/design.md`, `:(glob)${d}/spec/*/history.jsonl`])]),
-      git(["status", "--porcelain=v1", "--", ".gitifact/spec"])
+      git([
+        "log",
+        "--first-parent",
+        "--date-order",
+        "--format=%H%x00%P%x00%aN%x00%aE%x00%aI%x00%cN%x00%s",
+        "--max-count=11",
+        "--skip=" + cursor,
+        head,
+        "--",
+        ...[".gitifact", ".tryce"].flatMap((d) => [`:(glob)${d}/spec/*/requirements.md`, `:(glob)${d}/spec/*/design.md`, `:(glob)${d}/spec/*/history.jsonl`]),
+        ...documentDirs.flatMap((d) => [`:(glob)${d}/**/*.md`, `:(glob)${d}/history.jsonl`])
+      ]),
+      git(["status", "--porcelain=v1", "--", ".gitifact/spec", ...documentDirs])
     ]);
     {
       const people = /* @__PURE__ */ new Map();
@@ -24640,7 +25006,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       const [commit, parents, author, email3, date5, committer, message] = row.split("\0");
       if (!commit || author === void 0 || email3 === void 0 || !date5 || committer === void 0 || message === void 0) throw new SpecPreviewError("Git \uC774\uB825 \uD615\uC2DD\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.");
       const after = await snapshot3(commit);
-      let before = [];
+      let before = { specs: [], documents: [{ kind: "product", documents: [], history: [] }, { kind: "guide", documents: [], history: [] }] };
       const parent = parents?.split(" ")[0];
       if (parent) {
         try {
@@ -24650,7 +25016,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
           else throw error62;
         }
       }
-      return compareSpecPreviews(before, after).changes.map((c) => ({
+      return comparePreviewBundles(before, after).changes.map((c) => ({
         key: commit + ":" + c.id,
         commit,
         author,
@@ -24675,6 +25041,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       observedAt: (/* @__PURE__ */ new Date()).toISOString(),
       working: !!dirty.trim(),
       features,
+      documents,
       events: groups.flat(),
       contributors: peopleCache.data,
       contributorsLimited: peopleCache.limited,
@@ -24756,6 +25123,21 @@ async function startBrowserServer(options) {
     if (api) {
       if (request.headers["sec-fetch-site"] === "cross-site" && !allowedOrigin) return fail8(response, 403, "FORBIDDEN", "\uC678\uBD80 \uD398\uC774\uC9C0\uC758 \uC694\uCCAD\uC744 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
       if (url2.search && path3 !== "/api/v1/specs") return fail8(response, 400, "BAD_REQUEST", "\uC870\uD68C \uC778\uC790\uB97C \uBC1B\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+      if (path3.startsWith("/api/v1/product/assets/")) {
+        const name = path3.slice("/api/v1/product/assets/".length);
+        if (request.method !== "GET") {
+          response.setHeader("Allow", "GET");
+          return fail8(response, 405, "METHOD_NOT_ALLOWED", "\uD5C8\uC6A9\uD558\uC9C0 \uC54A\uB294 \uBA54\uC11C\uB4DC\uC785\uB2C8\uB2E4.");
+        }
+        if (!isProductAssetPath(".gitifact/product/" + name)) return fail8(response, 404, "NOT_FOUND", "\uC81C\uD488 \uC774\uBBF8\uC9C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+        const file2 = join4(initial.repository.rootPath, ".gitifact", "product", name);
+        const stat3 = await lstat3(file2).catch(() => void 0);
+        if (!stat3?.isFile() || stat3.isSymbolicLink() || stat3.size > 5 * 1024 * 1024) return fail8(response, 404, "NOT_FOUND", "\uC81C\uD488 \uC774\uBBF8\uC9C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+        const bytes = await readFile4(file2);
+        response.writeHead(200, { "Content-Type": contentType(name.toLowerCase()), "Cache-Control": "no-cache", "Content-Length": bytes.length });
+        response.end(bytes);
+        return;
+      }
       const method = path3 === "/api/v1/status/refresh" ? "POST" : "GET";
       if (!["/api/v1/session", "/api/v1/status", "/api/v1/status/refresh", "/api/v1/specs"].includes(path3)) return fail8(response, 404, "NOT_FOUND", "API\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
       if (request.method !== method) {
@@ -24881,12 +25263,12 @@ async function runBrowser(options) {
 
 // src/commands/spec-init.ts
 import { readdir as readdir3 } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { join as join7 } from "node:path";
 
 // src/adapters/git/init-repository.ts
 import { createHash as createHash3 } from "node:crypto";
-import { readFile as readFile4 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { readFile as readFile5 } from "node:fs/promises";
+import { join as join5 } from "node:path";
 function initRepository(cwd, inherited = process.env) {
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_LAZY_FETCH: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "1", LC_ALL: "C" };
   const runner = createGitRunner();
@@ -24906,10 +25288,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 fileInfo(join4(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: " + marker2);
+        if (await fileInfo(join5(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: " + marker2);
       }
       if (state.changes.some((change2) => change2.kind === "unmerged")) throw new InitError("GIT_OPERATION_IN_PROGRESS", "Git \uCDA9\uB3CC\uC744 \uBA3C\uC800 \uD574\uACB0\uD558\uC138\uC694.");
-      const index = await readFile4(indexPath).catch((error62) => {
+      const index = await readFile5(indexPath).catch((error62) => {
         if (error62.code === "ENOENT") return Buffer.alloc(0);
         throw error62;
       });
@@ -24923,11 +25305,6 @@ function initRepository(cwd, inherited = process.env) {
         stamp: JSON.stringify({ repository: state.repository, head: state.head, index: createHash3("sha256").update(index).digest("hex") })
       };
     },
-    async trackedPaths(root, prefix, commit) {
-      const indexed = await git(["ls-files", "-z", "--", prefix], root);
-      const committed = commit ? await git(["ls-tree", "-r", "--name-only", "-z", commit, "--", prefix], root) : Buffer.alloc(0);
-      return [...new Set(Buffer.concat([indexed, committed]).toString("utf8").split("\0").filter(Boolean))];
-    },
     async checkIgnore(root, path3 = ".gitifact/config.json") {
       const output2 = (await git(["check-ignore", "--no-index", "-v", "-z", "--stdin"], root, [0, 1], Buffer.from(path3 + "\0"))).toString("utf8");
       const fields2 = output2.split("\0");
@@ -24947,87 +25324,12 @@ function initRepository(cwd, inherited = process.env) {
   };
 }
 
-// src/commands/spec-init.ts
-async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish) {
-  const repo = initRepository(cwd, env);
-  const first = await repo.inspect();
-  const root = first.state.repository.rootPath;
-  const result = (config3, outcome) => ({
-    contract: "project-init",
-    version: 3,
-    ok: true,
-    outcome,
-    rootPath: root,
-    configPath: ".gitifact/config.json",
-    schemaVersion: config3.schemaVersion,
-    baseline: config3.baseline,
-    integrations: { skills: "not-installed-by-init", hooks: "not-installed-by-init" }
-  });
-  const existing = async (text2) => {
-    const config3 = parseManagedConfig(text2);
-    if (!("schemaVersion" in config3)) throw new InitError("MIGRATION_REQUIRED", "\uAE30\uC874 \uD615\uC2DD\uC740 \uBCC4\uB3C4 \uC804\uD658\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \uC124\uC815\uACFC \uAE30\uB85D\uC744 \uBCF4\uC874\uD558\uC138\uC694.");
-    await repo.validateBaseline(config3, root, first.state.head.commit, first.state.repository.objectFormat);
-    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text2) throw new InitError("INPUT_CHANGED", "\uCD08\uAE30\uD654 \uC870\uD68C \uC911 \uC785\uB825\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-    return result(config3, "already-initialized");
-  };
-  const old = await readConfigFile(root);
-  if (old !== void 0) return existing(old);
-  if (first.trackedConfig) throw new InitError("CONFIG_DELETED", "\uAE30\uC874 \uC124\uC815\uC758 \uC0AD\uC81C\uB97C \uC2E0\uADDC \uB3C4\uC785\uC73C\uB85C \uCC98\uB9AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
-  const checkRecords = async () => {
-    if (await fileInfo(join5(root, "specs"))) throw new InitError("EXISTING_RECORDS", "\uAE30\uC874 specs \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.");
-    const entries = await readdir3(join5(root, ".gitifact")).catch((e) => {
-      if (e.code === "ENOENT") return [];
-      throw e;
-    });
-    if (entries.some((name) => !/^\.init-[a-f0-9-]+\.tmp$/.test(name))) throw new InitError("EXISTING_RECORDS", "\uC124\uC815 \uC5C6\uB294 .gitifact \uC790\uB8CC\uB97C \uC790\uB3D9 \uCC44\uD0DD\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
-  };
-  const config2 = { schemaVersion: 1, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
-  const recheck = async () => {
-    await checkRecords();
-    await repo.checkIgnore(root);
-    if ((await repo.inspect()).stamp !== first.stamp) throw new InitError("INPUT_CHANGED", "HEAD \uB610\uB294 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-    if (await readConfigFile(root) !== void 0) throw new InitError("CONFIG_APPEARED", "\uB2E4\uB978 \uC2E4\uD589\uC774 \uC124\uC815\uC744 \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4.");
-  };
-  await recheck();
-  if (dryRun) return result(config2, "planned");
-  try {
-    await publishConfig(root, JSON.stringify(config2, null, 2) + "\n", recheck, beforePublish);
-  } catch (error62) {
-    if (error62.code === "EEXIST" || error62 instanceof InitError && error62.code === "CONFIG_APPEARED") {
-      const concurrent = await readConfigFile(root);
-      if (concurrent !== void 0) return existing(concurrent);
-    }
-    throw error62;
-  }
-  if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== JSON.stringify(config2, null, 2) + "\n") throw new InitError("INPUT_CHANGED_AFTER_WRITE", "\uC124\uC815 \uC0DD\uC131 \uD6C4 \uC785\uB825\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C\uC744 \uD655\uC778\uD558\uC138\uC694.");
-  return result(config2, "created");
-}
-
-// src/commands/init.ts
-async function runInit(options) {
-  try {
-    const dto = await initializeSpecProject(process.cwd(), options.dryRun);
-    process.stdout.write(options.format === "text" ? `${dto.outcome}: ${dto.rootPath}/.gitifact/config.json
-\uC800\uC7A5 \uADDC\uC57D: schemaVersion 1
-\uC2A4\uD0AC\xB7\uD6C5\uC740 \uC124\uCE58\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.
-` : JSON.stringify(dto) + "\n");
-  } catch (error62) {
-    const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
-    const failure2 = { code: known ? error62.code : "INIT_FAILED", message: known ? error62.message : "\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." };
-    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify({ contract: "project-init", version: 1, ok: false, error: failure2 }) + "\n");
-    process.exitCode = 1;
-  }
-}
-
-// src/commands/skills.ts
-import { createHash as createHash4 } from "node:crypto";
-import { readFile as readFile6 } from "node:fs/promises";
-
-// src/adapters/filesystem/skill-files.ts
-import { open as open3, readFile as readFile5, mkdir as mkdir3, realpath as realpath2, rename as rename2, link as link2, unlink as unlink3 } from "node:fs/promises";
+// src/adapters/filesystem/managed-file.ts
+import { open as open3, readFile as readFile6, mkdir as mkdir3, realpath as realpath2, rename as rename2, link as link2, unlink as unlink3 } from "node:fs/promises";
 import { join as join6, dirname as dirname2 } from "node:path";
 import { randomUUID as randomUUID5 } from "node:crypto";
-async function skillPath(root, path3, create = false) {
+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++) {
@@ -25045,41 +25347,41 @@ async function skillPath(root, path3, create = false) {
   }
   return full;
 }
-async function skillRead(root, path3) {
-  const full = await skillPath(root, path3);
+async function managedRead(root, path3, limit = DEFAULT_LIMIT) {
+  const full = await managedPath(root, path3);
   const before = await fileInfo(full);
   if (!before) return null;
-  if (before.size > 65536) throw new InitError("SKILL_TOO_LARGE", "64 KiB\uB97C \uCD08\uACFC\uD569\uB2C8\uB2E4: " + path3);
-  const bytes = await readFile5(full);
-  await skillPath(root, path3);
+  if (before.size > limit) throw new InitError("FILE_TOO_LARGE", limit / 1024 + " KiB\uB97C \uCD08\uACFC\uD569\uB2C8\uB2E4: " + path3);
+  const bytes = await readFile6(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 > 65536) {
+  if (!after || before.ino !== after.ino || before.dev !== after.dev || before.mtimeMs !== after.mtimeMs || bytes.length > limit) {
     throw new InitError("INPUT_CHANGED", "\uC870\uD68C \uC911 \uD30C\uC77C\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + path3);
   }
   try {
     return new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
   } catch {
-    throw new InitError("INVALID_SKILL", "UTF-8 \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: " + path3);
+    throw new InitError("INVALID_UTF8", "UTF-8 \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: " + path3);
   }
 }
-async function skillWrite(root, path3, previous, next, recheck) {
-  const full = await skillPath(root, path3, true);
+async function managedWrite(root, path3, previous, next, recheck) {
+  const full = await managedPath(root, path3, true);
   const directory = dirname2(full);
   const owner = await fileInfo(directory);
   const canonical = await realpath2(directory);
   const unchanged = async () => {
-    await skillPath(root, path3);
+    await managedPath(root, path3);
     const now = await fileInfo(directory);
-    if (now?.ino !== owner?.ino || now?.dev !== owner?.dev || await realpath2(directory) !== canonical) throw new InitError("INPUT_CHANGED", "\uC2A4\uD0AC \uACBD\uB85C\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
+    if (now?.ino !== owner?.ino || now?.dev !== owner?.dev || await realpath2(directory) !== canonical) throw new InitError("INPUT_CHANGED", "\uB300\uC0C1 \uACBD\uB85C\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + path3);
   };
   if (next === null) {
     await recheck();
     await unchanged();
-    if (await skillRead(root, path3) !== previous) throw new InitError("INPUT_CHANGED", "\uC81C\uAC70 \uB300\uC0C1\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
+    if (await managedRead(root, path3) !== previous) throw new InitError("INPUT_CHANGED", "\uC81C\uAC70 \uB300\uC0C1\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + path3);
     if (previous !== null) await unlink3(full);
     return;
   }
-  const temp = join6(directory, ".gitifact-skill-" + randomUUID5() + ".tmp");
+  const temp = join6(directory, ".gitifact-managed-" + randomUUID5() + ".tmp");
   const handle = await open3(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -25091,7 +25393,7 @@ async function skillWrite(root, path3, previous, next, recheck) {
     }
     await recheck();
     await unchanged();
-    if (await skillRead(root, path3) !== previous || await readFile5(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", "\uAC8C\uC2DC \uB300\uC0C1\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
+    if (await managedRead(root, path3) !== previous || await readFile6(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", "\uAC8C\uC2DC \uB300\uC0C1\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + path3);
     if (previous === null) await link2(temp, full);
     else await rename2(temp, full);
   } finally {
@@ -25100,163 +25402,292 @@ async function skillWrite(root, path3, previous, next, recheck) {
     if (now?.ino === tempOwner.ino && now.dev === tempOwner.dev) await unlink3(temp);
   }
 }
-async function skillLock(root, path3, action) {
-  const full = await skillPath(root, path3, true);
-  const handle = await open3(full, "wx").catch((error62) => {
-    if (error62.code === "EEXIST") throw new InitError("SKILLS_BUSY", "\uC2A4\uD0AC \uC791\uC5C5 \uC7A0\uAE08\uC774 \uC788\uC2B5\uB2C8\uB2E4. \uC2E4\uD589 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uC138\uC694.");
-    throw error62;
-  });
-  const owner = await handle.stat();
-  await handle.close();
-  try {
-    return await action();
-  } finally {
-    await skillPath(root, path3);
-    const now = await fileInfo(full);
-    if (now?.ino === owner.ino && now.dev === owner.dev) await unlink3(full);
+
+// src/commands/docs.ts
+import { readFile as readFile7 } from "node:fs/promises";
+var docTopics = ["workflow", "spec", "design", "product", "commit"];
+var summaries = {
+  workflow: "\uC2DC\uC791 \uC2DC \uD655\uC778\uD560 \uAC83, \uC694\uAD6C\uC0AC\uD56D\uC73C\uB85C \uB0A8\uAE38 \uC694\uCCAD\uC758 \uAD6C\uBD84, \uB9C8\uBB34\uB9AC \uBCF4\uACE0",
+  spec: "\uC0AC\uC6A9\uC790 \uC2A4\uD1A0\uB9AC\xB7\uC218\uC6A9 \uC870\uAC74 \uD615\uC2DD, ID \uADDC\uCE59, spec save \uC785\uB825",
+  design: "design.md \uBAA9\uCC28, \uCC38\uC870 \uC8FC\uC11D, \uAC1C\uC815 \uBC29\uC2DD",
+  product: "PRODUCT.md\uC640 guides \uBB38\uC11C\uC758 \uC5ED\uD560\uACFC \uC800\uC7A5 \uBA85\uB839",
+  commit: "spec commit \uC785\uB825, \uC774\uC720 \uAE30\uB85D, \uC2E4\uD328 \uD6C4 \uBCF5\uAD6C"
+};
+var isDocTopic = (value) => docTopics.includes(value);
+var readBundled = (topic) => readFile7(new URL("./docs/" + topic + ".md", import.meta.url), "utf8");
+function listDocTopics() {
+  const width = Math.max(...docTopics.map((topic) => topic.length));
+  return docTopics.map((topic) => topic.padEnd(width) + "  " + summaries[topic]).join("\n") + "\n";
+}
+async function runDocs(topic, controls = {}) {
+  if (topic === void 0) {
+    process.stdout.write(listDocTopics());
+    return;
   }
+  if (!isDocTopic(topic)) {
+    const failure2 = { contract: "docs", version: 1, ok: false, error: { code: "UNKNOWN_TOPIC", message: "\uC54C \uC218 \uC5C6\uB294 \uC8FC\uC81C\uC785\uB2C8\uB2E4: " + topic + ". \uC0AC\uC6A9 \uAC00\uB2A5: " + docTopics.join(", ") } };
+    process.stderr.write(JSON.stringify(failure2) + "\n");
+    process.exitCode = 1;
+    return;
+  }
+  process.stdout.write(await (controls.readDoc ?? readBundled)(topic));
 }
 
-// src/commands/skills.ts
-var source = ".agents/skills/gitifact-workflow/SKILL.md";
-var target = ".claude/skills/gitifact-workflow/SKILL.md";
-var manifest = ".agents/gitifact-skills.local.json";
-var lock = ".agents/gitifact-skills.local.lock";
-var ignores = ["/" + manifest, "/" + lock, "/" + target, "/.claude/skills/gitifact-workflow/.gitifact-skill-*.tmp", "/.agents/skills/gitifact-workflow/.gitifact-skill-*.tmp", "/.agents/.gitifact-skill-*.tmp"];
-var digest2 = (text2) => text2 === null ? null : createHash4("sha256").update(text2).digest("hex");
-function parseState(text2) {
-  if (text2 === null) return null;
-  let value;
-  try {
-    value = JSON.parse(text2);
-  } catch {
-    throw new InitError("INVALID_SKILL_MANIFEST", "\uB85C\uCEEC \uC2A4\uD0AC \uB9E4\uB2C8\uD398\uC2A4\uD2B8\uAC00 \uC190\uC0C1\uB410\uC2B5\uB2C8\uB2E4.");
-  }
-  if (!value || Object.keys(value).sort().join() !== "accepted,agent,source,target,version" || value.version !== 1 || value.source !== source || value.target !== target || ![null, "codex", "claude"].includes(value.agent) || !Array.isArray(value.accepted) || value.accepted.length < 1 || value.accepted.length > 2 || value.accepted.some((item) => item !== null && (typeof item !== "string" || !/^[a-f0-9]{64}$/.test(item)))) {
-    throw new InitError("UNSUPPORTED_SKILL_MANIFEST", "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB85C\uCEEC \uC2A4\uD0AC \uB9E4\uB2C8\uD398\uC2A4\uD2B8\uC785\uB2C8\uB2E4.");
+// src/commands/agent-block.ts
+var AGENT_START = "<!-- GITIFACT:START -->";
+var AGENT_END = "<!-- GITIFACT:END -->";
+var candidatePaths = ["AGENTS.md", "CLAUDE.md", ".claude/CLAUDE.md", ".cursorrules", ".hermes.md", "HERMES.md"];
+var agentPresetNames = ["claude", "cursor", "codex", "hermes", "all"];
+var agentPresets = {
+  claude: ["CLAUDE.md", ".claude/CLAUDE.md"],
+  cursor: [".cursorrules", "AGENTS.md"],
+  codex: ["AGENTS.md"],
+  hermes: [".hermes.md", "HERMES.md", "AGENTS.md"]
+};
+function boilerplateFor(path3) {
+  const name = path3 === "AGENTS.md" ? path3 : path3.split("/").pop().replace(/^\./, "").replace(/\.md$/, "");
+  return "# " + name + "\n\nProject-specific guidance for AI coding agents.\n";
+}
+function renderAgentBlock(version2) {
+  const lines = [
+    AGENT_START,
+    "gitifact v" + version2 + " \xB7 \uC800\uC7A5 \uADDC\uC57D schemaVersion 1",
+    "CLI: \uBAA8\uB4E0 \uBA85\uB839\uC740 `gitifact <cmd>`\uB85C \uC2E4\uD589\uD55C\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC774 \uB2E4\uB978 \uC2E4\uD589 \uBC29\uBC95\uC744 \uC9C0\uC815\uD558\uBA74 \uADF8\uAC83\uC744 \uB530\uB978\uB2E4.",
+    "",
+    "\uC2DC\uC791\uD560 \uB54C:",
+    "- `gitifact spec working`\uC73C\uB85C \uC81C\uD488 \uC124\uBA85\xB7\uC9C0\uCE68\xB7\uAE30\uB2A5 \uBA85\uC138\uB97C \uC77D\uACE0 git status\uC640 \uAE30\uC874 staging\uC744 \uD655\uC778\uD55C\uB2E4.",
+    "- \uC774 \uBE14\uB85D\uC740 \uC694\uC57D\uC774\uB2E4. \uC0C1\uC138 \uD615\uC2DD\uC740 `gitifact docs <topic>`\uC73C\uB85C \uC77D\uACE0 \uAE30\uC5B5\uC73C\uB85C \uCC44\uC6B0\uC9C0 \uC54A\uB294\uB2E4.",
+    "",
+    "\uBB34\uC5C7\uC744 \uC694\uAD6C\uC0AC\uD56D\uC73C\uB85C \uB0A8\uAE30\uB294\uAC00 (\uC81C\uD488 \uB3D9\uC791\uACFC \uC720\uC9C0\uD560 \uC81C\uC57D\uB9CC):",
+    "| \uC694\uCCAD | \uCC98\uB9AC |",
+    "| --- | --- |",
+    "| \uAC8C\uC2DC\uBB3C\uC744 \uC0AD\uC81C\uD560 \uC218 \uC788\uAC8C \uD574\uC8FC\uC138\uC694 | \uC694\uAD6C\uC0AC\uD56D\uC73C\uB85C \uC815\uB9AC\uD55C\uB2E4 |",
+    "| \uC774 \uB0B4\uBD80 \uD568\uC218 \uC774\uB984\uC744 \uBC14\uAFD4\uC8FC\uC138\uC694 | \uC77C\uBC18 \uAD6C\uD604 \uBCC0\uACBD\uC774\uB2E4 |",
+    "| \uC9C0\uAE08 \uD478\uC2DC\uD574\uC8FC\uC138\uC694 | \uC791\uC5C5 \uC9C0\uC2DC\uB2E4. \uB4F1\uB85D\uD558\uC9C0 \uC54A\uB294\uB2E4 |",
+    "| \uC678\uBD80 \uC11C\uBE44\uC2A4 \uC5C6\uC774 \uB3D9\uC791\uD574\uC57C \uD569\uB2C8\uB2E4 | \uC81C\uD488 \uC81C\uC57D\uC73C\uB85C \uBA85\uC138\uC5D0 \uBC18\uC601\uD55C\uB2E4 |",
+    "",
+    "\uADDC\uCE59:",
+    "- \uBA85\uC138\uB97C \uC800\uC7A5\uD558\uAE30 \uC804\uC5D0 `gitifact docs spec`\uC744 \uC77D\uB294\uB2E4. ID\uB294 CLI\uAC00 \uBC1C\uAE09\uD55C \uAC12\uB9CC \uC4F4\uB2E4.",
+    "- \uC0C8 \uAE30\uB2A5\uC740 requirements.md\uC640 design.md\uB97C \uD568\uAED8 \uC815\uB9AC\uD55C\uB2E4(`gitifact docs design`). \uC694\uAD6C\uC0AC\uD56D\uB9CC \uC694\uCCAD\uBC1B\uC73C\uBA74 \uB530\uB978\uB2E4.",
+    "- \uCEE4\uBC0B \uC694\uCCAD\uC744 \uBC1B\uC73C\uBA74 `gitifact docs commit`\uC744 \uC77D\uACE0 \uBA85\uC138\xB7\uC774\uC720\xB7\uCF54\uB4DC\xB7\uD14C\uC2A4\uD2B8\uB97C \uD568\uAED8 \uCEE4\uBC0B\uD55C\uB2E4.",
+    "- \uC790\uB3D9 \uAE30\uB85D\uC740 \uCEE4\uBC0B \uAD8C\uD55C\uC774 \uC544\uB2C8\uB2E4. \uC0AC\uC6A9\uC790 \uC694\uCCAD\uC774\uB098 \uBA85\uC2DC\uC801 \uD504\uB85C\uC81D\uD2B8 \uC815\uCC45\uC774 \uC788\uC744 \uB54C\uB9CC \uCEE4\uBC0B\uD558\uACE0 \uD478\uC2DC\uB294 \uBCC4\uB3C4 \uC694\uCCAD\uC744 \uB530\uB978\uB2E4.",
+    "- \uBD88\uBA85\uD655\uD55C \uC81C\uD488 \uB3D9\uC791\uB9CC \uC9C8\uBB38\uD558\uACE0 \uB3C5\uB9BD\uC801\uC778 \uC791\uC5C5\uC740 \uC9C4\uD589\uD55C\uB2E4. \uAE30\uC874 \uAE30\uB2A5 \uC804\uCCB4 \uB3C4\uCD9C\uC740 \uC694\uCCAD\uBC1B\uC558\uC744 \uB54C \uD55C\uB2E4.",
+    "- SELF-CHECK: save\xB7commit \uC785\uB825\uC744 \uB9CC\uB4E4\uAE30 \uC804\uC5D0 \uD574\uB2F9 docs\uB97C \uB2E4\uC2DC \uC77D\uACE0 \uD615\uC2DD\uC744 \uB300\uC870\uD55C\uB2E4. \uD655\uC2E4\uD558\uC9C0 \uC54A\uC73C\uBA74 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 `gitifact docs <topic>`\uC744 \uC2E4\uD589\uD55C\uB2E4.",
+    "",
+    "MORE CLI:",
+    "  docs <topic>     " + docTopics.join(", "),
+    "  spec working     \uD604\uC7AC \uBA85\uC138\xB7\uC81C\uD488\xB7\uC9C0\uCE68 \uC804\uCCB4\uC640 stamp",
+    "  spec save        --file <json>: \uC694\uAD6C\uC0AC\uD56D\xB7\uC124\uACC4\xB7\uBB38\uC11C \uC800\uC7A5",
+    "  spec commit      --file <json>: \uBCC0\uACBD \uC774\uC720 \uAE30\uB85D\uACFC \uCEE4\uBC0B\uC744 \uD55C \uBC88\uC5D0",
+    "  browser          \uC77D\uAE30 \uC804\uC6A9 \uBE0C\uB77C\uC6B0\uC800 \uC5F4\uAE30",
+    "  init             \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uC774 \uBE14\uB85D\uC744 \uAC31\uC2E0\uD55C\uB2E4",
+    AGENT_END
+  ];
+  return lines.join("\n");
+}
+function findBlock(text2) {
+  const start = text2.indexOf(AGENT_START);
+  if (start === -1) {
+    if (text2.includes(AGENT_END)) throw new InitError("AGENT_DOCS_MALFORMED", "\uC2DC\uC791 \uB9C8\uCEE4 \uC5C6\uC774 \uC885\uB8CC \uB9C8\uCEE4\uB9CC \uC788\uC2B5\uB2C8\uB2E4. \uBE14\uB85D\uC744 \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.");
+    return null;
   }
-  return value;
+  const end = text2.indexOf(AGENT_END, start + AGENT_START.length);
+  if (end === -1) throw new InitError("AGENT_DOCS_MALFORMED", "\uC885\uB8CC \uB9C8\uCEE4\uAC00 \uC5C6\uB294 GITIFACT \uBE14\uB85D\uC774 \uC788\uC2B5\uB2C8\uB2E4. \uBE14\uB85D\uC744 \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.");
+  if (text2.indexOf(AGENT_START, start + AGENT_START.length) !== -1) throw new InitError("AGENT_DOCS_MALFORMED", "GITIFACT \uC2DC\uC791 \uB9C8\uCEE4\uAC00 \uC5EC\uB7EC \uAC1C\uC785\uB2C8\uB2E4. \uC911\uBCF5 \uBE14\uB85D\uC744 \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.");
+  return { start, end: end + AGENT_END.length };
+}
+function isWrapperFile(text2) {
+  const found = findBlock(text2);
+  const own2 = found ? text2.slice(0, found.start) + text2.slice(found.end) : text2;
+  const lines = own2.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  return lines.length > 0 && lines.every((line) => /^@(?:\.\/)?[^\s]+$/.test(line) && candidatePaths.includes(line.replace(/^@(?:\.\/)?/, "")));
+}
+function resolveAgentPaths(preset, existing) {
+  if (preset && preset !== "all") {
+    const order = agentPresets[preset];
+    const found = order.find((path3) => existing.has(path3));
+    return found ? { inject: [found], create: null } : { inject: [], create: order[order.length - 1] };
+  }
+  const inject = candidatePaths.filter((path3) => existing.has(path3) && !isWrapperFile(existing.get(path3)));
+  if (inject.length > 0) return { inject, create: null };
+  return { inject: [], create: "AGENTS.md" };
+}
+var eolOf = (text2) => text2?.includes("\r\n") ? "\r\n" : "\n";
+function injectBlock(text2, block, boilerplate) {
+  const eol = eolOf(text2);
+  const body = block.split("\n").join(eol);
+  if (text2 === null) return boilerplate.split("\n").join(eol) + eol + body + eol;
+  const found = findBlock(text2);
+  if (found) return text2.slice(0, found.start) + body + text2.slice(found.end);
+  const head = text2.replace(/\s+$/, "");
+  return (head ? head + eol + eol : "") + body + eol;
+}
+function removeBlock(text2, boilerplate) {
+  const found = findBlock(text2);
+  if (!found) return text2;
+  const eol = eolOf(text2);
+  const before = text2.slice(0, found.start).replace(/\s+$/, "");
+  const after = text2.slice(found.end).replace(/^\s+/, "");
+  const rest = before && after ? before + eol + eol + after : before ? before + eol : after;
+  const normalize = (value) => value.replace(/\r\n/g, "\n").trim();
+  if (!normalize(rest) || normalize(rest) === normalize(boilerplate)) return null;
+  return rest;
 }
-async function skillsCommand(cwd, action, options = {}, env = process.env, controls = {}) {
+
+// src/commands/agent-docs.ts
+var skippedAgentDocs = { mode: "skip", paths: [], writes: [] };
+async function planAgentDocs(root, options) {
+  if (options.skip) return skippedAgentDocs;
+  const existing = /* @__PURE__ */ new Map();
+  for (const path3 of candidatePaths) {
+    const text2 = await managedRead(root, path3);
+    if (text2 !== null) existing.set(path3, text2);
+  }
+  const writes = [];
+  const paths2 = [];
+  if (options.remove) {
+    const scope = options.agent && options.agent !== "all" ? agentPresets[options.agent] : candidatePaths;
+    for (const path3 of scope) {
+      const text2 = existing.get(path3);
+      if (text2 === void 0 || !findBlock(text2)) continue;
+      paths2.push(path3);
+      writes.push({ path: path3, previous: text2, next: removeBlock(text2, boilerplateFor(path3)) });
+    }
+    return { mode: "remove", paths: paths2, writes };
+  }
+  const block = renderAgentBlock(options.version);
+  const { inject, create } = resolveAgentPaths(options.agent, existing);
+  for (const path3 of inject) {
+    const previous = existing.get(path3);
+    const next = injectBlock(previous, block, boilerplateFor(path3));
+    paths2.push(path3);
+    if (next !== previous) writes.push({ path: path3, previous, next });
+  }
+  if (create) {
+    paths2.push(create);
+    writes.push({ path: create, previous: null, next: injectBlock(null, block, boilerplateFor(create)) });
+  }
+  for (const [path3, text2] of existing) {
+    if (paths2.includes(path3) || !isWrapperFile(text2) || !findBlock(text2)) continue;
+    writes.push({ path: path3, previous: text2, next: removeBlock(text2, boilerplateFor(path3)) });
+  }
+  return { mode: "install", paths: paths2, writes };
+}
+async function applyAgentDocs(root, plan, recheck) {
+  for (const write of plan.writes) await managedWrite(root, write.path, write.previous, write.next, recheck);
+  return plan.writes.map((write) => write.path);
+}
+
+// src/commands/spec-init.ts
+async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs) {
   const repo = initRepository(cwd, env);
   const first = await repo.inspect();
   const root = first.state.repository.rootPath;
-  const configText = await readConfigFile(root);
-  if (configText === void 0) throw new InitError("NOT_INITIALIZED", "\uBA3C\uC800 \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
-  const config2 = parseManagedConfig(configText);
-  await repo.validateBaseline(config2, root, first.state.head.commit, first.state.repository.objectFormat);
-  const recheck = async () => {
-    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== configText) throw new InitError("INPUT_CHANGED", "Git \uB610\uB294 \uD504\uB85C\uC81D\uD2B8 \uC124\uC815\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-  };
-  const execute2 = async () => {
-    const original = await skillRead(root, source);
-    const saved = await skillRead(root, manifest);
-    const state = parseState(saved);
-    const copy = await skillRead(root, target);
-    if (copy !== null && !state) throw new InitError("UNMANAGED_SKILL", "\uAE30\uC874 Claude \uBCF5\uC0AC\uBCF8\uC740 \uAD00\uB9AC \uB300\uC0C1\uC774 \uC544\uB2D9\uB2C8\uB2E4. \uBCF4\uC874\uD558\uACE0 \uCD9C\uCC98\uB97C \uD655\uC778\uD558\uC138\uC694.");
-    if (state && !state.accepted.includes(digest2(copy))) throw new InitError("SKILL_MODIFIED", "Claude \uBCF5\uC0AC\uBCF8\uC774 \uC218\uC815\uB418\uAC70\uB098 \uC0AD\uC81C\uB410\uC2B5\uB2C8\uB2E4. \uC6D0\uBCF8\uACFC \uBE44\uAD50\uD558\uACE0 \uBCF4\uC874\uD558\uC138\uC694.");
-    const tracked = await repo.trackedPaths(root, ".agents/", first.state.head.commit);
-    const localTracked = await repo.trackedPaths(root, ".claude/skills/gitifact-workflow/", first.state.head.commit);
-    if (tracked.includes(manifest) || tracked.includes(lock) || localTracked.length) throw new InitError("LOCAL_SKILL_TRACKED", "\uB85C\uCEEC \uC2A4\uD0AC \uD30C\uC77C\uC774 Git\uC5D0\uC11C \uCD94\uC801 \uC911\uC785\uB2C8\uB2E4. \uBA3C\uC800 \uBCF4\uAD00 \uBC29\uCE68\uC744 \uD655\uC778\uD558\uC138\uC694.");
-    if (original === null && tracked.includes(source)) throw new InitError("SKILL_DELETED", "Git\uC5D0 \uC788\uB294 \uC2A4\uD0AC \uC6D0\uBCF8\uC774 \uC0AD\uC81C\uB410\uC2B5\uB2C8\uB2E4. \uBCF5\uAD6C \uD6C4 \uC2E4\uD589\uD558\uC138\uC694.");
-    const agent = action === "remove" ? null : options.agent ?? state?.agent;
-    if (action !== "remove" && !agent) throw new InitError("AGENT_REQUIRED", "--agent codex \uB610\uB294 claude\uB97C \uC9C0\uC815\uD558\uC138\uC694.");
-    if (action === "sync" && original === null) throw new InitError("SKILL_NOT_INSTALLED", "\uC2A4\uD0AC \uC6D0\uBCF8\uC744 \uBA3C\uC800 \uC124\uCE58\uD558\uC138\uC694.");
-    let wanted = original;
-    if (action === "install" && wanted === null) wanted = controls.template ?? await readFile6(new URL("./skills/gitifact-workflow/SKILL.md", import.meta.url), "utf8");
-    if (wanted !== null && (!wanted.startsWith("---") || !/^name: gitifact-workflow\r?$/m.test(wanted) || Buffer.byteLength(wanted) > 65536)) throw new InitError("INVALID_SKILL", "gitifact-workflow \uC6D0\uBCF8 \uD615\uC2DD\uC744 \uD655\uC778\uD558\uC138\uC694.");
-    const nextCopy = agent === "claude" ? wanted : null;
-    const ignoreBefore = await skillRead(root, ".gitignore");
-    const lines = (ignoreBefore ?? "").split(/\r?\n/);
-    const missing2 = ignores.filter((line) => !lines.includes(line));
-    const ignoreAfter = (ignoreBefore ?? "") + (ignoreBefore && !ignoreBefore.endsWith("\n") ? "\n" : "") + missing2.join("\n") + (missing2.length ? "\n" : "");
-    const result = (outcome) => skillsV1.parse({
-      contract: "skills",
-      version: 1,
-      ok: true,
-      outcome,
-      rootPath: root,
-      agent: agent ?? null,
-      source,
-      target: agent === "claude" ? target : null,
-      sourcePreserved: original !== null,
-      sessionState: "not-observed"
+  const docsPlan = agentDocs ? await planAgentDocs(root, agentDocs) : skippedAgentDocs;
+  const result = (config3, outcome) => projectInitV4.parse({
+    contract: "project-init",
+    version: 4,
+    ok: true,
+    outcome,
+    rootPath: root,
+    configPath: ".gitifact/config.json",
+    schemaVersion: config3.schemaVersion,
+    baseline: config3.baseline,
+    agentDocs: { mode: docsPlan.mode, paths: docsPlan.paths }
+  });
+  const existing = async (text3) => {
+    const config3 = parseManagedConfig(text3);
+    if (!("schemaVersion" in config3)) throw new InitError("MIGRATION_REQUIRED", "\uAE30\uC874 \uD615\uC2DD\uC740 \uBCC4\uB3C4 \uC804\uD658\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \uC124\uC815\uACFC \uAE30\uB85D\uC744 \uBCF4\uC874\uD558\uC138\uC694.");
+    await repo.validateBaseline(config3, root, first.state.head.commit, first.state.repository.objectFormat);
+    const unchanged = async () => {
+      if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text3) throw new InitError("INPUT_CHANGED", "\uCD08\uAE30\uD654 \uC870\uD68C \uC911 \uC785\uB825\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
+    };
+    await unchanged();
+    if (!dryRun) await applyAgentDocs(root, docsPlan, unchanged);
+    return result(config3, "already-initialized");
+  };
+  const old = await readConfigFile(root);
+  if (old !== void 0) return existing(old);
+  if (first.trackedConfig) throw new InitError("CONFIG_DELETED", "\uAE30\uC874 \uC124\uC815\uC758 \uC0AD\uC81C\uB97C \uC2E0\uADDC \uB3C4\uC785\uC73C\uB85C \uCC98\uB9AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+  const checkRecords = async () => {
+    if (await fileInfo(join7(root, "specs"))) throw new InitError("EXISTING_RECORDS", "\uAE30\uC874 specs \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.");
+    const entries = await readdir3(join7(root, ".gitifact")).catch((e) => {
+      if (e.code === "ENOENT") return [];
+      throw e;
     });
-    if (action === "remove" && !state) {
-      await recheck();
-      return result("not-installed");
-    }
-    await repo.checkIgnore(root, source);
-    if (options.dryRun) {
-      await recheck();
-      return result("planned");
-    }
-    if (missing2.length) await skillWrite(root, ".gitignore", ignoreBefore, ignoreAfter, recheck);
-    for (const path3 of [manifest, lock, target]) {
-      let ignored = false;
-      try {
-        await repo.checkIgnore(root, path3);
-      } catch (error62) {
-        if (error62 instanceof InitError && error62.code === "CONFIG_IGNORED") ignored = true;
-        else throw error62;
-      }
-      if (!ignored) throw new InitError("LOCAL_SKILL_NOT_IGNORED", "\uB85C\uCEEC \uACBD\uB85C\uAC00 ignore\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: " + path3);
+    if (entries.some((name) => !/^\.init-[a-f0-9-]+\.tmp$/.test(name))) throw new InitError("EXISTING_RECORDS", "\uC124\uC815 \uC5C6\uB294 .gitifact \uC790\uB8CC\uB97C \uC790\uB3D9 \uCC44\uD0DD\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+  };
+  const config2 = { schemaVersion: 1, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
+  const text2 = JSON.stringify(config2, null, 2) + "\n";
+  const recheck = async () => {
+    await checkRecords();
+    await repo.checkIgnore(root);
+    if ((await repo.inspect()).stamp !== first.stamp) throw new InitError("INPUT_CHANGED", "HEAD \uB610\uB294 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
+    if (await readConfigFile(root) !== void 0) throw new InitError("CONFIG_APPEARED", "\uB2E4\uB978 \uC2E4\uD589\uC774 \uC124\uC815\uC744 \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4.");
+  };
+  await recheck();
+  if (dryRun) return result(config2, "planned");
+  try {
+    await publishConfig(root, text2, recheck, beforePublish);
+  } catch (error62) {
+    if (error62.code === "EEXIST" || error62 instanceof InitError && error62.code === "CONFIG_APPEARED") {
+      const concurrent = await readConfigFile(root);
+      if (concurrent !== void 0) return existing(concurrent);
     }
-    const stateText = (accepted) => JSON.stringify({ version: 1, source, target, agent: agent ?? null, accepted }, null, 2) + "\n";
-    const journal = stateText([.../* @__PURE__ */ new Set([digest2(copy), digest2(nextCopy)])]);
-    const inputs = async () => {
-      await recheck();
-      if (await skillRead(root, source) !== original || await skillRead(root, target) !== copy) throw new InitError("INPUT_CHANGED", "\uC2A4\uD0AC \uC785\uB825\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-    };
-    await skillWrite(root, manifest, saved, journal, inputs);
-    await controls.afterJournal?.();
-    if (original === null && wanted !== null) await skillWrite(root, source, null, wanted, recheck);
-    if (copy !== nextCopy) await skillWrite(root, target, copy, nextCopy, recheck);
-    await skillWrite(root, manifest, journal, stateText([digest2(nextCopy)]), recheck);
-    await recheck();
-    if (await skillRead(root, source) !== wanted || await skillRead(root, target) !== nextCopy) throw new InitError("INPUT_CHANGED", "\uAC8C\uC2DC \uD6C4 \uC2A4\uD0AC\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC870\uD68C\uD558\uC138\uC694.");
-    return result(action === "remove" ? "removed" : action === "install" ? "installed" : "synced");
+    throw error62;
+  }
+  const published = async () => {
+    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text2) throw new InitError("INPUT_CHANGED_AFTER_WRITE", "\uC124\uC815 \uC0DD\uC131 \uD6C4 \uC785\uB825\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C\uC744 \uD655\uC778\uD558\uC138\uC694.");
   };
-  return options.dryRun ? execute2() : skillLock(root, lock, execute2);
+  await published();
+  await applyAgentDocs(root, docsPlan, published);
+  return result(config2, "created");
 }
-async function runSkills(action, options) {
+
+// src/commands/init.ts
+async function runInit(options, version2) {
   try {
-    const result = await skillsCommand(process.cwd(), action, options);
-    console.log(options.format === "text" && result.ok ? `${result.outcome}: ${JSON.stringify(result.rootPath)}
-\uC6D0\uBCF8: ${result.source}
-\uB85C\uCEEC \uBCF5\uC0AC\uBCF8: ${result.target ?? "\uC5C6\uC74C"}
-\uC138\uC158 \uB85C\uB529: \uD655\uC778\uD558\uC9C0 \uC54A\uC74C` : JSON.stringify(result));
+    const dto = await initializeSpecProject(
+      process.cwd(),
+      options.dryRun,
+      process.env,
+      void 0,
+      { version: version2, agent: options.agent, remove: options.removeAgents, skip: options.skipAgents }
+    );
+    if (!dto.ok) throw new Error("unreachable");
+    const docs = dto.agentDocs.mode === "skip" ? "\uAC74\uB108\uB700" : dto.agentDocs.paths.join(", ") + (dto.agentDocs.mode === "remove" ? " (\uBE14\uB85D \uC81C\uAC70)" : dto.outcome === "planned" ? " (\uBE14\uB85D \uC124\uCE58 \uC608\uC815)" : " (\uBE14\uB85D \uAC31\uC2E0)");
+    process.stdout.write(options.format === "text" ? `${dto.outcome}: ${dto.rootPath}/.gitifact/config.json
+\uC800\uC7A5 \uADDC\uC57D: schemaVersion 1
+\uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68: ${docs}
+` : JSON.stringify(dto) + "\n");
   } catch (error62) {
-    const failure2 = skillsV1.parse({ contract: "skills", version: 1, ok: false, error: {
-      code: error62 instanceof InitError ? error62.code : "SKILLS_FAILED",
-      message: error62 instanceof Error ? error62.message : "\uC2A4\uD0AC \uC791\uC5C5 \uC2E4\uD328"
-    } });
-    console.error(JSON.stringify(failure2));
+    const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
+    const failure2 = { code: known ? error62.code : "INIT_FAILED", message: known ? error62.message : "\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." };
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(projectInitV4.parse({ contract: "project-init", version: 4, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
 
 // src/commands/spec-preview.ts
-import { join as join11 } from "node:path";
-import { readFile as readFile10, stat as stat2 } from "node:fs/promises";
+import { join as join12 } from "node:path";
+import { readFile as readFile11, stat as stat2 } from "node:fs/promises";
 
 // src/adapters/filesystem/spec-preview-prepare.ts
-import { lstat as lstat3 } from "node:fs/promises";
-import { join as join7 } from "node:path";
-import { createHash as createHash5 } from "node:crypto";
+import { lstat as lstat4 } from "node:fs/promises";
+import { join as join8 } from "node:path";
+import { createHash as createHash4 } from "node:crypto";
 var fail5 = (message) => {
   throw new SpecPreviewError(message);
 };
 var same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
-var expected = (base, stamp) => createHash5("sha256").update(JSON.stringify({ base, stamp })).digest("hex");
+var expected = (base, stamp) => createHash4("sha256").update(JSON.stringify({ base, stamp })).digest("hex");
 var previewExpected = expected;
-var parseFiles = parsePreviewFiles;
 async function readPreviewContext(cwd) {
   const reader = specPreviewReader(cwd);
   const { gitDir } = await reader.location();
   const checkOperation = async () => {
     for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) {
-      const exists = await lstat3(join7(gitDir, name)).catch((e) => {
+      const exists = await lstat4(join8(gitDir, name)).catch((e) => {
         if (e.code === "ENOENT") return void 0;
         throw e;
       });
@@ -25267,20 +25698,21 @@ async function readPreviewContext(cwd) {
   const base = await reader.baseline();
   const working = await readWorkingPreviewState(cwd);
   const files = base.head ? await reader.files(base.head, working.config !== void 0) : /* @__PURE__ */ new Map();
-  const specs = parseFiles(files);
+  const bundle = parsePreviewBundle(files);
+  const specs = bundle.specs;
   const recheck = async () => {
     await checkOperation();
     if (!same(base, await reader.baseline())) fail5("HEAD \uB610\uB294 \uBE0C\uB79C\uCE58\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. changes\uBD80\uD130 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.");
   };
-  return { reader, base, files, specs, recheck, working };
+  return { reader, base, files, specs, bundle, recheck, working };
 }
 var context = readPreviewContext;
 async function readFinalPreviewChanges(cwd) {
   const c = await context(cwd);
   const current = await readWorkingPreviewState(cwd);
-  const delta = finalSpecPreviewChanges(c.specs, current.specs);
+  const delta = finalSpecPreviewChanges(c.bundle, current.bundle);
   await c.recheck();
-  const pendingReasons = current.specs.flatMap((s) => s.history.slice(c.specs.find((p) => p.id === s.id)?.history.length ?? 0).map((h) => ({ specId: s.id, path: s.path.replace(/requirements\.md$/, "history.jsonl"), ...h })));
+  const pendingReasons = pendingPreviewReasons(c.bundle, current.bundle);
   return { base: c.base, expected: expected(c.base, current.stamp), stamp: current.stamp, pendingReasons, ...delta };
 }
 async function prepareWorkingPreview(cwd, input2, publish) {
@@ -25292,7 +25724,7 @@ async function prepareWorkingPreview(cwd, input2, publish) {
   if (request.expected !== expected(c.base, current.stamp)) fail5("\uC900\uBE44 \uC785\uB825\uC774 \uC624\uB798\uB410\uC2B5\uB2C8\uB2E4. changes\uBD80\uD130 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.");
   const result = await previewTransaction(cwd, current.stamp, async (before) => {
     await c.recheck();
-    const prepared = prepareSpecPreview(c.specs, before.specs, c.files, before.files, request.reasons, () => generatePreviewId("H"));
+    const prepared = prepareSpecPreview(c.bundle, before.bundle, c.files, before.files, request.reasons, () => generatePreviewId("H"));
     return { writes: prepared.writes, data: { changes: prepared.changes, specChanges: prepared.specChanges, reasons: prepared.reasons, withoutReason: prepared.withoutReason }, recheck: c.recheck };
   }, publish);
   return { ...result, base: c.base, expected: expected(c.base, result.stamp), verification: { base: c.base, stamp: result.stamp } };
@@ -25304,15 +25736,15 @@ async function verifyPreparedPreview(cwd, input2, staged) {
   const c = await context(cwd);
   const current = await readWorkingPreviewState(cwd);
   if (!same(request.base, c.base) || request.stamp !== current.stamp) fail5("\uC900\uBE44 \uB4A4 HEAD \uB610\uB294 \uBA85\uC138\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC900\uBE44\uD558\uC138\uC694.");
-  finalSpecPreviewChanges(c.specs, current.specs);
-  compareSpecPreviews(c.specs, current.specs);
+  finalSpecPreviewChanges(c.bundle, current.bundle);
+  comparePreviewBundles(c.bundle, current.bundle);
   if (staged) {
     const index = await c.reader.index();
     if (index.size !== current.files.size) fail5("staging\uC758 \uBA85\uC138 \uBC94\uC704\uAC00 \uC900\uBE44\uD55C \uC6D0\uBB38\uACFC \uB2E4\uB985\uB2C8\uB2E4.");
-    for (const [path3, source2] of current.files) {
+    for (const [path3, source] of current.files) {
       const oid2 = index.get(path3);
-      const bytes = Buffer.from(source2);
-      const hash3 = createHash5(oid2?.length === 64 ? "sha256" : "sha1").update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
+      const bytes = Buffer.from(source);
+      const hash3 = createHash4(oid2?.length === 64 ? "sha256" : "sha1").update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
       if (oid2 !== hash3) fail5("staging \uC6D0\uBB38\uC774 \uC900\uBE44\uD55C \uD30C\uC77C\uACFC \uB2E4\uB985\uB2C8\uB2E4: " + path3);
     }
     if (!same([...index], [...await c.reader.index()])) fail5("\uD655\uC778 \uC911 staging\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
@@ -25324,22 +25756,22 @@ async function verifyPreparedPreview(cwd, input2, staged) {
 
 // src/commands/spec-preview-commit.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
-import { readFile as readFile8, mkdir as mkdir4, open as open4, rename as rename3, unlink as unlink4, rmdir as rmdir2, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { readFile as readFile9, mkdir as mkdir4, open as open4, rename as rename3, unlink as unlink4, rmdir as rmdir2, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 
 // src/commands/spec-commit-files.ts
-import { createHash as createHash6 } from "node:crypto";
-import { lstat as lstat4, readFile as readFile7 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { createHash as createHash5 } from "node:crypto";
+import { lstat as lstat5, readFile as readFile8 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 var fail6 = (message) => {
   throw new SpecPreviewError(message);
 };
-var hash2 = (value) => createHash6("sha256").update(value).digest("hex");
-var optional2 = (path3) => readFile7(path3).catch((e) => {
+var hash2 = (value) => createHash5("sha256").update(value).digest("hex");
+var optional2 = (path3) => readFile8(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info2 = (path3) => lstat4(path3).catch((e) => {
+var info2 = (path3) => lstat5(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -25351,14 +25783,14 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target2 = join8(root, ...parts.slice(0, i));
-    const stat3 = await info2(target2);
+    const target = join9(root, ...parts.slice(0, i));
+    const stat3 = await info2(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail6("\uB9C1\uD06C\xB7\uB514\uB809\uD130\uB9AC\xB7\uD2B9\uC218 \uD30C\uC77C\uC740 \uC120\uD0DD\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    if (i < parts.length && await info2(join8(target2, ".git"))) fail6("\uC911\uCCA9 \uC800\uC7A5\uC18C\uB294 \uC120\uD0DD\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    if (i < parts.length && await info2(join9(target, ".git"))) fail6("\uC911\uCCA9 \uC800\uC7A5\uC18C\uB294 \uC120\uD0DD\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail6("\uD558\uB4DC \uB9C1\uD06C \uB610\uB294 \uD30C\uC77C \uD06C\uAE30 \uD55C\uB3C4\uB97C \uD655\uC778\uD558\uC138\uC694.");
-      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile7(target2)]));
+      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile8(target)]));
     }
   }
   return null;
@@ -25378,7 +25810,7 @@ function paths(value, limit = 128) {
   return list;
 }
 function policyPaths(files) {
-  const all = /* @__PURE__ */ new Set(["AGENTS.md", "CLAUDE.md", ".agents/skills/gitifact-workflow/SKILL.md", ".gitignore", ".gitattributes", ".gitifact/config.json", ".tryce/config.json"]);
+  const all = /* @__PURE__ */ new Set(["AGENTS.md", "CLAUDE.md", ".gitignore", ".gitattributes", ".gitifact/config.json", ".tryce/config.json"]);
   for (const file2 of files) {
     const parts = file2.split("/");
     for (let i = 1; i < parts.length; i++) for (const name of ["AGENTS.md", "CLAUDE.md", ".gitignore", ".gitattributes"]) all.add(parts.slice(0, i).join("/") + "/" + name);
@@ -25388,6 +25820,7 @@ function policyPaths(files) {
 async function checkLegacySelection(root, selected) {
   const legacyJson = /^\.(?:gitifact|tryce)\/(?:spec\/[^/]+\/tryce\.json|notes\/N-[a-f0-9-]+\.json|mode-[a-f0-9-]+\.json|config\.(?:init-1|prototype-1)\.[a-f0-9]+\.json)$/;
   for (const p of selected.filter((p2) => p2.startsWith(".gitifact/") && !record2(p2) && p2 !== ".gitifact/config.json")) {
+    if (isProductAssetPath(p)) continue;
     if (!legacyJson.test(p) || await fingerprint(root, p) !== null) fail6(".gitifact\uC758 \uAD6C\uD615 \uAE30\uB85D\uC740 \uC0AD\uC81C\uB9CC \uC120\uD0DD\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4: " + p);
   }
   for (const p of selected.filter((p2) => p2.startsWith(".tryce/"))) {
@@ -25420,7 +25853,7 @@ async function previewCommit(cwd, action, input2) {
   });
   const indexPath = (await git(["rev-parse", "--path-format=absolute", "--git-path", "index"])).toString("utf8").trim();
   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 = join9(gitDir, "gitifact-spec-commit.lock");
+  const busy = join10(gitDir, "gitifact-spec-commit.lock");
   if (await info2(busy)) fail6("\uC774\uC804 \uCEE4\uBC0B \uC791\uC5C5 \uB610\uB294 \uBCF5\uAD6C \uC790\uB8CC\uAC00 \uC788\uC2B5\uB2C8\uB2E4: " + busy);
   if ((await staged()).length) fail6("\uAE30\uC874 staging\uC744 \uBCF4\uC874\uD569\uB2C8\uB2E4. \uC120\uD0DD \uBC94\uC704\uB97C \uC815\uB9AC\uD55C \uD6C4 \uB2E4\uC2DC \uACC4\uD68D\uD558\uC138\uC694.");
   const request = object3(input2);
@@ -25462,8 +25895,8 @@ async function previewCommit(cwd, action, input2) {
     if (data2.index !== hash2(await optional2(indexPath) ?? Buffer.alloc(0)) || (await staged()).length) fail6("\uACC4\uD68D \uC911 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
     return { outcome: "planned", plan: { ...data2, digest: seal(data2) }, committed: false };
   }
-  const { digest: digest3, ...data } = request;
-  if (request.kind !== "spec-preview-commit" || typeof digest3 !== "string" || digest3 !== seal(data)) fail6("\uCEE4\uBC0B \uACC4\uD68D\uC774 \uC190\uC0C1\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uACC4\uD68D\uD558\uC138\uC694.");
+  const { digest: digest2, ...data } = request;
+  if (request.kind !== "spec-preview-commit" || typeof digest2 !== "string" || digest2 !== seal(data)) fail6("\uCEE4\uBC0B \uACC4\uD68D\uC774 \uC190\uC0C1\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uACC4\uD68D\uD558\uC138\uC694.");
   plan = request;
   if (plan.root !== root || !Array.isArray(plan.files) || !Array.isArray(plan.context)) fail6("\uACC4\uD68D\uC758 \uC800\uC7A5\uC18C \uB610\uB294 \uD30C\uC77C \uBC94\uC704\uAC00 \uB2E4\uB985\uB2C8\uB2E4.");
   const selected = paths(plan.files.map((f) => f.path));
@@ -25479,16 +25912,16 @@ async function previewCommit(cwd, action, input2) {
   const before = await reader.baseline();
   const original = await optional2(indexPath);
   await mkdir4(busy);
-  const draftLock = join9(gitDir, "gitifact-spec-preview.lock");
+  const draftLock = join10(gitDir, "gitifact-spec-preview.lock");
   let draftOwned = false;
   let indexLock;
   let uncertain = false;
   let commitStarted = false;
-  const temporary = join9(gitDir, "gitifact-commit-index-" + randomUUID6());
+  const temporary = join10(gitDir, "gitifact-commit-index-" + randomUUID6());
   const checkFiles = async () => {
     for (const f of [...plan.files, ...plan.context]) if (f.hash !== await fingerprint(root, f.path)) fail6("\uCEE4\uBC0B \uC900\uBE44 \uC911 \uD30C\uC77C\xB7\uC815\uCC45\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + f.path);
     if ((await readLockedPreviewState(root)).stamp !== object3(plan.verification).stamp) fail6("\uCEE4\uBC0B \uC900\uBE44 \uC911 \uBA85\uC138 \uC9D1\uD569\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info2(join9(gitDir, name))) fail6("Git \uD1B5\uD569 \uC791\uC5C5\uC774 \uC2DC\uC791\uB410\uC2B5\uB2C8\uB2E4.");
+    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info2(join10(gitDir, name))) fail6("Git \uD1B5\uD569 \uC791\uC5C5\uC774 \uC2DC\uC791\uB410\uC2B5\uB2C8\uB2E4.");
   };
   try {
     await verifyPreparedPreview(cwd, plan.verification, false);
@@ -25496,7 +25929,7 @@ async function previewCommit(cwd, action, input2) {
     draftOwned = true;
     indexLock = await open4(indexPath + ".lock", "wx", 384);
     if (plan.index !== hash2(await optional2(indexPath) ?? Buffer.alloc(0)) || (await staged()).length) fail6("\uC7A0\uAE08 \uC911 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-    await writeFile2(join9(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
+    await writeFile2(join10(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
     if (original) await writeFile2(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
     await git(["add", "--", ...selected], temporary);
@@ -25504,7 +25937,7 @@ async function previewCommit(cwd, action, input2) {
     if (!actual.length || actual.some((p) => !selected.includes(p))) fail6("\uBE48 \uCEE4\uBC0B \uB610\uB294 \uC120\uD0DD \uBC16 \uD30C\uC77C\uC774 \uAC10\uC9C0\uB410\uC2B5\uB2C8\uB2E4.");
     for (const file2 of plan.files.filter((f) => record2(f.path) && f.hash !== null)) {
       const stagedBytes = await git(["show", ":" + file2.path], temporary);
-      if (!stagedBytes.equals(await readFile8(join9(root, file2.path)))) fail6("Git \uD544\uD130\uAC00 \uBA85\uC138\xB7\uC774\uC720 \uC6D0\uBB38\uC744 \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
+      if (!stagedBytes.equals(await readFile9(join10(root, file2.path)))) fail6("Git \uD544\uD130\uAC00 \uBA85\uC138\xB7\uC774\uC720 \uC6D0\uBB38\uC744 \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
     }
     await checkFiles();
     if (JSON.stringify(before) !== JSON.stringify(await reader.baseline())) fail6("HEAD\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
@@ -25519,7 +25952,7 @@ async function previewCommit(cwd, action, input2) {
     if (actualTree !== tree || after.branch !== before.branch || JSON.stringify(parents) !== JSON.stringify(before.head ? [before.head] : []) || trailers.some((t) => !message.split(/\r?\n/).includes(t))) fail6("\uCEE4\uBC0B\uC740 \uC2E4\uD589\uB410\uC9C0\uB9CC \uD6C5\xB7\uB3D9\uC2DC \uC791\uC5C5\uC774 \uACB0\uACFC\uB97C \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
     if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== plan.index) fail6("\uCEE4\uBC0B \uD6C4 \uC6D0\uB798 index \uBCC0\uACBD\uC744 \uAC10\uC9C0\uD588\uC2B5\uB2C8\uB2E4.");
     if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail6("\uD6C5\uC774 \uCEE4\uBC0B \uD6C4 staging\uC744 \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
-    await indexLock.writeFile(await readFile8(temporary));
+    await indexLock.writeFile(await readFile9(temporary));
     await indexLock.sync();
     await indexLock.close();
     await rename3(indexPath + ".lock", indexPath);
@@ -25543,7 +25976,7 @@ async function previewCommit(cwd, action, input2) {
       });
       await unlink4(temporary).catch(() => {
       });
-      await unlink4(join9(busy, "recovery.json")).catch(() => {
+      await unlink4(join10(busy, "recovery.json")).catch(() => {
       });
       await rmdir2(busy);
       if (draftOwned) await rmdir2(draftLock);
@@ -25552,9 +25985,9 @@ async function previewCommit(cwd, action, input2) {
 }
 
 // src/commands/spec-commit.ts
-import { createHash as createHash8, randomUUID as randomUUID7 } from "node:crypto";
-import { mkdir as mkdir5, open as open5, readFile as readFile9, rename as rename4, rmdir as rmdir3, unlink as unlink5, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { createHash as createHash7, randomUUID as randomUUID7 } from "node:crypto";
+import { mkdir as mkdir5, open as open5, readFile as readFile10, rename as rename4, rmdir as rmdir3, unlink as unlink5, writeFile as writeFile3 } from "node:fs/promises";
+import { join as join11 } from "node:path";
 var fields = ["reasons", "paths", "message", "authorization", "requirements", "policyFiles", "expected"];
 var integration = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"];
 var same2 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
@@ -25593,18 +26026,18 @@ async function specCommit(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 = join10(gitDir, "gitifact-spec-commit.lock");
+  const busy = join11(gitDir, "gitifact-spec-commit.lock");
   await failOnLegacyLock(gitDir);
   if (await info2(busy)) fail6("\uC774\uC804 \uCEE4\uBC0B \uC791\uC5C5 \uB610\uB294 \uBCF5\uAD6C \uC790\uB8CC\uAC00 \uC788\uC2B5\uB2C8\uB2E4: " + busy);
   if ((await staged()).length) fail6("\uAE30\uC874 staging\uC744 \uBCF4\uC874\uD569\uB2C8\uB2E4. \uC120\uD0DD \uBC94\uC704\uB97C \uC815\uB9AC\uD55C \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.");
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
   const current = c.working;
   if (request.expected !== void 0 && request.expected !== previewExpected(c.base, current.stamp)) fail6("\uC785\uB825\uC774 \uC624\uB798\uB410\uC2B5\uB2C8\uB2E4. changes\uBD80\uD130 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.");
-  const reasons = request.reasons ?? current.specs.flatMap((s) => s.history.slice(c.specs.find((p) => p.id === s.id)?.history.length ?? 0).map((h) => ({ requirements: h.requirements, ...h.designs ? { designs: h.designs } : {}, reason: h.reason })));
-  const prepared = prepareSpecPreview(c.specs, current.specs, c.files, current.files, reasons, () => generatePreviewId("H"));
+  const reasons = request.reasons ?? pendingPreviewReasons(c.bundle, current.bundle).map((h) => ({ requirements: h.requirements, ...h.designs ? { designs: h.designs } : {}, ...h.documents ? { documents: h.documents } : {}, reason: h.reason }));
+  const prepared = prepareSpecPreview(c.bundle, current.bundle, c.files, current.files, reasons, () => generatePreviewId("H"));
   const blobId = (text2) => {
     const bytes = Buffer.from(text2);
-    return createHash8(objectFormat).update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
+    return createHash7(objectFormat).update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
   };
   const present = [...current.files.keys()];
   if (present.some((p) => p.includes("\n"))) fail6("\uC904\uBC14\uAFC8\uC774 \uD3EC\uD568\uB41C \uBA85\uC138 \uACBD\uB85C\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
@@ -25642,8 +26075,12 @@ async function specCommit(cwd, input2, dryRun) {
     await c.recheck();
     return { outcome: "dry-run", committed: false, ...summary };
   }
-  const trailers = [...requirements.map((id) => "Gitifact-Req: " + id), ...prepared.changes.filter((c2) => c2.kind === "design").map((c2) => "Gitifact-Design: " + c2.id)];
-  const temporary = join10(gitDir, "gitifact-commit-index-" + randomUUID7());
+  const trailers = [
+    ...requirements.map((id) => "Gitifact-Req: " + id),
+    ...prepared.changes.filter((c2) => c2.kind === "design").map((c2) => "Gitifact-Design: " + c2.id),
+    ...prepared.changes.filter((c2) => c2.kind === "product" || c2.kind === "guide").map((c2) => "Gitifact-Doc: " + c2.id)
+  ];
+  const temporary = join11(gitDir, "gitifact-commit-index-" + randomUUID7());
   let owned = false;
   let uncertain = false;
   let indexLock;
@@ -25659,12 +26096,12 @@ async function specCommit(cwd, input2, dryRun) {
     await previewTransaction(cwd, current.stamp, async () => ({ writes, data: {}, recheck: c.recheck }), rename4, async (published) => {
       let commitStarted = false;
       try {
-        const lock2 = indexLock = await open5(indexPath + ".lock", "wx", 384);
+        const lock = indexLock = await open5(indexPath + ".lock", "wx", 384);
         const original = await optional2(indexPath);
         if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail6("\uC2E4\uD589 \uC911 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
         const locked = await hashes([.../* @__PURE__ */ new Set([...selected, ...contextPaths])]);
         for (const [path3, value] of started) if (locked.get(path3) !== value) fail6("\uC2E4\uD589 \uC911 \uD30C\uC77C\xB7\uC815\uCC45\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + path3);
-        await writeFile3(join10(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
+        await writeFile3(join11(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
         if (original) await writeFile3(temporary, original, { flag: "wx" });
         else await git(["read-tree", "--empty"], temporary);
         await git(["add", "--", ...stageable], temporary);
@@ -25680,7 +26117,7 @@ async function specCommit(cwd, input2, dryRun) {
             const size = Number(header[2]);
             if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail6("staging\uB41C \uBA85\uC138\xB7\uC774\uC720\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: " + path3);
             const staged2 = output2.subarray(end + 1, end + 1 + size);
-            const file2 = await readFile9(join10(root, path3));
+            const file2 = await readFile10(join11(root, path3));
             if (!staged2.equals(file2) && !staged2.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail6("Git \uD544\uD130\uAC00 \uBA85\uC138\xB7\uC774\uC720 \uC6D0\uBB38\uC744 \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
             offset = end + size + 2;
           }
@@ -25688,7 +26125,7 @@ async function specCommit(cwd, input2, dryRun) {
         const again = await hashes([...locked.keys()]);
         for (const [path3, value] of locked) if (again.get(path3) !== value) fail6("\uCEE4\uBC0B \uC900\uBE44 \uC911 \uD30C\uC77C\xB7\uC815\uCC45\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: " + path3);
         if ((await readLockedPreviewState(root)).stamp !== published.stamp) fail6("\uCEE4\uBC0B \uC900\uBE44 \uC911 \uBA85\uC138 \uC9D1\uD569\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
-        for (const name of integration) if (await info2(join10(gitDir, name))) fail6("Git \uD1B5\uD569 \uC791\uC5C5\uC774 \uC2DC\uC791\uB410\uC2B5\uB2C8\uB2E4.");
+        for (const name of integration) if (await info2(join11(gitDir, name))) fail6("Git \uD1B5\uD569 \uC791\uC5C5\uC774 \uC2DC\uC791\uB410\uC2B5\uB2C8\uB2E4.");
         if (!same2(c.base, await c.reader.baseline())) fail6("HEAD\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.");
         const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
         commitStarted = true;
@@ -25703,9 +26140,9 @@ async function specCommit(cwd, input2, dryRun) {
         if (headers[0] !== "tree " + tree || after.branch !== c.base.branch || !same2(parents, c.base.head ? [c.base.head] : []) || trailers.some((t) => !body.split(/\r?\n/).includes(t))) fail6("\uCEE4\uBC0B\uC740 \uC2E4\uD589\uB410\uC9C0\uB9CC \uD6C5\xB7\uB3D9\uC2DC \uC791\uC5C5\uC774 \uACB0\uACFC\uB97C \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
         if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== indexHash) fail6("\uCEE4\uBC0B \uD6C4 \uC6D0\uB798 index \uBCC0\uACBD\uC744 \uAC10\uC9C0\uD588\uC2B5\uB2C8\uB2E4.");
         if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail6("\uD6C5\uC774 \uCEE4\uBC0B \uD6C4 staging\uC744 \uBCC0\uACBD\uD588\uC2B5\uB2C8\uB2E4.");
-        await lock2.writeFile(await readFile9(temporary));
-        await lock2.sync();
-        await lock2.close();
+        await lock.writeFile(await readFile10(temporary));
+        await lock.sync();
+        await lock.close();
         await rename4(indexPath + ".lock", indexPath);
         indexLock = void 0;
         committed = { commit: after.head, paths: actual };
@@ -25730,7 +26167,7 @@ async function specCommit(cwd, input2, dryRun) {
       await unlink5(temporary).catch(() => {
       });
       if (owned) {
-        await unlink5(join10(busy, "recovery.json")).catch(() => {
+        await unlink5(join11(busy, "recovery.json")).catch(() => {
         });
         await rmdir3(busy);
       }
@@ -25747,7 +26184,7 @@ async function execute(action, options) {
   try {
     const guard = specPreviewReader(process.cwd());
     const { root, gitDir, objectFormat } = await guard.location();
-    for (const marker2 of operations) if (await fileInfo(join11(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: " + marker2);
+    for (const marker2 of operations) if (await fileInfo(join12(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: " + marker2);
     if (await guard.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", "Git \uCDA9\uB3CC\uC744 \uBA3C\uC800 \uD574\uACB0\uD558\uC138\uC694.");
     const raw = await readConfigFile(root);
     if (raw === void 0) throw new SpecPreviewError("\uBA3C\uC800 gitifact init\uC73C\uB85C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
@@ -25759,9 +26196,9 @@ async function execute(action, options) {
       if (action === "working") result = await readWorkingPreview(process.cwd());
       else if (action === "changes") result = await readFinalPreviewChanges(process.cwd());
       else {
-        const source2 = await stat2(options.file);
-        if (!source2.isFile() || source2.size > 1024 * 1024) throw new SpecPreviewError("\uC785\uB825\uC740 1 MiB \uC774\uD558\uC758 JSON \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.");
-        const bytes = await readFile10(options.file);
+        const source = await stat2(options.file);
+        if (!source.isFile() || source.size > 1024 * 1024) throw new SpecPreviewError("\uC785\uB825\uC740 1 MiB \uC774\uD558\uC758 JSON \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.");
+        const bytes = await readFile11(options.file);
         if (bytes.length > 1024 * 1024) throw new SpecPreviewError("\uC785\uB825 \uD06C\uAE30\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.");
         let input2;
         try {
@@ -25777,12 +26214,12 @@ async function execute(action, options) {
     const reader = specPreviewReader(process.cwd());
     if (action === "read") {
       const commit = await reader.resolve(options.ref ?? "HEAD");
-      const specs = await reader.read(commit);
-      process.stdout.write(JSON.stringify({ ...envelope, ok: true, commit, specs }) + "\n");
+      const bundle = await reader.readBundle(commit);
+      process.stdout.write(JSON.stringify({ ...envelope, ok: true, commit, specs: bundle.specs, documents: bundle.documents }) + "\n");
     } else {
       const [from, to] = await Promise.all([reader.resolve(options.from), reader.resolve(options.to)]);
-      const [before, after] = await Promise.all([reader.read(from), reader.read(to)]);
-      process.stdout.write(JSON.stringify({ ...envelope, ok: true, from, to, ...compareSpecPreviews(before, after) }) + "\n");
+      const [before, after] = await Promise.all([reader.readBundle(from), reader.readBundle(to)]);
+      process.stdout.write(JSON.stringify({ ...envelope, ok: true, from, to, ...comparePreviewBundles(before, after) }) + "\n");
     }
   } catch (error62) {
     const known = error62 instanceof SpecPreviewError || error62 instanceof RepositoryReadError || error62 instanceof InitError;
@@ -25792,11 +26229,11 @@ async function execute(action, options) {
 }
 
 // src/commands/migrate.ts
-import { lstat as lstat6, readdir as readdir4, readFile as readFile11, rename as rename5, writeFile as writeFile4, unlink as unlink6 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { lstat as lstat7, readdir as readdir4, readFile as readFile12, rename as rename5, writeFile as writeFile4, unlink as unlink6 } from "node:fs/promises";
+import { join as join13 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 var operations2 = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
-var info3 = (path3) => lstat6(path3).catch((e) => {
+var info3 = (path3) => lstat7(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -25807,18 +26244,18 @@ var fail7 = (code, message) => {
 async function migrateStore(cwd, dryRun = false) {
   const reader = specPreviewReader(cwd);
   const { root, gitDir } = await reader.location();
-  for (const marker3 of operations2) if (await info3(join12(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: " + marker3);
+  for (const marker3 of operations2) if (await info3(join13(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: " + marker3);
   if (await reader.hasUnmerged()) fail7("GIT_OPERATION_IN_PROGRESS", "Git \uCDA9\uB3CC\uC744 \uBA3C\uC800 \uD574\uACB0\uD558\uC138\uC694.");
-  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info3(join12(gitDir, name))) fail7("LOCKED", "\uC7A0\uAE08 \uB610\uB294 \uBCF5\uAD6C \uC790\uB8CC\uAC00 \uC788\uC2B5\uB2C8\uB2E4: " + join12(gitDir, name));
-  const from = join12(root, ".tryce");
-  const to = join12(root, ".gitifact");
+  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info3(join13(gitDir, name))) fail7("LOCKED", "\uC7A0\uAE08 \uB610\uB294 \uBCF5\uAD6C \uC790\uB8CC\uAC00 \uC788\uC2B5\uB2C8\uB2E4: " + join13(gitDir, name));
+  const from = join13(root, ".tryce");
+  const to = join13(root, ".gitifact");
   const fromInfo = await info3(from);
   if (await info3(to)) fail7("ALREADY_MIGRATED", ".gitifact\uAC00 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4. .tryce\uAC00 \uB0A8\uC544 \uC788\uC73C\uBA74 \uB0B4\uC6A9\uC744 \uBE44\uAD50\uD55C \uB4A4 \uC9C1\uC811 \uC815\uB9AC\uD558\uC138\uC694.");
   if (!fromInfo) return fail7("NOTHING_TO_MIGRATE", ".tryce \uC800\uC7A5\uC18C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
   if (!fromInfo.isDirectory() || fromInfo.isSymbolicLink()) fail7("PATH_CONFLICT", ".tryce\uB294 \uB9C1\uD06C\uAC00 \uC544\uB2CC \uC77C\uBC18 \uB514\uB809\uD130\uB9AC\uC5EC\uC57C \uD569\uB2C8\uB2E4.");
-  const configInfo = await info3(join12(from, "config.json"));
+  const configInfo = await info3(join13(from, "config.json"));
   if (!configInfo?.isFile() || configInfo.isSymbolicLink()) fail7("NOT_INITIALIZED", ".tryce/config.json\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-  const config2 = parseManagedConfig(decode4(await readFile11(join12(from, "config.json"))));
+  const config2 = parseManagedConfig(decode4(await readFile12(join13(from, "config.json"))));
   if (!("schemaVersion" in config2)) fail7("UNSUPPORTED_FORMAT", "\uAD6C\uD615 JSON \uD615\uC2DD\uC740 \uC804\uD658\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uAE30\uB85D\uC744 \uBCF4\uC874\uD558\uACE0 \uBCC4\uB3C4 \uC808\uCC28\uB97C \uD655\uC778\uD558\uC138\uC694.");
   const top = (await readdir4(from)).sort();
   if (top.some((name) => name !== "config.json" && name !== "spec")) fail7("UNSUPPORTED_FORMAT", ".tryce\uC5D0 config.json\xB7spec \uC678 \uD56D\uBAA9\uC774 \uC788\uC2B5\uB2C8\uB2E4. \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.");
@@ -25827,20 +26264,20 @@ async function migrateStore(cwd, dryRun = false) {
   const legacyRecords = [];
   const marker2 = /^<!-- tryce-(spec|req|design|ref): /;
   if (top.includes("spec")) {
-    for (const feature2 of (await readdir4(join12(from, "spec"))).sort()) {
-      const dir = join12(from, "spec", feature2);
+    for (const feature2 of (await readdir4(join13(from, "spec"))).sort()) {
+      const dir = join13(from, "spec", feature2);
       const stat3 = await info3(dir);
       if (!stat3?.isDirectory() || stat3.isSymbolicLink()) fail7("UNSUPPORTED_FORMAT", "\uBA85\uC138 \uD3F4\uB354\uAC00 \uC544\uB2D9\uB2C8\uB2E4: " + feature2);
       for (const name of (await readdir4(dir)).sort()) {
         if (!["requirements.md", "design.md", "history.jsonl", "tryce.json"].includes(name)) fail7("UNSUPPORTED_FORMAT", "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBA85\uC138 \uD30C\uC77C\uC785\uB2C8\uB2E4: .tryce/spec/" + feature2 + "/" + name);
-        const fileStat = await info3(join12(dir, name));
+        const fileStat = await info3(join13(dir, name));
         if (!fileStat?.isFile() || fileStat.isSymbolicLink() || fileStat.nlink !== 1 || fileStat.size > 1024 * 1024) fail7("UNSUPPORTED_FORMAT", "\uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2C8\uAC70\uB098 1 MiB\uB97C \uB118\uC2B5\uB2C8\uB2E4: " + name);
         const newPath = `.gitifact/spec/${feature2}/${name}`;
         if (name === "tryce.json") {
           legacyRecords.push(newPath);
           continue;
         }
-        const text2 = decode4(await readFile11(join12(dir, name)));
+        const text2 = decode4(await readFile12(join13(dir, name)));
         if (name === "history.jsonl") {
           files.set(newPath, text2);
           continue;
@@ -25878,15 +26315,15 @@ async function migrateStore(cwd, dryRun = false) {
     next: [
       "\uBCC0\uACBD\uC744 \uD655\uC778\uD55C \uB4A4 gitifact spec commit\uC73C\uB85C .tryce \uC0AD\uC81C\uC640 .gitifact \uCD94\uAC00\uB97C \uD568\uAED8 \uCEE4\uBC0B\uD558\uC138\uC694.",
       ...legacyRecords.length ? ["\uAD6C\uD615 JSON \uBA85\uC138(tryce.json)\uB294 \uC77D\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB0B4\uC6A9\uC744 Markdown \uBA85\uC138\uB85C \uC62E\uAE34 \uB4A4 \uC0AD\uC81C\uB97C spec commit\uC5D0 \uC120\uD0DD\uD558\uC138\uC694."] : [],
-      ".agents/skills/tryce-workflow\uC640 .claude \uBCF5\uC0AC\uBCF8\uC774 \uC788\uC73C\uBA74 \uC815\uB9AC\uD558\uACE0 gitifact skills install\uB85C \uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694.",
+      ".agents/skills/tryce-workflow\uC640 .claude \uBCF5\uC0AC\uBCF8\uC774 \uC788\uC73C\uBA74 \uC815\uB9AC\uD558\uACE0 gitifact init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD574 AGENTS.md \uB4F1\uC758 GITIFACT \uBE14\uB85D\uC744 \uAC31\uC2E0\uD558\uC138\uC694.",
       ".gitignore\xB7AGENTS.md\xB7CLAUDE.md\uC758 .tryce\xB7tryce-workflow \uC5B8\uAE09\uC744 \uC0C8 \uC774\uB984\uC73C\uB85C \uB9DE\uCD94\uC138\uC694."
     ]
   });
   if (dryRun) return result("planned");
   await rename5(from, to);
   for (const r of rewrites) {
-    const full = join12(root, r.path);
-    const temp = join12(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes2(8).toString("hex"));
+    const full = join13(root, r.path);
+    const temp = join13(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes2(8).toString("hex"));
     await writeFile4(temp, r.content, { flag: "wx" });
     try {
       await rename5(temp, full);
@@ -25909,20 +26346,16 @@ async function runMigrate(options) {
 }
 
 // src/main.ts
-var program2 = new Command().name("gitifact").description("\uD504\uB85C\uC81D\uD2B8\uC758 \uC694\uAD6C\uC0AC\uD56D\uACFC \uACB0\uC815 \uC774\uB825\uC744 Git\uC5D0 \uB0A8\uAE30\uB294 \uB3C4\uAD6C").version("0.1.0").allowExcessArguments(false).addHelpText("after", "\n\uC804\uCCB4 \uC774\uB825 \uAC80\uC0AC\uC640 GUI \uC694\uAD6C\uC0AC\uD56D \uD3B8\uC9D1\uC740 \uC544\uC9C1 \uC81C\uACF5\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.").action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").description("\uD504\uB85C\uC81D\uD2B8\uC758 \uC694\uAD6C\uC0AC\uD56D\uACFC \uACB0\uC815 \uC774\uB825\uC744 Git\uC5D0 \uB0A8\uAE30\uB294 \uB3C4\uAD6C").version("0.3.0").allowExcessArguments(false).addHelpText("after", "\n\uC804\uCCB4 \uC774\uB825 \uAC80\uC0AC\uC640 GUI \uC694\uAD6C\uC0AC\uD56D \uD3B8\uC9D1\uC740 \uC544\uC9C1 \uC81C\uACF5\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.").action(() => program2.outputHelp());
 program2.command("status").description("\uD604\uC7AC checkout\uC758 Git \uC0C1\uD0DC \uC870\uD68C (gitifact \uAC80\uC0AC \uBBF8\uC2E4\uD589)").allowExcessArguments(false).addOption(new Option("--format <format>", "\uCD9C\uB825 \uD615\uC2DD").choices(["json", "text"]).default("json")).action(async (options) => {
   await runStatus(options.format);
 });
 program2.command("browser").description("\uD604\uC7AC checkout\uC758 Git \uC0C1\uD0DC\uB97C \uB85C\uCEEC \uBE0C\uB77C\uC6B0\uC800\uB85C \uC870\uD68C").allowExcessArguments(false).option("--port <port>", "\uC218\uC2E0 \uD3EC\uD2B8 (0\uC740 \uC790\uB3D9 \uC120\uD0DD)", parsePort, 0).option("--dev", "Vite \uAC1C\uBC1C \uC11C\uBC84 Origin \uD5C8\uC6A9").action(runBrowser);
-program2.command("init").description("\uD504\uB85C\uC81D\uD2B8 \uC124\uC815\uACFC \uB3C4\uC785 \uAE30\uC900\uC120 \uC0DD\uC131 (\uC2A4\uD0AC\xB7\uD6C5 \uC81C\uC678)").allowExcessArguments(false).option("--dry-run", "\uD30C\uC77C\uC744 \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 \uCD08\uAE30\uD654 \uACC4\uD68D \uD655\uC778").addOption(new Option("--format <format>", "\uCD9C\uB825 \uD615\uC2DD").choices(["json", "text"]).default("json")).action(runInit);
+program2.command("init").description("\uD504\uB85C\uC81D\uD2B8 \uC124\uC815\xB7\uAE30\uC900\uC120 \uC0DD\uC131\uACFC \uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68 \uD30C\uC77C\uC758 GITIFACT \uBE14\uB85D \uC124\uCE58 (\uC7AC\uC2E4\uD589 \uC2DC \uBE14\uB85D \uAC31\uC2E0)").allowExcessArguments(false).option("--dry-run", "\uD30C\uC77C\uC744 \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 \uCD08\uAE30\uD654 \uACC4\uD68D \uD655\uC778").addOption(new Option("--agent <agent>", "\uC9C0\uCE68 \uD30C\uC77C \uB300\uC0C1 (\uAE30\uBCF8: \uAE30\uC874 \uD30C\uC77C \uC804\uBD80, \uC5C6\uC73C\uBA74 AGENTS.md)").choices([...agentPresetNames])).addOption(new Option("--remove-agents", "GITIFACT \uBE14\uB85D\uC744 \uC81C\uAC70").conflicts("skipAgents")).option("--skip-agents", "\uC9C0\uCE68 \uD30C\uC77C\uC744 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC74C").addOption(new Option("--format <format>", "\uCD9C\uB825 \uD615\uC2DD").choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.3.0"));
+program2.command("docs").description("\uC5D0\uC774\uC804\uD2B8\uC6A9 \uC791\uC5C5 \uC9C0\uCE68 \uCD9C\uB825 (\uC8FC\uC81C \uC5C6\uC774 \uC2E4\uD589\uD558\uBA74 \uBAA9\uB85D)").argument("[topic]", "workflow, spec, design, product, commit \uC911 \uD558\uB098").allowExcessArguments(false).action(async (topic) => {
+  await runDocs(topic);
+});
 program2.command("migrate").description(".tryce \uC800\uC7A5\uC18C\uB97C .gitifact\uB85C \uC804\uD658 (\uACBD\uB85C\uC640 \uB9C8\uCEE4\uB9CC \uBC14\uAFB8\uACE0 ID\xB7\uC774\uC720\xB7\uC774\uB825\uC740 \uBCF4\uC874)").allowExcessArguments(false).option("--dry-run", "\uD30C\uC77C\uC744 \uBC14\uAFB8\uC9C0 \uC54A\uACE0 \uC804\uD658 \uACC4\uD68D \uD655\uC778").action(runMigrate);
-var outputOption = () => new Option("--format <format>", "\uCD9C\uB825 \uD615\uC2DD").choices(["json", "text"]).default("json");
-var skills = program2.command("skills").description("\uD504\uB85C\uC81D\uD2B8 \uC2A4\uD0AC \uC6D0\uBCF8 \uC124\uCE58\uC640 \uB85C\uCEEC \uBCF5\uC0AC\uBCF8 \uAD00\uB9AC");
-for (const action of ["install", "sync", "remove"]) {
-  const command = skills.command(action).allowExcessArguments(false).option("--dry-run", "\uD30C\uC77C\uC744 \uC4F0\uC9C0 \uC54A\uACE0 \uACC4\uD68D \uD655\uC778").addOption(outputOption());
-  if (action !== "remove") command.addOption(new Option("--agent <agent>", "\uC0AC\uC6A9\uD560 \uC5D0\uC774\uC804\uD2B8").choices(["codex", "claude"]));
-  command.action((options) => runSkills(action, options));
-}
 var spec = program2.command("spec").description("Markdown \uBA85\uC138 \uC791\uC131\xB7\uC870\uD68C\xB7Git \uAE30\uB85D");
 var replaced = "Deprecated: 0.6.0\uC5D0\uC11C \uC81C\uAC70 \uC608\uC815. spec commit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.";
 spec.command("commit").description("\uBCC0\uACBD \uC774\uC720 \uAE30\uB85D\uACFC \uAD00\uB828 \uD30C\uC77C \uCEE4\uBC0B\uC744 \uD55C \uBC88\uC5D0 \uC2E4\uD589").allowExcessArguments(false).requiredOption("--file <path>", "reasons\xB7paths\xB7message\xB7authorization\uC744 \uB2F4\uC740 JSON \uD30C\uC77C").option("--dry-run", "\uD30C\uC77C\uC744 \uC4F0\uAC70\uB098 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uACE0 \uACB0\uACFC\uB9CC \uD655\uC778").action((o) => runSpecPreview("commit", o));