boxglow 0.6.3 → 0.6.5

package/bin/boxglow.js

@@ -1135,7 +1135,11 @@ var parts = {
   "\u3002\u3046\u3061\u672A\u7740\u624B\u306E {n} \u7BB1\u306F\u6C7A\u307E\u308B\u307E\u3067\u5F85\u3061\u307E\u3059": "; {n} not-started boxes wait until it is decided",
   "\u672A\u6C7A\u5B9A": "Undecided",
   "\u6E08\u3093\u3060\u4F5C\u696D\u304C\u3053\u306E\u65B9\u91DD\u306B\u5408\u3063\u3066\u3044\u308B\u3053\u3068\u3092\u78BA\u304B\u3081\u305F (\u78BA\u304B\u3081\u76F4\u3057\u306E\u672D\u3092\u6D88\u3059)": "The finished work matches this policy (clears the check-again mark)",
-  "\u78BA\u304B\u3081\u305F": "Checked"
+  "\u78BA\u304B\u3081\u305F": "Checked",
+  "\u30A8\u30C7\u30A3\u30BF\u3067\u958B\u304F: {path}": "Open in the editor: {path}",
+  "\u65B0\u3057\u3044\u30BF\u30D6\u3067\u958B\u304F: {path}": "Open in a new tab: {path}",
+  "\u30D1\u30B9\u3092\u30B3\u30D4\u30FC: {path}": "Copy the path: {path}",
+  "\u8A18\u9332\u3057\u305F\u3068\u304D\u306E\u7248\u3092\u30D6\u30E9\u30A6\u30B6\u3067\u898B\u308B": "See the recorded version in the browser"
 };
 
 // src/i18n/en/canvas.ts
@@ -1652,7 +1656,10 @@ var app = {
   "\u300C{name}\u300D\u3092\u524A\u9664\u3057\u307E\u3057\u305F (Undo \u3067\u623B\u305B\u307E\u3059)": 'Removed "{name}" (Undo brings it back)',
   "\u81EA\u52D5\u4FDD\u5B58: \u30AA\u30F3 (\u5909\u66F4\u306E\u305F\u3073\u306B\u66F8\u304D\u8FBC\u307F\u307E\u3059\u3002\u62BC\u3059\u3068\u30AA\u30D5)": "Auto save: on (every change is written; click to turn off)",
   "\u81EA\u52D5\u4FDD\u5B58: \u30AA\u30D5 (Save \u304B Ctrl+S \u3067\u66F8\u304D\u8FBC\u307F\u307E\u3059\u3002\u62BC\u3059\u3068\u30AA\u30F3)": "Auto save: off (Save or Ctrl+S writes; click to turn on)",
-  "{file} \u306B\u4FDD\u5B58\u3057\u307E\u3059 (\u81EA\u52D5\u4FDD\u5B58\u306F\u30AA\u30D5: Save \u304B Ctrl+S \u3067\u66F8\u304D\u307E\u3059)": "Saves to {file} (auto save is off: Save or Ctrl+S writes)"
+  "{file} \u306B\u4FDD\u5B58\u3057\u307E\u3059 (\u81EA\u52D5\u4FDD\u5B58\u306F\u30AA\u30D5: Save \u304B Ctrl+S \u3067\u66F8\u304D\u307E\u3059)": "Saves to {file} (auto save is off: Save or Ctrl+S writes)",
+  "\u30D1\u30B9\u3092\u30B3\u30D4\u30FC\u3057\u307E\u3057\u305F: {path} (\u30D6\u30E9\u30A6\u30B6\u304B\u3089\u306F\u624B\u5143\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u958B\u3051\u307E\u305B\u3093\u3002VS Code \u62E1\u5F35\u304B serve \u3067\u958B\u304F\u3068\u3001\u62BC\u3059\u3060\u3051\u3067\u958B\u3051\u307E\u3059)": "Copied the path: {path} (a browser cannot open files on this computer; in the VS Code extension or serve, clicking opens the file)",
+  "\u3053\u306E\u30D5\u30A1\u30A4\u30EB\u306F\u30D6\u30E9\u30A6\u30B6\u304B\u3089\u306F\u958B\u3051\u307E\u305B\u3093: {path}": "This file cannot be opened from the browser: {path}",
+  "\u30D5\u30A1\u30A4\u30EB\u3092\u958B\u3051\u307E\u305B\u3093\u3067\u3057\u305F: {path}": "Could not open the file: {path}"
 };
 
 // src/i18n/en/cli.ts
@@ -1685,6 +1692,9 @@ var cli = {
   "\u633F\u5165: \u300C{title}\u300D(id: {id}) \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8 {name} v{version}": 'Inserted: "{title}" (id: {id}) template {name} v{version}',
   "\u5165\u529B\u30B0\u30EB\u30FC\u30D7\u3092\u8FFD\u52A0: \u300C{name}\u300D": 'Added input group: "{name}"',
   "\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u300C{name}\u300D\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093 ({list})": 'Top-level input "{name}" not found ({list})',
+  "\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u304C\u8907\u6570\u3042\u308A\u307E\u3059\u3002--input <\u5165\u529B\u540D> \u3067\u9078\u3093\u3067\u304F\u3060\u3055\u3044 ({list})": "The plan has several top-level inputs. Choose one with --input <input name> ({list})",
+  "\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306B\u8CC7\u6599\u3092\u4ED8\u3051\u307E\u3057\u305F: \u300C{port}\u300D <- {artifact}": 'Attached material to the top-level input "{port}" <- {artifact}',
+  "\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306B\u8CC7\u6599\u3092\u4ED8\u3051\u308B\u524D\u306B context \u3092\u8AAD\u307F\u3001--context-token \u3092\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044\u3002": "Read context first and pass --context-token before attaching material to a top-level input.",
   "\u30B0\u30EB\u30FC\u30D7\u300C{name}\u300D\u304C\u3042\u308A\u307E\u305B\u3093 ({list})": 'No group named "{name}" ({list})',
   "\u300C{port}\u300D\u3092 \u30B0\u30EB\u30FC\u30D7\u300C{group}\u300D \u3078": 'Moved "{port}" to group "{group}"',
   "\u300C{port}\u300D\u3092 Inputs \u3078": 'Moved "{port}" to Inputs',
@@ -1832,6 +1842,22 @@ var cli = {
   '--options "A|B" (\u307E\u305F\u306F --option \u3092\u7E70\u308A\u8FD4\u3057\u3066) \u9078\u629E\u80A2\u3092 2 \u3064\u4EE5\u4E0A\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044': 'Give at least two options with --options "A|B" (or repeat --option)',
   "\u5206\u5C90\u3092\u8FFD\u52A0: \u300C{title}\u300D(id: {id})\u3002\u9053 (\u51FA\u529B): {options}\u3002\u5224\u65AD\u306B\u7B54\u3048\u308B\u3068\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u9053\u306E\u5148\u306F\u898B\u9001\u308A\u306B\u306A\u308A\u307E\u3059": 'Branch added: "{title}" (id: {id}). Paths (outputs): {options}. Once its decision is answered, the paths not chosen are skipped',
   "\u5408\u6D41 {name}": "merge {name}",
+  "\u300C{title}\u300D\u306B\u78BA\u304B\u3081\u76F4\u3057\u306E\u65B9\u91DD\u300C{name}\u300D\u306F\u3042\u308A\u307E\u305B\u3093 ({list})": '"{title}" has no policy "{name}" to check again ({list})',
+  "\u300C{title}\u300D\u306B\u78BA\u304B\u3081\u76F4\u3057\u306E\u65B9\u91DD\u306F\u3042\u308A\u307E\u305B\u3093": '"{title}" has no policy to check again',
+  "\u65B9\u91DD\u3092\u78BA\u304B\u3081\u307E\u3057\u305F: \u300C{title}\u300D <- {list}": 'Checked against the policies: "{title}" <- {list}',
+  "\u5165\u529B\u300C{name}\u300D\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093": 'Input "{name}" not found',
+  "\u5FC5\u9808 {name}": "required {name}",
+  "\u4EFB\u610F {name}": "optional {name}",
+  "--describe \u306F <\u540D\u524D>=<\u8AAC\u660E> \u306E\u5F62\u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044: {spec}": "Use --describe <name>=<description>: {spec}",
+  "\u8AAC\u660E {name}": "description {name}",
+  "--remove <\u984C\u540D\u304B\u30D1\u30B9\u304B URL> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044": "Specify --remove <title, path or URL>",
+  "\u300C{key}\u300D\u3068\u3044\u3046\u6210\u679C\u7269\u30FB\u8CC7\u6599\u306F\u4ED8\u3044\u3066\u3044\u307E\u305B\u3093 ({list})": 'Nothing called "{key}" is attached ({list})',
+  "\u5916\u3057\u307E\u3057\u305F: {key} ({list})": "Removed: {key} ({list})",
+  "\u4EFB\u610F (\u7121\u304F\u3066\u3082\u7740\u624B\u3067\u304D\u308B) \u306B\u3059\u308B\u5165\u529B\u306E\u540D\u524D": "Inputs to make optional (work can start without them)",
+  "\u5FC5\u9808\u306B\u623B\u3059\u5165\u529B\u306E\u540D\u524D": "Inputs to make required again",
+  '\u5165\u51FA\u529B\u306E\u8AAC\u660E: "<\u540D\u524D>=<\u8AAC\u660E>" (\u540C\u540D\u304C\u4E21\u65B9\u306B\u3042\u308C\u3070 in:<\u540D\u524D> / out:<\u540D\u524D>)': 'Port descriptions: "<name>=<description>" (if an input and an output share the name, use in:<name> / out:<name>)',
+  "\u65B9\u91DD\u306E\u78BA\u304B\u3081\u76F4\u3057\u3092\u6D88\u3059 (true = \u78BA\u304B\u3081\u76F4\u3057\u306E\u65B9\u91DD\u3059\u3079\u3066\u3001\u540D\u524D = \u305D\u306E\u65B9\u91DD\u3060\u3051)\u3002\u6E08\u3093\u3060\u4F5C\u696D\u304C\u65B9\u91DD\u306B\u5408\u3063\u3066\u3044\u308B\u3053\u3068\u3092\u78BA\u304B\u3081\u305F\u3068\u304D": 'Clear "Policy: check again" (true = every such policy, a name = only that one), after checking that the finished work matches the policy',
+  "true \u306A\u3089 path \u306E\u6210\u679C\u7269\u30FB\u8CC7\u6599\u3092\u5916\u3059 (\u984C\u540D\u304B\u30D1\u30B9\u304B URL \u3067\u63A2\u3059)": "If true, remove the attached item named by path (matched by title, path or URL)",
   "\u901A\u5E38 {name}": "all-of {name}",
   "--in <\u540D\u524D> / --out <\u540D\u524D> / --rename <\u65E7\u540D>=<\u65B0\u540D> / --any-of <\u5165\u529B\u540D> / --all-of <\u5165\u529B\u540D> \u306E\u3044\u305A\u308C\u304B\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044": "Specify one of --in <name> / --out <name> / --rename <old>=<new> / --any-of <input> / --all-of <input>",
   "\u5408\u6D41\u306B\u3059\u308B\u5165\u529B\u306E\u540D\u524D (\u5206\u304B\u308C\u305F\u9053\u304C\u307E\u3068\u307E\u308B\u3068\u3053\u308D)": "Names of inputs to make a merge (where the paths of a branch come together)",
@@ -1967,7 +1993,7 @@ var cli = {
   "\u3042\u308A": "present",
   "\u306A\u3057": "absent",
   "\u3042\u308A (\u5370 {mark})": "present (mark {mark})",
-  "--in <\u540D\u524D> / --out <\u540D\u524D> / --remove <\u540D\u524D> / --policy <\u51FA\u529B\u540D> / --expect <\u51FA\u529B\u540D>=<kind>:<hint> / --self <\u51FA\u529B\u540D> / --rename <\u65E7\u540D>=<\u65B0\u540D> / --any-of <\u5165\u529B\u540D> / --all-of <\u5165\u529B\u540D> \u306E\u3044\u305A\u308C\u304B\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044": "Give at least one of --in <name> / --out <name> / --remove <name> / --policy <output> / --expect <output>=<kind>:<hint> / --self <output> / --rename <old>=<new> / --any-of <input> / --all-of <input>",
+  "--in <\u540D\u524D> / --out <\u540D\u524D> / --remove <\u540D\u524D> / --policy <\u51FA\u529B\u540D> / --expect <\u51FA\u529B\u540D>=<kind>:<hint> / --self <\u51FA\u529B\u540D> / --rename <\u65E7\u540D>=<\u65B0\u540D> / --any-of <\u5165\u529B\u540D> / --all-of <\u5165\u529B\u540D> / --optional <\u5165\u529B\u540D> / --required <\u5165\u529B\u540D> / --describe <\u540D\u524D>=<\u8AAC\u660E> \u306E\u3044\u305A\u308C\u304B\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044": "Specify one of --in <name> / --out <name> / --remove <name> / --policy <output> / --expect <output>=<kind>:<hint> / --self <output> / --rename <old>=<new> / --any-of <input> / --all-of <input> / --optional <input> / --required <input> / --describe <name>=<description>",
   "\u300C{name}\u300D\u306F\u5165\u529B\u3068\u51FA\u529B\u306E\u4E21\u65B9\u306B\u3042\u308A\u307E\u3059\u3002in:{name} / out:{name} \u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044": '"{name}" exists as both an input and an output; use in:{name} / out:{name}',
   "\u524A\u9664: {name} (\u4F7F\u3046\u7BB1\u306E\u5165\u529B {count} \u4EF6\u3082)": "deleted: {name} (and {count} input(s) of the boxes that use it)",
   "\u524A\u9664: {name}": "deleted: {name}",
@@ -1976,7 +2002,7 @@ var cli = {
   "\u5206\u5C90\u306E\u9053: \u300C{title}\u300D: {list}": 'Branch paths: "{title}": {list}',
   "\u53D6\u308A\u4E0B\u3052\u3089\u308C\u308B\u5224\u65AD (\u672A\u56DE\u7B54) \u304C\u3042\u308A\u307E\u305B\u3093": "There is no unanswered decision to withdraw",
   "\u53D6\u308A\u4E0B\u3052: \u300C{title}\u300D\u306E\u554F\u3044\u3092\u524A\u9664\u3057\u307E\u3057\u305F": 'Withdrawn: the question on "{title}" was deleted',
-  "\u6D88\u3059\u30DD\u30FC\u30C8\u306E\u540D\u524D (\u5165\u529B\u3092\u6D88\u3059\u3068\u3001\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u6700\u5F8C\u306E\u51FA\u529B\u306F\u6D88\u305B\u306A\u3044\u3002\u540C\u540D\u304C\u4E21\u65B9\u306B\u3042\u308C\u3070 in:<\u540D\u524D> / out:<\u540D\u524D>)": "Names of ports to remove (removing an input also removes the inputs of the boxes that use it; the last output stays; if an input and an output share the name, use in:<name> / out:<name>)",
+  "\u6D88\u3059\u30DD\u30FC\u30C8\u306E\u540D\u524D (\u5165\u529B\u3092\u6D88\u3059\u3068\u3001\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u540C\u540D\u304C\u4E21\u65B9\u306B\u3042\u308C\u3070 in:<\u540D\u524D> / out:<\u540D\u524D>)": "Names of ports to remove (removing an input also removes the inputs of the boxes that use it; if an input and an output share the name, use in:<name> / out:<name>)",
   "\u554F\u3044\u3092\u53D6\u308A\u4E0B\u3052\u308B (\u672A\u56DE\u7B54\u3060\u3051\u3002\u5206\u5C90\u306E\u554F\u3044\u306F\u6D88\u305B\u306A\u3044\u3002\u56DE\u7B54\u6E08\u307F\u306F reopen)": "Withdraw a question (unanswered only; a branch's question cannot be removed; answered ones use reopen)",
   "\u5224\u65AD\u306E id (\u7701\u7565\u3059\u308B\u3068\u6700\u65B0\u306E\u672A\u56DE\u7B54)": "Decision id (default: the latest unanswered one)",
   "--to <\u4F5C\u308A\u76F4\u3059\u7BB1> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044 (\u5019\u88DC: {list})": "Give --to <box to redo> (candidates: {list})",
@@ -1995,7 +2021,10 @@ var cli = {
   "\u65B9\u91DD\u306E\u7BC4\u56F2: all = \u8A08\u753B\u5168\u4F53\u3001<block> = \u305D\u306E\u7BB1\u306E\u4E2D\u3001\u7701\u7565 = \u540C\u3058\u89AA\u306E\u4E2D": "Policy scope: all = the whole plan, <block> = inside that box, omitted = within the same parent",
   "\u65B9\u91DD\u3092\u53C2\u8003\u306B\u3059\u308B (\u6C7A\u307E\u3063\u3066\u3044\u306A\u304F\u3066\u3082\u7740\u624B\u3092\u5F85\u305F\u305B\u306A\u3044)": "Make the policy advisory (boxes can start before it is decided)",
   "\u65B9\u91DD\u3092\u3084\u3081\u308B\u51FA\u529B\u306E\u540D\u524D": "Outputs that are no longer policies",
-  "\u3053\u306E\u7BB1\u3067\u306F\u53D7\u3051\u53D6\u3089\u306A\u3044\u65B9\u91DD (<\u7BB1>.<\u51FA\u529B\u540D>)": "Policies this box does not take (<box>.<output>)"
+  "\u3053\u306E\u7BB1\u3067\u306F\u53D7\u3051\u53D6\u3089\u306A\u3044\u65B9\u91DD (<\u7BB1>.<\u51FA\u529B\u540D>)": "Policies this box does not take (<box>.<output>)",
+  "\u30D5\u30A1\u30A4\u30EB\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: {path}": "File not found: {path}",
+  "\u8A08\u753B\u306E\u30D5\u30A9\u30EB\u30C0\u306E\u5916\u306E\u30D5\u30A1\u30A4\u30EB\u306F\u8868\u793A\u3067\u304D\u307E\u305B\u3093: {path}": "Files outside the plan's folder cannot be shown: {path}",
+  "\u30D5\u30A1\u30A4\u30EB\u304C\u5927\u304D\u3059\u304E\u3066\u8868\u793A\u3067\u304D\u307E\u305B\u3093: {path}": "The file is too large to show: {path}"
 };
 
 // src/i18n/en/model.ts
@@ -2166,6 +2195,10 @@ var report = {
   "\u4F5C\u696D\u3092\u59CB\u3081\u308B (\u4F5C\u696D\u4E2D\u306E\u672D\u304C\u4ED8\u304F)\u3002\u540C\u6642\u306B\u4F5C\u696D\u4E2D\u306B\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u306F 1\u301C2 \u500B\u307E\u3067": "Start work (the box gets a Working tag). Keep at most 1-2 boxes in progress at a time",
   "\u4F55\u3092\u3059\u308B\u304B": "What you will do",
   "\u5B8C\u4E86\u306B\u3059\u308B\u3002\u6210\u679C\u7269 (\u540D\u524D=\u30D1\u30B9\u304B URL) \u3092\u4ED8\u3051\u308B\u3002Git \u306E\u30D5\u30A1\u30A4\u30EB\u306A\u3089 commit+path+blob \u304C\u8A18\u9332\u3055\u308C\u308B": "Mark as done. Attach deliverables (name=path or URL). For files in Git, commit+path+blob is recorded",
+  '\u6210\u679C\u7269\u3060\u3051\u4ED8\u3051\u308B (\u5B8C\u4E86\u306B\u306F\u3057\u306A\u3044)\u3002block \u306B "inputs" \u3092\u6307\u5B9A\u3059\u308B\u3068\u3001\u8A08\u753B\u306E\u6700\u4E0A\u4F4D\u306E\u5165\u529B (Inputs) \u306B\u8CC7\u6599\u3092\u4ED8\u3051\u308B (input \u3067\u5165\u529B\u540D\u3092\u9078\u3076)\u3002\u5165\u529B\u306B\u8CC7\u6599\u304C\u7121\u3044\u3068\u3001\u305D\u308C\u3092\u4F7F\u3046\u7BB1\u306F\u7740\u624B\u3067\u304D\u306A\u3044': 'Attach a deliverable without finishing the box. With block "inputs", attach material to a top-level plan input (choose it with input). Boxes that use an input cannot start until it has material',
+  "\u30EA\u30DD\u30B8\u30C8\u30EA\u5185\u306E\u30D1\u30B9 \u307E\u305F\u306F URL": "Path in the repository or URL",
+  "\u4ED8\u3051\u308B\u51FA\u529B\u306E\u540D\u524D (\u7BB1\u306E\u3068\u304D)": "Output to attach to (for a box)",
+  "\u4ED8\u3051\u308B\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306E\u540D\u524D (block \u304C inputs \u306E\u3068\u304D)": "Top-level input to attach to (when block is inputs)",
   "\u540D\u524D=\u30D1\u30B9 \u307E\u305F\u306F \u540D\u524D=URL": "name=path or name=URL",
   "\u51FA\u529B\u306E\u540D\u524D\u3092\u5909\u3048\u308B\u3068\u304D": "To rename the output",
   "\u8A70\u307E\u3063\u305F (\u8A08\u753B\u306E\u5916\u306E\u969C\u5BB3\u3002\u56F0\u3063\u3066\u3044\u308B\u3053\u3068\u3092\u66F8\u3044\u3066\u4ED6\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u79FB\u308B\u3002\u5165\u529B\u304C\u8DB3\u308A\u306A\u3044\u3060\u3051\u306A\u3089\u3001\u4F5C\u308B\u30DC\u30C3\u30AF\u30B9\u3092 add \u3057\u3066 connect \u3059\u308B)": "Stuck on an obstacle outside the plan (write what is in the way and move on to another box. If only an input is missing, add a box that produces it and connect it instead)",
@@ -3655,6 +3688,14 @@ function changedPolicies(p, blockId) {
     return stamp === void 0 ? isPolicyReady(p, q.id) : stamp !== policyStamp(p, q.id);
   });
 }
+function ackPolicy(p, blockId, portId) {
+  const b = p.blocks[blockId];
+  if (!b) return p;
+  const targets = portId ? [portId] : policiesFor(p, blockId).map((q2) => q2.id);
+  const q = touch(p);
+  q.blocks[blockId] = { ...b, policyStamps: { ...b.policyStamps ?? {}, ...Object.fromEntries(targets.map((id) => [id, policyStamp(p, id)])) } };
+  return q;
+}
 function setPolicy(p, portId, policy2) {
   const port2 = p.ports[portId];
   if (!port2 || port2.direction !== "out") return p;
@@ -4178,7 +4219,7 @@ function splitBlock(p, parentId, spec, actor, makers) {
     if (Object.keys(scope2).length) q.blocks[r.blockId].scope = scope2;
     for (const name of b.inputs ?? []) q = addPort(q, { blockId: r.blockId, direction: "in", name }).project;
   }
-  const resolve7 = (ref, dir2) => {
+  const resolve8 = (ref, dir2) => {
     let why = t("\u30DC\u30C3\u30AF\u30B9\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093");
     for (const { title, portName } of refSplits(ref)) {
       const isParent = title === "parent" || title === parent.title || title === parentId;
@@ -4195,8 +4236,8 @@ function splitBlock(p, parentId, spec, actor, makers) {
     return { ep: null, why };
   };
   for (const c of spec.connections ?? []) {
-    const from = resolve7(c.from, "out");
-    let to = resolve7(c.to, "in");
+    const from = resolve8(c.from, "out");
+    let to = resolve8(c.to, "in");
     if (!to.ep && from.ep && !c.to.includes(".")) {
       const tid = c.to === "parent" || c.to === parent.title || c.to === parentId ? null : made[c.to] ?? findBlock(q, c.to).block?.id;
       if (tid) {
@@ -4303,7 +4344,7 @@ function instantiateNode(p, parentId, node, origin, position) {
       made[c.title] = rc.blockId;
       y += 120;
     }
-    const resolve7 = (ref, dir2) => {
+    const resolve8 = (ref, dir2) => {
       for (const { title, portName } of refSplits(ref)) {
         const isParent = title === "parent";
         const blockId = isParent ? id : made[title];
@@ -4315,8 +4356,8 @@ function instantiateNode(p, parentId, node, origin, position) {
       return null;
     };
     for (const c of node.connections) {
-      const from = resolve7(c.from, "out");
-      const to = resolve7(c.to, "in");
+      const from = resolve8(c.from, "out");
+      const to = resolve8(c.to, "in");
       if (from && to) q = connect(q, from, to).project;
     }
   }
@@ -5988,7 +6029,7 @@ function resolveToken(server, allowEnvironmentToken = true) {
 import { hostname as hostname2 } from "node:os";
 
 // package.json
-var version = "0.6.3";
+var version = "0.6.5";
 
 // src/model/version.ts
 var APP_VERSION = version;
@@ -6963,7 +7004,7 @@ function groupConflicts(base, local, remote, conflicts2) {
     parents.set(key, root);
     return root;
   };
-  const join13 = (keys) => {
+  const join14 = (keys) => {
     const sorted = [...new Set(keys.length ? keys : [SETTINGS])].sort();
     const first = find(sorted[0]);
     for (const key of sorted.slice(1)) parents.set(find(key), first);
@@ -7001,9 +7042,9 @@ function groupConflicts(base, local, remote, conflicts2) {
     return [SETTINGS];
   };
   const items = conflicts2.filter((c) => !c.automatic);
-  for (const c of items) join13(owners(c));
+  for (const c of items) join14(owners(c));
   for (const p of projects) for (const port2 of Object.values(p.ports)) {
-    if (port2.promotedFrom) join13(portOwners(port2.id));
+    if (port2.promotedFrom) join14(portOwners(port2.id));
   }
   const ids = new Set(projects.flatMap((p) => Object.keys(p.blocks)));
   for (const id of ids) {
@@ -7035,7 +7076,7 @@ function groupConflicts(base, local, remote, conflicts2) {
         ))
           keys.push(...edgeOwners(e.id));
       }
-    join13(keys);
+    join14(keys);
     keys.forEach((key) => structural.add(key));
   }
   const grouped = /* @__PURE__ */ new Map();
@@ -8383,7 +8424,7 @@ function registerTools(server, run2) {
   }, async ({ block: b, spec, contextToken }) => safe(run2, ["split", b, "--spec", JSON.stringify(spec), ...contextToken ? ["--context-token", contextToken] : []]));
   server.registerTool("boxglow_connect", { description: t("\u7DDA\u3092\u3064\u306A\u3050: <\u984C\u540D.\u51FA\u529B\u540D> \u304B\u3089 <\u984C\u540D> \u3078 (\u53D7\u3051\u5074\u306F\u984C\u540D\u3060\u3051\u3067\u3088\u3044\u3002\u51FA\u529B\u540D\u3068\u540C\u3058\u540D\u524D\u306E\u5165\u529B\u304C\u4F5C\u3089\u308C\u308B\u3002<\u984C\u540D.\u5165\u529B\u540D> \u3067\u65E2\u5B58\u306E\u5165\u529B\u3092\u6307\u5B9A\u3057\u3066\u3082\u3088\u3044\u3002\u89AA\u306E\u5165\u529B\u306F project.\u5165\u529B\u540D\u3001\u89AA\u306E\u51FA\u529B\u3078\u306F \u984C\u540D.\u51FA\u529B\u540D -> project)"), inputSchema: { from: z2.string(), to: z2.string() } }, async ({ from, to }) => safe(run2, ["connect", from, to]));
   server.registerTool("boxglow_disconnect", { description: t("\u7DDA\u3092\u5916\u3059"), inputSchema: { from: z2.string(), to: z2.string() } }, async ({ from, to }) => safe(run2, ["disconnect", from, to]));
-  server.registerTool("boxglow_port", { description: t("\u30DC\u30C3\u30AF\u30B9\u306B\u5165\u529B / \u51FA\u529B\u3092\u8DB3\u3059\u3001\u540D\u524D\u3092\u5909\u3048\u308B\u3001\u51FA\u529B\u306E\u4E88\u5B9A\u6210\u679C\u7269 (expect) \u3068\u62C5\u5F53 (self) \u3092\u6C7A\u3081\u308B\u3002anyOf \u306E\u5165\u529B\u306F\u5408\u6D41 (\u3069\u308C\u304B 1 \u3064\u304C\u5C4A\u3051\u3070\u3088\u3044) \u306B\u3059\u308B"), inputSchema: { block: block2, in: z2.array(z2.string()).optional(), out: z2.array(z2.string()).optional(), policy: z2.array(z2.string()).optional().describe(t("\u65B9\u91DD\u3068\u3057\u3066\u914D\u308B\u51FA\u529B\u306E\u540D\u524D (\u7DDA\u3092\u5F15\u304B\u305A\u306B\u7BC4\u56F2\u306E\u7BB1\u3059\u3079\u3066\u306B\u5C4A\u304F\u3002\u6280\u8853\u9078\u5B9A\u306A\u3069\u5168\u4F53\u306B\u52B9\u304F\u6C7A\u5B9A)")), policyScope: z2.string().optional().describe(t("\u65B9\u91DD\u306E\u7BC4\u56F2: all = \u8A08\u753B\u5168\u4F53\u3001<block> = \u305D\u306E\u7BB1\u306E\u4E2D\u3001\u7701\u7565 = \u540C\u3058\u89AA\u306E\u4E2D")), advisory: z2.boolean().optional().describe(t("\u65B9\u91DD\u3092\u53C2\u8003\u306B\u3059\u308B (\u6C7A\u307E\u3063\u3066\u3044\u306A\u304F\u3066\u3082\u7740\u624B\u3092\u5F85\u305F\u305B\u306A\u3044)")), noPolicy: z2.array(z2.string()).optional().describe(t("\u65B9\u91DD\u3092\u3084\u3081\u308B\u51FA\u529B\u306E\u540D\u524D")), skipPolicy: z2.array(z2.string()).optional().describe(t("\u3053\u306E\u7BB1\u3067\u306F\u53D7\u3051\u53D6\u3089\u306A\u3044\u65B9\u91DD (<\u7BB1>.<\u51FA\u529B\u540D>)")), remove: z2.array(z2.string()).optional().describe(t("\u6D88\u3059\u30DD\u30FC\u30C8\u306E\u540D\u524D (\u5165\u529B\u3092\u6D88\u3059\u3068\u3001\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u6700\u5F8C\u306E\u51FA\u529B\u306F\u6D88\u305B\u306A\u3044\u3002\u540C\u540D\u304C\u4E21\u65B9\u306B\u3042\u308C\u3070 in:<\u540D\u524D> / out:<\u540D\u524D>)")), expect: z2.array(z2.string()).optional().describe(t('\u4E88\u5B9A\u6210\u679C\u7269: "<\u51FA\u529B\u540D>=<kind>:<hint>" (kind \u306F file / dir / url / doc / note / decision / result\u3001hint \u306F\u30D1\u30B9\u306E\u898B\u5F53\u3084\u984C\u540D)')), self: z2.array(z2.string()).optional().describe(t("\u5B50\u306B\u4EFB\u305B\u305A\u3001\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B\u306E\u540D\u524D (\u7D71\u5408\u30FB\u691C\u8A3C\u306A\u3069\u3002\u5B50\u3092\u6301\u3064\u30DC\u30C3\u30AF\u30B9\u3060\u3051)")), noSelf: z2.array(z2.string()).optional().describe(t("\u81EA\u8EAB\u304C\u4F5C\u308B\u5370\u3092\u5916\u3059\u51FA\u529B\u306E\u540D\u524D")), rename: z2.string().optional().describe(t("\u65E7=\u65B0")), anyOf: z2.array(z2.string()).optional().describe(t("\u5408\u6D41\u306B\u3059\u308B\u5165\u529B\u306E\u540D\u524D (\u5206\u304B\u308C\u305F\u9053\u304C\u307E\u3068\u307E\u308B\u3068\u3053\u308D)")), allOf: z2.array(z2.string()).optional().describe(t("\u901A\u5E38 (\u3059\u3079\u3066\u8981\u308B) \u306B\u623B\u3059\u5165\u529B\u306E\u540D\u524D")) } }, async (a) => {
+  server.registerTool("boxglow_port", { description: t("\u30DC\u30C3\u30AF\u30B9\u306B\u5165\u529B / \u51FA\u529B\u3092\u8DB3\u3059\u3001\u540D\u524D\u3092\u5909\u3048\u308B\u3001\u51FA\u529B\u306E\u4E88\u5B9A\u6210\u679C\u7269 (expect) \u3068\u62C5\u5F53 (self) \u3092\u6C7A\u3081\u308B\u3002anyOf \u306E\u5165\u529B\u306F\u5408\u6D41 (\u3069\u308C\u304B 1 \u3064\u304C\u5C4A\u3051\u3070\u3088\u3044) \u306B\u3059\u308B"), inputSchema: { block: block2, in: z2.array(z2.string()).optional(), out: z2.array(z2.string()).optional(), policy: z2.array(z2.string()).optional().describe(t("\u65B9\u91DD\u3068\u3057\u3066\u914D\u308B\u51FA\u529B\u306E\u540D\u524D (\u7DDA\u3092\u5F15\u304B\u305A\u306B\u7BC4\u56F2\u306E\u7BB1\u3059\u3079\u3066\u306B\u5C4A\u304F\u3002\u6280\u8853\u9078\u5B9A\u306A\u3069\u5168\u4F53\u306B\u52B9\u304F\u6C7A\u5B9A)")), policyScope: z2.string().optional().describe(t("\u65B9\u91DD\u306E\u7BC4\u56F2: all = \u8A08\u753B\u5168\u4F53\u3001<block> = \u305D\u306E\u7BB1\u306E\u4E2D\u3001\u7701\u7565 = \u540C\u3058\u89AA\u306E\u4E2D")), advisory: z2.boolean().optional().describe(t("\u65B9\u91DD\u3092\u53C2\u8003\u306B\u3059\u308B (\u6C7A\u307E\u3063\u3066\u3044\u306A\u304F\u3066\u3082\u7740\u624B\u3092\u5F85\u305F\u305B\u306A\u3044)")), noPolicy: z2.array(z2.string()).optional().describe(t("\u65B9\u91DD\u3092\u3084\u3081\u308B\u51FA\u529B\u306E\u540D\u524D")), skipPolicy: z2.array(z2.string()).optional().describe(t("\u3053\u306E\u7BB1\u3067\u306F\u53D7\u3051\u53D6\u3089\u306A\u3044\u65B9\u91DD (<\u7BB1>.<\u51FA\u529B\u540D>)")), remove: z2.array(z2.string()).optional().describe(t("\u6D88\u3059\u30DD\u30FC\u30C8\u306E\u540D\u524D (\u5165\u529B\u3092\u6D88\u3059\u3068\u3001\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u540C\u540D\u304C\u4E21\u65B9\u306B\u3042\u308C\u3070 in:<\u540D\u524D> / out:<\u540D\u524D>)")), expect: z2.array(z2.string()).optional().describe(t('\u4E88\u5B9A\u6210\u679C\u7269: "<\u51FA\u529B\u540D>=<kind>:<hint>" (kind \u306F file / dir / url / doc / note / decision / result\u3001hint \u306F\u30D1\u30B9\u306E\u898B\u5F53\u3084\u984C\u540D)')), self: z2.array(z2.string()).optional().describe(t("\u5B50\u306B\u4EFB\u305B\u305A\u3001\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B\u306E\u540D\u524D (\u7D71\u5408\u30FB\u691C\u8A3C\u306A\u3069\u3002\u5B50\u3092\u6301\u3064\u30DC\u30C3\u30AF\u30B9\u3060\u3051)")), noSelf: z2.array(z2.string()).optional().describe(t("\u81EA\u8EAB\u304C\u4F5C\u308B\u5370\u3092\u5916\u3059\u51FA\u529B\u306E\u540D\u524D")), rename: z2.string().optional().describe(t("\u65E7=\u65B0")), anyOf: z2.array(z2.string()).optional().describe(t("\u5408\u6D41\u306B\u3059\u308B\u5165\u529B\u306E\u540D\u524D (\u5206\u304B\u308C\u305F\u9053\u304C\u307E\u3068\u307E\u308B\u3068\u3053\u308D)")), allOf: z2.array(z2.string()).optional().describe(t("\u901A\u5E38 (\u3059\u3079\u3066\u8981\u308B) \u306B\u623B\u3059\u5165\u529B\u306E\u540D\u524D")), optional: z2.array(z2.string()).optional().describe(t("\u4EFB\u610F (\u7121\u304F\u3066\u3082\u7740\u624B\u3067\u304D\u308B) \u306B\u3059\u308B\u5165\u529B\u306E\u540D\u524D")), required: z2.array(z2.string()).optional().describe(t("\u5FC5\u9808\u306B\u623B\u3059\u5165\u529B\u306E\u540D\u524D")), describe: z2.array(z2.string()).optional().describe(t('\u5165\u51FA\u529B\u306E\u8AAC\u660E: "<\u540D\u524D>=<\u8AAC\u660E>" (\u540C\u540D\u304C\u4E21\u65B9\u306B\u3042\u308C\u3070 in:<\u540D\u524D> / out:<\u540D\u524D>)')) } }, async (a) => {
     const argv = ["port", a.block];
     opt(argv, "in", a.in);
     opt(argv, "out", a.out);
@@ -8399,6 +8440,9 @@ function registerTools(server, run2) {
     opt(argv, "rename", a.rename);
     opt(argv, "any-of", a.anyOf);
     opt(argv, "all-of", a.allOf);
+    opt(argv, "optional", a.optional);
+    opt(argv, "required", a.required);
+    opt(argv, "describe", a.describe);
     return safe(run2, argv);
   });
   server.registerTool("boxglow_branch", {
@@ -8473,9 +8517,11 @@ function registerTools(server, run2) {
     opt(argv, "context-token", a.contextToken);
     return safe(run2, argv);
   });
-  server.registerTool("boxglow_ack", { description: t("\u4EBA\u306E\u56DE\u7B54\u3092\u8AAD\u3093\u3067\u5F15\u304D\u53D6\u3063\u305F\u3068\u8A18\u9332\u3059\u308B (status \u306E\u300C\u56DE\u7B54\u3042\u308A\u300D\u304B\u3089\u6D88\u3048\u308B)"), inputSchema: { block: block2, contextToken: z2.string().optional(), id: z2.string().optional().describe(t("decision id (\u7701\u7565\u3059\u308B\u3068\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u3059\u3079\u3066)")) } }, async ({ block: b, id, contextToken }) => {
+  server.registerTool("boxglow_ack", { description: t("\u4EBA\u306E\u56DE\u7B54\u3092\u8AAD\u3093\u3067\u5F15\u304D\u53D6\u3063\u305F\u3068\u8A18\u9332\u3059\u308B (status \u306E\u300C\u56DE\u7B54\u3042\u308A\u300D\u304B\u3089\u6D88\u3048\u308B)"), inputSchema: { block: block2, contextToken: z2.string().optional(), id: z2.string().optional().describe(t("decision id (\u7701\u7565\u3059\u308B\u3068\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u3059\u3079\u3066)")), policy: z2.union([z2.boolean(), z2.string()]).optional().describe(t("\u65B9\u91DD\u306E\u78BA\u304B\u3081\u76F4\u3057\u3092\u6D88\u3059 (true = \u78BA\u304B\u3081\u76F4\u3057\u306E\u65B9\u91DD\u3059\u3079\u3066\u3001\u540D\u524D = \u305D\u306E\u65B9\u91DD\u3060\u3051)\u3002\u6E08\u3093\u3060\u4F5C\u696D\u304C\u65B9\u91DD\u306B\u5408\u3063\u3066\u3044\u308B\u3053\u3068\u3092\u78BA\u304B\u3081\u305F\u3068\u304D")) } }, async ({ block: b, id, contextToken, policy: policy2 }) => {
     const argv = ["ack", b];
     opt(argv, "id", id);
+    if (policy2 === true) argv.push("--policy");
+    else if (typeof policy2 === "string") opt(argv, "policy", policy2);
     opt(argv, "context-token", contextToken);
     return safe(run2, argv);
   });
@@ -8518,6 +8564,14 @@ function registerTools(server, run2) {
   });
   server.registerTool("boxglow_lint", { description: t("\u8A08\u753B (\u307E\u305F\u306F\u30DC\u30C3\u30AF\u30B9\u306E\u914D\u4E0B) \u306E\u691C\u67FB: \u5FC5\u305A\u76F4\u3059 (\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6\u306E\u6B20\u843D\u3001\u89AA\u51FA\u529B\u306E\u62C5\u5F53\u306E\u672A\u5B9A\u30FB\u91CD\u8907\u3001\u6392\u4ED6\u306E\u9053\u306E\u4E21\u65B9\u3092\u5FC5\u9808) \u3068\u898B\u76F4\u3057\u5019\u88DC (\u5B50\u304C 1 \u500B\u3001\u3064\u306A\u304C\u3089\u306A\u3044\u51FA\u529B\u3001\u5F62\u3060\u3051\u306E\u8A18\u5165\u3001\u9053\u306E\u5148\u304C\u7121\u3044\u5206\u5C90\u3001\u5165\u529B 1 \u672C\u306E\u5408\u6D41\u3001\u5144\u5F1F\u306E\u540C\u3058\u4E88\u5B9A\u6210\u679C\u7269) \u3092\u5206\u3051\u3066\u8FD4\u3059"), inputSchema: { block: z2.string().optional().describe(t("\u7701\u7565\u3059\u308B\u3068\u8A08\u753B\u5168\u4F53")) }, annotations: { readOnlyHint: true } }, async ({ block: b }) => safe(run2, ["lint", ...b ? [b] : [], "--json"]));
   server.registerTool("boxglow_validate", { description: t("\u8A08\u753B\u306E\u554F\u984C (\u3064\u306A\u304C\u3063\u3066\u3044\u306A\u3044\u5165\u51FA\u529B\u306A\u3069) \u3092\u691C\u67FB\u3059\u308B"), inputSchema: {}, annotations: { readOnlyHint: true } }, async () => safe(run2, ["validate"]));
+  server.registerTool("boxglow_artifact", { description: t('\u6210\u679C\u7269\u3060\u3051\u4ED8\u3051\u308B (\u5B8C\u4E86\u306B\u306F\u3057\u306A\u3044)\u3002block \u306B "inputs" \u3092\u6307\u5B9A\u3059\u308B\u3068\u3001\u8A08\u753B\u306E\u6700\u4E0A\u4F4D\u306E\u5165\u529B (Inputs) \u306B\u8CC7\u6599\u3092\u4ED8\u3051\u308B (input \u3067\u5165\u529B\u540D\u3092\u9078\u3076)\u3002\u5165\u529B\u306B\u8CC7\u6599\u304C\u7121\u3044\u3068\u3001\u305D\u308C\u3092\u4F7F\u3046\u7BB1\u306F\u7740\u624B\u3067\u304D\u306A\u3044'), inputSchema: { block: block2, path: z2.string().describe(t("\u30EA\u30DD\u30B8\u30C8\u30EA\u5185\u306E\u30D1\u30B9 \u307E\u305F\u306F URL")), title: z2.string().optional(), output: z2.string().optional().describe(t("\u4ED8\u3051\u308B\u51FA\u529B\u306E\u540D\u524D (\u7BB1\u306E\u3068\u304D)")), input: z2.string().optional().describe(t("\u4ED8\u3051\u308B\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306E\u540D\u524D (block \u304C inputs \u306E\u3068\u304D)")), remove: z2.boolean().optional().describe(t("true \u306A\u3089 path \u306E\u6210\u679C\u7269\u30FB\u8CC7\u6599\u3092\u5916\u3059 (\u984C\u540D\u304B\u30D1\u30B9\u304B URL \u3067\u63A2\u3059)")), contextToken: z2.string().optional() } }, async (a) => {
+    const argv = a.remove ? ["artifact", a.block, "--remove", a.path] : ["artifact", a.block, a.path];
+    opt(argv, "title", a.title);
+    opt(argv, "output", a.output);
+    opt(argv, "input", a.input);
+    opt(argv, "context-token", a.contextToken);
+    return safe(run2, argv);
+  });
   server.registerTool("boxglow_run", { description: t('\u305D\u306E\u307B\u304B\u306E CLI \u30B3\u30DE\u30F3\u30C9\u3092\u305D\u306E\u307E\u307E\u5B9F\u884C\u3059\u308B (\u4F8B: ["log", "--n", "20"]\u3001["layout"]\u3001["help"])'), inputSchema: { args: z2.array(z2.string()) } }, async ({ args }) => safe(run2, args));
   server.registerTool("boxglow_claims", { description: t("\u53D7\u3051\u6301\u3061\u4E00\u89A7 (\u81EA\u5206\u30FB\u4ED6\u8005\u30FB\u671F\u9650\u5207\u308C)"), inputSchema: {}, annotations: { readOnlyHint: true } }, async () => safe(run2, ["claims"]));
   server.registerTool("boxglow_claim_renew", { description: t("\u53D7\u3051\u6301\u3061\u306E\u671F\u9650\u3092\u5EF6\u9577\u3059\u308B (5\u5206\u3054\u3068\u3001\u307E\u305F\u306F\u9577\u3044\u51E6\u7406\u306E\u524D\u306B\u5B9F\u884C)"), inputSchema: { block: block2 } }, async ({ block: b }) => safe(run2, ["claim-renew", b]));
@@ -8533,13 +8587,46 @@ async function startMcp(run2) {
 
 // cli/serve.ts
 import { createServer } from "node:http";
-import { existsSync as existsSync8, mkdirSync as mkdirSync7, readFileSync as readFileSync10, realpathSync as realpathSync3, statSync as statSync5, watch, writeFileSync as writeFileSync5 } from "node:fs";
-import { basename as basename3, dirname as dirname6, extname, join as join8, relative, resolve as resolve3 } from "node:path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync7, readFileSync as readFileSync10, realpathSync as realpathSync3, statSync as statSync6, watch, writeFileSync as writeFileSync5 } from "node:fs";
+import { basename as basename3, dirname as dirname7, extname, isAbsolute as isAbsolute2, join as join9, relative, resolve as resolve4 } from "node:path";
 import { spawn } from "node:child_process";
 
+// cli/attached-file.ts
+import { existsSync as existsSync5, statSync as statSync3 } from "node:fs";
+import { dirname as dirname4, isAbsolute, join as join6, resolve as resolve3 } from "node:path";
+function gitRootOf(dir2) {
+  let cur = resolve3(dir2);
+  for (let i = 0; i < 64; i++) {
+    if (existsSync5(join6(cur, ".git"))) return cur;
+    const up = dirname4(cur);
+    if (up === cur) return null;
+    cur = up;
+  }
+  return null;
+}
+function attachedFileBases(planFile) {
+  const planDir = dirname4(resolve3(planFile));
+  const root = gitRootOf(planDir);
+  return [.../* @__PURE__ */ new Set([planDir, ...root ? [root] : []])];
+}
+function resolveAttachedFile(planFile, path) {
+  let p = path.trim();
+  if (p.startsWith("file://")) p = decodeURIComponent(p.slice("file://".length));
+  p = p.replace(/[?#].*$/, "");
+  if (!p) return null;
+  const candidates = isAbsolute(p) ? [p] : attachedFileBases(planFile).map((base) => resolve3(base, p));
+  for (const c of candidates) {
+    try {
+      if (existsSync5(c) && statSync3(c).isFile()) return c;
+    } catch {
+    }
+  }
+  return null;
+}
+
 // cli/sync/host.ts
 import { randomUUID as randomUUID7 } from "node:crypto";
-import { existsSync as existsSync7, readFileSync as readFileSync9, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync8, readFileSync as readFileSync9, statSync as statSync5 } from "node:fs";
 
 // src/sync/billing.ts
 function parseBilling2(value) {
@@ -8626,9 +8713,9 @@ function parseSummary(v) {
 }
 
 // cli/sync/agent-config.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname4, join as join6 } from "node:path";
+import { dirname as dirname5, join as join7 } from "node:path";
 
 // node_modules/smol-toml/dist/error.js
 function getLineColFromPtr(string, ptr) {
@@ -9558,29 +9645,29 @@ function mergeCodexConfig(existing, server, token) {
 // cli/sync/agent-config.ts
 function writeAgentConfig(target, server, token, dir2) {
   if (target === "codex") {
-    const path2 = join6(homedir2(), ".codex", "config.toml");
-    mkdirSync5(dirname4(path2), { recursive: true });
-    writeFileSync4(path2, mergeCodexConfig(existsSync5(path2) ? readFileSync6(path2, "utf8") : null, server, token), { mode: 384 });
+    const path2 = join7(homedir2(), ".codex", "config.toml");
+    mkdirSync5(dirname5(path2), { recursive: true });
+    writeFileSync4(path2, mergeCodexConfig(existsSync6(path2) ? readFileSync6(path2, "utf8") : null, server, token), { mode: 384 });
     return { path: path2, gitignored: true };
   }
-  const path = join6(dir2, ".mcp.json");
-  writeFileSync4(path, mergeMcpJson(existsSync5(path) ? readFileSync6(path, "utf8") : null, server, token));
-  const gi = join6(dir2, ".gitignore");
-  if (!existsSync5(gi)) return { path, gitignored: false };
+  const path = join7(dir2, ".mcp.json");
+  writeFileSync4(path, mergeMcpJson(existsSync6(path) ? readFileSync6(path, "utf8") : null, server, token));
+  const gi = join7(dir2, ".gitignore");
+  if (!existsSync6(gi)) return { path, gitignored: false };
   const next = gitignoreWithMcpJson(readFileSync6(gi, "utf8"));
   if (next !== null) writeFileSync4(gi, next);
   return { path, gitignored: true };
 }
 
 // cli/sync/host.ts
-import { dirname as dirname5 } from "node:path";
+import { dirname as dirname6 } from "node:path";
 
 // cli/sync/command.ts
 import { readFileSync as readFileSync8 } from "node:fs";
 
 // cli/sync/watch.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync3 } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync4 } from "node:fs";
+import { join as join8 } from "node:path";
 var DEBOUNCE_MS = 2e3;
 var MAX_WAIT_MS = 1e4;
 var POLL_MS = 3e4;
@@ -9590,7 +9677,7 @@ var RETRY_MS = 5e3;
 var RETRY_MAX_MS = 6e4;
 function signature(file) {
   try {
-    const st = statSync3(file);
+    const st = statSync4(file);
     return `${st.mtimeMs}:${st.size}`;
   } catch {
     return "none";
@@ -9604,7 +9691,7 @@ function contentHash(file) {
   }
 }
 function bindingsFor(server) {
-  const root = join7(configDir(), "sync");
+  const root = join8(configDir(), "sync");
   let names = [];
   try {
     names = readdirSync3(root);
@@ -9613,8 +9700,8 @@ function bindingsFor(server) {
   }
   const states = [], unreadable = [];
   for (const name of names) {
-    const dir2 = join7(root, name);
-    if (!existsSync6(join7(dir2, "state.json"))) continue;
+    const dir2 = join8(root, name);
+    if (!existsSync7(join8(dir2, "state.json"))) continue;
     try {
       const state = new StateStore(dir2).read();
       if (state && state.binding.server === normalizeServer(server)) states.push({ dir: dir2, state });
@@ -9625,9 +9712,9 @@ function bindingsFor(server) {
   return { states, unreadable };
 }
 function lockWatch(server) {
-  const root = join7(configDir(), "sync");
+  const root = join8(configDir(), "sync");
   mkdirSync6(root, { recursive: true, mode: 448 });
-  const path = join7(root, `watch-${hashOf(normalizeServer(server)).slice(0, 16)}`);
+  const path = join8(root, `watch-${hashOf(normalizeServer(server)).slice(0, 16)}`);
   try {
     return { unlock: lockFile(path, { waitMs: 0 }), path };
   } catch (e) {
@@ -10467,7 +10554,7 @@ var SyncHost = class {
     if (resolved?.source === "env") return "env:" + hashOf(resolved.token).slice(0, 16);
     const path = credentialsPath(this.server);
     try {
-      const st = statSync4(path);
+      const st = statSync5(path);
       return `stored:${st.mtimeMs}:${st.size}:${hashOf(readFileSync9(path, "utf8")).slice(0, 16)}`;
     } catch {
       return "none";
@@ -10945,7 +11032,7 @@ var SyncHost = class {
         state.connected = void 0;
         if (action.kind === "connectAgent") {
           try {
-            const written2 = writeAgentConfig(action.target, this.server, created.token, file ? dirname5(file) : process.cwd());
+            const written2 = writeAgentConfig(action.target, this.server, created.token, file ? dirname6(file) : process.cwd());
             state.newToken = void 0;
             state.connected = { target: action.target, wrote: true, path: written2.path, gitignored: written2.gitignored };
           } catch (e) {
@@ -11227,7 +11314,7 @@ var SyncHost = class {
         return;
       }
       const target = realFile(destination);
-      if (action.destination === "new" && (existsSync7(target) || bindingsOf(target).bindings.length))
+      if (action.destination === "new" && (existsSync8(target) || bindingsOf(target).bindings.length))
         throw new SyncDestinationError(t("\u4FDD\u5B58\u5148\u306B\u306F\u65E2\u306B\u30D5\u30A1\u30A4\u30EB\u304C\u3042\u308A\u307E\u3059\u3002\u5225\u306E\u540D\u524D\u3092\u9078\u3093\u3067\u304F\u3060\u3055\u3044\u3002"));
       if (this.startups.get(file) !== op || this.stopping || this.stopped) return;
       if (op.credentials !== this.credentialsGeneration()) throw new Error("Credentials changed");
@@ -11765,6 +11852,8 @@ var HttpError = class extends Error {
   status;
 };
 var ASSETS_DIR = "boxglow.assets";
+var ATTACHED_MIME = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp", ".pdf": "application/pdf", ".mp4": "video/mp4", ".webm": "video/webm", ".mp3": "audio/mpeg", ".wav": "audio/wav" };
+var MAX_ATTACHED = 50 * 1024 * 1024;
 var ASSET_MIME = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml" };
 var MAX_ASSET = 10 * 1024 * 1024;
 function readRawBody(req, limit) {
@@ -11801,9 +11890,9 @@ function readBody(req, limit = MAX_BODY) {
 }
 function startServe(opts) {
   const { file, dist, log } = opts;
-  if (!existsSync8(join8(dist, "index.html"))) throw new Error(t("Web \u30A2\u30D7\u30EA\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: {dist} (npm run build \u3067 dist/ \u3092\u4F5C\u3063\u3066\u304F\u3060\u3055\u3044)", { dist }));
-  if (!existsSync8(file)) {
-    if (!existsSync8(dirname6(file))) throw new Error(t("\u30D5\u30A9\u30EB\u30C0\u304C\u3042\u308A\u307E\u305B\u3093: {dir}", { dir: dirname6(file) }));
+  if (!existsSync9(join9(dist, "index.html"))) throw new Error(t("Web \u30A2\u30D7\u30EA\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: {dist} (npm run build \u3067 dist/ \u3092\u4F5C\u3063\u3066\u304F\u3060\u3055\u3044)", { dist }));
+  if (!existsSync9(file)) {
+    if (!existsSync9(dirname7(file))) throw new Error(t("\u30D5\u30A9\u30EB\u30C0\u304C\u3042\u308A\u307E\u305B\u3093: {dir}", { dir: dirname7(file) }));
     log(t("\u30D5\u30A1\u30A4\u30EB\u306F\u307E\u3060\u3042\u308A\u307E\u305B\u3093: {file} (\u753B\u9762\u304B\u3089\u8A08\u753B\u3092\u4F5C\u308B\u304B\u3001\u30B5\u30FC\u30D0\u30FC\u306E\u8A08\u753B\u3092\u53D7\u3051\u53D6\u308B\u3068\u3001\u3053\u3053\u306B\u4FDD\u5B58\u3057\u307E\u3059)", { file }));
   }
   const children = [];
@@ -11829,7 +11918,7 @@ data: ${data}
       destinationPicker: "sibling",
       chooseDestination: async (source, name) => {
         if (!name || !/^[^./\\][^/\\:<>"|?*]*\.json$/.test(name) || /[\x00-\x1f]/.test(name) || /^(con|prn|aux|nul|com[1-9]|lpt[1-9])\./i.test(name)) throw new SyncDestinationError(t("\u4FDD\u5B58\u30D5\u30A1\u30A4\u30EB\u540D\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u30D5\u30A9\u30EB\u30C0\u3092\u542B\u3081\u305A\u3001.json\u3067\u7D42\u308F\u308B\u540D\u524D\u3092\u6307\u5B9A\u3057\u307E\u3059\u3002"));
-        return join8(dirname6(source), name);
+        return join9(dirname7(source), name);
       },
       onOpened: async (target) => {
         const child = startServe({ file: target, port: 0, dist, open: false, log, sync: { server: opts.sync.server, allowEnvironmentToken: opts.sync.allowEnvironmentToken, autoEnable: false } });
@@ -11849,7 +11938,7 @@ data: ${data}
   let timer;
   let watcher;
   try {
-    watcher = watch(dirname6(file), (_ev, name) => {
+    watcher = watch(dirname7(file), (_ev, name) => {
       if (name && String(name) !== basename3(file)) return;
       clearTimeout(timer);
       timer = setTimeout(broadcast, 80);
@@ -11872,7 +11961,7 @@ data: ${data}
       const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
       if (url.pathname === "/api/project") {
         if (req.method === "GET") {
-          if (!existsSync8(file)) {
+          if (!existsSync9(file)) {
             send(404, JSON.stringify({ code: "no-file", file: basename3(file) }), "application/json; charset=utf-8", { "x-boxglow-file": encodeURIComponent(basename3(file)), "x-boxglow-version": APP_VERSION, "x-boxglow-protocol": String(SAVE_PROTOCOL) });
             return;
           }
@@ -11934,20 +12023,36 @@ data: ${JSON.stringify(lastSync ?? syncHost.status(file))}
         });
         return;
       }
+      if (url.pathname === "/api/file") {
+        if (req.method !== "GET" && req.method !== "HEAD") throw new HttpError(405, t("\u3053\u306E\u30E1\u30BD\u30C3\u30C9\u306F\u4F7F\u3048\u307E\u305B\u3093"));
+        const asked = url.searchParams.get("path") ?? "";
+        const found = resolveAttachedFile(file, asked);
+        if (!found) throw new HttpError(404, t("\u30D5\u30A1\u30A4\u30EB\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: {path}", { path: asked }));
+        const real = realpathSync3(found);
+        const inside2 = attachedFileBases(file).some((base2) => {
+          const rel = relative(realpathSync3(base2), real);
+          return rel !== "" && !rel.startsWith("..") && !isAbsolute2(rel);
+        });
+        if (!inside2) throw new HttpError(403, t("\u8A08\u753B\u306E\u30D5\u30A9\u30EB\u30C0\u306E\u5916\u306E\u30D5\u30A1\u30A4\u30EB\u306F\u8868\u793A\u3067\u304D\u307E\u305B\u3093: {path}", { path: asked }));
+        if (statSync6(real).size > MAX_ATTACHED) throw new HttpError(413, t("\u30D5\u30A1\u30A4\u30EB\u304C\u5927\u304D\u3059\u304E\u3066\u8868\u793A\u3067\u304D\u307E\u305B\u3093: {path}", { path: asked }));
+        const type = ATTACHED_MIME[extname(real).toLowerCase()] ?? "text/plain; charset=utf-8";
+        send(200, req.method === "HEAD" ? "" : readFileSync10(real), type, type === "application/pdf" ? {} : { "content-security-policy": "sandbox; default-src 'none'; img-src 'self'; media-src 'self'; style-src 'unsafe-inline'" });
+        return;
+      }
       if (url.pathname.startsWith("/api/assets/")) {
-        const assetsDir = join8(dirname6(file), ASSETS_DIR);
+        const assetsDir = join9(dirname7(file), ASSETS_DIR);
         const name = decodeURIComponent(url.pathname.slice("/api/assets/".length)).replace(/^boxglow\.assets\//, "");
         if (!/^[^/\\]+$/.test(name) || name.startsWith(".") || !ASSET_MIME[extname(name).toLowerCase()]) throw new HttpError(400, t("\u3053\u306E\u540D\u524D\u306E\u753B\u50CF\u306F\u6271\u3048\u307E\u305B\u3093: {name}", { name }));
-        const target2 = join8(assetsDir, name);
+        const target2 = join9(assetsDir, name);
         if (req.method === "GET" || req.method === "HEAD") {
-          if (!existsSync8(target2) || !statSync5(target2).isFile()) throw new HttpError(404, t("\u753B\u50CF\u304C\u3042\u308A\u307E\u305B\u3093: {name}", { name }));
+          if (!existsSync9(target2) || !statSync6(target2).isFile()) throw new HttpError(404, t("\u753B\u50CF\u304C\u3042\u308A\u307E\u305B\u3093: {name}", { name }));
           send(200, req.method === "HEAD" ? "" : readFileSync10(target2), ASSET_MIME[extname(name).toLowerCase()], { "cache-control": "no-cache" });
           return;
         }
         if (req.method === "PUT") {
           const bytes = await readRawBody(req, MAX_ASSET);
           mkdirSync7(assetsDir, { recursive: true });
-          if (existsSync8(target2)) throw new HttpError(409, t("\u540C\u3058\u540D\u524D\u306E\u753B\u50CF\u304C\u3042\u308A\u307E\u3059: {name}", { name }));
+          if (existsSync9(target2)) throw new HttpError(409, t("\u540C\u3058\u540D\u524D\u306E\u753B\u50CF\u304C\u3042\u308A\u307E\u3059: {name}", { name }));
           writeFileSync5(target2, bytes);
           send(200, JSON.stringify({ ok: true, path: `${ASSETS_DIR}/${name}` }));
           return;
@@ -11956,13 +12061,13 @@ data: ${JSON.stringify(lastSync ?? syncHost.status(file))}
       }
       if (req.method !== "GET" && req.method !== "HEAD") throw new HttpError(405, t("\u3053\u306E\u30E1\u30BD\u30C3\u30C9\u306F\u4F7F\u3048\u307E\u305B\u3093"));
       const base = realpathSync3(dist);
-      const target = resolve3(base, "." + decodeURIComponent(url.pathname));
+      const target = resolve4(base, "." + decodeURIComponent(url.pathname));
       const inside = (path2) => {
         const rel = relative(base, path2);
         return rel !== ".." && !rel.startsWith("../") && !rel.startsWith("..\\");
       };
       if (!inside(target)) throw new HttpError(403, t("\u3053\u306E\u30D1\u30B9\u306F\u914D\u4FE1\u3067\u304D\u307E\u305B\u3093"));
-      const path = existsSync8(target) && statSync5(target).isFile() ? realpathSync3(target) : join8(base, "index.html");
+      const path = existsSync9(target) && statSync6(target).isFile() ? realpathSync3(target) : join9(base, "index.html");
       if (!inside(path)) throw new HttpError(403, t("\u3053\u306E\u30D1\u30B9\u306F\u914D\u4FE1\u3067\u304D\u307E\u305B\u3093"));
       send(200, req.method === "HEAD" ? "" : readFileSync10(path), MIME[extname(path)] ?? "application/octet-stream");
     } catch (e) {
@@ -11998,24 +12103,24 @@ data: ${JSON.stringify(lastSync ?? syncHost.status(file))}
 }
 
 // cli/plan-io.ts
-import { existsSync as existsSync9, readFileSync as readFileSync11 } from "node:fs";
-import { dirname as dirname7, join as join9, resolve as resolve4 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "node:fs";
+import { dirname as dirname8, join as join10, resolve as resolve5 } from "node:path";
 var filePlanIO = {
   locate(opt2, forInit) {
-    if (opt2) return resolve4(opt2);
-    if (process.env.BOXGLOW_FILE) return resolve4(process.env.BOXGLOW_FILE);
+    if (opt2) return resolve5(opt2);
+    if (process.env.BOXGLOW_FILE) return resolve5(process.env.BOXGLOW_FILE);
     let dir2 = process.cwd();
     for (let i = 0; i < 12; i++) {
-      const candidate = join9(dir2, "boxglow.json");
-      if (existsSync9(candidate)) return candidate;
-      const parent = dirname7(dir2);
+      const candidate = join10(dir2, "boxglow.json");
+      if (existsSync10(candidate)) return candidate;
+      const parent = dirname8(dir2);
       if (parent === dir2) break;
       dir2 = parent;
     }
-    if (forInit) return join9(process.cwd(), "boxglow.json");
+    if (forInit) return join10(process.cwd(), "boxglow.json");
     throw new Error(t("boxglow.json \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093 (--file \u3067\u6307\u5B9A\u3059\u308B\u304B\u3001`boxglow init` \u3067\u4F5C\u3063\u3066\u304F\u3060\u3055\u3044)"));
   },
-  exists: (path) => existsSync9(path),
+  exists: (path) => existsSync10(path),
   read: (path) => readFileSync11(path, "utf8"),
   commit: (path, text2, expected, opts) => commitFile(path, text2, expected, opts)
 };
@@ -12267,12 +12372,12 @@ function isCurrentToken(p, token) {
 }
 
 // cli/setup-agent.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync8, readFileSync as readFileSync12, writeFileSync as writeFileSync6 } from "node:fs";
-import { dirname as dirname8, join as join10 } from "node:path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync8, readFileSync as readFileSync12, writeFileSync as writeFileSync6 } from "node:fs";
+import { dirname as dirname9, join as join11 } from "node:path";
 var BEGIN = "<!-- boxglow:begin -->";
 var END = "<!-- boxglow:end -->";
 function readObject(path) {
-  if (!existsSync10(path)) return {};
+  if (!existsSync11(path)) return {};
   const value = JSON.parse(readFileSync12(path, "utf8"));
   if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(t("\u8A2D\u5B9A\u306E\u5F62\u304C\u6B63\u3057\u304F\u3042\u308A\u307E\u305B\u3093: {where}", { where: path }));
   return value;
@@ -12355,8 +12460,8 @@ ${body}
 ${identity}
 ${END}
 `;
-    const path = join10(root, name);
-    const cur = existsSync10(path) ? readFileSync12(path, "utf8") : "";
+    const path = join11(root, name);
+    const cur = existsSync11(path) ? readFileSync12(path, "utf8") : "";
     const begin = cur.indexOf(BEGIN);
     const end = cur.indexOf(END);
     if (begin < 0 !== end < 0 || begin >= 0 && end < begin) throw new Error(t("Boxglow \u306E\u5370 (boxglow:begin / boxglow:end) \u304C\u6B63\u3057\u304F\u5BFE\u306B\u306A\u3063\u3066\u3044\u307E\u305B\u3093: {path}", { path }));
@@ -12376,8 +12481,8 @@ dependencies:
       value: boxglow
       transport: stdio
 `);
-    const tomlPath = join10(root, ".codex/config.toml");
-    const toml = existsSync10(tomlPath) ? readFileSync12(tomlPath, "utf8") : "";
+    const tomlPath = join11(root, ".codex/config.toml");
+    const toml = existsSync11(tomlPath) ? readFileSync12(tomlPath, "utf8") : "";
     let parsed;
     try {
       parsed = parse(toml);
@@ -12399,7 +12504,7 @@ default_tools_approval_mode = "auto"
       }
       files.set(".codex/config.toml", candidate);
     }
-    const hooksFile = readObject(join10(root, ".codex/hooks.json"));
+    const hooksFile = readObject(join11(root, ".codex/hooks.json"));
     const hooks = object(hooksFile.hooks, "hooks");
     if (mergeHooks(hooks, "codex")) {
       hooksFile.hooks = hooks;
@@ -12415,7 +12520,7 @@ ${r.body.replace(/"""/g, '\\"\\"\\"')}
   }
   if (claude) {
     files.set(".claude/skills/boxglow/SKILL.md", skill);
-    const settings = readObject(join10(root, ".claude/settings.json"));
+    const settings = readObject(join11(root, ".claude/settings.json"));
     const hooks = object(settings.hooks, "hooks");
     let changed2 = mergeHooks(hooks, "claude-code");
     if (changed2) settings.hooks = hooks;
@@ -12444,7 +12549,7 @@ tools: Bash, Read
 
 ${r.body}
 `);
-    const mcp = readObject(join10(root, ".mcp.json"));
+    const mcp = readObject(join11(root, ".mcp.json"));
     const servers = object(mcp.mcpServers, "mcpServers");
     if (!servers.boxglow) {
       servers.boxglow = { command: "npx", args: ["-y", "boxglow", "mcp", "--actor", "claude-code"] };
@@ -12454,9 +12559,9 @@ ${r.body}
   }
   const changed = [];
   for (const [name, text2] of files) {
-    const path = join10(root, name);
-    if (existsSync10(path) && readFileSync12(path, "utf8") === text2) continue;
-    mkdirSync8(dirname8(path), { recursive: true });
+    const path = join11(root, name);
+    if (existsSync11(path) && readFileSync12(path, "utf8") === text2) continue;
+    mkdirSync8(dirname9(path), { recursive: true });
     writeFileSync6(path, text2, "utf8");
     changed.push(name);
   }
@@ -12467,8 +12572,8 @@ function checkAgentSetup(root, agent) {
   const claude = agent !== "codex";
   const lines = [];
   const has = (rel, test) => {
-    const p = join10(root, rel);
-    if (!existsSync10(p)) return false;
+    const p = join11(root, rel);
+    if (!existsSync11(p)) return false;
     return test ? test(readFileSync12(p, "utf8")) : true;
   };
   const hooksOk = (rel, actor) => has(rel, (text2) => {
@@ -12686,16 +12791,16 @@ function resumeReport(project, options = {}) {
 }
 
 // cli/hooks.ts
-import { appendFileSync, existsSync as existsSync11, mkdirSync as mkdirSync9, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join11 } from "node:path";
+import { appendFileSync, existsSync as existsSync12, mkdirSync as mkdirSync9, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join12 } from "node:path";
 import { createHash as createHash4 } from "node:crypto";
 var sessionMark = (id) => id ? createHash4("sha256").update(id).digest("hex").slice(0, 8) : "";
-var hookLogPath = () => join11(configDir(), "hooks.log");
+var hookLogPath = () => join12(configDir(), "hooks.log");
 function recordHook(entry) {
   try {
     const path = hookLogPath();
     mkdirSync9(configDir(), { recursive: true });
-    const lines = existsSync11(path) ? readFileSync13(path, "utf8").split("\n").filter(Boolean) : [];
+    const lines = existsSync12(path) ? readFileSync13(path, "utf8").split("\n").filter(Boolean) : [];
     lines.push(JSON.stringify(entry));
     writeFileSync7(path, lines.slice(-200).join("\n") + "\n");
   } catch {
@@ -12704,7 +12809,7 @@ function recordHook(entry) {
 function readHookLog(cwd) {
   try {
     const path = hookLogPath();
-    if (!existsSync11(path)) return [];
+    if (!existsSync12(path)) return [];
     const all = readFileSync13(path, "utf8").split("\n").filter(Boolean).map((l) => {
       try {
         return JSON.parse(l);
@@ -13369,20 +13474,20 @@ function reviewable(p, blockId) {
 }
 
 // cli/main.ts
-import { existsSync as existsSync13, readFileSync as readFileSync14, writeFileSync as writeFileSync8 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync14, writeFileSync as writeFileSync8 } from "node:fs";
 import { execFileSync as execFileSync3 } from "node:child_process";
 
 // docs/AGENTS_SNIPPET.md
-var AGENTS_SNIPPET_default = '# Boxglow \u3092\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306B\u4F7F\u308F\u305B\u308B\u6307\u793A\u66F8 (AGENTS.md / CLAUDE.md \u306B\u8CBC\u308B)\n\n\u4E0B\u306E\u300C---\u300D\u306E\u9593\u3092\u305D\u306E\u307E\u307E\u30EA\u30DD\u30B8\u30C8\u30EA\u306E AGENTS.md (Codex) \u3084 CLAUDE.md (Claude Code) \u306B\u8CBC\u308B\u3002\nboxglow.json \u306F\u30EA\u30DD\u30B8\u30C8\u30EA\u76F4\u4E0B\u306B\u7F6E\u304F (`npx boxglow init --name "<\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D>"`)\u3002\n\n---\n\n## Boxglow (\u8A08\u753B\u3068\u9032\u6357\u306E\u5171\u6709)\n\n\u3053\u306E\u30EA\u30DD\u30B8\u30C8\u30EA\u306E\u8A08\u753B\u3068\u9032\u6357\u306F `boxglow.json` \u304C\u6B63\u672C\u3002\u4EBA\u9593\u306F Boxglow \u306E\u753B\u9762\u3067\u3053\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u898B\u3066\u3044\u308B\u3002\n\u30D5\u30A1\u30A4\u30EB\u3092\u76F4\u63A5\u7DE8\u96C6\u305B\u305A\u3001\u5FC5\u305A `npx boxglow` \u30B3\u30DE\u30F3\u30C9\u3067\u66F4\u65B0\u3059\u308B\u3053\u3068 (\u7D50\u7DDA\u30EB\u30FC\u30EB\u3068\u5C65\u6B74\u304C\u4FDD\u305F\u308C\u308B)\u3002\n\n\u30D6\u30ED\u30C3\u30AF = \u300C\u5165\u529B\u304B\u3089\u51FA\u529B (\u6210\u679C\u7269) \u3092\u4F5C\u308B\u30BF\u30B9\u30AF\u300D\u3002\u51FA\u529B\u306E\u6210\u679C\u7269\u304C\u78BA\u5B9A\u3057\u305F\u3089\u5B8C\u4E86 (WhiteBox)\u3002\n\u72B6\u614B: BlackBox (\u51FA\u529B\u3060\u3051\u6C7A\u3081\u305F) \u2192 GrayBox (\u7740\u624B\u4E2D) \u2192 WhiteBox (\u5B8C\u4E86)\u3002\n\n### \u4F5C\u696D\u306E\u305F\u3073\u306B\u5B88\u308B\u3053\u3068\n\n1. **\u6700\u521D\u306B\u8AAD\u3080**: `npx boxglow resume` (\u307E\u305F\u306F `npx boxglow status --brief`) \u3067\u3001\u4F5C\u696D\u4E2D\u30FB\u5224\u65AD\u5F85\u3061\u30FBAI \u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u30FB\u6B21\u306E\u5019\u88DC\u30FB\u672A\u5B8C\u4E86\u306E\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u8AAD\u3080\u3002\u524D\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u7D9A\u304D\u306F\u3001\u3053\u3053\u306B\u51FA\u308B\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u304B\u3089\u518D\u958B\u3059\u308B\u3002`npx boxglow show <block>` \u3067\u62C5\u5F53\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u306E\u5165\u51FA\u529B\u3092\u78BA\u8A8D\u3059\u308B\n2. **\u6E96\u5099\u3092\u78BA\u8A8D**: \u53D6\u308A\u304B\u304B\u308B\u524D\u306B `npx boxglow context <block>` \u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E `readiness` \u304C\u6E96\u5099\u306E\u72B6\u614B: `state` \u304C `ready` \u306A\u3089\u7740\u624B\u3067\u304D\u308B\u3002`unprepared` (\u8981\u5177\u4F53\u5316) \u306A\u3089 `unprepared` \u306E\u7406\u7531\u3068 `next` \u306E\u6B21\u306E\u4E00\u624B\u306B\u5F93\u3063\u3066\u5148\u306B\u5177\u4F53\u5316\u3059\u308B\u3002`waiting` \u306F\u5FC5\u9808\u306E\u5165\u529B\u304B\u5206\u5C90\u306E\u7B54\u3048\u3092\u5F85\u3063\u3066\u3044\u308B\n3. **\u53D7\u3051\u6301\u3061\u3001\u5177\u4F53\u5316**: \u5177\u4F53\u5316\u3084\u5206\u89E3\u306E\u524D\u306B `npx boxglow claim <block>` \u3067\u53D7\u3051\u6301\u3061\u3060\u3051\u3092\u53D6\u308B (\u5B9F\u884C\u4E2D\u306B\u306F\u306A\u3089\u306A\u3044\u3002\u53D7\u3051\u6301\u3061\u5236\u5FA1\u304C\u7121\u52B9\u306A\u8A08\u753B\u3067\u306F\u300C\u53D6\u5F97\u4E0D\u8981\u300D\u3067\u6B63\u5E38\u7D42\u4E86\u3059\u308B)\u3002\u305D\u306E\u3046\u3048\u3067\u4E0D\u8DB3\u3092\u57CB\u3081\u308B:\n   - \u51FA\u529B\u306E\u4E88\u5B9A\u6210\u679C\u7269: `npx boxglow port <block> --expect "<\u51FA\u529B\u540D>=file:src/x.ts"` (kind \u306F file / dir / url / doc / note / decision / result\u3002hint \u306F\u30D1\u30B9\u306E\u898B\u5F53\u3084\u984C\u540D\u3002\u307E\u3060\u4F5C\u3063\u3066\u3044\u306A\u3044\u30D5\u30A1\u30A4\u30EB\u3067\u3088\u3044)\n   - \u5B8C\u4E86\u6761\u4EF6: `npx boxglow scope <block> --acceptance "<\u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6>"`\u3002\u51E6\u7406\u306E\u7BC4\u56F2\u306F `--goal`\u3002\u51FA\u529B\u3092\u4F5C\u308B\u3046\u3048\u3067\u5B88\u308B\u6761\u4EF6 (\u6027\u80FD\u30FB\u54C1\u8CEA\u30FB\u30B5\u30A4\u30BA\u30FB\u5BF8\u6CD5\u30FB\u6D88\u8CBB\u96FB\u529B\u306A\u3069) \u306F `--constraints`\n   - 1 \u3064\u306E\u30DC\u30C3\u30AF\u30B9\u3067\u51FA\u529B\u3092\u4F5C\u308B\u898B\u901A\u3057\u304C\u7ACB\u305F\u306A\u3044\u306A\u3089 `npx boxglow split <block> --spec \'<JSON>\'` \u3067\u4E2D\u306B\u5C0F\u3055\u306A\u30DC\u30C3\u30AF\u30B9\u3092\u7F6E\u304F\u3002\u4ECA\u56DE\u7740\u624B\u3059\u308B\u5B50\u3060\u3051 expect / acceptance \u3092\u66F8\u304D\u3001\u5148\u306E\u5B50\u306F\u984C\u540D\u3068\u51FA\u529B\u3060\u3051\u3067\u3088\u3044 (\u8981\u5177\u4F53\u5316\u3068\u3057\u3066\u6B8B\u308B)\u3002\u5165\u529B\u306F\u4E0D\u660E\u306A\u3089\u7701\u7565\u3057\u3066\u3088\u3044 (\u81EA\u52D5\u3067\u4E0A\u306E\u968E\u5C64\u306E\u5165\u529B\u306B\u306A\u308B)\n   - \u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u304C\u5206\u304B\u3089\u306A\u3044\u3068\u304D\u306F\u3001\u67B6\u7A7A\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u66F8\u304B\u305A\u300C\u5BFE\u8C61\u3092\u7279\u5B9A\u3059\u308B\u8ABF\u67FB\u300D\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u51FA\u529B `note` \u3067\u4F5C\u3063\u3066\u59CB\u3081\u308B\n4. **\u7740\u624B\u3092\u8A18\u9332**: \u6E96\u5099\u304C\u3067\u304D\u305F\u3089 `npx boxglow context <block>` \u3092\u8AAD\u307F\u76F4\u3057\u3066\u304B\u3089 `npx boxglow start <block> --note "<\u4F55\u3092\u3059\u308B\u304B>"`\u3002\u540C\u6642\u306B\u9032\u3081\u308B\u30DC\u30C3\u30AF\u30B9\u306F 1\u301C2 \u500B\u307E\u3067\u3002\n   start \u3057\u305F\u30DC\u30C3\u30AF\u30B9\u306B\u300C\u4ECA\u3053\u3053\u300D(\u672C\u5F53\u306B\u3044\u307E\u4F5C\u696D\u3057\u3066\u3044\u308B\u30DC\u30C3\u30AF\u30B9\u3002\u8907\u6570\u306E AI \u3084\u4EBA\u304C\u3044\u308C\u3070\u3001\u3044\u304F\u3064\u3067\u3082) \u304C\u4ED8\u304D\u3001\u753B\u9762\u3067\u592A\u3044\u67A0\u3068 NOW \u306E\u672D\u304C\u4ED8\u304F\u3002\u5225\u306E\u30DC\u30C3\u30AF\u30B9\u306B\u3082\u4ED8\u3051\u308B\u3068\u304D\u306F `npx boxglow now <block>` (\u5916\u3059\u3068\u304D\u306F `--off`\u3001\u5168\u90E8\u6D88\u3059\u3068\u304D\u306F `now none`)\u3002done / leave \u3067\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5206\u304C\u5916\u308C\u308B\u3002\u4EBA\u3082\u753B\u9762\u306E\u72B6\u614B\u30BF\u30D6\u306E NOW \u3067\u4ED8\u3051\u5916\u3057\u3059\u308B\n   \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u304C\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001\u51FA\u529B\u306E `contextToken` (\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3) \u3092\u4ED8\u3051\u308B:\n   `npx boxglow start <block> --note "<\u4F55\u3092\u3059\u308B\u304B>" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` (\u4E0B\u306E\u300C\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3068\u5F15\u304D\u7D99\u304E\u300D\u3092\u53C2\u7167)\n   \u8981\u5177\u4F53\u5316\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u306E start \u306F\u65E2\u5B9A\u3067\u306F\u8B66\u544A (\u7406\u7531\u3068\u6B21\u306E\u4E00\u624B\u304C\u51FA\u308B)\u3002`policy --unprepared reject` \u306E\u8A08\u753B\u3067\u306F\u958B\u59CB\u3067\u304D\u306A\u3044 (`--reason` \u3067\u306F\u901A\u308C\u306A\u3044\u3002\u4EBA\u306E\u64CD\u4F5C\u306F\u901A\u308B)\u3002\u51FA\u529B\u3092\u5B50\u306B\u4EFB\u305B\u304D\u308A\u306E\u89AA\u3082\u5B9F\u884C\u3059\u308B\u3082\u306E\u304C\u7121\u3044\u306E\u3067\u3001\u5B50\u3092 start \u3059\u308B\n5. **\u5B8C\u4E86\u3092\u8A18\u9332**: \u51FA\u529B\u306E\u6210\u679C\u7269\u304C\u3067\u304D\u305F\u3089 `npx boxglow done <block> --artifact "<\u540D\u524D>=<\u30EA\u30DD\u30B8\u30C8\u30EA\u5185\u306E\u30D1\u30B9>" --checked "<\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C>"`\u3002\u691C\u67FB\u7D50\u679C\u306F\u6C7A\u307E\u3063\u305F 3 \u3064\u3067\u6B8B\u3059: `--checked` (\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C\u3002\u4F8B: "vitest 53 \u4EF6\u6210\u529F; e2e home 34/34")\u3001`--not-checked` (\u8A66\u3057\u3066\u3044\u306A\u3044\u3053\u3068)\u3001`--limits` (\u6B8B\u308B\u5236\u9650\u30FB\u6CE8\u610F)\u3002\u30B3\u30FC\u30C9\u4EE5\u5916\u306E\u6210\u679C\u7269 (\u6587\u66F8\u306A\u3069) \u306F\u300C\u78BA\u8A8D\u3057\u305F\u3053\u3068\u300D\u3092 `--checked` \u306B\u66F8\u304F\u3002\u7BB1\u306B\u6B8B\u308A\u3001context \u3068 show \u306B\u51FA\u308B\u3002\n   guard \u304C\u6709\u52B9\u306A\u3089 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3092\u4ED8\u3051\u308B (\u76F4\u524D\u306E\u81EA\u5206\u306E\u64CD\u4F5C\u306E\u51FA\u529B\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u3066\u3044\u308C\u3070\u3001\u305D\u308C\u3092\u4F7F\u3046)\u3002\n   HEAD \u306B\u30B3\u30DF\u30C3\u30C8\u6E08\u307F\u3067\u5185\u5BB9\u304C\u4E00\u81F4\u3059\u308B\u30D5\u30A1\u30A4\u30EB\u306F\u300C\u30B3\u30DF\u30C3\u30C8 + \u30D1\u30B9 + \u4E2D\u8EAB\u306E\u30CF\u30C3\u30B7\u30E5\u300D\u3067\u8A18\u9332\u3055\u308C\u308B (\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u306F\u3057\u306A\u3044)\u3002\u672A\u30B3\u30DF\u30C3\u30C8\u30FB\u672A\u8FFD\u8DE1\u306E\u30D5\u30A1\u30A4\u30EB\u306F\u30ED\u30FC\u30AB\u30EB\u53C2\u7167\u3068\u3057\u3066\u6B8B\u308A\u3001\u30B3\u30DF\u30C3\u30C8\u3057\u305F\u5F8C\u306E `npx boxglow check` \u3067 Git \u306E\u53C2\u7167\u306B\u88DC\u5B8C\u3055\u308C\u308B\u3002\u8A18\u9332\u306E\u305F\u3081\u3060\u3051\u306B\u30B3\u30DF\u30C3\u30C8\u3057\u306A\u3044\u3002\u5168\u968E\u5C64\u304C\u5FC5\u8981\u306A\u3089 `npx boxglow status` \u3092\u8AAD\u3080\u3002PR \u3084\u5916\u90E8\u8CC7\u6599\u306F URL \u3067\u3082\u3088\u3044\u3002\n   \u6210\u679C\u7269\u3060\u3051\u5148\u306B\u4ED8\u3051\u308B\u306A\u3089 `npx boxglow artifact <block> <\u30D1\u30B9>`\u3002\u9032\u6357\u306E\u9014\u4E2D\u7D4C\u904E\u306F `npx boxglow set <block> --progress 60`\n6. **\u4EBA\u9593\u306E\u5224\u65AD\u304C\u8981\u308B**: `npx boxglow ask <block> "<\u8CEA\u554F>" --options "A|B"`\u3002\u56DE\u7B54\u304C\u3042\u308B\u307E\u3067\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u9032\u3081\u305A\u3001\u4ED6\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u79FB\u308B\u3002\u4EBA\u306E\u56DE\u7B54\u306F `status` \u306E\u300C\u56DE\u7B54\u3042\u308A\u300D\u306B\u51FA\u308B\u3002\u8AAD\u3093\u3060\u3089 `npx boxglow ack <block>` \u3067\u5F15\u304D\u53D6\u308B (\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E `start` / `done` / `set` \u306A\u3069\u3067\u3082\u81EA\u52D5\u3067\u5F15\u304D\u53D6\u3089\u308C\u308B)\u3002\u5F15\u304D\u53D6\u308B\u307E\u3067\u4EBA\u306E\u753B\u9762\u306B\u306F\u300CAI \u672A\u78BA\u8A8D\u300D\u3068\u3057\u3066\u6B8B\u308A\u3001\u4EBA\u304C\u7B54\u3048\u3092\u76F4\u305B\u308B\u3002\u56DE\u7B54\u306E\u4E2D\u306B\u554F\u3044\u8FD4\u3057\u304C\u3042\u308C\u3070\u3001`ask` \u3068 `answer --by <\u81EA\u5206>` \u3067\u81EA\u5206\u306E\u7B54\u3048\u3082\u8A18\u9332\u3059\u308B\n7. **\u8A70\u307E\u3063\u305F\u3089**: \u5165\u529B (\u524D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u6210\u679C\u7269\u30FB\u8CC7\u6599) \u304C\u8DB3\u308A\u306A\u3044\u3053\u3068\u304C\u539F\u56E0\u306A\u3089\u3001\u8A70\u307E\u308A\u306B\u3057\u306A\u3044\u3002`npx boxglow show <block>` \u3067\u5165\u529B\u306E\u914D\u7DDA\u3092\u78BA\u304B\u3081\u3001\u8DB3\u308A\u306A\u3044\u3082\u306E\u3092\u4F5C\u308B\u30DC\u30C3\u30AF\u30B9\u304C\u7121\u3051\u308C\u3070 `npx boxglow add` \u3067\u5916 (\u4E0A\u6D41) \u306B\u4F5C\u308A\u3001`npx boxglow connect` \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5165\u529B\u306B\u3064\u306A\u3050 (\u914D\u7DDA\u304C\u300C\u5F85\u3061\u300D\u306E\u8272\u3067\u6B8B\u308A\u3001\u4F55\u3092\u5F85\u3063\u3066\u3044\u308B\u304B\u304C\u56F3\u3067\u898B\u3048\u308B)\u3002\u9078\u629E\u80A2\u304B\u3089\u9078\u3093\u3067\u3082\u3089\u3048\u3070\u9032\u3081\u308B\u306A\u3089 `ask`\u3002\u305D\u308C\u4EE5\u5916\u306E\u3001\u8A08\u753B\u306E\u5916\u306B\u3042\u308B\u969C\u5BB3 (\u74B0\u5883\u304C\u52D5\u304B\u306A\u3044\u3001\u6A29\u9650\u3084\u30AD\u30FC\u304C\u7121\u3044\u3001\u5916\u90E8\u306E\u8FD4\u4E8B\u5F85\u3061\u3001\u539F\u56E0\u306E\u5206\u304B\u3089\u306A\u3044\u5931\u6557) \u3060\u3051\u3092 `npx boxglow blocked <block> --note "<\u56F0\u3063\u3066\u3044\u308B\u3053\u3068>"` \u3067\u8A18\u9332\u3059\u308B \u8A55\u4FA1\u3084\u691C\u67FB\u3067\u524D\u306E\u6210\u679C\u7269\u304C\u901A\u3089\u306A\u304B\u3063\u305F\u3068\u304D\u306F\u3001\u7DDA\u3067\u623B\u3055\u305A (\u5FAA\u74B0\u306B\u306A\u308B) `npx boxglow sendback <\u8A55\u4FA1\u306E\u7BB1> --to <\u4F5C\u308A\u76F4\u3059\u7BB1> --note "<\u7406\u7531>"` \u3067\u5DEE\u3057\u623B\u3059 (\u305D\u306E\u7BB1\u306F In Progress \u306B\u623B\u308A\u3001\u6210\u679C\u7269\u306F\u5DEE\u3057\u623B\u3057\u6E08\u307F\u3068\u3057\u3066\u6B8B\u308B\u3002\u7406\u7531\u306F context \u306B\u51FA\u308B)\u3002\n8. **\u6210\u679C\u7269\u306E\u78BA\u8A8D**: \u30D5\u30A1\u30A4\u30EB\u3092\u79FB\u52D5\u30FB\u6539\u540D\u3057\u305F\u3089 `npx boxglow check` \u3092\u5B9F\u884C\u3059\u308B (\u79FB\u52D5\u3092\u691C\u51FA\u3057\u3066\u30D1\u30B9\u3092\u4ED8\u3051\u66FF\u3048\u308B\u3002\u898B\u3064\u304B\u3089\u306A\u3051\u308C\u3070\u5370\u304C\u4ED8\u304F)\n9. **\u9032\u6357\u3084\u6C17\u3065\u304D\u3092\u6B8B\u3059**: `npx boxglow log <block> "<\u672C\u6587>"` \u3067\u3001\u65E5\u4ED8\u3068\u66F8\u304D\u624B\u3064\u304D\u306E\u4F5C\u696D\u8A18\u9332\u3092\u30DC\u30C3\u30AF\u30B9\u306B\u8DB3\u3059 (Markdown \u53EF\u3002\u4EBA\u306F\u753B\u9762\u306E\u300C\u8A18\u9332\u300D\u30BF\u30D6\u3067\u540C\u3058\u3082\u306E\u3092\u898B\u3066\u66F8\u304F)\u3002\u5F15\u304D\u7D99\u304E\u30E1\u30E2 (checkpoint) \u306F 1 \u3064\u3092\u4E0A\u66F8\u304D\u3059\u308B\u304C\u3001\u8A18\u9332\u306F\u7A4D\u307F\u4E0A\u304C\u308B\n10. **\u4E2D\u65AD\u30FB\u5F15\u304D\u7D99\u304E\u306E\u524D\u306B**: \u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u7D42\u308F\u308A\u30FB\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306E\u5727\u7E2E\u30FB\u4ED6\u306E AI \u3084\u4EBA\u3078\u306E\u5F15\u304D\u7D99\u304E\u306E\u524D\u306B\u3001`npx boxglow checkpoint <block> --note "\u5206\u304B\u3063\u305F\u3053\u3068; \u6B21\u306B\u3059\u308B\u3053\u3068; \u672A\u89E3\u6C7A\u306E\u3053\u3068"` \u3067\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u6B8B\u3059 (guard \u304C\u6709\u52B9\u306A\u3089 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3092\u4ED8\u3051\u308B)\u3002\u4F1A\u8A71\u306E\u5C65\u6B74\u304C\u6D88\u3048\u3066\u3082\u8A08\u753B\u306E\u4E2D\u306B\u6B8B\u308A\u3001\u6B21\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u304C `resume` \u3068 `context` \u3067\u8AAD\u3080\n11. **\u5831\u544A**: \u4F5C\u696D\u306E\u6700\u5F8C\u306B `npx boxglow status --brief` \u306E\u5185\u5BB9\u3092\u8981\u7D04\u3057\u3066\u5831\u544A\u3059\u308B\n\n### \u69CB\u9020\u306E\u7D04\u675F\n\n- **\u307E\u3060\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u306F\u5206\u5C90\u3067\u8868\u3059**: \u8A08\u753B\u3092\u4F5C\u308B\u6642\u70B9\u3067\u3001\u5224\u65AD\u6B21\u7B2C\u3067\u5F8C\u306E\u4F5C\u696D (\u9053) \u304C\u5909\u308F\u308B\u3068\u304D\u306F `npx boxglow branch "<\u984C\u540D>" --options "A|B" --question "<\u554F\u3044>" --context "<\u5224\u65AD\u6750\u6599>"` \u3067\u5206\u5C90\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u4F5C\u308B\u3002\u9078\u629E\u80A2\u3054\u3068\u306B\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u308B\u306E\u3067\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u521D\u306E\u30DC\u30C3\u30AF\u30B9\u3078 `connect` \u3059\u308B\u3002\u9053\u304C\u5F8C\u3067 1 \u3064\u306B\u307E\u3068\u307E\u308B\u3068\u3053\u308D\u306B\u306F `npx boxglow join --title "<\u984C\u540D>"` \u3067\u5408\u6D41\u306E\u90E8\u54C1\u3092\u7F6E\u304D\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u5F8C\u306E\u51FA\u529B\u3092\u3053\u306E\u90E8\u54C1\u3078 `connect` \u3057\u3001\u90E8\u54C1\u306E\u51FA\u529B\u3092\u5148\u306E\u7BB1\u3078\u3064\u306A\u3050 (\u3069\u308C\u304B 1 \u3064\u306E\u9053\u304C\u5C4A\u3051\u3070\u5148\u3078\u9032\u3080)\u3002\u4EBA\u304C\u7B54\u3048\u308B\u3068\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u9053\u306E\u5148\u306F\u300C\u898B\u9001\u308A\u300D\u306B\u306A\u308A\u3001\u9032\u6357\u3068\u6B21\u306E\u5019\u88DC\u304B\u3089\u5916\u308C\u308B\u3002\u3059\u3067\u306B\u4F5C\u3063\u305F\u30DC\u30C3\u30AF\u30B9\u304C\u5B9F\u306F\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u3060\u3068\u5206\u304B\u3063\u305F\u3089\u3001`npx boxglow branch --box <block> --options "A|B" --question "<\u554F\u3044>"` \u3067\u5206\u5C90\u306B\u5909\u3048\u308B (\u4ECA\u306E\u51FA\u529B\u304C 1 \u3064\u76EE\u306E\u9078\u629E\u80A2\u306E\u9053\u306B\u306A\u308A\u3001\u7DDA\u306F\u6B8B\u308B)\u3002\u7B54\u3048\u304C\u51FA\u308B\u524D\u306E\u9053\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u300C\u5206\u5C90\u5F85\u3061\u300D\u3067\u3001\u7740\u624B\u3059\u308B\u3068\u8B66\u544A\u3055\u308C\u308B (\u5148\u306B\u4E0B\u8ABF\u3079\u3059\u308B\u306A\u3069\u7406\u7531\u304C\u3042\u308C\u3070 `--reason` \u3067\u8A18\u9332\u3059\u308B)\n- \u6700\u4E0A\u4F4D\u306B\u306F\u300C\u5165\u529B\u30CE\u30FC\u30C9\u300D\u300C\u6700\u7D42\u6210\u679C\u7269\u30CE\u30FC\u30C9\u300D\u3068\u300C\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u300D\u3060\u3051\u304C\u3042\u308B\u3002\u30BF\u30B9\u30AF\u306F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u4E2D\u306B\u7F6E\u304F (`add` \u306E\u65E2\u5B9A\u306E\u89AA\u306F\u6700\u521D\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9)\n- \u968E\u5C64\u306E\u6DF1\u3055\u306B\u5236\u9650\u306F\u306A\u3044\u3002`split` \u306F\u4F55\u6BB5\u3067\u3082\u4F7F\u3048\u308B\n- \u5225\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3067\u3082\u4F7F\u3048\u305D\u3046\u306A\u30DC\u30C3\u30AF\u30B9 (\u4F8B: \u5165\u529B\u753B\u50CF\u306E\u30E2\u30CE\u30AF\u30ED\u5316) \u306F `npx boxglow export-block <block> --out <\u540D\u524D>.boxglow-block.json` \u3067\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306B\u3057\u3001\n  `npx boxglow import-block <path> --parent <block>` \u3067\u633F\u5165\u3059\u308B\u3002\u30EA\u30DD\u30B8\u30C8\u30EA\u306E `boxglow-blocks/` \u306B\u7F6E\u3044\u3066\u5171\u6709\u3057\u3066\u3088\u3044\n\n\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u304C\u591A\u3044\u3068\u304D\u306F `npx boxglow group "<\u30B0\u30EB\u30FC\u30D7\u540D>"` \u3067\u30B0\u30EB\u30FC\u30D7\u3092\u4F5C\u308A\u3001`npx boxglow group-set <\u5165\u529B\u540D> <\u30B0\u30EB\u30FC\u30D7\u540D>` \u3067\u5206\u3051\u308B (\u4F8B: PCIe \u4ED5\u69D8\u66F8 / DDR \u4ED5\u69D8\u66F8)\u3002\n\n### split \u306E JSON \u5F62\u5F0F\n\n```json\n{\n  "blocks": [\n    { "title": "\u5BFE\u8C61\u7B87\u6240\u3092\u7279\u5B9A\u3059\u308B", "inputs": ["\u518D\u73FE\u624B\u9806"], "outputs": ["\u8ABF\u67FB\u30E1\u30E2"],\n      "expect": "note:\u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u3068\u51E6\u7406\u3001\u6839\u62E0\u3001\u5909\u66F4\u5019\u88DC\u3001\u78BA\u8A8D\u65B9\u6CD5\u3001\u672A\u6C7A\u4E8B\u9805", "acceptance": "\u5909\u66F4\u3059\u308B\u30D5\u30A1\u30A4\u30EB\u3068\u51E6\u7406\u304C\u6C7A\u307E\u308A\u3001\u5F8C\u7D9A\u306E\u30DC\u30C3\u30AF\u30B9\u306B expect \u3068 acceptance \u3092\u8A2D\u5B9A\u3067\u304D\u308B\u3002\u307E\u305F\u306F\u3001\u8A2D\u5B9A\u3067\u304D\u306A\u3044\u7406\u7531\u3068\u5FC5\u8981\u306A\u5224\u65AD\u304C\u5206\u304B\u308B",\n      "goal": "\u518D\u73FE\u3057\u3066\u7D4C\u8DEF\u3092\u8FFD\u3046\u3002\u88FD\u54C1\u30B3\u30FC\u30C9\u306E\u4FEE\u6B63\u306F\u4ECA\u56DE\u306E\u7BC4\u56F2\u5916" },\n    { "title": "\u4FDD\u5B58\u306E\u518D\u8A66\u884C\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3092\u53D6\u308A\u76F4\u3059", "inputs": ["\u8ABF\u67FB\u30E1\u30E2"], "outputs": ["\u4FEE\u6B63"],\n      "expect": "file:src/sync/state.ts", "acceptance": "\u4FDD\u5B58\u3092\u4E00\u5EA6\u5931\u6557\u3055\u305B\u3001\u518D\u4FDD\u5B58\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3068\u64CD\u4F5C\u304C\u623B\u308B (\u30C6\u30B9\u30C8\u3067\u78BA\u8A8D)" },\n    { "title": "\u30EA\u30EA\u30FC\u30B9\u30CE\u30FC\u30C8\u3092\u66F8\u304F", "inputs": ["\u4FEE\u6B63"], "outputs": ["\u30CE\u30FC\u30C8"] }\n  ],\n  "connections": [\n    { "from": "parent.\u518D\u73FE\u624B\u9806", "to": "\u5BFE\u8C61\u7B87\u6240\u3092\u7279\u5B9A\u3059\u308B.\u518D\u73FE\u624B\u9806" },\n    { "from": "\u5BFE\u8C61\u7B87\u6240\u3092\u7279\u5B9A\u3059\u308B.\u8ABF\u67FB\u30E1\u30E2", "to": "\u4FDD\u5B58\u306E\u518D\u8A66\u884C\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3092\u53D6\u308A\u76F4\u3059" },\n    { "from": "\u4FDD\u5B58\u306E\u518D\u8A66\u884C\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3092\u53D6\u308A\u76F4\u3059.\u4FEE\u6B63", "to": "\u30EA\u30EA\u30FC\u30B9\u30CE\u30FC\u30C8\u3092\u66F8\u304F" },\n    { "from": "\u30EA\u30EA\u30FC\u30B9\u30CE\u30FC\u30C8\u3092\u66F8\u304F.\u30CE\u30FC\u30C8", "to": "parent.\u51FA\u529B" }\n  ]\n}\n```\n\n`expect` (\u4E88\u5B9A\u6210\u679C\u7269: `"kind:hint"` \u307E\u305F\u306F `{ "kind", "hint" }`)\u3001`acceptance` (\u5B8C\u4E86\u6761\u4EF6)\u3001`goal` (\u4ECA\u56DE\u884C\u3046\u51E6\u7406) \u306F\u4ECA\u56DE\u7740\u624B\u3059\u308B\u5B50\u3060\u3051\u306B\u66F8\u304F\u3002\n3 \u3064\u76EE\u306E\u5B50\u306E\u3088\u3046\u306B\u984C\u540D\u3068\u51FA\u529B\u3060\u3051\u306E\u5B50\u306F\u300C\u8981\u5177\u4F53\u5316\u300D\u3068\u3057\u3066\u6B8B\u308A\u3001\u7740\u624B\u3059\u308B\u756A\u306B\u306A\u3063\u3066\u304B\u3089 `port --expect` / `scope --acceptance` \u3067\u6C7A\u3081\u308B\u3002\n\u89AA\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B (\u5B50\u306E\u6210\u679C\u3092\u7D71\u5408\u3059\u308B\u306A\u3069) \u306F `"parentMakes": ["\u51FA\u529B\u540D"]` \u3067\u5370\u3092\u4ED8\u3051\u308B (\u5B50\u306E\u7D50\u7DDA\u3068\u91CD\u306A\u308B\u3068\u300C\u62C5\u5F53\u304C\u91CD\u8907\u300D\u3068\u6848\u5185\u3055\u308C\u308B)\u3002\n`"splitBy": "\u5DE5\u7A0B"` \u3067\u76F4\u4E0B\u306E\u5B50\u306E\u5206\u3051\u65B9\u3092\u4E00\u8A9E\u3067\u6B8B\u3059 (\u5DE5\u7A0B / \u6210\u679C\u7269 / \u6A5F\u80FD \u306A\u3069\u3002`set <block> --split-by` \u3067\u3082\u66F8\u3051\u308B)\u3002\u540C\u3058\u968E\u5C64\u306E\u5B50\u306F\u540C\u3058\u5206\u3051\u65B9\u30FB\u540C\u3058\u5177\u4F53\u5EA6\u306B\u305D\u308D\u3048\u308B\u3002\n`split` \u304C\u4FDD\u5B58\u3057\u306A\u3044\u306E\u306F\u58CA\u308C\u305F\u69CB\u9020 (\u7D50\u7DDA\u5148\u304C\u7121\u3044\u3001\u5FAA\u74B0\u3001\u5F62\u306E\u9055\u3046 expect) \u3060\u3051\u3002\u5B50\u304C 1 \u500B\u3001\u89AA\u306E\u51FA\u529B\u3092\u4F5C\u308B\u5B50\u304C\u307E\u3060\u7121\u3044\u3001\u3068\u3044\u3063\u305F\u9014\u4E2D\u306E\u5206\u89E3\u306F\u4FDD\u5B58\u3055\u308C\u3001\u4E0D\u8DB3\u3068\u3057\u3066\u8868\u793A\u3055\u308C\u308B\u3002\n\u5206\u89E3\u306E\u5F8C\u3068\u7740\u624B\u306E\u524D\u306B `npx boxglow lint <block>` \u3092\u8AAD\u3080\u3002\u300C\u5FC5\u305A\u76F4\u3059\u300D(\u89AA\u51FA\u529B\u306E\u62C5\u5F53\u306E\u672A\u5B9A\u30FB\u91CD\u8907\u3001\u540C\u3058\u5206\u5C90\u306E\u6392\u4ED6\u306E\u9053\u306E\u4E21\u65B9\u3092\u5FC5\u9808\u306B\u3057\u3066\u3044\u308B\u3001\u4F5C\u696D\u4E2D\u306A\u306E\u306B\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6\u304C\u7121\u3044\u3001\u691C\u67FB\u306E\u5BFE\u8C61\u305D\u306E\u3082\u306E\u306E\u6B20\u843D) \u306F\u76F4\u3057\u3066\u304B\u3089\u9032\u3080\u3002\n\u300C\u7740\u624B\u306E\u524D\u306B\u57CB\u3081\u308B\u300D(\u307E\u3060\u59CB\u3081\u3066\u3044\u306A\u3044\u30DC\u30C3\u30AF\u30B9\u306E\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6) \u306F\u3001\u305D\u306E\u5B50\u306E\u7740\u624B\u306E\u756A\u3067\u57CB\u3081\u308C\u3070\u3088\u3044 (\u5148\u306E\u4ED5\u4E8B\u306E\u5206\u3092\u4ECA\u3001\u5F62\u3060\u3051\u66F8\u304B\u306A\u3044)\u3002\n\u300C\u898B\u76F4\u3057\u5019\u88DC\u300D(\u5B50\u304C 1 \u500B\u3001\u3069\u3053\u306B\u3082\u3064\u306A\u304C\u3089\u306A\u3044\u51FA\u529B\u3001\u5F62\u3060\u3051\u306E\u8A18\u5165\u3001\u9053\u306E\u5148\u304C\u7121\u3044\u5206\u5C90\u3001\u5165\u529B 1 \u672C\u306E\u5408\u6D41\u3001\u5144\u5F1F\u306E\u540C\u3058\u4E88\u5B9A\u6210\u679C\u7269) \u306F\u5185\u5BB9\u3092\u898B\u3066\u5224\u65AD\u3059\u308B (\u6A5F\u68B0\u306F\u62D2\u5426\u3057\u306A\u3044)\u3002`context` \u306B\u3082\u4EF6\u6570\u3068\u4E0A\u4F4D 3 \u4EF6\u304C\u51FA\u308B\u3002\n\n**\u5185\u5BB9\u306E\u30EC\u30D3\u30E5\u30FC (\u610F\u5473\u306F\u6A5F\u68B0\u3067\u306F\u5224\u5B9A\u3067\u304D\u306A\u3044\u306E\u3067\u3001AI \u304B\u4EBA\u304C\u6750\u6599\u3092\u8AAD\u3093\u3067\u8A55\u4FA1\u3057\u3001\u6839\u62E0\u3092\u6B8B\u3059)**\n- \u5206\u89E3\u3057\u305F\u5F8C: `npx boxglow review-split <\u89AA>` \u3067\u6750\u6599 (\u89AA\u306E\u76EE\u7684\u30FB\u5236\u7D04\u30FB\u5B8C\u4E86\u6761\u4EF6\u30FB\u5165\u51FA\u529B\u3001\u5B50\u306E\u5BFE\u8C61\u30FB\u5165\u51FA\u529B\u30FB\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6\u3001\u7D50\u7DDA) \u3068\u30C1\u30A7\u30C3\u30AF\u9805\u76EE\u3092\u8AAD\u307F\u3001\u8A55\u4FA1\u3057\u305F\u3089 `npx boxglow split-ok <\u89AA> --note "<\u6839\u62E0: \u4F55\u3092\u78BA\u8A8D\u3057\u305F\u304B>"` \u3067\u8A18\u9332\u3059\u308B\u3002\n- \u7740\u624B\u3059\u308B\u524D: `npx boxglow review-box <block>` \u3067\u6750\u6599 (\u5BFE\u8C61\u30FB\u51E6\u7406\u30FB\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u78BA\u8A8D\u65B9\u6CD5\u3001\u5165\u529B\u306E\u4F9B\u7D66\u5143\u3001\u4E0A\u6D41\u306E\u5206\u5C90\u306E\u7B54\u3048) \u3092\u8AAD\u307F\u3001`npx boxglow box-ok <block> --note "<\u6839\u62E0>"` \u3067\u8A18\u9332\u3059\u308B\u3002\n- \u8A18\u9332\u306F\u300C\u8A55\u4FA1\u3057\u305F\u3068\u7533\u544A\u3057\u6839\u62E0\u3092\u6B8B\u3057\u305F\u8A18\u9332\u300D\u3067\u3042\u308A\u3001\u59A5\u5F53\u6027\u306E\u8A3C\u660E\u3067\u306F\u306A\u3044\u3002\u6750\u6599\u304C\u5909\u308F\u308B\u3068 `context` \u306E `reviews` \u304C `stale` (\u4F55\u304C\u5909\u308F\u3063\u305F\u304B\u3068\u3001\u4F55\u3092\u78BA\u8A8D\u3059\u308C\u3070\u3088\u3044\u304B\u306E\u6848\u5185\u3064\u304D) \u306B\u306A\u308B\u3002`stale` \u306F\u300C\u5206\u89E3\u304C\u4E0D\u6B63\u300D\u3067\u306F\u306A\u304F\u300C\u524D\u56DE\u306E\u78BA\u8A8D\u5F8C\u306B\u6750\u6599\u304C\u5909\u308F\u3063\u305F\u300D\u3068\u3044\u3046\u610F\u5473\u3002\u4F4D\u7F6E\u3084\u914D\u8272\u3001\u9032\u6357\u3001\u62C5\u5F53\u306E\u5909\u66F4\u3067\u306F\u53E4\u304F\u306A\u3089\u306A\u3044\u3002\u5206\u89E3\u306E\u8A18\u9332\u306F\u5206\u5C90\u306E\u7B54\u3048\u3067\u306F\u53E4\u304F\u306A\u3089\u305A\u3001\u7740\u624B\u6E96\u5099\u306E\u8A18\u9332\u306F\u7B54\u3048\u304C\u5909\u308F\u308B\u3068\u53E4\u304F\u306A\u308B\u3002\n- \u5148\u306E\u5B50\u3092\u7740\u624B\u306E\u756A\u3067\u5177\u4F53\u5316\u3059\u308B\u3068\u3001\u89AA\u306E\u5206\u89E3\u306E\u8A18\u9332\u306F\u5FC5\u305A `stale` \u306B\u306A\u308B (\u5B50\u306E expect / acceptance \u3082\u6750\u6599\u306E\u305F\u3081)\u3002\u305D\u306E\u5B50\u306E expect\u30FBscope \u3092\u4E00\u901A\u308A\u66F8\u304D\u7D42\u3048\u3066\u304B\u3089\u3001\u5909\u308F\u3063\u305F\u5B50\u3068\u3001\u89AA\u306E\u5B8C\u4E86\u6761\u4EF6\u30FB\u5BFE\u8C61\u5916\u7BC4\u56F2\u30FB\u5144\u5F1F\u3068\u306E\u5206\u62C5\u3078\u306E\u5F71\u97FF\u3060\u3051\u3092\u78BA\u8A8D\u3057\u3001\u6574\u5408\u3059\u308C\u3070 `split-ok <\u89AA> --note "B181 \u306E\u5177\u4F53\u5316\u3092\u78BA\u8A8D\u3002\u89AA\u306E\u5BFE\u8C61\u5916\u7BC4\u56F2\u306B\u5165\u3089\u305A\u3001B182 \u3068\u306E\u5206\u62C5\u306F\u91CD\u8907\u3057\u306A\u3044"` \u306E\u3088\u3046\u306B\u66F4\u65B0\u3059\u308B\u3002port \u3084 scope \u306E\u64CD\u4F5C\u3054\u3068\u306B\u518D\u78BA\u8A8D\u306F\u3057\u306A\u3044\u3002\u8907\u6570\u306E\u5B50\u3092\u540C\u6642\u306B\u5177\u4F53\u5316\u3057\u305F\u3089\u3001\u307E\u3068\u3081\u3066\u78BA\u8A8D\u3057\u3066\u3088\u3044\u3002\n- \u7740\u624B\u306E\u6761\u4EF6\u306B\u306F\u3057\u3066\u3044\u306A\u3044 (\u65E2\u5B9A\u3067\u3082 reject \u306E\u8A08\u753B\u3067\u3082)\u3002`start` \u3092\u6B62\u3081\u308B\u306E\u306F\u8981\u5177\u4F53\u5316\u3068\u5165\u529B\u5F85\u3061\u3060\u3051\u3002\n\n**\u5206\u5C90\u30FB\u5408\u6D41\u3092 AI \u304C\u4F7F\u3046**\n- `ask` \u306B\u9078\u629E\u80A2\u3092\u4ED8\u3051\u305F\u3068\u304D\u3001\u7B54\u3048\u3067\u5F8C\u306E\u4F5C\u696D\u304C\u5206\u304B\u308C\u308B\u306A\u3089 `--branch` \u3092\u4ED8\u3051\u308B: \u305D\u306E\u30DC\u30C3\u30AF\u30B9\u304C\u5206\u5C90\u306B\u306A\u308A\u3001\u9078\u629E\u80A2\u3054\u3068\u306E\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u308B\u3002\u5404\u9053\u306E\u6700\u521D\u306E\u30DC\u30C3\u30AF\u30B9\u3078 `connect` \u3057\u3001\u9053\u304C\u307E\u3068\u307E\u308B\u3068\u3053\u308D\u306B `join` \u3092\u7F6E\u304F\u3002\n- `split` \u306E JSON \u3067\u3082\u4F5C\u308C\u308B: \u5B50\u306B `"branch": { "question": "...", "options": ["A", "B"] }` \u3067\u5206\u5C90\u306E\u30DC\u30C3\u30AF\u30B9 (\u51FA\u529B\u306F\u9078\u629E\u80A2\u306E\u540D\u524D)\u3001`"join": true` \u3067\u5408\u6D41\u306E\u90E8\u54C1\u3002\u4F8B:\n  `{ "blocks": [{ "title": "\u8A8D\u8A3C\u65B9\u5F0F\u3092\u6C7A\u3081\u308B", "branch": { "question": "\u3069\u308C?", "options": ["\u30E1\u30FC\u30EB", "OAuth"] } }, { "title": "\u30E1\u30FC\u30EB\u3067\u5B9F\u88C5", "outputs": ["\u8A8D\u8A3C"] }, { "title": "OAuth \u3067\u5B9F\u88C5", "outputs": ["\u8A8D\u8A3C"] }, { "title": "\u5408\u6D41", "join": true }], "connections": [{ "from": "\u8A8D\u8A3C\u65B9\u5F0F\u3092\u6C7A\u3081\u308B.\u30E1\u30FC\u30EB", "to": "\u30E1\u30FC\u30EB\u3067\u5B9F\u88C5" }, { "from": "\u8A8D\u8A3C\u65B9\u5F0F\u3092\u6C7A\u3081\u308B.OAuth", "to": "OAuth \u3067\u5B9F\u88C5" }, { "from": "\u30E1\u30FC\u30EB\u3067\u5B9F\u88C5.\u8A8D\u8A3C", "to": "\u5408\u6D41" }, { "from": "OAuth \u3067\u5B9F\u88C5.\u8A8D\u8A3C", "to": "\u5408\u6D41" }, { "from": "\u5408\u6D41.\u5408\u6D41", "to": "parent.\u8A8D\u8A3C" }] }`\n- `lint` \u306F\u3001\u540C\u3058\u5206\u5C90\u306E\u6392\u4ED6\u306E\u9053\u306E\u4E21\u65B9\u3092 1 \u3064\u306E\u30DC\u30C3\u30AF\u30B9\u304C\u5FC5\u9808\u306B\u3057\u3066\u3044\u308B (\u4E21\u65B9\u304C\u5C4A\u304F\u3053\u3068\u306F\u306A\u3044) \u3092\u300C\u5FC5\u305A\u76F4\u3059\u300D\u3001\u9053\u306E\u5148\u304C\u7121\u3044\u30FB\u5408\u6D41\u306E\u5165\u529B\u304C 1 \u672C\u3092\u300C\u898B\u76F4\u3057\u5019\u88DC\u300D\u3068\u3057\u3066\u51FA\u3059\u3002\n`parent.<\u540D\u524D>` \u306F\u5206\u89E3\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u81EA\u8EAB\u306E\u5165\u529B / \u51FA\u529B\u3002`<block>` \u306F\u77ED\u3044 ID (B12 \u306A\u3069\u3002status \u306B\u51FA\u308B) \u304B\u984C\u540D\u3002\n\u51FA\u529B\u306F\u4F5C\u308B\u7269\u3054\u3068\u306B 1 \u672C (1 \u3064\u306E\u4F5C\u696D\u3067\u8907\u6570\u306E\u7269\u304C\u3067\u304D\u308B\u306A\u3089 outputs \u306B\u5168\u90E8\u66F8\u304F\u30022 \u672C\u76EE\u4EE5\u964D\u306E expect \u306F `port <block> --expect "<\u51FA\u529B\u540D>=<kind>:<hint>"`)\u3002\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306F\u540C\u3058\u540D\u524D\u306B\u306A\u308B (\u3069\u3061\u3089\u5074\u3067\u5909\u3048\u3066\u3082\u3001\u3064\u306A\u304C\u308B\u5148\u3082\u5909\u308F\u308B)\u3002\u984C\u540D\u306F\u300C\u4F55\u3092\u4F5C\u308B\u304B\u300D\u304C\u5206\u304B\u308B\u77ED\u3044\u8A00\u8449\u306B\u3059\u308B\u3002\n\u671F\u65E5\u3084\u6642\u9593\u306F `npx boxglow set <block> --due 2026-10-15 --start 2026-10-01 --estimate 8 --hours 3.5` \u3067\u8A18\u9332\u3059\u308B\u3002\n\u30DC\u30C3\u30AF\u30B9\u306B\u306F\u4ED5\u4E8B\u306E\u7A2E\u985E (\u30AB\u30C6\u30B4\u30EA) \u3092\u4ED8\u3051\u308B: `--category design` (\u8A2D\u8A08) / build (\u5B9F\u88C5) / verify (\u691C\u8A3C) / evaluate (\u8A55\u4FA1) / study (\u691C\u8A0E) / research (\u8ABF\u67FB) / ui (\u30C7\u30B6\u30A4\u30F3) / improve (\u6539\u5584) / fix (\u8AB2\u984C\u89E3\u6C7A) / docs (\u6587\u66F8) / ops (\u904B\u7528) / other (\u305D\u306E\u4ED6: \u8FF7\u3063\u305F\u3068\u304D)\u3002add \u306E\u3068\u304D\u306B\u4ED8\u3051\u3001\u5909\u3048\u308B\u306A\u3089 `npx boxglow set <block> --category verify`\u3002\n\u7D50\u7DDA\u306E\u53D7\u3051\u5074\u306F\u984C\u540D\u3060\u3051\u3067\u3088\u3044 (`npx boxglow connect "A.\u8A2D\u8A08\u66F8" "B"` \u3067 B \u306B\u5165\u529B\u300C\u8A2D\u8A08\u66F8\u300D\u304C\u4F5C\u3089\u308C\u3066\u3064\u306A\u304C\u308B\u3002\u968E\u5C64\u304C\u9055\u3063\u3066\u3082\u9014\u4E2D\u306E\u7BB1\u306B\u5165\u51FA\u529B\u3092\u4F5C\u3063\u3066\u901A\u308B\u3002split \u306E connections \u3082 `to: "B"` \u3067\u3088\u3044)\u3002\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306F\u540C\u3058\u540D\u524D\u306B\u306A\u308B (\u3064\u306A\u3044\u3060\u6642\u70B9\u3067\u305D\u308D\u3044\u3001\u3069\u3061\u3089\u5074\u3067\u540D\u524D\u3092\u5909\u3048\u3066\u3082\u3001\u3064\u306A\u304C\u308B\u5148\u304C\u4E00\u7DD2\u306B\u5909\u308F\u308B)\u3002\u65E2\u5B58\u306E\u30DC\u30C3\u30AF\u30B9\u306B\u5165\u51FA\u529B\u3092\u8DB3\u3059 / \u540D\u524D\u3092\u5909\u3048\u308B\u306E\u306F `npx boxglow port <block> --in <\u540D\u524D> --out <\u540D\u524D> --remove <\u540D\u524D> --rename <\u65E7>=<\u65B0>` (\u5165\u529B\u3092\u6D88\u3059\u3068\u3001\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306F `port inputs`\u3002\u9593\u9055\u3048\u305F\u554F\u3044\u306F `npx boxglow unask <block>` \u3067\u53D6\u308A\u4E0B\u3052\u308B) (`project` = \u6700\u521D\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u3002\u6700\u7D42\u6210\u679C\u7269\u306E\u540D\u524D\u3082\u3053\u308C\u3067\u5909\u3048\u308B)\u3002\u7DDA\u3092\u5916\u3059\u306E\u306F `npx boxglow disconnect <\u984C\u540D.\u51FA\u529B\u540D> <\u984C\u540D.\u5165\u529B\u540D>`\u3001\u30DC\u30C3\u30AF\u30B9\u305D\u306E\u3082\u306E\u3092\u6D88\u3059\u306E\u306F `npx boxglow remove <block>` (\u4E2D\u306B\u30DC\u30C3\u30AF\u30B9\u304C\u3042\u308C\u3070 `--force`)\u3002MCP \u30C4\u30FC\u30EB (`boxglow_status` / `boxglow_start` / `boxglow_done` / `boxglow_ask` \u306A\u3069\u3002\u5229\u7528\u3059\u308B\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306B\u767B\u9332\u6E08\u307F\u306A\u3089\u4F7F\u3048\u308B\u3002`.mcp.json` \u306F Claude Code \u5411\u3051\u3067\u3001Codex \u306F\u5225\u9014\u767B\u9332\u3059\u308B) \u306F\u540C\u3058\u30B3\u30DE\u30F3\u30C9\u306E\u5225\u306E\u5165\u53E3\u3067\u3001\u3069\u3061\u3089\u3067\u66F8\u3044\u3066\u3082\u540C\u3058\u30D5\u30A1\u30A4\u30EB\u304C\u66F4\u65B0\u3055\u308C\u308B\u3002\u8A08\u753B\u306E\u6587\u66F8\u306F `npx boxglow export --out docs/ROADMAP.md`\u3002\n**\u5168\u4F53\u306B\u52B9\u304F\u6C7A\u5B9A\u306F\u65B9\u91DD\u306B\u3059\u308B**: \u6280\u8853\u9078\u5B9A\u30FB\u4F7F\u3046\u30A8\u30F3\u30B8\u30F3\u30FB\u753B\u98A8\u306E\u6C7A\u307E\u308A\u306A\u3069\u3001\u591A\u304F\u306E\u7BB1\u306B\u52B9\u304F\u6C7A\u5B9A\u3092\u51FA\u529B\u306B\u6301\u3064\u7BB1\u306F\u3001\u305D\u306E\u51FA\u529B\u3092\u65B9\u91DD\u306B\u3059\u308B (`npx boxglow port <block> --policy "<\u51FA\u529B\u540D>"`\u3002\u7BC4\u56F2\u306F\u65E2\u5B9A\u3067\u540C\u3058\u89AA\u306E\u4E2D\u3001`--policy-scope all` \u3067\u8A08\u753B\u5168\u4F53\u3001`--advisory` \u3067\u53C2\u8003)\u3002\u7DDA\u3092\u5F15\u304B\u305A\u306B\u7BC4\u56F2\u306E\u7BB1\u3059\u3079\u3066\u3078\u5C4A\u304D\u3001\u6C7A\u307E\u308B\u307E\u3067\u7BC4\u56F2\u306E\u672A\u7740\u624B\u306E\u7BB1\u306F\u300C\u65B9\u91DD\u5F85\u3061\u300D\u306B\u306A\u308B (\u9032\u3081\u3066\u3044\u308B\u7BB1\u306F\u6B62\u307E\u3089\u306A\u3044)\u3002`context` \u306E `policies` \u306B\u4E2D\u8EAB\u304C\u51FA\u308B\u306E\u3067\u3001\u4F5C\u696D\u306E\u524D\u306B\u8AAD\u3080\u3002\u95A2\u4FC2\u306A\u3044\u7BB1\u306F `--skip-policy "<\u7BB1>.<\u51FA\u529B\u540D>"` \u3067\u5916\u3059\u3002\u5B8C\u4E86\u5F8C\u306B\u65B9\u91DD\u304C\u5909\u308F\u308B\u3068 `policyChanged` \u306B\u51FA\u308B (\u78BA\u304B\u3081\u76F4\u3059)\u30021 \u672C\u305A\u3064\u7DDA\u3067\u3064\u306A\u304C\u306A\u3044\u3002\n\n\u65B0\u3057\u3044\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3067\u306F\u3001\u65B9\u91DD (README \u3084\u4F9D\u983C\u6587) \u304B\u3089\u6700\u4E0A\u4F4D\u306E\u5927\u9805\u76EE 3\u301C7 \u500B\u3092\u5148\u306B\u4F5C\u308A\u3001\u4EBA\u306B `ask` \u3067\u78BA\u8A8D\u3057\u3066\u304B\u3089\u3001\u7740\u624B\u3059\u308B\u5927\u9805\u76EE\u3060\u3051\u3092 `split` \u3067\u5206\u89E3\u3059\u308B (\u5148\u306E\u6BB5\u968E\u306F\u7C97\u3044\u307E\u307E)\u3002`ask` \u306E\u8CEA\u554F\u306F\u305D\u308C\u3060\u3051\u3067\u5224\u65AD\u3067\u304D\u308B\u3088\u3046\u306B\u66F8\u304D\u3001\u524D\u63D0\u30FB\u6BD4\u8F03\u30FB\u5F71\u97FF\u306F `--context` \u306B\u5165\u308C\u308B (\u300C\u3053\u308C\u3067\u3088\u3044\u3067\u3059\u304B\u300D\u306E\u3088\u3046\u306B\u5916\u3092\u6307\u3055\u306A\u3044)\u3002\u5019\u88DC\u304B\u3089 1 \u3064\u3092\u9078\u3076\u5834\u9762\u3067\u306F\u3001\u81EA\u5206\u3067\u6C7A\u3081\u308B\u3068\u304D\u3082 `ask ... --options "A|B|C"` \u3068 `answer --by <\u81EA\u5206>` \u3067\u8A18\u9332\u3057\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u5019\u88DC\u3092\u6B8B\u3059\u3002\u65B9\u91DD\u8EE2\u63DB\u306F `reopen <block> --note <\u7406\u7531>`\u3002\u3059\u3079\u3066 CLI \u3060\u3051\u3067\u6210\u7ACB\u3059\u308B (\u753B\u9762\u306F\u4EBA\u304C\u898B\u308B\u305F\u3081\u306E\u3082\u306E)\u3002\u4EBA\u304C\u3044\u306A\u3044\u904B\u7528\u306A\u3089\u3001AI \u304C `answer --by <\u81EA\u5206>` \u3067\u5224\u65AD\u3092\u8A18\u9332\u3057\u3066\u9032\u3081\u308B\u3002\n\u51FA\u529B\u306E\u540D\u524D\u306F\u300C\u5177\u4F53\u7684\u306A\u6210\u679C\u7269\u300D\u306B\u3059\u308B (\u4F8B: `\u8A2D\u8A08\u66F8 docs/design.md`\u3001`PR #12`\u3001`\u516C\u958B URL`\u3001`\u30C6\u30B9\u30C8\u7D50\u679C (vitest 53 \u4EF6)`)\u3002\u300C\u6A5F\u80FD\u4E00\u5F0F\u300D\u300C\u6240\u898B\u300D\u306E\u3088\u3046\u306A\u62BD\u8C61\u7684\u306A\u540D\u524D\u306F\u907F\u3051\u3001done \u306E\u3068\u304D\u306F\u5FC5\u305A --artifact \u3067\u30D5\u30A1\u30A4\u30EB\u30FBURL\u30FB\u30B3\u30DF\u30C3\u30C8\u3092\u4ED8\u3051\u308B\u3002\n\u3059\u3079\u3066\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u300C\u5165\u529B \u2192 \u51FA\u529B\u300D\u304C\u4F55\u304B\u306B\u3064\u306A\u304C\u3063\u3066\u3044\u308B\u3088\u3046\u306B\u3059\u308B (\u3064\u306A\u304C\u3063\u3066\u3044\u306A\u3044\u30DC\u30C3\u30AF\u30B9\u306F\u8A08\u753B\u306E\u7A74\u3002\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u30CE\u30FC\u30C9\u306F\u3001\u672A\u63A5\u7D9A\u306E\u5165\u529B\u304C\u81EA\u52D5\u3067\u4E0A\u304C\u308B)\u3002\n\u8907\u6570\u4EBA\u3067\u540C\u3058 boxglow.json \u3092\u7DE8\u96C6\u3059\u308B\u306A\u3089\u3001\u5404\u81EA\u306E clone \u3067\u4E00\u5EA6 `npx boxglow git-setup` \u3092\u5B9F\u884C\u3059\u308B (\u30DC\u30C3\u30AF\u30B9\u306E\u5358\u4F4D\u3067\u81EA\u52D5\u30DE\u30FC\u30B8\u3055\u308C\u3001\u5225\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5909\u66F4\u306F\u885D\u7A81\u3057\u306A\u3044)\u3002\n\u8907\u6570\u30EA\u30DD\u30B8\u30C8\u30EA\u3092 1 \u3064\u306E\u8A08\u753B\u3067\u7BA1\u7406\u3059\u308B\u3068\u304D\u306F\u3001boxglow.json \u3092\u4E0A\u306E\u30D5\u30A9\u30EB\u30C0\u306B\u7F6E\u304D\u3001\u5404\u30EA\u30DD\u30B8\u30C8\u30EA\u3067\u306F\u74B0\u5883\u5909\u6570 BOXGLOW_FILE \u306B\u305D\u306E\u5834\u6240\u3092\u5165\u308C\u308B (\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u30EA\u30DD\u30B8\u30C8\u30EA\u3054\u3068\u306B 1 \u3064\u3002`npx boxglow project "\u540D\u524D" --repo <\u30D1\u30B9>`)\u3002\n\u5165\u529B\u306F\u65E2\u5B9A\u3067\u5FC5\u9808\u3002\u7121\u304F\u3066\u3082\u7740\u624B\u3067\u304D\u308B\u5165\u529B\u306F\u753B\u9762\u3067\u300C\u4EFB\u610F\u300D\u306B\u3059\u308B\u3002status \u306E\u300C\u6B21\u306E\u5019\u88DC\u300D\u306F\u5FC5\u9808\u306E\u5165\u529B\u304C\u305D\u308D\u3063\u305F\u30DC\u30C3\u30AF\u30B9\u304B\u3089\u4E26\u3076 (\u300C\u7740\u624B\u3067\u304D\u308B\u300D/\u300C\u5FC5\u9808\u306E\u5165\u529B\u5F85\u3061\u300D\u304C\u4ED8\u304F)\u3002\n\u5165\u529B\u306E\u8AAC\u660E\u306F\u66F8\u304B\u306A\u3044 (\u3064\u306A\u304C\u3063\u305F\u51FA\u529B\u5074\u306E\u8AAC\u660E\u304C\u4F7F\u308F\u308C\u308B)\u3002\u51FA\u529B\u306E\u8AAC\u660E\u306B\u5F62\u5F0F\u30FB\u5236\u7D04\u3092\u66F8\u304F\u3002\n\n\n### \u81EA\u52D5\u3067\u52D5\u304F\u4ED5\u7D44\u307F (hooks)\n\n`setup-agent` \u306F Claude Code / Codex \u306E hooks \u306B `boxglow hook` \u3092\u767B\u9332\u3059\u308B\u3002\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u958B\u59CB\u30FB\u518D\u958B\u30FB\u5727\u7E2E\u306E\u5F8C\u306B\u306F\u8A08\u753B\u306E\u518D\u958B\u306E\u6982\u8981 (resume) \u304C\u81EA\u52D5\u3067\u6587\u8108\u306B\u5165\u308B\u3002\u5FDC\u7B54\u3092\u7D42\u3048\u308B\u3068\u304D\u3001\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067 start \u3057\u305F\u7BB1\u306B\u5F15\u304D\u7D99\u304E (done \u304B checkpoint) \u304C\u7121\u3051\u308C\u3070\u300C\u8A18\u9332\u3057\u3066\u304B\u3089\u7D42\u3048\u308B\u300D\u3088\u3046\u7D9A\u884C\u304C\u6307\u793A\u3055\u308C\u308B (log \u306F\u9032\u6357\u306E\u30E1\u30E2\u3067\u3001\u5F15\u304D\u7D99\u304E\u306E\u4EE3\u308F\u308A\u306B\u306A\u3089\u306A\u3044)\u3002boxglow.json \u3092 Edit / Write / apply_patch \u3067\u76F4\u63A5\u66F8\u304D\u63DB\u3048\u308B\u64CD\u4F5C\u306F\u6B62\u3081\u3089\u308C\u308B (CLI \u304B MCP \u3067\u66F4\u65B0\u3059\u308B)\u3002\u3053\u308C\u3089\u306F\u6307\u793A\u306E\u4EE3\u308F\u308A\u3067\u306F\u306A\u304F\u3001\u5FD8\u308C\u305F\u3068\u304D\u306E\u4FDD\u967A\u306A\u306E\u3067\u3001\u4E0A\u306E\u624B\u9806\u3069\u304A\u308A\u306B\u81EA\u5206\u3067\u8A18\u9332\u3059\u308B\u3002\n\n### \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3068\u5F15\u304D\u7D99\u304E\n\n\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u306F\u3001AI \u304C\u53E4\u3044\u6307\u793A\u306E\u307E\u307E\u4F5C\u696D\u3092\u9032\u3081\u308B\u306E\u3092\u9632\u3050\u4ED5\u7D44\u307F\u3002`setup-agent` \u304C\u6709\u52B9\u306B\u3059\u308B (\u305D\u308C\u4EE5\u5916\u306E\u8A08\u753B\u3067\u306F `npx boxglow guard on`)\u3002\n\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001AI \u306E `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` \u306B `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u304C\u8981\u308B\u3002\u4EBA\u306E\u64CD\u4F5C (`--actor human`) \u306B\u306F\u8981\u6C42\u3055\u308C\u306A\u3044\u3002\n\n```\nnpx boxglow context B12        # \u5224\u65AD (\u5F15\u304D\u53D6\u308A\u6E08\u307F\u306E\u56DE\u7B54\u3092\u542B\u3080)\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6\u30FB\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E contextToken \u304C\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\nnpx boxglow start B12 --note "<\u4F55\u3092\u3059\u308B\u304B>" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\nnpx boxglow ask B12 "<\u8CEA\u554F>" --options "A|B" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n#   \u2192 \u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C: \u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\nnpx boxglow done B12 --artifact "<\u540D\u524D>=<\u30D1\u30B9>" --context-token <\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n```\n\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u308B\u5834\u5408 (\u8AAD\u307F\u76F4\u3057\u304C\u8981\u308B)**: \u4EBA\u304C\u56DE\u7B54\u3057\u305F\u30FB\u56DE\u7B54\u3092\u76F4\u3057\u305F\u3001\u4EBA\u304C\u6307\u793A (\u984C\u540D\u30FB\u8AAC\u660E\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6) \u3092\u5909\u3048\u305F\u3001\u4ED6\u306E AI \u3084\u4EBA\u304C\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u66F4\u65B0\u3057\u305F\u3002\u89AA\u3084\u5165\u529B\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u3067\u8D77\u304D\u305F\u5834\u5408\u3082\u540C\u3058\u3002\u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F\u62D2\u5426\u3055\u308C\u308B\u306E\u3067\u3001`context` \u3092\u8AAD\u307F\u76F4\u3057\u3001\u5909\u308F\u3063\u305F\u5185\u5BB9\u3092\u4F5C\u696D\u306B\u53CD\u6620\u3057\u3066\u304B\u3089\u3084\u308A\u76F4\u3059\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u3089\u306A\u3044\u5834\u5408**: `start` / `blocked` / `review` / `leave` / `ack`\u3001\u9032\u6357\u30FB\u72B6\u614B\u30FB\u671F\u65E5\u30FB\u30AB\u30C6\u30B4\u30EA\u306E\u5909\u66F4\u3001`check` \u306B\u3088\u308B\u6210\u679C\u7269\u306E\u78BA\u8A8D\u3001\u753B\u9762\u3067\u306E\u914D\u7F6E\u306E\u5909\u66F4\u3002\u540C\u3058\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4F7F\u3044\u7D9A\u3051\u3089\u308C\u308B\n- **\u81EA\u5206\u3067\u66F4\u65B0\u3067\u304D\u308B\u5834\u5408**: \u81EA\u5206\u306E `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` \u306A\u3069\u3067\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5909\u308F\u3063\u305F\u3068\u304D\u306F\u3001\u305D\u306E\u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u308B\u3002\u81EA\u5206\u3067\u5909\u3048\u305F\u5185\u5BB9\u306F\u5206\u304B\u3063\u3066\u3044\u308B\u306E\u3067\u3001\u8AAD\u307F\u76F4\u3055\u305A\u306B\u6B21\u306E\u64CD\u4F5C\u3078\u4F7F\u3046\u3002`ask` / `decision` / `answer` / `reopen` \u306F\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u7121\u3057\u3067\u3082\u5B9F\u884C\u3067\u304D\u308B\u304C\u3001\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4ED8\u3051\u305F\u3068\u304D\u3060\u3051\n- **\u6700\u521D\u306F\u77ED\u3044\u5F62\u3067\u8AAD\u3080**: `npx boxglow context <block> --brief` \u306F\u3001\u5BFE\u8C61\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u60C5\u5831 (\u8AAC\u660E\u30FB\u7BC4\u56F2\u30FB\u5224\u65AD\u30FB\u5F15\u304D\u7D99\u304E\u30FB\u5165\u51FA\u529B\u30FB\u6210\u679C\u7269) \u306F\u5168\u90E8\u3001\u8A08\u753B\u5168\u4F53\u306E\u8AAC\u660E\u3001\u89AA\u3068\u5165\u529B\u5143\u306E\u984C\u540D\u30FB\u72B6\u614B\u30FB\u5224\u65AD (\u6750\u6599\u3068\u9078\u629E\u80A2\u3064\u304D\u3002\u524D\u306E\u56DE\u7B54\u306E\u5C65\u6B74\u306F\u7701\u304F)\u30FB\u5BFE\u8C61\u306B\u3064\u306A\u304C\u308B\u51FA\u529B\u3092\u51FA\u3059\u3002\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F `--brief` \u306A\u3057\u3068\u540C\u3058\u306A\u306E\u3067\u3001\u305D\u306E\u307E\u307E `--context-token` \u306B\u4F7F\u3048\u308B\u3002`target.missingInputs` (\u4E0D\u8DB3\u3057\u3066\u3044\u308B\u5FC5\u9808\u306E\u5165\u529B) \u3068 `target.inputs[].sources` (\u3069\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u3069\u306E\u51FA\u529B\u304B\u30FB\u6210\u679C\u7269\u306E\u53C2\u7167) \u3092\u5148\u306B\u898B\u308B\u3002`omitted` \u306B\u7701\u3044\u305F\u4EF6\u6570\u304C\u51FA\u308B\u3002\u7701\u304B\u308C\u305F\u8AAC\u660E\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6\u30FB\u5F15\u304D\u7D99\u304E\u304C\u4F5C\u696D\u306B\u95A2\u308F\u308A\u305D\u3046\u306A\u3089\u3001`--brief` \u306A\u3057\u3067\u8AAD\u3080\u304B\u3001\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E `context` \u3092\u8AAD\u3080\n- **\u77ED\u3044\u5F62\u3067\u59CB\u3081\u308B\u524D\u63D0**: \u7BC4\u56F2 (scope) \u3092 1 \u9805\u76EE\u3067\u3082\u8A2D\u5B9A\u3057\u305F\u89AA\u30FB\u5165\u529B\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u8AAC\u660E\u306F\u3001\u77ED\u3044\u5F62\u3067\u306F\u7701\u304B\u308C\u308B (`omitted.descriptions` \u306B\u4EF6\u6570)\u3002\u7BC4\u56F2\u3092\u8A2D\u5B9A\u3059\u308B\u3068\u304D\u306F\u3001\u8AAC\u660E\u306B\u66F8\u3044\u305F\u5236\u7D04 (\u4E92\u63DB\u6027\u30FB\u7981\u6B62\u4E8B\u9805\u30FB\u671F\u9650\u306A\u3069) \u3092\u7BC4\u56F2\u3078\u5199\u3057\u7D42\u3048\u3066\u304B\u3089\u306B\u3059\u308B\u3002\u5199\u3057\u305F\u304B\u5206\u304B\u3089\u306A\u3044\u8A08\u753B\u30FB`omitted.descriptions` \u304C 0 \u3067\u306A\u3044\u8A08\u753B\u3067\u306F\u3001\u7740\u624B\u524D\u306B `--brief` \u306A\u3057\u3067 1 \u5EA6\u8AAD\u3080\u3002\u77ED\u3044\u5F62\u306F\u8ABF\u67FB\u306E\u51FA\u767A\u70B9\u3067\u3001\u305D\u308C\u3060\u3051\u8AAD\u3081\u3070\u5341\u5206\u3068\u3044\u3046\u4FDD\u8A3C\u3067\u306F\u306A\u3044\n- \u77ED\u3044\u5F62\u3067\u3082\u7528\u304C\u8DB3\u308A\u308B\u3088\u3046\u306B\u66F8\u304F: \u4F5C\u696D\u3092\u7E1B\u308B\u6761\u4EF6\u306F\u8AAC\u660E\u306E\u4E2D\u306B\u57CB\u3081\u305A\u306B scope (non-goals / constraints / acceptance / consult) \u306B\u66F8\u304F\u3002\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u306F\u6700\u65B0\u306E 1 \u4EF6\u3060\u3051\u304C\u6B8B\u308B\u306E\u3067\u3001\u672A\u89E3\u6C7A\u306E\u70B9\u30FB\u6CE8\u610F\u70B9\u30FB\u6B21\u306E\u624B\u9806\u3092\u6BCE\u56DE\u66F8\u304D\u76F4\u3057\u3066\u6301\u3061\u8D8A\u3059\u3002\u8ABF\u3079\u59CB\u3081\u308B\u5834\u6240\u306F\u3001\u5BFE\u8C61\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u8AAC\u660E\u306B\u6B21\u306E\u5F62\u3067\u66F8\u304F (\u51FA\u767A\u70B9\u3067\u3042\u308A\u3001\u305D\u306E\u30D5\u30A1\u30A4\u30EB\u3060\u3051\u8AAD\u3081\u3070\u8DB3\u308A\u308B\u3068\u3044\u3046\u610F\u5473\u3067\u306F\u306A\u3044):\n  `\u5909\u66F4\u5019\u88DC: <\u30D1\u30B9> \u2014 <\u8ABF\u3079\u59CB\u3081\u308B\u7406\u7531>` / `\u95A2\u9023\u691C\u67FB: <\u30D1\u30B9\u307E\u305F\u306F\u30B3\u30DE\u30F3\u30C9> \u2014 <\u78BA\u304B\u3081\u308B\u3053\u3068>`\n- \u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u901A\u3059\u305F\u3081\u306B guard \u3092\u7121\u52B9\u306B\u3057\u306A\u3044 (AI \u304C `guard off` \u3059\u308B\u306B\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u8981\u308B)\n- MCP \u3067\u306F `boxglow_context` \u3068\u3001\u5404\u30C4\u30FC\u30EB\u306E `contextToken` \u5F15\u6570\u3092\u4F7F\u3046 (\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F\u30C4\u30FC\u30EB\u306E\u7D50\u679C\u306E\u6700\u5F8C\u306E\u884C\u306B\u51FA\u308B)\n- \u300C\u4ED6\u306E Boxglow \u304C\u66F8\u304D\u8FBC\u307F\u4E2D (\u30ED\u30C3\u30AF\u4E2D)\u300D\u3068\u51FA\u3066\u3001\u5C11\u3057\u5F85\u3063\u3066\u3084\u308A\u76F4\u3057\u3066\u3082\u89E3\u3051\u306A\u3044\u3068\u304D\u306F\u3001`npx boxglow unlock` \u306E\u8868\u793A (\u6301\u3061\u4E3B\u3068\u5224\u5B9A) \u3092\u4EBA\u306B\u898B\u305B\u3066\u89E3\u9664\u3092\u983C\u3080\u3002\u81EA\u5206\u3067 `--actor human` \u3092\u4ED8\u3051\u305F\u308A\u3001\u30ED\u30C3\u30AF\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u76F4\u63A5\u6D88\u3057\u305F\u308A\u3057\u306A\u3044\n\n### \u7740\u624B\u30FB\u5B8C\u4E86\u3001\u4ECA\u56DE\u306E\u7BC4\u56F2\u3001\u8A18\u9332\u306E\u9BAE\u5EA6\n\n- \u6700\u521D\u306B resume \u306E\u73FE\u6CC1 (\u6D3B\u52D5\u30FB\u5224\u65AD\u5F85\u3061\u30FB\u672A\u78BA\u8A8D\u56DE\u7B54) \u3092\u8AAD\u3080\u3002\u5019\u88DC\u306F\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2 / \u305D\u306E\u4ED6\u300D\u306E\u5404\u7D44\u3067\u300C\u7740\u624B\u3067\u304D\u308B / \u8981\u5177\u4F53\u5316 / \u5165\u529B\u5F85\u3061\u300D\u306B\u5206\u304B\u308C\u3001\u8981\u5177\u4F53\u5316\u306E\u7406\u7531\u3068\u4E0D\u8DB3\u3059\u308B\u5165\u529B\u540D\u304C\u51FA\u308B\u3002\u8981\u5177\u4F53\u5316\u3084\u5165\u529B\u5F85\u3061\u3092\u3001\u6E96\u5099\u6E08\u307F\u3068\u53D6\u308A\u9055\u3048\u306A\u3044\u3002\n- \u300C\u7740\u624B\u3067\u304D\u308B\u300D(Ready) \u306F\u3001\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B\u304C\u3042\u308A\u3001\u305D\u306E\u4E88\u5B9A\u6210\u679C\u7269 (expect) \u3068\u5B8C\u4E86\u6761\u4EF6 (acceptance) \u304C\u66F8\u304B\u308C\u3001\u5FC5\u9808\u306E\u5165\u529B\u304C\u305D\u308D\u3063\u3066\u3044\u308B\u3001\u3068\u3044\u3046\u6A5F\u68B0\u691C\u67FB\u306E\u7D50\u679C\u3002\u5185\u5BB9\u304C\u5177\u4F53\u7684\u304B\u3069\u3046\u304B\u307E\u3067\u306F\u4FDD\u8A3C\u3057\u306A\u3044 (`expect = src/`\u3001`acceptance = \u52D5\u4F5C\u3059\u308B` \u3067\u3082\u901A\u308B)\u3002\u5BFE\u8C61\u30FB\u51E6\u7406\u30FB\u6210\u679C\u30FB\u78BA\u8A8D\u65B9\u6CD5\u3092\u7B2C\u4E09\u8005\u304C\u8FFD\u3048\u308B\u3088\u3046\u306B\u66F8\u304F\u3002\n- \u30DC\u30C3\u30AF\u30B9\u306E\u4EFB\u610F5\u9805\u76EE\u3092 scope \u3067\u8A2D\u5B9A\u3059\u308B\u3002goal = \u4ECA\u56DE\u9054\u6210\u3059\u308B\u3053\u3068\u3001non-goals = \u4ECA\u56DE\u306F\u6271\u308F\u306A\u3044\u3053\u3068\u3001acceptance = \u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6\u3001consult = \u7BC4\u56F2\u3092\u5E83\u3052\u308B\u524D\u306B\u76F8\u8AC7\u3059\u308B\u6761\u4EF6\u3002context \u306E\u5148\u982D\u3067\u5BFE\u8C61\u3068\u89AA\u306E\u7BC4\u56F2\u3092\u8AAD\u307F\u3001\u7740\u624B\u524D\u3068\u5B8C\u4E86\u524D\u306B\u7167\u5408\u3059\u308B\u3002\u5B8C\u4E86\u6761\u4EF6\u306E\u672C\u6587\u3092AI\u304C\u6E80\u305F\u3057\u305F\u304B\u306F\u81EA\u52D5\u5224\u5B9A\u3057\u306A\u3044\u3002\n- scope B12 --goal "\u9054\u6210\u3059\u308B\u3053\u3068" --non-goals "\u4ECA\u56DE\u6271\u308F\u306A\u3044\u3053\u3068" --acceptance "\u78BA\u8A8D\u3059\u308B\u6761\u4EF6" --consult "\u76F8\u8AC7\u3059\u308B\u6761\u4EF6" \u3067\u8A2D\u5B9A\u3059\u308B\u3002scope B12 \u306F\u8868\u793A\u3060\u3051\u3002\u5404\u9805\u76EE\u306B none \u307E\u305F\u306F\u7A7A\u6587\u5B57\u3092\u6E21\u3059\u3068\u6D88\u3059\u3002\u753B\u9762\u3067\u306F\u8A73\u7D30\u30D1\u30CD\u30EB\u306E\u300C\u305D\u306E\u4ED6\u300D\u30BF\u30D6 \u2192\u300C\u4F5C\u696D\u7BC4\u56F2\u3092\u7DE8\u96C6\u300D\u3002\u8A18\u5165\u6E08\u307F\u306E\u9805\u76EE\u3060\u3051\u304C\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2\u300D\u306B\u51FA\u308B\u3002\n- focus B12 \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u3068\u914D\u4E0B\u3092\u6B21\u5019\u88DC\u306E\u5148\u982D\u306B\u3059\u308B\u3002focus \u306F\u73FE\u5728\u306E\u5BFE\u8C61\u306E\u8868\u793A\u3001focus none \u306F\u89E3\u9664\u3002\u5BFE\u8C61\u5916\u3082\u5225\u306E\u7D44\u306B\u6B8B\u308B\u3002\u5019\u88DC\u306B\u51FA\u308B\u3053\u3068\u81EA\u4F53\u306F\u4F5C\u696D\u7BC4\u56F2\u306E\u62E1\u5927\u3084\u516C\u958B\u3092\u8A31\u53EF\u3057\u306A\u3044\u3002\n- start \u306E\u5FC5\u9808\u5165\u529B\u4E0D\u8DB3\u306F\u65E2\u5B9A\u3067\u8B66\u544A\u3059\u308B\u304C\u3001\u5F93\u6765\u3069\u304A\u308A\u958B\u59CB\u3067\u304D\u308B\u3002\u5148\u884C\u4F5C\u696D\u304C\u5FC5\u8981\u306A\u3089 --reason "\u5148\u306B\u884C\u3046\u7406\u7531" \u3092\u4ED8\u3051\u308B\u3002\u8B66\u544A\u306F\u51FA\u305A\u3001\u7406\u7531\u306F\u6D3B\u52D5\u3068\u30ED\u30B0\u306B\u6B8B\u308B\u3002done \u306E\u51FA\u529B\u6210\u679C\u7269\u306A\u3057\u3082\u65E2\u5B9A\u3067\u8B66\u544A\u306E\u307F\u3002\u65E2\u5B58\u306E\u51FA\u529B\u6210\u679C\u7269\u307E\u305F\u306F --artifact \u3092\u6570\u3048\u3001\u30DC\u30C3\u30AF\u30B9\u306E\u53C2\u8003\u8CC7\u6599\u306F\u6570\u3048\u306A\u3044\u3002\n- \u8A08\u753B\u3067\u9078\u3076\u5834\u5408\u3060\u3051 policy --start reject --done reject --unprepared reject \u306B\u3059\u308B\u3002\u305D\u308C\u305E\u308C warn \u306B\u623B\u305B\u308B\u3002\u5165\u529B\u5F85\u3061\u306E\u62D2\u5426\u3067\u3082\u7406\u7531\u4ED8\u304D\u306E\u958B\u59CB\u306F\u53EF\u80FD\u3060\u304C\u3001\u8981\u5177\u4F53\u5316\u306E\u62D2\u5426\u306F\u7406\u7531\u3067\u306F\u901A\u308C\u306A\u3044 (\u5148\u306B\u5177\u4F53\u5316\u3059\u308B)\u3002\u6210\u679C\u7269\u306A\u3057\u306E\u62D2\u5426\u306F set --status white \u306B\u3082\u52B9\u304F\u3002\u4EBA\u306E\u64CD\u4F5C (\u753B\u9762 / --actor human) \u306F\u62D2\u5426\u3057\u306A\u3044\u3002AI\u304C\u62D2\u5426\u3092\u907F\u3051\u308B\u305F\u3081\u306B\u4EBA\u3092\u540D\u4E57\u3063\u305F\u308A\u3001\u8A2D\u5B9A\u3092\u5F31\u3081\u305F\u308A\u3057\u306A\u3044\u3002\n- guard \u6709\u52B9\u6642\u3001scope \u306E\u5909\u66F4\u3001focus \u306E\u8A2D\u5B9A\u30FB\u89E3\u9664\u3001policy \u306E\u5909\u66F4\u306B\u3082 --context-token \u304C\u5FC5\u8981\u3002scope/focus/policy \u3092\u5909\u3048\u308B\u3068\u65B0\u3057\u3044\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u3067\u3001\u6B21\u306E\u64CD\u4F5C\u306F\u305D\u308C\u3092\u4F7F\u3046\u3002\u8868\u793A\u3060\u3051\u306B\u306F\u4E0D\u8981\u3002\n- resume \u306F\u5B8C\u4E86\u6E08\u307F\u306E\u5F15\u304D\u7D99\u304E\u672C\u6587\u3092\u96A0\u3057\u3001\u4EF6\u6570\u3060\u3051\u793A\u3059\u3002\u5C65\u6B74\u304C\u5FC5\u8981\u306A\u5834\u5408\u3060\u3051 resume --include-completed \u3067\u5C55\u958B\u3059\u308B (context / show \u3067\u306F\u500B\u5225\u306B\u8AAD\u3081\u308B)\u3002\n- \u8AAC\u660E\u306F descriptionUpdatedAt\u3001\u72B6\u614B\u306F statusChangedAt\u3001\u5F15\u304D\u7D99\u304E\u306F\u65E2\u5B58\u306E at \u3067\u65E5\u6642\u3092\u78BA\u8A8D\u3067\u304D\u308B\u3002\u72B6\u614B\u5909\u66F4\u3088\u308A\u53E4\u3044\u30E1\u30E2\u306F\u305D\u306E\u65E8\u3092\u793A\u3059\u3002\u65E7\u8A18\u9332\u306E\u4E0D\u660E\u306A\u65E5\u6642\u306F\u88DC\u308F\u306A\u3044\u3002\u300C\u65B0\u3057\u3044\u8A18\u9332\u300D\u306F\u771F\u507D\u306E\u4FDD\u8A3C\u3067\u306F\u306A\u3044\u3002\n- Done \u3067\u53E4\u3044\u72B6\u6CC1\u8AAC\u660E\u304C\u6B8B\u308B\u53EF\u80FD\u6027\u304C\u3042\u308B\u5834\u5408\u3001CLI\u30FB\u8A73\u7D30\u30D1\u30CD\u30EB\u30FBresume \u306B\u898B\u76F4\u3057\u6848\u5185\u304C\u51FA\u308B\u3002\u672C\u6587\u306F\u81EA\u52D5\u3067\u6D88\u3055\u306A\u3044\u3002\u5185\u5BB9\u3092\u78BA\u8A8D\u3057\u3001\u5FC5\u8981\u306A\u3089 set B12 --note "\u73FE\u5728\u306E\u8AAC\u660E" (none \u3067\u6D88\u53BB) \u307E\u305F\u306F\u753B\u9762\u306E Notes \u3067\u76F4\u3059\u3002\n- MCP \u306F boxglow_scope / boxglow_focus / boxglow_policy\u3001boxglow_claim\u3001boxglow_port \u306E expect / self\u3001boxglow_start \u306E reason\u3001boxglow_resume \u306E includeCompleted \u3092\u4F7F\u3046\u3002\u5909\u66F4\u306B\u306F contextToken \u3092\u4ED8\u3051\u308B\u3002\n- \u30C7\u30FC\u30BF\u5F62\u5F0F\u306F v5 \u306E\u307E\u307E\u3067\u5168\u9805\u76EE\u306F\u4EFB\u610F\u3002\u65E7\u7248 (0.4.2\u4EE5\u524D) \u306F\u65B0\u3057\u3044\u898F\u5247\u3092\u5B9F\u884C\u305B\u305A\u3001\u4FDD\u5B58\u6642\u306B\u8A08\u753B\u306E workflowPolicy / focusBlockId \u3092\u843D\u3068\u3059\u3002\u3053\u308C\u3089\u3092\u4F7F\u3046\u8A08\u753B\u306E\u66F8\u304D\u624B (CLI\u30FBserve\u30FB\u753B\u9762\u30FB\u62E1\u5F35\u5185\u306E\u30A2\u30D7\u30EA) \u306F\u5BFE\u5FDC\u3057\u305F\u30D3\u30EB\u30C9\u306B\u63C3\u3048\u308B\u3002\u7248\u756A\u53F7\u3060\u3051\u3067\u306A\u304F\u30D3\u30EB\u30C9\u65E5\u6642\u3082\u78BA\u8A8D\u3059\u308B\u3002\n\n\n### Sync decisions\n\nAI may only sync already bound projects and inspect comparisons. If sync stops for a conflict or a human choice, summarize the differences and use ask to notify the user. Never resolve conflicts, create a new binding, relink, recover, adopt, restore, or confirm an account. A human must use the UI or explicitly run CLI with --actor human. AI must never add --actor human, including after a chat answer; record the answer and wait for the human to apply the sync choice.\n\nCodex\u306F\u5168CLI\u547C\u3073\u51FA\u3057\u306B `--actor codex`\u3001Claude Code\u306F `--actor claude-code` \u3092\u660E\u793A\u3059\u308B\u3002WSL\u306A\u3069\u3067\u306F\u5B9F\u884C\u74B0\u5883\u306E\u5370\u304C\u6E21\u3089\u306A\u3044\u3053\u3068\u304C\u3042\u308B\u3002\u30B5\u30D6\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306F `codex-\u4F5C\u696D\u540D` \u306A\u3069\u306B\u5206\u3051\u3001\u4EBA\u3092\u540D\u4E57\u3089\u306A\u3044\u3002\n\n### \u4E26\u5217\u4F5C\u696D\u306E\u53D7\u3051\u6301\u3061\n\n\u8A08\u753B\u3067\u53D7\u3051\u6301\u3061\u304C\u6709\u52B9\u306A\u3089\u3001CLI\u5B9F\u884C\u3054\u3068\u306B\u4E00\u610F\u306E `BOXGLOW_INSTANCE_ID` \u3092\u56FA\u5B9A\u3057\u3001`claims` \u3068 `context` \u3092\u8AAD\u3093\u3067\u304B\u3089 `claim` (\u5177\u4F53\u5316\u30FB\u5206\u89E3\u306E\u524D) \u307E\u305F\u306F `start` (\u5B9F\u884C) \u3059\u308B\u3002`claim` \u3067\u53D6\u3063\u305F\u53D7\u3051\u6301\u3061\u306F\u3001\u305D\u306E\u307E\u307E `start` \u306B\u5F15\u304D\u7D99\u304C\u308C\u308B\u3002\u72EC\u7ACB\u3057\u305F\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u9593\u3067\u5B9F\u884CID\u3092\u5171\u6709\u3057\u306A\u3044\u3002\u65E2\u5B9A\u306F\u30DC\u30C3\u30AF\u30B9\u306E\u307F\u3001\u5FC5\u8981\u306A\u3089 `--scope subtree`\u3002\u6210\u529F\u3057\u305FCLAIM\u884C\u306Etoken\u3092\u4FDD\u6301\u3057\u3001\u4FDD\u5B58\u3059\u308B\u64CD\u4F5C\u306B `--claim-token` \u3092\u4ED8\u3051\u308B\u3002MCP\u306F\u5B9F\u884CID\u3068\u53D7\u9818\u8A3C\u3092\u81EA\u52D5\u3067\u4FDD\u6301\u3059\u308B\u30025\u5206\u3054\u3068 (\u671F\u9650\u304C\u77ED\u3051\u308C\u3070\u534A\u5206\u4EE5\u5185) \u306B `claim-renew` / `boxglow_claim_renew` \u3092\u547C\u3073\u3001\u4E2D\u65AD\u524D\u306Fcheckpoint\u3002done/leave\u306F\u5BFE\u8C61\u306E\u53D7\u3051\u6301\u3061\u3092\u89E3\u653E\u3059\u308B\u3002\u671F\u9650\u5207\u308C\u3084\u4E16\u4EE3\u9055\u3044\u3092\u7121\u8996\u305B\u305A\u3001\u6700\u65B0context\u3092\u78BA\u8A8D\u3057\u3066\u53D6\u308A\u76F4\u3059\u3002\u540C\u540Dactor\u3067\u3082\u5225\u5B9F\u884C\u306E\u53D7\u3051\u6301\u3061\u306F\u596A\u308F\u306A\u3044\u3002\u8A2D\u5B9A\u30FB\u5F37\u5236\u89E3\u9664\u30FB\u540C\u671F\u7AF6\u5408\u306E\u89E3\u6C7A\u306F\u4EBA\u306B\u4F9D\u983C\u3057\u3001AI\u304Chuman\u3092\u540D\u4E57\u3063\u3066\u4EE3\u884C\u3057\u306A\u3044\u3002\u5171\u6709\u30D5\u30A1\u30A4\u30EB\u4EE5\u5916\u306E\u540C\u671F\u30B3\u30D4\u30FC\u9593\u306B\u306F\u6392\u4ED6\u4FDD\u8A3C\u304C\u306A\u3044\u3002\u8A73\u3057\u304F\u306F `docs/CLAIMS.md`\u3002\n\n\u4ED6\u8005\u306E\u5B9F\u884CID\u30FB\u53D7\u9818\u8A3C\u3092\u4F7F\u308F\u306A\u3044\u3002\u8A08\u753B\u3084claims\u306E\u51FA\u529B\u304B\u3089\u4ED6\u8005\u306E\u53D7\u9818\u8A3C\u3092\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u3082\u7981\u6B62\u3002MCP\u518D\u8D77\u52D5\u5F8C\u306E\u540C\u540Dactor\u3082\u5225\u5B9F\u884C\u306A\u306E\u3067\u3001\u81EA\u52D5\u3067\u5F15\u304D\u7D99\u304C\u305A\u671F\u9650\u3092\u5F85\u3064\u304B\u4EBA\u306B\u89E3\u9664\u3092\u983C\u3080\u3002\n\n\u5165\u529B\u306E\u81EA\u52D5\u5F15\u304D\u4E0A\u3052\u306F\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u7BC4\u56F2\u3067\u6271\u3046\u3002\u5171\u6709\u5165\u529B\u306E\u5185\u5BB9\u5909\u66F4\u3084\u5225\u30DC\u30C3\u30AF\u30B9\u3078\u306E\u914D\u7F6E\u5909\u66F4\u306B\u306F\u3001\u5F71\u97FF\u3059\u308B\u7BC4\u56F2\u306E\u53D6\u5F97\u3082\u5FC5\u8981\u3002focus\u3084group\u306A\u3069\u8A08\u753B\u5168\u4F53\u306E\u8A2D\u5B9A\u306B\u306F `context root` \u2192 `claim root` \u3067root\u3092\u53D6\u5F97\u3057\u3001\u305D\u306ECLAIM\u3092\u6E21\u3059 (`start root` \u3067\u3082\u53D6\u308C\u308B\u304C\u3001\u5B9F\u884C\u4E2D\u306B\u306F\u3057\u306A\u3044 `claim` \u3092\u4F7F\u3046)\u3002root\u306E\u307F\u306E\u53D6\u5F97\u306F\u901A\u5E38\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u542B\u307E\u306A\u3044\u3002\u8A08\u753B\u8A2D\u5B9A\u306E\u5909\u66F4\u306Froot\u306E\u307F\u3067\u8DB3\u308A\u308B\u3002root\u306Esubtree\u306F\u4E26\u884C\u4F5C\u696D\u3092\u5168\u90E8\u6B62\u3081\u308B\u306E\u3067\u3001AI\u306F\u4F7F\u308F\u305A\u4EBA\u306B\u76F8\u8AC7\u3059\u308B\u3002root\u306E\u7D42\u4E86\u306F `leave root`\u3002context guard\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3082\u5F15\u304D\u7D9A\u304D\u5FC5\u8981\u3002\n\n---\n\n\u540C\u671F\u306E\u4EBA\u5C02\u7528\u64CD\u4F5C\u306F\u3001\u5F37\u5236\u7684\u306A\u6A29\u9650\u5206\u96E2\u3067\u306F\u306A\u304F\u8AA4\u64CD\u4F5C\u306E\u9632\u6B62\u3067\u3059\u3002AI \u306F `--actor human` \u3092\u540D\u4E57\u3089\u305A\u3001\u6BD4\u8F03\u3068\u505C\u6B62\u7406\u7531\u3092\u4EBA\u3078\u4F1D\u3048\u3066\u304F\u3060\u3055\u3044\u3002MCP \u3068 AI \u3068\u3057\u3066\u8B58\u5225\u3057\u305F CLI \u306F\u3001\u4EBA\u7528\u306E\u9078\u629E\u30B3\u30DE\u30F3\u30C9\u3092\u51FA\u529B\u3057\u307E\u305B\u3093\u3002\n\n\u4EBA\u306ECLI\u64CD\u4F5C\u306F `--actor human:\u540D\u524D` \u3082\u53D7\u3051\u4ED8\u3051\u307E\u3059\u3002AI\u306F\u3053\u306E\u5F62\u3067\u3082\u4EBA\u3092\u540D\u4E57\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002AI\u5411\u3051\u505C\u6B62\u6587\u306E `boxglow sync --help` \u306F\u3001AI\u74B0\u5883\u3092\u5F15\u304D\u7D99\u3044\u3060\u4EBA\u3078\u306E\u6848\u5185\u3067\u3059\u3002AI\u306E\u4EE3\u884C\u8A31\u53EF\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002\n';
+var AGENTS_SNIPPET_default = '# Boxglow \u3092\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306B\u4F7F\u308F\u305B\u308B\u6307\u793A\u66F8 (AGENTS.md / CLAUDE.md \u306B\u8CBC\u308B)\n\n\u4E0B\u306E\u300C---\u300D\u306E\u9593\u3092\u305D\u306E\u307E\u307E\u30EA\u30DD\u30B8\u30C8\u30EA\u306E AGENTS.md (Codex) \u3084 CLAUDE.md (Claude Code) \u306B\u8CBC\u308B\u3002\nboxglow.json \u306F\u30EA\u30DD\u30B8\u30C8\u30EA\u76F4\u4E0B\u306B\u7F6E\u304F (`npx boxglow init --name "<\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D>"`)\u3002\n\n---\n\n## Boxglow (\u8A08\u753B\u3068\u9032\u6357\u306E\u5171\u6709)\n\n\u3053\u306E\u30EA\u30DD\u30B8\u30C8\u30EA\u306E\u8A08\u753B\u3068\u9032\u6357\u306F `boxglow.json` \u304C\u6B63\u672C\u3002\u4EBA\u9593\u306F Boxglow \u306E\u753B\u9762\u3067\u3053\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u898B\u3066\u3044\u308B\u3002\n\u30D5\u30A1\u30A4\u30EB\u3092\u76F4\u63A5\u7DE8\u96C6\u305B\u305A\u3001\u5FC5\u305A `npx boxglow` \u30B3\u30DE\u30F3\u30C9\u3067\u66F4\u65B0\u3059\u308B\u3053\u3068 (\u7D50\u7DDA\u30EB\u30FC\u30EB\u3068\u5C65\u6B74\u304C\u4FDD\u305F\u308C\u308B)\u3002\n\n\u30D6\u30ED\u30C3\u30AF = \u300C\u5165\u529B\u304B\u3089\u51FA\u529B (\u6210\u679C\u7269) \u3092\u4F5C\u308B\u30BF\u30B9\u30AF\u300D\u3002\u51FA\u529B\u306E\u6210\u679C\u7269\u304C\u78BA\u5B9A\u3057\u305F\u3089\u5B8C\u4E86 (WhiteBox)\u3002\n\u72B6\u614B: BlackBox (\u51FA\u529B\u3060\u3051\u6C7A\u3081\u305F) \u2192 GrayBox (\u7740\u624B\u4E2D) \u2192 WhiteBox (\u5B8C\u4E86)\u3002\n\n### \u4F5C\u696D\u306E\u305F\u3073\u306B\u5B88\u308B\u3053\u3068\n\n1. **\u6700\u521D\u306B\u8AAD\u3080**: `npx boxglow resume` (\u307E\u305F\u306F `npx boxglow status --brief`) \u3067\u3001\u4F5C\u696D\u4E2D\u30FB\u5224\u65AD\u5F85\u3061\u30FBAI \u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u30FB\u6B21\u306E\u5019\u88DC\u30FB\u672A\u5B8C\u4E86\u306E\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u8AAD\u3080\u3002\u524D\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u7D9A\u304D\u306F\u3001\u3053\u3053\u306B\u51FA\u308B\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u304B\u3089\u518D\u958B\u3059\u308B\u3002`npx boxglow show <block>` \u3067\u62C5\u5F53\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u306E\u5165\u51FA\u529B\u3092\u78BA\u8A8D\u3059\u308B\n2. **\u6E96\u5099\u3092\u78BA\u8A8D**: \u53D6\u308A\u304B\u304B\u308B\u524D\u306B `npx boxglow context <block>` \u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E `readiness` \u304C\u6E96\u5099\u306E\u72B6\u614B: `state` \u304C `ready` \u306A\u3089\u7740\u624B\u3067\u304D\u308B\u3002`unprepared` (\u8981\u5177\u4F53\u5316) \u306A\u3089 `unprepared` \u306E\u7406\u7531\u3068 `next` \u306E\u6B21\u306E\u4E00\u624B\u306B\u5F93\u3063\u3066\u5148\u306B\u5177\u4F53\u5316\u3059\u308B\u3002`waiting` \u306F\u5FC5\u9808\u306E\u5165\u529B\u304B\u5206\u5C90\u306E\u7B54\u3048\u3092\u5F85\u3063\u3066\u3044\u308B\n3. **\u53D7\u3051\u6301\u3061\u3001\u5177\u4F53\u5316**: \u5177\u4F53\u5316\u3084\u5206\u89E3\u306E\u524D\u306B `npx boxglow claim <block>` \u3067\u53D7\u3051\u6301\u3061\u3060\u3051\u3092\u53D6\u308B (\u5B9F\u884C\u4E2D\u306B\u306F\u306A\u3089\u306A\u3044\u3002\u53D7\u3051\u6301\u3061\u5236\u5FA1\u304C\u7121\u52B9\u306A\u8A08\u753B\u3067\u306F\u300C\u53D6\u5F97\u4E0D\u8981\u300D\u3067\u6B63\u5E38\u7D42\u4E86\u3059\u308B)\u3002\u305D\u306E\u3046\u3048\u3067\u4E0D\u8DB3\u3092\u57CB\u3081\u308B:\n   - \u51FA\u529B\u306E\u4E88\u5B9A\u6210\u679C\u7269: `npx boxglow port <block> --expect "<\u51FA\u529B\u540D>=file:src/x.ts"` (kind \u306F file / dir / url / doc / note / decision / result\u3002hint \u306F\u30D1\u30B9\u306E\u898B\u5F53\u3084\u984C\u540D\u3002\u307E\u3060\u4F5C\u3063\u3066\u3044\u306A\u3044\u30D5\u30A1\u30A4\u30EB\u3067\u3088\u3044)\n   - \u5B8C\u4E86\u6761\u4EF6: `npx boxglow scope <block> --acceptance "<\u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6>"`\u3002\u51E6\u7406\u306E\u7BC4\u56F2\u306F `--goal`\u3002\u51FA\u529B\u3092\u4F5C\u308B\u3046\u3048\u3067\u5B88\u308B\u6761\u4EF6 (\u6027\u80FD\u30FB\u54C1\u8CEA\u30FB\u30B5\u30A4\u30BA\u30FB\u5BF8\u6CD5\u30FB\u6D88\u8CBB\u96FB\u529B\u306A\u3069) \u306F `--constraints`\n   - 1 \u3064\u306E\u30DC\u30C3\u30AF\u30B9\u3067\u51FA\u529B\u3092\u4F5C\u308B\u898B\u901A\u3057\u304C\u7ACB\u305F\u306A\u3044\u306A\u3089 `npx boxglow split <block> --spec \'<JSON>\'` \u3067\u4E2D\u306B\u5C0F\u3055\u306A\u30DC\u30C3\u30AF\u30B9\u3092\u7F6E\u304F\u3002\u4ECA\u56DE\u7740\u624B\u3059\u308B\u5B50\u3060\u3051 expect / acceptance \u3092\u66F8\u304D\u3001\u5148\u306E\u5B50\u306F\u984C\u540D\u3068\u51FA\u529B\u3060\u3051\u3067\u3088\u3044 (\u8981\u5177\u4F53\u5316\u3068\u3057\u3066\u6B8B\u308B)\u3002\u5165\u529B\u306F\u4E0D\u660E\u306A\u3089\u7701\u7565\u3057\u3066\u3088\u3044 (\u81EA\u52D5\u3067\u4E0A\u306E\u968E\u5C64\u306E\u5165\u529B\u306B\u306A\u308B)\n   - \u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u304C\u5206\u304B\u3089\u306A\u3044\u3068\u304D\u306F\u3001\u67B6\u7A7A\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u66F8\u304B\u305A\u300C\u5BFE\u8C61\u3092\u7279\u5B9A\u3059\u308B\u8ABF\u67FB\u300D\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u51FA\u529B `note` \u3067\u4F5C\u3063\u3066\u59CB\u3081\u308B\n4. **\u7740\u624B\u3092\u8A18\u9332**: \u6E96\u5099\u304C\u3067\u304D\u305F\u3089 `npx boxglow context <block>` \u3092\u8AAD\u307F\u76F4\u3057\u3066\u304B\u3089 `npx boxglow start <block> --note "<\u4F55\u3092\u3059\u308B\u304B>"`\u3002\u540C\u6642\u306B\u9032\u3081\u308B\u30DC\u30C3\u30AF\u30B9\u306F 1\u301C2 \u500B\u307E\u3067\u3002\n   start \u3057\u305F\u30DC\u30C3\u30AF\u30B9\u306B\u300C\u4ECA\u3053\u3053\u300D(\u672C\u5F53\u306B\u3044\u307E\u4F5C\u696D\u3057\u3066\u3044\u308B\u30DC\u30C3\u30AF\u30B9\u3002\u8907\u6570\u306E AI \u3084\u4EBA\u304C\u3044\u308C\u3070\u3001\u3044\u304F\u3064\u3067\u3082) \u304C\u4ED8\u304D\u3001\u753B\u9762\u3067\u592A\u3044\u67A0\u3068 NOW \u306E\u672D\u304C\u4ED8\u304F\u3002\u5225\u306E\u30DC\u30C3\u30AF\u30B9\u306B\u3082\u4ED8\u3051\u308B\u3068\u304D\u306F `npx boxglow now <block>` (\u5916\u3059\u3068\u304D\u306F `--off`\u3001\u5168\u90E8\u6D88\u3059\u3068\u304D\u306F `now none`)\u3002done / leave \u3067\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5206\u304C\u5916\u308C\u308B\u3002\u4EBA\u3082\u753B\u9762\u306E\u72B6\u614B\u30BF\u30D6\u306E NOW \u3067\u4ED8\u3051\u5916\u3057\u3059\u308B\n   \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u304C\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001\u51FA\u529B\u306E `contextToken` (\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3) \u3092\u4ED8\u3051\u308B:\n   `npx boxglow start <block> --note "<\u4F55\u3092\u3059\u308B\u304B>" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` (\u4E0B\u306E\u300C\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3068\u5F15\u304D\u7D99\u304E\u300D\u3092\u53C2\u7167)\n   \u8981\u5177\u4F53\u5316\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u306E start \u306F\u65E2\u5B9A\u3067\u306F\u8B66\u544A (\u7406\u7531\u3068\u6B21\u306E\u4E00\u624B\u304C\u51FA\u308B)\u3002`policy --unprepared reject` \u306E\u8A08\u753B\u3067\u306F\u958B\u59CB\u3067\u304D\u306A\u3044 (`--reason` \u3067\u306F\u901A\u308C\u306A\u3044\u3002\u4EBA\u306E\u64CD\u4F5C\u306F\u901A\u308B)\u3002\u51FA\u529B\u3092\u5B50\u306B\u4EFB\u305B\u304D\u308A\u306E\u89AA\u3082\u5B9F\u884C\u3059\u308B\u3082\u306E\u304C\u7121\u3044\u306E\u3067\u3001\u5B50\u3092 start \u3059\u308B\n5. **\u5B8C\u4E86\u3092\u8A18\u9332**: \u51FA\u529B\u306E\u6210\u679C\u7269\u304C\u3067\u304D\u305F\u3089 `npx boxglow done <block> --artifact "<\u540D\u524D>=<\u30EA\u30DD\u30B8\u30C8\u30EA\u5185\u306E\u30D1\u30B9>" --checked "<\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C>"`\u3002\u691C\u67FB\u7D50\u679C\u306F\u6C7A\u307E\u3063\u305F 3 \u3064\u3067\u6B8B\u3059: `--checked` (\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C\u3002\u4F8B: "vitest 53 \u4EF6\u6210\u529F; e2e home 34/34")\u3001`--not-checked` (\u8A66\u3057\u3066\u3044\u306A\u3044\u3053\u3068)\u3001`--limits` (\u6B8B\u308B\u5236\u9650\u30FB\u6CE8\u610F)\u3002\u30B3\u30FC\u30C9\u4EE5\u5916\u306E\u6210\u679C\u7269 (\u6587\u66F8\u306A\u3069) \u306F\u300C\u78BA\u8A8D\u3057\u305F\u3053\u3068\u300D\u3092 `--checked` \u306B\u66F8\u304F\u3002\u7BB1\u306B\u6B8B\u308A\u3001context \u3068 show \u306B\u51FA\u308B\u3002\n   guard \u304C\u6709\u52B9\u306A\u3089 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3092\u4ED8\u3051\u308B (\u76F4\u524D\u306E\u81EA\u5206\u306E\u64CD\u4F5C\u306E\u51FA\u529B\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u3066\u3044\u308C\u3070\u3001\u305D\u308C\u3092\u4F7F\u3046)\u3002\n   HEAD \u306B\u30B3\u30DF\u30C3\u30C8\u6E08\u307F\u3067\u5185\u5BB9\u304C\u4E00\u81F4\u3059\u308B\u30D5\u30A1\u30A4\u30EB\u306F\u300C\u30B3\u30DF\u30C3\u30C8 + \u30D1\u30B9 + \u4E2D\u8EAB\u306E\u30CF\u30C3\u30B7\u30E5\u300D\u3067\u8A18\u9332\u3055\u308C\u308B (\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u306F\u3057\u306A\u3044)\u3002\u672A\u30B3\u30DF\u30C3\u30C8\u30FB\u672A\u8FFD\u8DE1\u306E\u30D5\u30A1\u30A4\u30EB\u306F\u30ED\u30FC\u30AB\u30EB\u53C2\u7167\u3068\u3057\u3066\u6B8B\u308A\u3001\u30B3\u30DF\u30C3\u30C8\u3057\u305F\u5F8C\u306E `npx boxglow check` \u3067 Git \u306E\u53C2\u7167\u306B\u88DC\u5B8C\u3055\u308C\u308B\u3002\u8A18\u9332\u306E\u305F\u3081\u3060\u3051\u306B\u30B3\u30DF\u30C3\u30C8\u3057\u306A\u3044\u3002\u5168\u968E\u5C64\u304C\u5FC5\u8981\u306A\u3089 `npx boxglow status` \u3092\u8AAD\u3080\u3002PR \u3084\u5916\u90E8\u8CC7\u6599\u306F URL \u3067\u3082\u3088\u3044\u3002\n   \u6210\u679C\u7269\u3060\u3051\u5148\u306B\u4ED8\u3051\u308B\u306A\u3089 `npx boxglow artifact <block> <\u30D1\u30B9>`\u3002\u9032\u6357\u306E\u9014\u4E2D\u7D4C\u904E\u306F `npx boxglow set <block> --progress 60`\n6. **\u4EBA\u9593\u306E\u5224\u65AD\u304C\u8981\u308B**: `npx boxglow ask <block> "<\u8CEA\u554F>" --options "A|B"`\u3002\u56DE\u7B54\u304C\u3042\u308B\u307E\u3067\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u9032\u3081\u305A\u3001\u4ED6\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u79FB\u308B\u3002\u4EBA\u306E\u56DE\u7B54\u306F `status` \u306E\u300C\u56DE\u7B54\u3042\u308A\u300D\u306B\u51FA\u308B\u3002\u8AAD\u3093\u3060\u3089 `npx boxglow ack <block>` \u3067\u5F15\u304D\u53D6\u308B (\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E `start` / `done` / `set` \u306A\u3069\u3067\u3082\u81EA\u52D5\u3067\u5F15\u304D\u53D6\u3089\u308C\u308B)\u3002\u5F15\u304D\u53D6\u308B\u307E\u3067\u4EBA\u306E\u753B\u9762\u306B\u306F\u300CAI \u672A\u78BA\u8A8D\u300D\u3068\u3057\u3066\u6B8B\u308A\u3001\u4EBA\u304C\u7B54\u3048\u3092\u76F4\u305B\u308B\u3002\u56DE\u7B54\u306E\u4E2D\u306B\u554F\u3044\u8FD4\u3057\u304C\u3042\u308C\u3070\u3001`ask` \u3068 `answer --by <\u81EA\u5206>` \u3067\u81EA\u5206\u306E\u7B54\u3048\u3082\u8A18\u9332\u3059\u308B\n7. **\u8A70\u307E\u3063\u305F\u3089**: \u5165\u529B (\u524D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u6210\u679C\u7269\u30FB\u8CC7\u6599) \u304C\u8DB3\u308A\u306A\u3044\u3053\u3068\u304C\u539F\u56E0\u306A\u3089\u3001\u8A70\u307E\u308A\u306B\u3057\u306A\u3044\u3002`npx boxglow show <block>` \u3067\u5165\u529B\u306E\u914D\u7DDA\u3092\u78BA\u304B\u3081\u3001\u8DB3\u308A\u306A\u3044\u3082\u306E\u3092\u4F5C\u308B\u30DC\u30C3\u30AF\u30B9\u304C\u7121\u3051\u308C\u3070 `npx boxglow add` \u3067\u5916 (\u4E0A\u6D41) \u306B\u4F5C\u308A\u3001`npx boxglow connect` \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5165\u529B\u306B\u3064\u306A\u3050 (\u914D\u7DDA\u304C\u300C\u5F85\u3061\u300D\u306E\u8272\u3067\u6B8B\u308A\u3001\u4F55\u3092\u5F85\u3063\u3066\u3044\u308B\u304B\u304C\u56F3\u3067\u898B\u3048\u308B)\u3002\u9078\u629E\u80A2\u304B\u3089\u9078\u3093\u3067\u3082\u3089\u3048\u3070\u9032\u3081\u308B\u306A\u3089 `ask`\u3002\u305D\u308C\u4EE5\u5916\u306E\u3001\u8A08\u753B\u306E\u5916\u306B\u3042\u308B\u969C\u5BB3 (\u74B0\u5883\u304C\u52D5\u304B\u306A\u3044\u3001\u6A29\u9650\u3084\u30AD\u30FC\u304C\u7121\u3044\u3001\u5916\u90E8\u306E\u8FD4\u4E8B\u5F85\u3061\u3001\u539F\u56E0\u306E\u5206\u304B\u3089\u306A\u3044\u5931\u6557) \u3060\u3051\u3092 `npx boxglow blocked <block> --note "<\u56F0\u3063\u3066\u3044\u308B\u3053\u3068>"` \u3067\u8A18\u9332\u3059\u308B \u8A55\u4FA1\u3084\u691C\u67FB\u3067\u524D\u306E\u6210\u679C\u7269\u304C\u901A\u3089\u306A\u304B\u3063\u305F\u3068\u304D\u306F\u3001\u7DDA\u3067\u623B\u3055\u305A (\u5FAA\u74B0\u306B\u306A\u308B) `npx boxglow sendback <\u8A55\u4FA1\u306E\u7BB1> --to <\u4F5C\u308A\u76F4\u3059\u7BB1> --note "<\u7406\u7531>"` \u3067\u5DEE\u3057\u623B\u3059 (\u305D\u306E\u7BB1\u306F In Progress \u306B\u623B\u308A\u3001\u6210\u679C\u7269\u306F\u5DEE\u3057\u623B\u3057\u6E08\u307F\u3068\u3057\u3066\u6B8B\u308B\u3002\u7406\u7531\u306F context \u306B\u51FA\u308B)\u3002\n8. **\u6210\u679C\u7269\u306E\u78BA\u8A8D**: \u30D5\u30A1\u30A4\u30EB\u3092\u79FB\u52D5\u30FB\u6539\u540D\u3057\u305F\u3089 `npx boxglow check` \u3092\u5B9F\u884C\u3059\u308B (\u79FB\u52D5\u3092\u691C\u51FA\u3057\u3066\u30D1\u30B9\u3092\u4ED8\u3051\u66FF\u3048\u308B\u3002\u898B\u3064\u304B\u3089\u306A\u3051\u308C\u3070\u5370\u304C\u4ED8\u304F)\n9. **\u9032\u6357\u3084\u6C17\u3065\u304D\u3092\u6B8B\u3059**: `npx boxglow log <block> "<\u672C\u6587>"` \u3067\u3001\u65E5\u4ED8\u3068\u66F8\u304D\u624B\u3064\u304D\u306E\u4F5C\u696D\u8A18\u9332\u3092\u30DC\u30C3\u30AF\u30B9\u306B\u8DB3\u3059 (Markdown \u53EF\u3002\u4EBA\u306F\u753B\u9762\u306E\u300C\u8A18\u9332\u300D\u30BF\u30D6\u3067\u540C\u3058\u3082\u306E\u3092\u898B\u3066\u66F8\u304F)\u3002\u5F15\u304D\u7D99\u304E\u30E1\u30E2 (checkpoint) \u306F 1 \u3064\u3092\u4E0A\u66F8\u304D\u3059\u308B\u304C\u3001\u8A18\u9332\u306F\u7A4D\u307F\u4E0A\u304C\u308B\n10. **\u4E2D\u65AD\u30FB\u5F15\u304D\u7D99\u304E\u306E\u524D\u306B**: \u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u7D42\u308F\u308A\u30FB\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306E\u5727\u7E2E\u30FB\u4ED6\u306E AI \u3084\u4EBA\u3078\u306E\u5F15\u304D\u7D99\u304E\u306E\u524D\u306B\u3001`npx boxglow checkpoint <block> --note "\u5206\u304B\u3063\u305F\u3053\u3068; \u6B21\u306B\u3059\u308B\u3053\u3068; \u672A\u89E3\u6C7A\u306E\u3053\u3068"` \u3067\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u6B8B\u3059 (guard \u304C\u6709\u52B9\u306A\u3089 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3092\u4ED8\u3051\u308B)\u3002\u4F1A\u8A71\u306E\u5C65\u6B74\u304C\u6D88\u3048\u3066\u3082\u8A08\u753B\u306E\u4E2D\u306B\u6B8B\u308A\u3001\u6B21\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u304C `resume` \u3068 `context` \u3067\u8AAD\u3080\n11. **\u5831\u544A**: \u4F5C\u696D\u306E\u6700\u5F8C\u306B `npx boxglow status --brief` \u306E\u5185\u5BB9\u3092\u8981\u7D04\u3057\u3066\u5831\u544A\u3059\u308B\n\n### \u69CB\u9020\u306E\u7D04\u675F\n\n- **\u307E\u3060\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u306F\u5206\u5C90\u3067\u8868\u3059**: \u8A08\u753B\u3092\u4F5C\u308B\u6642\u70B9\u3067\u3001\u5224\u65AD\u6B21\u7B2C\u3067\u5F8C\u306E\u4F5C\u696D (\u9053) \u304C\u5909\u308F\u308B\u3068\u304D\u306F `npx boxglow branch "<\u984C\u540D>" --options "A|B" --question "<\u554F\u3044>" --context "<\u5224\u65AD\u6750\u6599>"` \u3067\u5206\u5C90\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u4F5C\u308B\u3002\u9078\u629E\u80A2\u3054\u3068\u306B\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u308B\u306E\u3067\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u521D\u306E\u30DC\u30C3\u30AF\u30B9\u3078 `connect` \u3059\u308B\u3002\u9053\u304C\u5F8C\u3067 1 \u3064\u306B\u307E\u3068\u307E\u308B\u3068\u3053\u308D\u306B\u306F `npx boxglow join --title "<\u984C\u540D>"` \u3067\u5408\u6D41\u306E\u90E8\u54C1\u3092\u7F6E\u304D\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u5F8C\u306E\u51FA\u529B\u3092\u3053\u306E\u90E8\u54C1\u3078 `connect` \u3057\u3001\u90E8\u54C1\u306E\u51FA\u529B\u3092\u5148\u306E\u7BB1\u3078\u3064\u306A\u3050 (\u3069\u308C\u304B 1 \u3064\u306E\u9053\u304C\u5C4A\u3051\u3070\u5148\u3078\u9032\u3080)\u3002\u4EBA\u304C\u7B54\u3048\u308B\u3068\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u9053\u306E\u5148\u306F\u300C\u898B\u9001\u308A\u300D\u306B\u306A\u308A\u3001\u9032\u6357\u3068\u6B21\u306E\u5019\u88DC\u304B\u3089\u5916\u308C\u308B\u3002\u3059\u3067\u306B\u4F5C\u3063\u305F\u30DC\u30C3\u30AF\u30B9\u304C\u5B9F\u306F\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u3060\u3068\u5206\u304B\u3063\u305F\u3089\u3001`npx boxglow branch --box <block> --options "A|B" --question "<\u554F\u3044>"` \u3067\u5206\u5C90\u306B\u5909\u3048\u308B (\u4ECA\u306E\u51FA\u529B\u304C 1 \u3064\u76EE\u306E\u9078\u629E\u80A2\u306E\u9053\u306B\u306A\u308A\u3001\u7DDA\u306F\u6B8B\u308B)\u3002\u7B54\u3048\u304C\u51FA\u308B\u524D\u306E\u9053\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u300C\u5206\u5C90\u5F85\u3061\u300D\u3067\u3001\u7740\u624B\u3059\u308B\u3068\u8B66\u544A\u3055\u308C\u308B (\u5148\u306B\u4E0B\u8ABF\u3079\u3059\u308B\u306A\u3069\u7406\u7531\u304C\u3042\u308C\u3070 `--reason` \u3067\u8A18\u9332\u3059\u308B)\n- \u6700\u4E0A\u4F4D\u306B\u306F\u300C\u5165\u529B\u30CE\u30FC\u30C9\u300D\u300C\u6700\u7D42\u6210\u679C\u7269\u30CE\u30FC\u30C9\u300D\u3068\u300C\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u300D\u3060\u3051\u304C\u3042\u308B\u3002\u30BF\u30B9\u30AF\u306F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u4E2D\u306B\u7F6E\u304F (`add` \u306E\u65E2\u5B9A\u306E\u89AA\u306F\u6700\u521D\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9)\n- \u968E\u5C64\u306E\u6DF1\u3055\u306B\u5236\u9650\u306F\u306A\u3044\u3002`split` \u306F\u4F55\u6BB5\u3067\u3082\u4F7F\u3048\u308B\n- \u5225\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3067\u3082\u4F7F\u3048\u305D\u3046\u306A\u30DC\u30C3\u30AF\u30B9 (\u4F8B: \u5165\u529B\u753B\u50CF\u306E\u30E2\u30CE\u30AF\u30ED\u5316) \u306F `npx boxglow export-block <block> --out <\u540D\u524D>.boxglow-block.json` \u3067\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306B\u3057\u3001\n  `npx boxglow import-block <path> --parent <block>` \u3067\u633F\u5165\u3059\u308B\u3002\u30EA\u30DD\u30B8\u30C8\u30EA\u306E `boxglow-blocks/` \u306B\u7F6E\u3044\u3066\u5171\u6709\u3057\u3066\u3088\u3044\n\n\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u304C\u591A\u3044\u3068\u304D\u306F `npx boxglow group "<\u30B0\u30EB\u30FC\u30D7\u540D>"` \u3067\u30B0\u30EB\u30FC\u30D7\u3092\u4F5C\u308A\u3001`npx boxglow group-set <\u5165\u529B\u540D> <\u30B0\u30EB\u30FC\u30D7\u540D>` \u3067\u5206\u3051\u308B (\u4F8B: PCIe \u4ED5\u69D8\u66F8 / DDR \u4ED5\u69D8\u66F8)\u3002\n\n### split \u306E JSON \u5F62\u5F0F\n\n```json\n{\n  "blocks": [\n    { "title": "\u5BFE\u8C61\u7B87\u6240\u3092\u7279\u5B9A\u3059\u308B", "inputs": ["\u518D\u73FE\u624B\u9806"], "outputs": ["\u8ABF\u67FB\u30E1\u30E2"],\n      "expect": "note:\u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u3068\u51E6\u7406\u3001\u6839\u62E0\u3001\u5909\u66F4\u5019\u88DC\u3001\u78BA\u8A8D\u65B9\u6CD5\u3001\u672A\u6C7A\u4E8B\u9805", "acceptance": "\u5909\u66F4\u3059\u308B\u30D5\u30A1\u30A4\u30EB\u3068\u51E6\u7406\u304C\u6C7A\u307E\u308A\u3001\u5F8C\u7D9A\u306E\u30DC\u30C3\u30AF\u30B9\u306B expect \u3068 acceptance \u3092\u8A2D\u5B9A\u3067\u304D\u308B\u3002\u307E\u305F\u306F\u3001\u8A2D\u5B9A\u3067\u304D\u306A\u3044\u7406\u7531\u3068\u5FC5\u8981\u306A\u5224\u65AD\u304C\u5206\u304B\u308B",\n      "goal": "\u518D\u73FE\u3057\u3066\u7D4C\u8DEF\u3092\u8FFD\u3046\u3002\u88FD\u54C1\u30B3\u30FC\u30C9\u306E\u4FEE\u6B63\u306F\u4ECA\u56DE\u306E\u7BC4\u56F2\u5916" },\n    { "title": "\u4FDD\u5B58\u306E\u518D\u8A66\u884C\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3092\u53D6\u308A\u76F4\u3059", "inputs": ["\u8ABF\u67FB\u30E1\u30E2"], "outputs": ["\u4FEE\u6B63"],\n      "expect": "file:src/sync/state.ts", "acceptance": "\u4FDD\u5B58\u3092\u4E00\u5EA6\u5931\u6557\u3055\u305B\u3001\u518D\u4FDD\u5B58\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3068\u64CD\u4F5C\u304C\u623B\u308B (\u30C6\u30B9\u30C8\u3067\u78BA\u8A8D)" },\n    { "title": "\u30EA\u30EA\u30FC\u30B9\u30CE\u30FC\u30C8\u3092\u66F8\u304F", "inputs": ["\u4FEE\u6B63"], "outputs": ["\u30CE\u30FC\u30C8"] }\n  ],\n  "connections": [\n    { "from": "parent.\u518D\u73FE\u624B\u9806", "to": "\u5BFE\u8C61\u7B87\u6240\u3092\u7279\u5B9A\u3059\u308B.\u518D\u73FE\u624B\u9806" },\n    { "from": "\u5BFE\u8C61\u7B87\u6240\u3092\u7279\u5B9A\u3059\u308B.\u8ABF\u67FB\u30E1\u30E2", "to": "\u4FDD\u5B58\u306E\u518D\u8A66\u884C\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3092\u53D6\u308A\u76F4\u3059" },\n    { "from": "\u4FDD\u5B58\u306E\u518D\u8A66\u884C\u5F8C\u306B\u540C\u671F\u72B6\u614B\u3092\u53D6\u308A\u76F4\u3059.\u4FEE\u6B63", "to": "\u30EA\u30EA\u30FC\u30B9\u30CE\u30FC\u30C8\u3092\u66F8\u304F" },\n    { "from": "\u30EA\u30EA\u30FC\u30B9\u30CE\u30FC\u30C8\u3092\u66F8\u304F.\u30CE\u30FC\u30C8", "to": "parent.\u51FA\u529B" }\n  ]\n}\n```\n\n`expect` (\u4E88\u5B9A\u6210\u679C\u7269: `"kind:hint"` \u307E\u305F\u306F `{ "kind", "hint" }`)\u3001`acceptance` (\u5B8C\u4E86\u6761\u4EF6)\u3001`goal` (\u4ECA\u56DE\u884C\u3046\u51E6\u7406) \u306F\u4ECA\u56DE\u7740\u624B\u3059\u308B\u5B50\u3060\u3051\u306B\u66F8\u304F\u3002\n3 \u3064\u76EE\u306E\u5B50\u306E\u3088\u3046\u306B\u984C\u540D\u3068\u51FA\u529B\u3060\u3051\u306E\u5B50\u306F\u300C\u8981\u5177\u4F53\u5316\u300D\u3068\u3057\u3066\u6B8B\u308A\u3001\u7740\u624B\u3059\u308B\u756A\u306B\u306A\u3063\u3066\u304B\u3089 `port --expect` / `scope --acceptance` \u3067\u6C7A\u3081\u308B\u3002\n\u89AA\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B (\u5B50\u306E\u6210\u679C\u3092\u7D71\u5408\u3059\u308B\u306A\u3069) \u306F `"parentMakes": ["\u51FA\u529B\u540D"]` \u3067\u5370\u3092\u4ED8\u3051\u308B (\u5B50\u306E\u7D50\u7DDA\u3068\u91CD\u306A\u308B\u3068\u300C\u62C5\u5F53\u304C\u91CD\u8907\u300D\u3068\u6848\u5185\u3055\u308C\u308B)\u3002\n`"splitBy": "\u5DE5\u7A0B"` \u3067\u76F4\u4E0B\u306E\u5B50\u306E\u5206\u3051\u65B9\u3092\u4E00\u8A9E\u3067\u6B8B\u3059 (\u5DE5\u7A0B / \u6210\u679C\u7269 / \u6A5F\u80FD \u306A\u3069\u3002`set <block> --split-by` \u3067\u3082\u66F8\u3051\u308B)\u3002\u540C\u3058\u968E\u5C64\u306E\u5B50\u306F\u540C\u3058\u5206\u3051\u65B9\u30FB\u540C\u3058\u5177\u4F53\u5EA6\u306B\u305D\u308D\u3048\u308B\u3002\n`split` \u304C\u4FDD\u5B58\u3057\u306A\u3044\u306E\u306F\u58CA\u308C\u305F\u69CB\u9020 (\u7D50\u7DDA\u5148\u304C\u7121\u3044\u3001\u5FAA\u74B0\u3001\u5F62\u306E\u9055\u3046 expect) \u3060\u3051\u3002\u5B50\u304C 1 \u500B\u3001\u89AA\u306E\u51FA\u529B\u3092\u4F5C\u308B\u5B50\u304C\u307E\u3060\u7121\u3044\u3001\u3068\u3044\u3063\u305F\u9014\u4E2D\u306E\u5206\u89E3\u306F\u4FDD\u5B58\u3055\u308C\u3001\u4E0D\u8DB3\u3068\u3057\u3066\u8868\u793A\u3055\u308C\u308B\u3002\n\u5206\u89E3\u306E\u5F8C\u3068\u7740\u624B\u306E\u524D\u306B `npx boxglow lint <block>` \u3092\u8AAD\u3080\u3002\u300C\u5FC5\u305A\u76F4\u3059\u300D(\u89AA\u51FA\u529B\u306E\u62C5\u5F53\u306E\u672A\u5B9A\u30FB\u91CD\u8907\u3001\u540C\u3058\u5206\u5C90\u306E\u6392\u4ED6\u306E\u9053\u306E\u4E21\u65B9\u3092\u5FC5\u9808\u306B\u3057\u3066\u3044\u308B\u3001\u4F5C\u696D\u4E2D\u306A\u306E\u306B\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6\u304C\u7121\u3044\u3001\u691C\u67FB\u306E\u5BFE\u8C61\u305D\u306E\u3082\u306E\u306E\u6B20\u843D) \u306F\u76F4\u3057\u3066\u304B\u3089\u9032\u3080\u3002\n\u300C\u7740\u624B\u306E\u524D\u306B\u57CB\u3081\u308B\u300D(\u307E\u3060\u59CB\u3081\u3066\u3044\u306A\u3044\u30DC\u30C3\u30AF\u30B9\u306E\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6) \u306F\u3001\u305D\u306E\u5B50\u306E\u7740\u624B\u306E\u756A\u3067\u57CB\u3081\u308C\u3070\u3088\u3044 (\u5148\u306E\u4ED5\u4E8B\u306E\u5206\u3092\u4ECA\u3001\u5F62\u3060\u3051\u66F8\u304B\u306A\u3044)\u3002\n\u300C\u898B\u76F4\u3057\u5019\u88DC\u300D(\u5B50\u304C 1 \u500B\u3001\u3069\u3053\u306B\u3082\u3064\u306A\u304C\u3089\u306A\u3044\u51FA\u529B\u3001\u5F62\u3060\u3051\u306E\u8A18\u5165\u3001\u9053\u306E\u5148\u304C\u7121\u3044\u5206\u5C90\u3001\u5165\u529B 1 \u672C\u306E\u5408\u6D41\u3001\u5144\u5F1F\u306E\u540C\u3058\u4E88\u5B9A\u6210\u679C\u7269) \u306F\u5185\u5BB9\u3092\u898B\u3066\u5224\u65AD\u3059\u308B (\u6A5F\u68B0\u306F\u62D2\u5426\u3057\u306A\u3044)\u3002`context` \u306B\u3082\u4EF6\u6570\u3068\u4E0A\u4F4D 3 \u4EF6\u304C\u51FA\u308B\u3002\n\n**\u5185\u5BB9\u306E\u30EC\u30D3\u30E5\u30FC (\u610F\u5473\u306F\u6A5F\u68B0\u3067\u306F\u5224\u5B9A\u3067\u304D\u306A\u3044\u306E\u3067\u3001AI \u304B\u4EBA\u304C\u6750\u6599\u3092\u8AAD\u3093\u3067\u8A55\u4FA1\u3057\u3001\u6839\u62E0\u3092\u6B8B\u3059)**\n- \u5206\u89E3\u3057\u305F\u5F8C: `npx boxglow review-split <\u89AA>` \u3067\u6750\u6599 (\u89AA\u306E\u76EE\u7684\u30FB\u5236\u7D04\u30FB\u5B8C\u4E86\u6761\u4EF6\u30FB\u5165\u51FA\u529B\u3001\u5B50\u306E\u5BFE\u8C61\u30FB\u5165\u51FA\u529B\u30FB\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u5B8C\u4E86\u6761\u4EF6\u3001\u7D50\u7DDA) \u3068\u30C1\u30A7\u30C3\u30AF\u9805\u76EE\u3092\u8AAD\u307F\u3001\u8A55\u4FA1\u3057\u305F\u3089 `npx boxglow split-ok <\u89AA> --note "<\u6839\u62E0: \u4F55\u3092\u78BA\u8A8D\u3057\u305F\u304B>"` \u3067\u8A18\u9332\u3059\u308B\u3002\n- \u7740\u624B\u3059\u308B\u524D: `npx boxglow review-box <block>` \u3067\u6750\u6599 (\u5BFE\u8C61\u30FB\u51E6\u7406\u30FB\u4E88\u5B9A\u6210\u679C\u7269\u30FB\u78BA\u8A8D\u65B9\u6CD5\u3001\u5165\u529B\u306E\u4F9B\u7D66\u5143\u3001\u4E0A\u6D41\u306E\u5206\u5C90\u306E\u7B54\u3048) \u3092\u8AAD\u307F\u3001`npx boxglow box-ok <block> --note "<\u6839\u62E0>"` \u3067\u8A18\u9332\u3059\u308B\u3002\n- \u8A18\u9332\u306F\u300C\u8A55\u4FA1\u3057\u305F\u3068\u7533\u544A\u3057\u6839\u62E0\u3092\u6B8B\u3057\u305F\u8A18\u9332\u300D\u3067\u3042\u308A\u3001\u59A5\u5F53\u6027\u306E\u8A3C\u660E\u3067\u306F\u306A\u3044\u3002\u6750\u6599\u304C\u5909\u308F\u308B\u3068 `context` \u306E `reviews` \u304C `stale` (\u4F55\u304C\u5909\u308F\u3063\u305F\u304B\u3068\u3001\u4F55\u3092\u78BA\u8A8D\u3059\u308C\u3070\u3088\u3044\u304B\u306E\u6848\u5185\u3064\u304D) \u306B\u306A\u308B\u3002`stale` \u306F\u300C\u5206\u89E3\u304C\u4E0D\u6B63\u300D\u3067\u306F\u306A\u304F\u300C\u524D\u56DE\u306E\u78BA\u8A8D\u5F8C\u306B\u6750\u6599\u304C\u5909\u308F\u3063\u305F\u300D\u3068\u3044\u3046\u610F\u5473\u3002\u4F4D\u7F6E\u3084\u914D\u8272\u3001\u9032\u6357\u3001\u62C5\u5F53\u306E\u5909\u66F4\u3067\u306F\u53E4\u304F\u306A\u3089\u306A\u3044\u3002\u5206\u89E3\u306E\u8A18\u9332\u306F\u5206\u5C90\u306E\u7B54\u3048\u3067\u306F\u53E4\u304F\u306A\u3089\u305A\u3001\u7740\u624B\u6E96\u5099\u306E\u8A18\u9332\u306F\u7B54\u3048\u304C\u5909\u308F\u308B\u3068\u53E4\u304F\u306A\u308B\u3002\n- \u5148\u306E\u5B50\u3092\u7740\u624B\u306E\u756A\u3067\u5177\u4F53\u5316\u3059\u308B\u3068\u3001\u89AA\u306E\u5206\u89E3\u306E\u8A18\u9332\u306F\u5FC5\u305A `stale` \u306B\u306A\u308B (\u5B50\u306E expect / acceptance \u3082\u6750\u6599\u306E\u305F\u3081)\u3002\u305D\u306E\u5B50\u306E expect\u30FBscope \u3092\u4E00\u901A\u308A\u66F8\u304D\u7D42\u3048\u3066\u304B\u3089\u3001\u5909\u308F\u3063\u305F\u5B50\u3068\u3001\u89AA\u306E\u5B8C\u4E86\u6761\u4EF6\u30FB\u5BFE\u8C61\u5916\u7BC4\u56F2\u30FB\u5144\u5F1F\u3068\u306E\u5206\u62C5\u3078\u306E\u5F71\u97FF\u3060\u3051\u3092\u78BA\u8A8D\u3057\u3001\u6574\u5408\u3059\u308C\u3070 `split-ok <\u89AA> --note "B181 \u306E\u5177\u4F53\u5316\u3092\u78BA\u8A8D\u3002\u89AA\u306E\u5BFE\u8C61\u5916\u7BC4\u56F2\u306B\u5165\u3089\u305A\u3001B182 \u3068\u306E\u5206\u62C5\u306F\u91CD\u8907\u3057\u306A\u3044"` \u306E\u3088\u3046\u306B\u66F4\u65B0\u3059\u308B\u3002port \u3084 scope \u306E\u64CD\u4F5C\u3054\u3068\u306B\u518D\u78BA\u8A8D\u306F\u3057\u306A\u3044\u3002\u8907\u6570\u306E\u5B50\u3092\u540C\u6642\u306B\u5177\u4F53\u5316\u3057\u305F\u3089\u3001\u307E\u3068\u3081\u3066\u78BA\u8A8D\u3057\u3066\u3088\u3044\u3002\n- \u7740\u624B\u306E\u6761\u4EF6\u306B\u306F\u3057\u3066\u3044\u306A\u3044 (\u65E2\u5B9A\u3067\u3082 reject \u306E\u8A08\u753B\u3067\u3082)\u3002`start` \u3092\u6B62\u3081\u308B\u306E\u306F\u8981\u5177\u4F53\u5316\u3068\u5165\u529B\u5F85\u3061\u3060\u3051\u3002\n\n**\u5206\u5C90\u30FB\u5408\u6D41\u3092 AI \u304C\u4F7F\u3046**\n- `ask` \u306B\u9078\u629E\u80A2\u3092\u4ED8\u3051\u305F\u3068\u304D\u3001\u7B54\u3048\u3067\u5F8C\u306E\u4F5C\u696D\u304C\u5206\u304B\u308C\u308B\u306A\u3089 `--branch` \u3092\u4ED8\u3051\u308B: \u305D\u306E\u30DC\u30C3\u30AF\u30B9\u304C\u5206\u5C90\u306B\u306A\u308A\u3001\u9078\u629E\u80A2\u3054\u3068\u306E\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u308B\u3002\u5404\u9053\u306E\u6700\u521D\u306E\u30DC\u30C3\u30AF\u30B9\u3078 `connect` \u3057\u3001\u9053\u304C\u307E\u3068\u307E\u308B\u3068\u3053\u308D\u306B `join` \u3092\u7F6E\u304F\u3002\n- `split` \u306E JSON \u3067\u3082\u4F5C\u308C\u308B: \u5B50\u306B `"branch": { "question": "...", "options": ["A", "B"] }` \u3067\u5206\u5C90\u306E\u30DC\u30C3\u30AF\u30B9 (\u51FA\u529B\u306F\u9078\u629E\u80A2\u306E\u540D\u524D)\u3001`"join": true` \u3067\u5408\u6D41\u306E\u90E8\u54C1\u3002\u4F8B:\n  `{ "blocks": [{ "title": "\u8A8D\u8A3C\u65B9\u5F0F\u3092\u6C7A\u3081\u308B", "branch": { "question": "\u3069\u308C?", "options": ["\u30E1\u30FC\u30EB", "OAuth"] } }, { "title": "\u30E1\u30FC\u30EB\u3067\u5B9F\u88C5", "outputs": ["\u8A8D\u8A3C"] }, { "title": "OAuth \u3067\u5B9F\u88C5", "outputs": ["\u8A8D\u8A3C"] }, { "title": "\u5408\u6D41", "join": true }], "connections": [{ "from": "\u8A8D\u8A3C\u65B9\u5F0F\u3092\u6C7A\u3081\u308B.\u30E1\u30FC\u30EB", "to": "\u30E1\u30FC\u30EB\u3067\u5B9F\u88C5" }, { "from": "\u8A8D\u8A3C\u65B9\u5F0F\u3092\u6C7A\u3081\u308B.OAuth", "to": "OAuth \u3067\u5B9F\u88C5" }, { "from": "\u30E1\u30FC\u30EB\u3067\u5B9F\u88C5.\u8A8D\u8A3C", "to": "\u5408\u6D41" }, { "from": "OAuth \u3067\u5B9F\u88C5.\u8A8D\u8A3C", "to": "\u5408\u6D41" }, { "from": "\u5408\u6D41.\u5408\u6D41", "to": "parent.\u8A8D\u8A3C" }] }`\n- `lint` \u306F\u3001\u540C\u3058\u5206\u5C90\u306E\u6392\u4ED6\u306E\u9053\u306E\u4E21\u65B9\u3092 1 \u3064\u306E\u30DC\u30C3\u30AF\u30B9\u304C\u5FC5\u9808\u306B\u3057\u3066\u3044\u308B (\u4E21\u65B9\u304C\u5C4A\u304F\u3053\u3068\u306F\u306A\u3044) \u3092\u300C\u5FC5\u305A\u76F4\u3059\u300D\u3001\u9053\u306E\u5148\u304C\u7121\u3044\u30FB\u5408\u6D41\u306E\u5165\u529B\u304C 1 \u672C\u3092\u300C\u898B\u76F4\u3057\u5019\u88DC\u300D\u3068\u3057\u3066\u51FA\u3059\u3002\n`parent.<\u540D\u524D>` \u306F\u5206\u89E3\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u81EA\u8EAB\u306E\u5165\u529B / \u51FA\u529B\u3002`<block>` \u306F\u77ED\u3044 ID (B12 \u306A\u3069\u3002status \u306B\u51FA\u308B) \u304B\u984C\u540D\u3002\n\u51FA\u529B\u306F\u4F5C\u308B\u7269\u3054\u3068\u306B 1 \u672C (1 \u3064\u306E\u4F5C\u696D\u3067\u8907\u6570\u306E\u7269\u304C\u3067\u304D\u308B\u306A\u3089 outputs \u306B\u5168\u90E8\u66F8\u304F\u30022 \u672C\u76EE\u4EE5\u964D\u306E expect \u306F `port <block> --expect "<\u51FA\u529B\u540D>=<kind>:<hint>"`)\u3002\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306F\u540C\u3058\u540D\u524D\u306B\u306A\u308B (\u3069\u3061\u3089\u5074\u3067\u5909\u3048\u3066\u3082\u3001\u3064\u306A\u304C\u308B\u5148\u3082\u5909\u308F\u308B)\u3002\u984C\u540D\u306F\u300C\u4F55\u3092\u4F5C\u308B\u304B\u300D\u304C\u5206\u304B\u308B\u77ED\u3044\u8A00\u8449\u306B\u3059\u308B\u3002\n\u671F\u65E5\u3084\u6642\u9593\u306F `npx boxglow set <block> --due 2026-10-15 --start 2026-10-01 --estimate 8 --hours 3.5` \u3067\u8A18\u9332\u3059\u308B\u3002\n\u30DC\u30C3\u30AF\u30B9\u306B\u306F\u4ED5\u4E8B\u306E\u7A2E\u985E (\u30AB\u30C6\u30B4\u30EA) \u3092\u4ED8\u3051\u308B: `--category design` (\u8A2D\u8A08) / build (\u5B9F\u88C5) / verify (\u691C\u8A3C) / evaluate (\u8A55\u4FA1) / study (\u691C\u8A0E) / research (\u8ABF\u67FB) / ui (\u30C7\u30B6\u30A4\u30F3) / improve (\u6539\u5584) / fix (\u8AB2\u984C\u89E3\u6C7A) / docs (\u6587\u66F8) / ops (\u904B\u7528) / other (\u305D\u306E\u4ED6: \u8FF7\u3063\u305F\u3068\u304D)\u3002add \u306E\u3068\u304D\u306B\u4ED8\u3051\u3001\u5909\u3048\u308B\u306A\u3089 `npx boxglow set <block> --category verify`\u3002\n\u7D50\u7DDA\u306E\u53D7\u3051\u5074\u306F\u984C\u540D\u3060\u3051\u3067\u3088\u3044 (`npx boxglow connect "A.\u8A2D\u8A08\u66F8" "B"` \u3067 B \u306B\u5165\u529B\u300C\u8A2D\u8A08\u66F8\u300D\u304C\u4F5C\u3089\u308C\u3066\u3064\u306A\u304C\u308B\u3002\u968E\u5C64\u304C\u9055\u3063\u3066\u3082\u9014\u4E2D\u306E\u7BB1\u306B\u5165\u51FA\u529B\u3092\u4F5C\u3063\u3066\u901A\u308B\u3002split \u306E connections \u3082 `to: "B"` \u3067\u3088\u3044)\u3002\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306F\u540C\u3058\u540D\u524D\u306B\u306A\u308B (\u3064\u306A\u3044\u3060\u6642\u70B9\u3067\u305D\u308D\u3044\u3001\u3069\u3061\u3089\u5074\u3067\u540D\u524D\u3092\u5909\u3048\u3066\u3082\u3001\u3064\u306A\u304C\u308B\u5148\u304C\u4E00\u7DD2\u306B\u5909\u308F\u308B)\u3002\u65E2\u5B58\u306E\u30DC\u30C3\u30AF\u30B9\u306B\u5165\u51FA\u529B\u3092\u8DB3\u3059 / \u540D\u524D\u3092\u5909\u3048\u308B\u306E\u306F `npx boxglow port <block> --in <\u540D\u524D> --out <\u540D\u524D> --remove <\u540D\u524D> --rename <\u65E7>=<\u65B0>` (\u5165\u529B\u3092\u6D88\u3059\u3068\u3001\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306F `port inputs`\u3002\u9593\u9055\u3048\u305F\u554F\u3044\u306F `npx boxglow unask <block>` \u3067\u53D6\u308A\u4E0B\u3052\u308B) (`project` = \u6700\u521D\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u3002\u6700\u7D42\u6210\u679C\u7269\u306E\u540D\u524D\u3082\u3053\u308C\u3067\u5909\u3048\u308B)\u3002\u7DDA\u3092\u5916\u3059\u306E\u306F `npx boxglow disconnect <\u984C\u540D.\u51FA\u529B\u540D> <\u984C\u540D.\u5165\u529B\u540D>`\u3001\u30DC\u30C3\u30AF\u30B9\u305D\u306E\u3082\u306E\u3092\u6D88\u3059\u306E\u306F `npx boxglow remove <block>` (\u4E2D\u306B\u30DC\u30C3\u30AF\u30B9\u304C\u3042\u308C\u3070 `--force`)\u3002MCP \u30C4\u30FC\u30EB (`boxglow_status` / `boxglow_start` / `boxglow_done` / `boxglow_ask` \u306A\u3069\u3002\u5229\u7528\u3059\u308B\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306B\u767B\u9332\u6E08\u307F\u306A\u3089\u4F7F\u3048\u308B\u3002`.mcp.json` \u306F Claude Code \u5411\u3051\u3067\u3001Codex \u306F\u5225\u9014\u767B\u9332\u3059\u308B) \u306F\u540C\u3058\u30B3\u30DE\u30F3\u30C9\u306E\u5225\u306E\u5165\u53E3\u3067\u3001\u3069\u3061\u3089\u3067\u66F8\u3044\u3066\u3082\u540C\u3058\u30D5\u30A1\u30A4\u30EB\u304C\u66F4\u65B0\u3055\u308C\u308B\u3002\u8A08\u753B\u306E\u6587\u66F8\u306F `npx boxglow export --out docs/ROADMAP.md`\u3002\n**\u5168\u4F53\u306B\u52B9\u304F\u6C7A\u5B9A\u306F\u65B9\u91DD\u306B\u3059\u308B**: \u6280\u8853\u9078\u5B9A\u30FB\u4F7F\u3046\u30A8\u30F3\u30B8\u30F3\u30FB\u753B\u98A8\u306E\u6C7A\u307E\u308A\u306A\u3069\u3001\u591A\u304F\u306E\u7BB1\u306B\u52B9\u304F\u6C7A\u5B9A\u3092\u51FA\u529B\u306B\u6301\u3064\u7BB1\u306F\u3001\u305D\u306E\u51FA\u529B\u3092\u65B9\u91DD\u306B\u3059\u308B (`npx boxglow port <block> --policy "<\u51FA\u529B\u540D>"`\u3002\u7BC4\u56F2\u306F\u65E2\u5B9A\u3067\u540C\u3058\u89AA\u306E\u4E2D\u3001`--policy-scope all` \u3067\u8A08\u753B\u5168\u4F53\u3001`--advisory` \u3067\u53C2\u8003)\u3002\u7DDA\u3092\u5F15\u304B\u305A\u306B\u7BC4\u56F2\u306E\u7BB1\u3059\u3079\u3066\u3078\u5C4A\u304D\u3001\u6C7A\u307E\u308B\u307E\u3067\u7BC4\u56F2\u306E\u672A\u7740\u624B\u306E\u7BB1\u306F\u300C\u65B9\u91DD\u5F85\u3061\u300D\u306B\u306A\u308B (\u9032\u3081\u3066\u3044\u308B\u7BB1\u306F\u6B62\u307E\u3089\u306A\u3044)\u3002`context` \u306E `policies` \u306B\u4E2D\u8EAB\u304C\u51FA\u308B\u306E\u3067\u3001\u4F5C\u696D\u306E\u524D\u306B\u8AAD\u3080\u3002\u95A2\u4FC2\u306A\u3044\u7BB1\u306F `--skip-policy "<\u7BB1>.<\u51FA\u529B\u540D>"` \u3067\u5916\u3059\u3002\u5B8C\u4E86\u5F8C\u306B\u65B9\u91DD\u304C\u5909\u308F\u308B\u3068 `policyChanged` \u306B\u51FA\u308B (\u78BA\u304B\u3081\u76F4\u3059)\u30021 \u672C\u305A\u3064\u7DDA\u3067\u3064\u306A\u304C\u306A\u3044\u3002\n\n\u65B0\u3057\u3044\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3067\u306F\u3001\u65B9\u91DD (README \u3084\u4F9D\u983C\u6587) \u304B\u3089\u6700\u4E0A\u4F4D\u306E\u5927\u9805\u76EE 3\u301C7 \u500B\u3092\u5148\u306B\u4F5C\u308A\u3001\u4EBA\u306B `ask` \u3067\u78BA\u8A8D\u3057\u3066\u304B\u3089\u3001\u7740\u624B\u3059\u308B\u5927\u9805\u76EE\u3060\u3051\u3092 `split` \u3067\u5206\u89E3\u3059\u308B (\u5148\u306E\u6BB5\u968E\u306F\u7C97\u3044\u307E\u307E)\u3002`ask` \u306E\u8CEA\u554F\u306F\u305D\u308C\u3060\u3051\u3067\u5224\u65AD\u3067\u304D\u308B\u3088\u3046\u306B\u66F8\u304D\u3001\u524D\u63D0\u30FB\u6BD4\u8F03\u30FB\u5F71\u97FF\u306F `--context` \u306B\u5165\u308C\u308B (\u300C\u3053\u308C\u3067\u3088\u3044\u3067\u3059\u304B\u300D\u306E\u3088\u3046\u306B\u5916\u3092\u6307\u3055\u306A\u3044)\u3002\u5019\u88DC\u304B\u3089 1 \u3064\u3092\u9078\u3076\u5834\u9762\u3067\u306F\u3001\u81EA\u5206\u3067\u6C7A\u3081\u308B\u3068\u304D\u3082 `ask ... --options "A|B|C"` \u3068 `answer --by <\u81EA\u5206>` \u3067\u8A18\u9332\u3057\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u5019\u88DC\u3092\u6B8B\u3059\u3002\u65B9\u91DD\u8EE2\u63DB\u306F `reopen <block> --note <\u7406\u7531>`\u3002\u3059\u3079\u3066 CLI \u3060\u3051\u3067\u6210\u7ACB\u3059\u308B (\u753B\u9762\u306F\u4EBA\u304C\u898B\u308B\u305F\u3081\u306E\u3082\u306E)\u3002\u4EBA\u304C\u3044\u306A\u3044\u904B\u7528\u306A\u3089\u3001AI \u304C `answer --by <\u81EA\u5206>` \u3067\u5224\u65AD\u3092\u8A18\u9332\u3057\u3066\u9032\u3081\u308B\u3002\n\u51FA\u529B\u306E\u540D\u524D\u306F\u300C\u5177\u4F53\u7684\u306A\u6210\u679C\u7269\u300D\u306B\u3059\u308B (\u4F8B: `\u8A2D\u8A08\u66F8 docs/design.md`\u3001`PR #12`\u3001`\u516C\u958B URL`\u3001`\u30C6\u30B9\u30C8\u7D50\u679C (vitest 53 \u4EF6)`)\u3002\u300C\u6A5F\u80FD\u4E00\u5F0F\u300D\u300C\u6240\u898B\u300D\u306E\u3088\u3046\u306A\u62BD\u8C61\u7684\u306A\u540D\u524D\u306F\u907F\u3051\u3001done \u306E\u3068\u304D\u306F\u5FC5\u305A --artifact \u3067\u30D5\u30A1\u30A4\u30EB\u30FBURL\u30FB\u30B3\u30DF\u30C3\u30C8\u3092\u4ED8\u3051\u308B\u3002\n\u3059\u3079\u3066\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u300C\u5165\u529B \u2192 \u51FA\u529B\u300D\u304C\u4F55\u304B\u306B\u3064\u306A\u304C\u3063\u3066\u3044\u308B\u3088\u3046\u306B\u3059\u308B (\u3064\u306A\u304C\u3063\u3066\u3044\u306A\u3044\u30DC\u30C3\u30AF\u30B9\u306F\u8A08\u753B\u306E\u7A74\u3002\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u30CE\u30FC\u30C9\u306F\u3001\u672A\u63A5\u7D9A\u306E\u5165\u529B\u304C\u81EA\u52D5\u3067\u4E0A\u304C\u308B)\u3002\n\u8907\u6570\u4EBA\u3067\u540C\u3058 boxglow.json \u3092\u7DE8\u96C6\u3059\u308B\u306A\u3089\u3001\u5404\u81EA\u306E clone \u3067\u4E00\u5EA6 `npx boxglow git-setup` \u3092\u5B9F\u884C\u3059\u308B (\u30DC\u30C3\u30AF\u30B9\u306E\u5358\u4F4D\u3067\u81EA\u52D5\u30DE\u30FC\u30B8\u3055\u308C\u3001\u5225\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5909\u66F4\u306F\u885D\u7A81\u3057\u306A\u3044)\u3002\n\u8907\u6570\u30EA\u30DD\u30B8\u30C8\u30EA\u3092 1 \u3064\u306E\u8A08\u753B\u3067\u7BA1\u7406\u3059\u308B\u3068\u304D\u306F\u3001boxglow.json \u3092\u4E0A\u306E\u30D5\u30A9\u30EB\u30C0\u306B\u7F6E\u304D\u3001\u5404\u30EA\u30DD\u30B8\u30C8\u30EA\u3067\u306F\u74B0\u5883\u5909\u6570 BOXGLOW_FILE \u306B\u305D\u306E\u5834\u6240\u3092\u5165\u308C\u308B (\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u30EA\u30DD\u30B8\u30C8\u30EA\u3054\u3068\u306B 1 \u3064\u3002`npx boxglow project "\u540D\u524D" --repo <\u30D1\u30B9>`)\u3002\n\u5165\u529B\u306F\u65E2\u5B9A\u3067\u5FC5\u9808\u3002\u7121\u304F\u3066\u3082\u7740\u624B\u3067\u304D\u308B\u5165\u529B\u306F `npx boxglow port <block> --optional <\u5165\u529B\u540D>` \u3067\u300C\u4EFB\u610F\u300D\u306B\u3059\u308B (\u623B\u3059\u306E\u306F `--required`)\u3002\u5165\u51FA\u529B\u306E\u8AAC\u660E\u306F `--describe "<\u540D\u524D>=<\u8AAC\u660E>"`\u3002status \u306E\u300C\u6B21\u306E\u5019\u88DC\u300D\u306F\u5FC5\u9808\u306E\u5165\u529B\u304C\u305D\u308D\u3063\u305F\u30DC\u30C3\u30AF\u30B9\u304B\u3089\u4E26\u3076 (\u300C\u7740\u624B\u3067\u304D\u308B\u300D/\u300C\u5FC5\u9808\u306E\u5165\u529B\u5F85\u3061\u300D\u304C\u4ED8\u304F)\u3002\u8A08\u753B\u306E\u6700\u4E0A\u4F4D\u306E\u5165\u529B (Inputs) \u306B\u8CC7\u6599 (\u4ED5\u69D8\u66F8\u30FB\u30B7\u30CA\u30EA\u30AA\u306A\u3069\u306E\u30D5\u30A1\u30A4\u30EB\u3084 URL) \u304C\u7121\u3044\u3068\u3001\u305D\u308C\u3092\u4F7F\u3046\u7BB1\u306F\u3059\u3079\u3066\u5165\u529B\u5F85\u3061\u306B\u306A\u308B\u3002\u8CC7\u6599\u304C\u624B\u5143\u306B\u3042\u308C\u3070\u3001\u4EBA\u306B\u983C\u307E\u305A\u306B `npx boxglow artifact inputs <\u30D1\u30B9\u304B URL> --input <\u5165\u529B\u540D>` (MCP \u306F `boxglow_artifact` \u306B block: "inputs") \u3067\u81EA\u5206\u3067\u4ED8\u3051\u308B\u3002\u9593\u9055\u3048\u3066\u4ED8\u3051\u305F\u6210\u679C\u7269\u30FB\u8CC7\u6599\u306F `npx boxglow artifact <block|inputs> --remove <\u984C\u540D\u304B\u30D1\u30B9>` \u3067\u5916\u3059\u3002\u6E08\u3093\u3060\u7BB1\u306B\u300C\u65B9\u91DD: \u78BA\u304B\u3081\u76F4\u3057\u300D\u304C\u4ED8\u3044\u305F\u3089\u3001\u4F5C\u696D\u304C\u65B9\u91DD\u306B\u5408\u3063\u3066\u3044\u308B\u304B\u3092\u78BA\u304B\u3081\u3001\u5408\u3063\u3066\u3044\u308C\u3070 `npx boxglow ack <block> --policy` \u3067\u5370\u3092\u6D88\u3059 (\u5408\u3063\u3066\u3044\u306A\u3051\u308C\u3070 reopen \u3057\u3066\u76F4\u3059)\u3002\n\u5165\u529B\u306E\u8AAC\u660E\u306F\u66F8\u304B\u306A\u3044 (\u3064\u306A\u304C\u3063\u305F\u51FA\u529B\u5074\u306E\u8AAC\u660E\u304C\u4F7F\u308F\u308C\u308B)\u3002\u51FA\u529B\u306E\u8AAC\u660E\u306B\u5F62\u5F0F\u30FB\u5236\u7D04\u3092\u66F8\u304F\u3002\n\n\n### \u81EA\u52D5\u3067\u52D5\u304F\u4ED5\u7D44\u307F (hooks)\n\n`setup-agent` \u306F Claude Code / Codex \u306E hooks \u306B `boxglow hook` \u3092\u767B\u9332\u3059\u308B\u3002\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u958B\u59CB\u30FB\u518D\u958B\u30FB\u5727\u7E2E\u306E\u5F8C\u306B\u306F\u8A08\u753B\u306E\u518D\u958B\u306E\u6982\u8981 (resume) \u304C\u81EA\u52D5\u3067\u6587\u8108\u306B\u5165\u308B\u3002\u5FDC\u7B54\u3092\u7D42\u3048\u308B\u3068\u304D\u3001\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067 start \u3057\u305F\u7BB1\u306B\u5F15\u304D\u7D99\u304E (done \u304B checkpoint) \u304C\u7121\u3051\u308C\u3070\u300C\u8A18\u9332\u3057\u3066\u304B\u3089\u7D42\u3048\u308B\u300D\u3088\u3046\u7D9A\u884C\u304C\u6307\u793A\u3055\u308C\u308B (log \u306F\u9032\u6357\u306E\u30E1\u30E2\u3067\u3001\u5F15\u304D\u7D99\u304E\u306E\u4EE3\u308F\u308A\u306B\u306A\u3089\u306A\u3044)\u3002boxglow.json \u3092 Edit / Write / apply_patch \u3067\u76F4\u63A5\u66F8\u304D\u63DB\u3048\u308B\u64CD\u4F5C\u306F\u6B62\u3081\u3089\u308C\u308B (CLI \u304B MCP \u3067\u66F4\u65B0\u3059\u308B)\u3002\u3053\u308C\u3089\u306F\u6307\u793A\u306E\u4EE3\u308F\u308A\u3067\u306F\u306A\u304F\u3001\u5FD8\u308C\u305F\u3068\u304D\u306E\u4FDD\u967A\u306A\u306E\u3067\u3001\u4E0A\u306E\u624B\u9806\u3069\u304A\u308A\u306B\u81EA\u5206\u3067\u8A18\u9332\u3059\u308B\u3002\n\n### \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3068\u5F15\u304D\u7D99\u304E\n\n\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u306F\u3001AI \u304C\u53E4\u3044\u6307\u793A\u306E\u307E\u307E\u4F5C\u696D\u3092\u9032\u3081\u308B\u306E\u3092\u9632\u3050\u4ED5\u7D44\u307F\u3002`setup-agent` \u304C\u6709\u52B9\u306B\u3059\u308B (\u305D\u308C\u4EE5\u5916\u306E\u8A08\u753B\u3067\u306F `npx boxglow guard on`)\u3002\n\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001AI \u306E `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` \u306B `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u304C\u8981\u308B\u3002\u4EBA\u306E\u64CD\u4F5C (`--actor human`) \u306B\u306F\u8981\u6C42\u3055\u308C\u306A\u3044\u3002\n\n```\nnpx boxglow context B12        # \u5224\u65AD (\u5F15\u304D\u53D6\u308A\u6E08\u307F\u306E\u56DE\u7B54\u3092\u542B\u3080)\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6\u30FB\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E contextToken \u304C\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\nnpx boxglow start B12 --note "<\u4F55\u3092\u3059\u308B\u304B>" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\nnpx boxglow ask B12 "<\u8CEA\u554F>" --options "A|B" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n#   \u2192 \u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C: \u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\nnpx boxglow done B12 --artifact "<\u540D\u524D>=<\u30D1\u30B9>" --context-token <\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n```\n\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u308B\u5834\u5408 (\u8AAD\u307F\u76F4\u3057\u304C\u8981\u308B)**: \u4EBA\u304C\u56DE\u7B54\u3057\u305F\u30FB\u56DE\u7B54\u3092\u76F4\u3057\u305F\u3001\u4EBA\u304C\u6307\u793A (\u984C\u540D\u30FB\u8AAC\u660E\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6) \u3092\u5909\u3048\u305F\u3001\u4ED6\u306E AI \u3084\u4EBA\u304C\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u66F4\u65B0\u3057\u305F\u3002\u89AA\u3084\u5165\u529B\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u3067\u8D77\u304D\u305F\u5834\u5408\u3082\u540C\u3058\u3002\u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F\u62D2\u5426\u3055\u308C\u308B\u306E\u3067\u3001`context` \u3092\u8AAD\u307F\u76F4\u3057\u3001\u5909\u308F\u3063\u305F\u5185\u5BB9\u3092\u4F5C\u696D\u306B\u53CD\u6620\u3057\u3066\u304B\u3089\u3084\u308A\u76F4\u3059\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u3089\u306A\u3044\u5834\u5408**: `start` / `blocked` / `review` / `leave` / `ack`\u3001\u9032\u6357\u30FB\u72B6\u614B\u30FB\u671F\u65E5\u30FB\u30AB\u30C6\u30B4\u30EA\u306E\u5909\u66F4\u3001`check` \u306B\u3088\u308B\u6210\u679C\u7269\u306E\u78BA\u8A8D\u3001\u753B\u9762\u3067\u306E\u914D\u7F6E\u306E\u5909\u66F4\u3002\u540C\u3058\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4F7F\u3044\u7D9A\u3051\u3089\u308C\u308B\n- **\u81EA\u5206\u3067\u66F4\u65B0\u3067\u304D\u308B\u5834\u5408**: \u81EA\u5206\u306E `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` \u306A\u3069\u3067\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5909\u308F\u3063\u305F\u3068\u304D\u306F\u3001\u305D\u306E\u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u308B\u3002\u81EA\u5206\u3067\u5909\u3048\u305F\u5185\u5BB9\u306F\u5206\u304B\u3063\u3066\u3044\u308B\u306E\u3067\u3001\u8AAD\u307F\u76F4\u3055\u305A\u306B\u6B21\u306E\u64CD\u4F5C\u3078\u4F7F\u3046\u3002`ask` / `decision` / `answer` / `reopen` \u306F\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u7121\u3057\u3067\u3082\u5B9F\u884C\u3067\u304D\u308B\u304C\u3001\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4ED8\u3051\u305F\u3068\u304D\u3060\u3051\n- **\u6700\u521D\u306F\u77ED\u3044\u5F62\u3067\u8AAD\u3080**: `npx boxglow context <block> --brief` \u306F\u3001\u5BFE\u8C61\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u60C5\u5831 (\u8AAC\u660E\u30FB\u7BC4\u56F2\u30FB\u5224\u65AD\u30FB\u5F15\u304D\u7D99\u304E\u30FB\u5165\u51FA\u529B\u30FB\u6210\u679C\u7269) \u306F\u5168\u90E8\u3001\u8A08\u753B\u5168\u4F53\u306E\u8AAC\u660E\u3001\u89AA\u3068\u5165\u529B\u5143\u306E\u984C\u540D\u30FB\u72B6\u614B\u30FB\u5224\u65AD (\u6750\u6599\u3068\u9078\u629E\u80A2\u3064\u304D\u3002\u524D\u306E\u56DE\u7B54\u306E\u5C65\u6B74\u306F\u7701\u304F)\u30FB\u5BFE\u8C61\u306B\u3064\u306A\u304C\u308B\u51FA\u529B\u3092\u51FA\u3059\u3002\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F `--brief` \u306A\u3057\u3068\u540C\u3058\u306A\u306E\u3067\u3001\u305D\u306E\u307E\u307E `--context-token` \u306B\u4F7F\u3048\u308B\u3002`target.missingInputs` (\u4E0D\u8DB3\u3057\u3066\u3044\u308B\u5FC5\u9808\u306E\u5165\u529B) \u3068 `target.inputs[].sources` (\u3069\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u3069\u306E\u51FA\u529B\u304B\u30FB\u6210\u679C\u7269\u306E\u53C2\u7167) \u3092\u5148\u306B\u898B\u308B\u3002`omitted` \u306B\u7701\u3044\u305F\u4EF6\u6570\u304C\u51FA\u308B\u3002\u7701\u304B\u308C\u305F\u8AAC\u660E\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6\u30FB\u5F15\u304D\u7D99\u304E\u304C\u4F5C\u696D\u306B\u95A2\u308F\u308A\u305D\u3046\u306A\u3089\u3001`--brief` \u306A\u3057\u3067\u8AAD\u3080\u304B\u3001\u305D\u306E\u30DC\u30C3\u30AF\u30B9\u306E `context` \u3092\u8AAD\u3080\n- **\u77ED\u3044\u5F62\u3067\u59CB\u3081\u308B\u524D\u63D0**: \u7BC4\u56F2 (scope) \u3092 1 \u9805\u76EE\u3067\u3082\u8A2D\u5B9A\u3057\u305F\u89AA\u30FB\u5165\u529B\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u8AAC\u660E\u306F\u3001\u77ED\u3044\u5F62\u3067\u306F\u7701\u304B\u308C\u308B (`omitted.descriptions` \u306B\u4EF6\u6570)\u3002\u7BC4\u56F2\u3092\u8A2D\u5B9A\u3059\u308B\u3068\u304D\u306F\u3001\u8AAC\u660E\u306B\u66F8\u3044\u305F\u5236\u7D04 (\u4E92\u63DB\u6027\u30FB\u7981\u6B62\u4E8B\u9805\u30FB\u671F\u9650\u306A\u3069) \u3092\u7BC4\u56F2\u3078\u5199\u3057\u7D42\u3048\u3066\u304B\u3089\u306B\u3059\u308B\u3002\u5199\u3057\u305F\u304B\u5206\u304B\u3089\u306A\u3044\u8A08\u753B\u30FB`omitted.descriptions` \u304C 0 \u3067\u306A\u3044\u8A08\u753B\u3067\u306F\u3001\u7740\u624B\u524D\u306B `--brief` \u306A\u3057\u3067 1 \u5EA6\u8AAD\u3080\u3002\u77ED\u3044\u5F62\u306F\u8ABF\u67FB\u306E\u51FA\u767A\u70B9\u3067\u3001\u305D\u308C\u3060\u3051\u8AAD\u3081\u3070\u5341\u5206\u3068\u3044\u3046\u4FDD\u8A3C\u3067\u306F\u306A\u3044\n- \u77ED\u3044\u5F62\u3067\u3082\u7528\u304C\u8DB3\u308A\u308B\u3088\u3046\u306B\u66F8\u304F: \u4F5C\u696D\u3092\u7E1B\u308B\u6761\u4EF6\u306F\u8AAC\u660E\u306E\u4E2D\u306B\u57CB\u3081\u305A\u306B scope (non-goals / constraints / acceptance / consult) \u306B\u66F8\u304F\u3002\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u306F\u6700\u65B0\u306E 1 \u4EF6\u3060\u3051\u304C\u6B8B\u308B\u306E\u3067\u3001\u672A\u89E3\u6C7A\u306E\u70B9\u30FB\u6CE8\u610F\u70B9\u30FB\u6B21\u306E\u624B\u9806\u3092\u6BCE\u56DE\u66F8\u304D\u76F4\u3057\u3066\u6301\u3061\u8D8A\u3059\u3002\u8ABF\u3079\u59CB\u3081\u308B\u5834\u6240\u306F\u3001\u5BFE\u8C61\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u8AAC\u660E\u306B\u6B21\u306E\u5F62\u3067\u66F8\u304F (\u51FA\u767A\u70B9\u3067\u3042\u308A\u3001\u305D\u306E\u30D5\u30A1\u30A4\u30EB\u3060\u3051\u8AAD\u3081\u3070\u8DB3\u308A\u308B\u3068\u3044\u3046\u610F\u5473\u3067\u306F\u306A\u3044):\n  `\u5909\u66F4\u5019\u88DC: <\u30D1\u30B9> \u2014 <\u8ABF\u3079\u59CB\u3081\u308B\u7406\u7531>` / `\u95A2\u9023\u691C\u67FB: <\u30D1\u30B9\u307E\u305F\u306F\u30B3\u30DE\u30F3\u30C9> \u2014 <\u78BA\u304B\u3081\u308B\u3053\u3068>`\n- \u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u901A\u3059\u305F\u3081\u306B guard \u3092\u7121\u52B9\u306B\u3057\u306A\u3044 (AI \u304C `guard off` \u3059\u308B\u306B\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u8981\u308B)\n- MCP \u3067\u306F `boxglow_context` \u3068\u3001\u5404\u30C4\u30FC\u30EB\u306E `contextToken` \u5F15\u6570\u3092\u4F7F\u3046 (\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F\u30C4\u30FC\u30EB\u306E\u7D50\u679C\u306E\u6700\u5F8C\u306E\u884C\u306B\u51FA\u308B)\n- \u300C\u4ED6\u306E Boxglow \u304C\u66F8\u304D\u8FBC\u307F\u4E2D (\u30ED\u30C3\u30AF\u4E2D)\u300D\u3068\u51FA\u3066\u3001\u5C11\u3057\u5F85\u3063\u3066\u3084\u308A\u76F4\u3057\u3066\u3082\u89E3\u3051\u306A\u3044\u3068\u304D\u306F\u3001`npx boxglow unlock` \u306E\u8868\u793A (\u6301\u3061\u4E3B\u3068\u5224\u5B9A) \u3092\u4EBA\u306B\u898B\u305B\u3066\u89E3\u9664\u3092\u983C\u3080\u3002\u81EA\u5206\u3067 `--actor human` \u3092\u4ED8\u3051\u305F\u308A\u3001\u30ED\u30C3\u30AF\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u76F4\u63A5\u6D88\u3057\u305F\u308A\u3057\u306A\u3044\n\n### \u7740\u624B\u30FB\u5B8C\u4E86\u3001\u4ECA\u56DE\u306E\u7BC4\u56F2\u3001\u8A18\u9332\u306E\u9BAE\u5EA6\n\n- \u6700\u521D\u306B resume \u306E\u73FE\u6CC1 (\u6D3B\u52D5\u30FB\u5224\u65AD\u5F85\u3061\u30FB\u672A\u78BA\u8A8D\u56DE\u7B54) \u3092\u8AAD\u3080\u3002\u5019\u88DC\u306F\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2 / \u305D\u306E\u4ED6\u300D\u306E\u5404\u7D44\u3067\u300C\u7740\u624B\u3067\u304D\u308B / \u8981\u5177\u4F53\u5316 / \u5165\u529B\u5F85\u3061\u300D\u306B\u5206\u304B\u308C\u3001\u8981\u5177\u4F53\u5316\u306E\u7406\u7531\u3068\u4E0D\u8DB3\u3059\u308B\u5165\u529B\u540D\u304C\u51FA\u308B\u3002\u8981\u5177\u4F53\u5316\u3084\u5165\u529B\u5F85\u3061\u3092\u3001\u6E96\u5099\u6E08\u307F\u3068\u53D6\u308A\u9055\u3048\u306A\u3044\u3002\n- \u300C\u7740\u624B\u3067\u304D\u308B\u300D(Ready) \u306F\u3001\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B\u304C\u3042\u308A\u3001\u305D\u306E\u4E88\u5B9A\u6210\u679C\u7269 (expect) \u3068\u5B8C\u4E86\u6761\u4EF6 (acceptance) \u304C\u66F8\u304B\u308C\u3001\u5FC5\u9808\u306E\u5165\u529B\u304C\u305D\u308D\u3063\u3066\u3044\u308B\u3001\u3068\u3044\u3046\u6A5F\u68B0\u691C\u67FB\u306E\u7D50\u679C\u3002\u5185\u5BB9\u304C\u5177\u4F53\u7684\u304B\u3069\u3046\u304B\u307E\u3067\u306F\u4FDD\u8A3C\u3057\u306A\u3044 (`expect = src/`\u3001`acceptance = \u52D5\u4F5C\u3059\u308B` \u3067\u3082\u901A\u308B)\u3002\u5BFE\u8C61\u30FB\u51E6\u7406\u30FB\u6210\u679C\u30FB\u78BA\u8A8D\u65B9\u6CD5\u3092\u7B2C\u4E09\u8005\u304C\u8FFD\u3048\u308B\u3088\u3046\u306B\u66F8\u304F\u3002\n- \u30DC\u30C3\u30AF\u30B9\u306E\u4EFB\u610F5\u9805\u76EE\u3092 scope \u3067\u8A2D\u5B9A\u3059\u308B\u3002goal = \u4ECA\u56DE\u9054\u6210\u3059\u308B\u3053\u3068\u3001non-goals = \u4ECA\u56DE\u306F\u6271\u308F\u306A\u3044\u3053\u3068\u3001acceptance = \u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6\u3001consult = \u7BC4\u56F2\u3092\u5E83\u3052\u308B\u524D\u306B\u76F8\u8AC7\u3059\u308B\u6761\u4EF6\u3002context \u306E\u5148\u982D\u3067\u5BFE\u8C61\u3068\u89AA\u306E\u7BC4\u56F2\u3092\u8AAD\u307F\u3001\u7740\u624B\u524D\u3068\u5B8C\u4E86\u524D\u306B\u7167\u5408\u3059\u308B\u3002\u5B8C\u4E86\u6761\u4EF6\u306E\u672C\u6587\u3092AI\u304C\u6E80\u305F\u3057\u305F\u304B\u306F\u81EA\u52D5\u5224\u5B9A\u3057\u306A\u3044\u3002\n- scope B12 --goal "\u9054\u6210\u3059\u308B\u3053\u3068" --non-goals "\u4ECA\u56DE\u6271\u308F\u306A\u3044\u3053\u3068" --acceptance "\u78BA\u8A8D\u3059\u308B\u6761\u4EF6" --consult "\u76F8\u8AC7\u3059\u308B\u6761\u4EF6" \u3067\u8A2D\u5B9A\u3059\u308B\u3002scope B12 \u306F\u8868\u793A\u3060\u3051\u3002\u5404\u9805\u76EE\u306B none \u307E\u305F\u306F\u7A7A\u6587\u5B57\u3092\u6E21\u3059\u3068\u6D88\u3059\u3002\u753B\u9762\u3067\u306F\u8A73\u7D30\u30D1\u30CD\u30EB\u306E\u300C\u305D\u306E\u4ED6\u300D\u30BF\u30D6 \u2192\u300C\u4F5C\u696D\u7BC4\u56F2\u3092\u7DE8\u96C6\u300D\u3002\u8A18\u5165\u6E08\u307F\u306E\u9805\u76EE\u3060\u3051\u304C\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2\u300D\u306B\u51FA\u308B\u3002\n- focus B12 \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u3068\u914D\u4E0B\u3092\u6B21\u5019\u88DC\u306E\u5148\u982D\u306B\u3059\u308B\u3002focus \u306F\u73FE\u5728\u306E\u5BFE\u8C61\u306E\u8868\u793A\u3001focus none \u306F\u89E3\u9664\u3002\u5BFE\u8C61\u5916\u3082\u5225\u306E\u7D44\u306B\u6B8B\u308B\u3002\u5019\u88DC\u306B\u51FA\u308B\u3053\u3068\u81EA\u4F53\u306F\u4F5C\u696D\u7BC4\u56F2\u306E\u62E1\u5927\u3084\u516C\u958B\u3092\u8A31\u53EF\u3057\u306A\u3044\u3002\n- start \u306E\u5FC5\u9808\u5165\u529B\u4E0D\u8DB3\u306F\u65E2\u5B9A\u3067\u8B66\u544A\u3059\u308B\u304C\u3001\u5F93\u6765\u3069\u304A\u308A\u958B\u59CB\u3067\u304D\u308B\u3002\u5148\u884C\u4F5C\u696D\u304C\u5FC5\u8981\u306A\u3089 --reason "\u5148\u306B\u884C\u3046\u7406\u7531" \u3092\u4ED8\u3051\u308B\u3002\u8B66\u544A\u306F\u51FA\u305A\u3001\u7406\u7531\u306F\u6D3B\u52D5\u3068\u30ED\u30B0\u306B\u6B8B\u308B\u3002done \u306E\u51FA\u529B\u6210\u679C\u7269\u306A\u3057\u3082\u65E2\u5B9A\u3067\u8B66\u544A\u306E\u307F\u3002\u65E2\u5B58\u306E\u51FA\u529B\u6210\u679C\u7269\u307E\u305F\u306F --artifact \u3092\u6570\u3048\u3001\u30DC\u30C3\u30AF\u30B9\u306E\u53C2\u8003\u8CC7\u6599\u306F\u6570\u3048\u306A\u3044\u3002\n- \u8A08\u753B\u3067\u9078\u3076\u5834\u5408\u3060\u3051 policy --start reject --done reject --unprepared reject \u306B\u3059\u308B\u3002\u305D\u308C\u305E\u308C warn \u306B\u623B\u305B\u308B\u3002\u5165\u529B\u5F85\u3061\u306E\u62D2\u5426\u3067\u3082\u7406\u7531\u4ED8\u304D\u306E\u958B\u59CB\u306F\u53EF\u80FD\u3060\u304C\u3001\u8981\u5177\u4F53\u5316\u306E\u62D2\u5426\u306F\u7406\u7531\u3067\u306F\u901A\u308C\u306A\u3044 (\u5148\u306B\u5177\u4F53\u5316\u3059\u308B)\u3002\u6210\u679C\u7269\u306A\u3057\u306E\u62D2\u5426\u306F set --status white \u306B\u3082\u52B9\u304F\u3002\u4EBA\u306E\u64CD\u4F5C (\u753B\u9762 / --actor human) \u306F\u62D2\u5426\u3057\u306A\u3044\u3002AI\u304C\u62D2\u5426\u3092\u907F\u3051\u308B\u305F\u3081\u306B\u4EBA\u3092\u540D\u4E57\u3063\u305F\u308A\u3001\u8A2D\u5B9A\u3092\u5F31\u3081\u305F\u308A\u3057\u306A\u3044\u3002\n- guard \u6709\u52B9\u6642\u3001scope \u306E\u5909\u66F4\u3001focus \u306E\u8A2D\u5B9A\u30FB\u89E3\u9664\u3001policy \u306E\u5909\u66F4\u306B\u3082 --context-token \u304C\u5FC5\u8981\u3002scope/focus/policy \u3092\u5909\u3048\u308B\u3068\u65B0\u3057\u3044\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u3067\u3001\u6B21\u306E\u64CD\u4F5C\u306F\u305D\u308C\u3092\u4F7F\u3046\u3002\u8868\u793A\u3060\u3051\u306B\u306F\u4E0D\u8981\u3002\n- resume \u306F\u5B8C\u4E86\u6E08\u307F\u306E\u5F15\u304D\u7D99\u304E\u672C\u6587\u3092\u96A0\u3057\u3001\u4EF6\u6570\u3060\u3051\u793A\u3059\u3002\u5C65\u6B74\u304C\u5FC5\u8981\u306A\u5834\u5408\u3060\u3051 resume --include-completed \u3067\u5C55\u958B\u3059\u308B (context / show \u3067\u306F\u500B\u5225\u306B\u8AAD\u3081\u308B)\u3002\n- \u8AAC\u660E\u306F descriptionUpdatedAt\u3001\u72B6\u614B\u306F statusChangedAt\u3001\u5F15\u304D\u7D99\u304E\u306F\u65E2\u5B58\u306E at \u3067\u65E5\u6642\u3092\u78BA\u8A8D\u3067\u304D\u308B\u3002\u72B6\u614B\u5909\u66F4\u3088\u308A\u53E4\u3044\u30E1\u30E2\u306F\u305D\u306E\u65E8\u3092\u793A\u3059\u3002\u65E7\u8A18\u9332\u306E\u4E0D\u660E\u306A\u65E5\u6642\u306F\u88DC\u308F\u306A\u3044\u3002\u300C\u65B0\u3057\u3044\u8A18\u9332\u300D\u306F\u771F\u507D\u306E\u4FDD\u8A3C\u3067\u306F\u306A\u3044\u3002\n- Done \u3067\u53E4\u3044\u72B6\u6CC1\u8AAC\u660E\u304C\u6B8B\u308B\u53EF\u80FD\u6027\u304C\u3042\u308B\u5834\u5408\u3001CLI\u30FB\u8A73\u7D30\u30D1\u30CD\u30EB\u30FBresume \u306B\u898B\u76F4\u3057\u6848\u5185\u304C\u51FA\u308B\u3002\u672C\u6587\u306F\u81EA\u52D5\u3067\u6D88\u3055\u306A\u3044\u3002\u5185\u5BB9\u3092\u78BA\u8A8D\u3057\u3001\u5FC5\u8981\u306A\u3089 set B12 --note "\u73FE\u5728\u306E\u8AAC\u660E" (none \u3067\u6D88\u53BB) \u307E\u305F\u306F\u753B\u9762\u306E Notes \u3067\u76F4\u3059\u3002\n- MCP \u306F boxglow_scope / boxglow_focus / boxglow_policy\u3001boxglow_claim\u3001boxglow_port \u306E expect / self\u3001boxglow_start \u306E reason\u3001boxglow_resume \u306E includeCompleted \u3092\u4F7F\u3046\u3002\u5909\u66F4\u306B\u306F contextToken \u3092\u4ED8\u3051\u308B\u3002\n- \u30C7\u30FC\u30BF\u5F62\u5F0F\u306F v5 \u306E\u307E\u307E\u3067\u5168\u9805\u76EE\u306F\u4EFB\u610F\u3002\u65E7\u7248 (0.4.2\u4EE5\u524D) \u306F\u65B0\u3057\u3044\u898F\u5247\u3092\u5B9F\u884C\u305B\u305A\u3001\u4FDD\u5B58\u6642\u306B\u8A08\u753B\u306E workflowPolicy / focusBlockId \u3092\u843D\u3068\u3059\u3002\u3053\u308C\u3089\u3092\u4F7F\u3046\u8A08\u753B\u306E\u66F8\u304D\u624B (CLI\u30FBserve\u30FB\u753B\u9762\u30FB\u62E1\u5F35\u5185\u306E\u30A2\u30D7\u30EA) \u306F\u5BFE\u5FDC\u3057\u305F\u30D3\u30EB\u30C9\u306B\u63C3\u3048\u308B\u3002\u7248\u756A\u53F7\u3060\u3051\u3067\u306A\u304F\u30D3\u30EB\u30C9\u65E5\u6642\u3082\u78BA\u8A8D\u3059\u308B\u3002\n\n\n### Sync decisions\n\nAI may only sync already bound projects and inspect comparisons. If sync stops for a conflict or a human choice, summarize the differences and use ask to notify the user. Never resolve conflicts, create a new binding, relink, recover, adopt, restore, or confirm an account. A human must use the UI or explicitly run CLI with --actor human. AI must never add --actor human, including after a chat answer; record the answer and wait for the human to apply the sync choice.\n\nCodex\u306F\u5168CLI\u547C\u3073\u51FA\u3057\u306B `--actor codex`\u3001Claude Code\u306F `--actor claude-code` \u3092\u660E\u793A\u3059\u308B\u3002WSL\u306A\u3069\u3067\u306F\u5B9F\u884C\u74B0\u5883\u306E\u5370\u304C\u6E21\u3089\u306A\u3044\u3053\u3068\u304C\u3042\u308B\u3002\u30B5\u30D6\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306F `codex-\u4F5C\u696D\u540D` \u306A\u3069\u306B\u5206\u3051\u3001\u4EBA\u3092\u540D\u4E57\u3089\u306A\u3044\u3002\n\n### \u4E26\u5217\u4F5C\u696D\u306E\u53D7\u3051\u6301\u3061\n\n\u8A08\u753B\u3067\u53D7\u3051\u6301\u3061\u304C\u6709\u52B9\u306A\u3089\u3001CLI\u5B9F\u884C\u3054\u3068\u306B\u4E00\u610F\u306E `BOXGLOW_INSTANCE_ID` \u3092\u56FA\u5B9A\u3057\u3001`claims` \u3068 `context` \u3092\u8AAD\u3093\u3067\u304B\u3089 `claim` (\u5177\u4F53\u5316\u30FB\u5206\u89E3\u306E\u524D) \u307E\u305F\u306F `start` (\u5B9F\u884C) \u3059\u308B\u3002`claim` \u3067\u53D6\u3063\u305F\u53D7\u3051\u6301\u3061\u306F\u3001\u305D\u306E\u307E\u307E `start` \u306B\u5F15\u304D\u7D99\u304C\u308C\u308B\u3002\u72EC\u7ACB\u3057\u305F\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u9593\u3067\u5B9F\u884CID\u3092\u5171\u6709\u3057\u306A\u3044\u3002\u65E2\u5B9A\u306F\u30DC\u30C3\u30AF\u30B9\u306E\u307F\u3001\u5FC5\u8981\u306A\u3089 `--scope subtree`\u3002\u6210\u529F\u3057\u305FCLAIM\u884C\u306Etoken\u3092\u4FDD\u6301\u3057\u3001\u4FDD\u5B58\u3059\u308B\u64CD\u4F5C\u306B `--claim-token` \u3092\u4ED8\u3051\u308B\u3002MCP\u306F\u5B9F\u884CID\u3068\u53D7\u9818\u8A3C\u3092\u81EA\u52D5\u3067\u4FDD\u6301\u3059\u308B\u30025\u5206\u3054\u3068 (\u671F\u9650\u304C\u77ED\u3051\u308C\u3070\u534A\u5206\u4EE5\u5185) \u306B `claim-renew` / `boxglow_claim_renew` \u3092\u547C\u3073\u3001\u4E2D\u65AD\u524D\u306Fcheckpoint\u3002done/leave\u306F\u5BFE\u8C61\u306E\u53D7\u3051\u6301\u3061\u3092\u89E3\u653E\u3059\u308B\u3002\u671F\u9650\u5207\u308C\u3084\u4E16\u4EE3\u9055\u3044\u3092\u7121\u8996\u305B\u305A\u3001\u6700\u65B0context\u3092\u78BA\u8A8D\u3057\u3066\u53D6\u308A\u76F4\u3059\u3002\u540C\u540Dactor\u3067\u3082\u5225\u5B9F\u884C\u306E\u53D7\u3051\u6301\u3061\u306F\u596A\u308F\u306A\u3044\u3002\u8A2D\u5B9A\u30FB\u5F37\u5236\u89E3\u9664\u30FB\u540C\u671F\u7AF6\u5408\u306E\u89E3\u6C7A\u306F\u4EBA\u306B\u4F9D\u983C\u3057\u3001AI\u304Chuman\u3092\u540D\u4E57\u3063\u3066\u4EE3\u884C\u3057\u306A\u3044\u3002\u5171\u6709\u30D5\u30A1\u30A4\u30EB\u4EE5\u5916\u306E\u540C\u671F\u30B3\u30D4\u30FC\u9593\u306B\u306F\u6392\u4ED6\u4FDD\u8A3C\u304C\u306A\u3044\u3002\u8A73\u3057\u304F\u306F `docs/CLAIMS.md`\u3002\n\n\u4ED6\u8005\u306E\u5B9F\u884CID\u30FB\u53D7\u9818\u8A3C\u3092\u4F7F\u308F\u306A\u3044\u3002\u8A08\u753B\u3084claims\u306E\u51FA\u529B\u304B\u3089\u4ED6\u8005\u306E\u53D7\u9818\u8A3C\u3092\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u3082\u7981\u6B62\u3002MCP\u518D\u8D77\u52D5\u5F8C\u306E\u540C\u540Dactor\u3082\u5225\u5B9F\u884C\u306A\u306E\u3067\u3001\u81EA\u52D5\u3067\u5F15\u304D\u7D99\u304C\u305A\u671F\u9650\u3092\u5F85\u3064\u304B\u4EBA\u306B\u89E3\u9664\u3092\u983C\u3080\u3002\n\n\u5165\u529B\u306E\u81EA\u52D5\u5F15\u304D\u4E0A\u3052\u306F\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u7BC4\u56F2\u3067\u6271\u3046\u3002\u5171\u6709\u5165\u529B\u306E\u5185\u5BB9\u5909\u66F4\u3084\u5225\u30DC\u30C3\u30AF\u30B9\u3078\u306E\u914D\u7F6E\u5909\u66F4\u306B\u306F\u3001\u5F71\u97FF\u3059\u308B\u7BC4\u56F2\u306E\u53D6\u5F97\u3082\u5FC5\u8981\u3002focus\u3084group\u306A\u3069\u8A08\u753B\u5168\u4F53\u306E\u8A2D\u5B9A\u306B\u306F `context root` \u2192 `claim root` \u3067root\u3092\u53D6\u5F97\u3057\u3001\u305D\u306ECLAIM\u3092\u6E21\u3059 (`start root` \u3067\u3082\u53D6\u308C\u308B\u304C\u3001\u5B9F\u884C\u4E2D\u306B\u306F\u3057\u306A\u3044 `claim` \u3092\u4F7F\u3046)\u3002root\u306E\u307F\u306E\u53D6\u5F97\u306F\u901A\u5E38\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u542B\u307E\u306A\u3044\u3002\u8A08\u753B\u8A2D\u5B9A\u306E\u5909\u66F4\u306Froot\u306E\u307F\u3067\u8DB3\u308A\u308B\u3002root\u306Esubtree\u306F\u4E26\u884C\u4F5C\u696D\u3092\u5168\u90E8\u6B62\u3081\u308B\u306E\u3067\u3001AI\u306F\u4F7F\u308F\u305A\u4EBA\u306B\u76F8\u8AC7\u3059\u308B\u3002root\u306E\u7D42\u4E86\u306F `leave root`\u3002context guard\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3082\u5F15\u304D\u7D9A\u304D\u5FC5\u8981\u3002\n\n---\n\n\u540C\u671F\u306E\u4EBA\u5C02\u7528\u64CD\u4F5C\u306F\u3001\u5F37\u5236\u7684\u306A\u6A29\u9650\u5206\u96E2\u3067\u306F\u306A\u304F\u8AA4\u64CD\u4F5C\u306E\u9632\u6B62\u3067\u3059\u3002AI \u306F `--actor human` \u3092\u540D\u4E57\u3089\u305A\u3001\u6BD4\u8F03\u3068\u505C\u6B62\u7406\u7531\u3092\u4EBA\u3078\u4F1D\u3048\u3066\u304F\u3060\u3055\u3044\u3002MCP \u3068 AI \u3068\u3057\u3066\u8B58\u5225\u3057\u305F CLI \u306F\u3001\u4EBA\u7528\u306E\u9078\u629E\u30B3\u30DE\u30F3\u30C9\u3092\u51FA\u529B\u3057\u307E\u305B\u3093\u3002\n\n\u4EBA\u306ECLI\u64CD\u4F5C\u306F `--actor human:\u540D\u524D` \u3082\u53D7\u3051\u4ED8\u3051\u307E\u3059\u3002AI\u306F\u3053\u306E\u5F62\u3067\u3082\u4EBA\u3092\u540D\u4E57\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002AI\u5411\u3051\u505C\u6B62\u6587\u306E `boxglow sync --help` \u306F\u3001AI\u74B0\u5883\u3092\u5F15\u304D\u7D99\u3044\u3060\u4EBA\u3078\u306E\u6848\u5185\u3067\u3059\u3002AI\u306E\u4EE3\u884C\u8A31\u53EF\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002\n';
 
 // docs/AGENTS_SNIPPET.en.md
-var AGENTS_SNIPPET_en_default = '# Instructions for agents using Boxglow (paste into AGENTS.md / CLAUDE.md)\n\nPaste the part between the "---" lines below, as is, into your repository\'s AGENTS.md (Codex) or CLAUDE.md (Claude Code).\nPut boxglow.json at the repository root (`npx boxglow init --name "<project name>"`).\n\n---\n\n## Boxglow (shared plan and progress)\n\n`boxglow.json` is the source of truth for this repository\'s plan and progress. Humans watch this file on the Boxglow screen.\nDo not edit the file directly; always update it with `npx boxglow` commands (this keeps the wiring rules and the history intact).\n\nA block = "a task that turns inputs into an output (deliverable)". It is done (WhiteBox) once the output\'s deliverable is settled.\nStatus: BlackBox (only the output is decided) \u2192 GrayBox (in progress) \u2192 WhiteBox (done).\n\n### What to do every time you work\n\n1. **Read first**: read `npx boxglow resume` (or `npx boxglow status --brief`) for work in progress, pending decisions, unread answers, next candidates, and handoffs for unfinished boxes. To continue a previous session, start from the handoff notes shown there. Check the inputs and outputs of your box with `npx boxglow show <block>`\n2. **Check readiness**: before taking on a box, read `npx boxglow context <block>`. Its `readiness` is the state of preparation: `state: "ready"` means you can start. `"unprepared"` (needs detail) means you add detail first, following the reasons in `unprepared` and the commands in `next`. `"waiting"` means a required input or a branch answer is missing\n3. **Hold, then add detail**: before adding detail or splitting, hold the box with `npx boxglow claim <block>` (this does not start it; on a plan without claims it prints "not needed" and succeeds). Then fill in what is missing:\n   - the output\'s planned deliverable: `npx boxglow port <block> --expect "<output>=file:src/x.ts"` (kind: file / dir / url / doc / note / decision / result; hint: a path or title. The file need not exist yet)\n   - the acceptance criteria: `npx boxglow scope <block> --acceptance "<when it counts as done>"`; the work itself with `--goal`; what the output must respect (performance, quality, size, dimensions, power, ...) with `--constraints`\n   - when you cannot see how to produce the output with a single box, place smaller boxes inside it with `npx boxglow split <block> --spec \'<JSON>\'`. Write expect / acceptance only for the children you will start now; later children need only a title and an output (they stay "needs detail"). Inputs can be omitted if unknown (they automatically become inputs of the level above)\n   - when you do not know which files are involved, do not invent paths: add a box "find the target" with a `note` output and start that\n4. **Record the start**: once ready, read `npx boxglow context <block>` again, then run `npx boxglow start <block> --note "<what you will do>"`. Work on at most 1-2 boxes at a time.\n   The started box is marked "now" (the boxes being worked on right now; any number when several agents or people work; a thick frame and a NOW tag on the canvas). Add another with `npx boxglow now <block>` (`--off` removes one, `now none` clears all); done / leave remove that box. People toggle it with the NOW button on the Status tab\n   On a plan with the context guard on, pass the `contextToken` (context token) from the context output:\n   `npx boxglow start <block> --note "<what you will do>" --context-token <context token>` (see "Context token and handoff" below)\n   Starting a box that still needs detail warns by default (with the reasons and the next commands). On a plan with `policy --unprepared reject` it is refused (`--reason` does not bypass it; human actions are allowed). A parent whose outputs are all made by its children has nothing to run itself: start the child instead\n5. **Record completion**: when the output\'s deliverable exists, run `npx boxglow done <block> --artifact "<name>=<path in the repository>"`. Record the verification in three fixed fields: `--checked` (checks run and their results, e.g. "vitest 53 passed; e2e home 34/34"), `--not-checked` (what was not tried), `--limits` (remaining limits / caveats). For non-code deliverables (documents etc.) write what you confirmed in `--checked`. It stays on the box and shows in context / show.\n   With the guard on, add `--context-token <context token>` (if your previous command printed "New context token: <token>", use that one).\n   An unchanged file already committed to HEAD is recorded as "commit + path + content hash" (nothing is uploaded). Uncommitted or untracked files remain local file references, and `npx boxglow check` turns them into Git references once they are committed; do not create a commit solely to satisfy Boxglow. Use full `npx boxglow status` when you need the entire tree. For PRs and external material, a URL is fine.\n   To attach a deliverable ahead of completion, use `npx boxglow artifact <block> <path>`. Record progress along the way with `npx boxglow set <block> --progress 60`\n6. **When a human decision is needed**: `npx boxglow ask <block> "<question>" --options "A|B"`. Do not proceed with that box until it is answered; move on to another box. A human\'s answer appears under "Answered" in `status`. After reading it, acknowledge it with `npx boxglow ack <block>` (`start` / `done` / `set` etc. on that box also acknowledge it automatically). Until you acknowledge it, it stays on the human\'s screen as "Not read by the AI yet" and the human can still revise the answer. If the answer contains a question back to you, record your own answer too with `ask` and `answer --by <yourself>`\n7. **When you are stuck**: If the cause is a missing input (a deliverable of an earlier box, or material), do not mark the box as blocked. Check its input wires with `npx boxglow show <block>`; if no box produces what is missing, create one outside (upstream) with `npx boxglow add` and wire it to this box\'s input with `npx boxglow connect` (the wire stays in the waiting color, so the diagram shows what the box is waiting for). If a choice between options would let you continue, use `ask`. Record only obstacles outside the plan (an environment that does not work, missing permissions or keys, waiting for an outside reply, a failure with no known cause) with `npx boxglow blocked <block> --note "<what is in the way>"` When a check or evaluation rejects an earlier deliverable, do not wire backwards (it would be a cycle): `npx boxglow sendback <evaluating box> --to <box to redo> --note "<reason>"` sends it back (that box returns to In Progress, its artifacts are kept as rejected, and the reason appears in context).\n8. **Check deliverables**: after moving or renaming files, run `npx boxglow check` (it detects the move and updates the path; if the file cannot be found, it is flagged)\n9. **Keep progress and findings**: `npx boxglow log <block> "<text>"` adds a dated, signed work-log entry to the box (Markdown). People read and write the same log in the Log tab. The handoff note (checkpoint) is overwritten; log entries accumulate\n10. **Before an interruption or a handoff**: before the session ends, the context is compacted, or you hand over to another AI or a person, save a handoff note with `npx boxglow checkpoint <block> --note "Findings; next steps; unresolved questions"` (with the guard on, add `--context-token <context token>`). It stays in the plan even when the chat history is gone, and the next session reads it with `resume` and `context`\n11. **Report**: at the end of your work, summarize `npx boxglow status --brief` and report it\n\n### Structural rules\n\n- **Show an undecided fork as a branch**: when, at planning time, later work (a path) depends on a decision that has not been made, create a branch box with `npx boxglow branch "<title>" --options "A|B" --question "<question>" --context "<background>"`. Each option becomes a path (output); `connect` each one to the first box of that path. Where the paths come together again, add a merge part with `npx boxglow join --title "<title>"`, `connect` the last output of each path to it, and connect its output to the next box (any one path arriving is enough). Once a person answers, the boxes on the paths not chosen are skipped and drop out of progress and next candidates. If a box you already made turns out to be an undecided fork, turn it into a branch with `npx boxglow branch --box <block> --options "A|B" --question "<question>"` (its output becomes the first option\'s path; wires stay). Before the answer, boxes on the paths wait for the branch and starting them warns (record a reason with `--reason`, e.g. for early research)\n- The top level contains only the "input node", the "final deliverable node" and "project boxes". Tasks go inside a project box (the default parent of `add` is the first project box)\n- There is no limit on depth. `split` can be used at any level\n- A box that could be reused in another project (e.g. converting input images to monochrome) can be turned into a template with `npx boxglow export-block <block> --out <name>.boxglow-block.json` and\n  inserted with `npx boxglow import-block <path> --parent <block>`. You may share templates by putting them in the repository\'s `boxglow-blocks/`\n\nWhen there are many top-level inputs, create a group with `npx boxglow group "<group name>"` and sort inputs into it with `npx boxglow group-set <input name> <group name>` (e.g. PCIe spec / DDR spec).\n\n### JSON format for split\n\n```json\n{\n  "blocks": [\n    { "title": "Find the target", "inputs": ["Repro steps"], "outputs": ["Notes"],\n      "expect": "note:the files and code paths involved, evidence, candidate changes, how to check, open questions", "acceptance": "the files and code to change are known and the following boxes can be given expect and acceptance; or the reason they cannot, and the decision needed, is clear",\n      "goal": "reproduce and trace the path; changing product code is out of scope here" },\n    { "title": "Refresh sync state after a retried save", "inputs": ["Notes"], "outputs": ["Fix"],\n      "expect": "file:src/sync/state.ts", "acceptance": "fail one save, retry, and the sync state and actions come back (covered by a test)" },\n    { "title": "Write the release note", "inputs": ["Fix"], "outputs": ["Note"] }\n  ],\n  "connections": [\n    { "from": "parent.Repro steps", "to": "Find the target.Repro steps" },\n    { "from": "Find the target.Notes", "to": "Refresh sync state after a retried save" },\n    { "from": "Refresh sync state after a retried save.Fix", "to": "Write the release note" },\n    { "from": "Write the release note.Note", "to": "parent.Output" }\n  ]\n}\n```\n\n`expect` (planned deliverable: `"kind:hint"` or `{ "kind", "hint" }`), `acceptance` and `goal` go only on the children you will start now.\nA child with just a title and an output, like the third one, stays "needs detail" until its turn; then set them with `port --expect` / `scope --acceptance`.\nOutputs the parent makes itself (integrating the children\'s results, for example) are marked with `"parentMakes": ["<output>"]` (if a child\'s wire also feeds it, readiness reports two makers).\n`"splitBy": "stage"` records in one word how the direct children are divided (stage / deliverable / feature; also `set <block> --split-by`). Siblings should follow the same division and the same level of detail.\n`split` refuses to save only a broken structure (a wire to nothing, a cycle, a malformed expect). Unfinished breakdowns (a single child, a parent output nobody makes yet) are saved and reported as gaps.\nAfter a split and before a start, read `npx boxglow lint <block>`. Fix the "must fix" items (parent outputs with no or two makers, both exclusive paths of one branch required, a box in progress without expect / acceptance, gaps on the box you are checking) before going on.\n"Fill in before starting" items (expect / acceptance of boxes not started yet) are filled when that child\'s turn comes (do not write token entries for later work now).\n"Review" items (a single child, unconnected outputs, token entries, empty branch paths, single-input merges, siblings with the same expect) are for you to judge (the tool never refuses on them). `context` also prints the counts and the top three.\n\n**Content review (meaning cannot be checked by the tool: an AI or a person reads the material, judges, and records the basis)**\n- After a split: read `npx boxglow review-split <parent>` (the parent\'s goal, constraints, acceptance and ports; the children\'s targets, ports, planned deliverables and acceptance; the wiring; a checklist). When reviewed, record it with `npx boxglow split-ok <parent> --note "<basis: what you checked>"`.\n- Before a start: read `npx boxglow review-box <block>` (target, work, planned deliverable, checks, input sources, upstream branch answers) and record with `npx boxglow box-ok <block> --note "<basis>"`.\n- A record says "reviewed, with this basis"; it does not prove validity. When the material changes, `reviews` in `context` becomes `stale` (with what changed and what to check). `stale` does not mean the breakdown is wrong; it means the material changed after the last review. Position, colours, progress and assignees do not make it stale. The breakdown record is not affected by branch answers; the readiness record is.\n- Adding detail to a later child at its turn always makes the parent\'s breakdown record `stale` (the children\'s expect / acceptance are part of the material). Finish that child\'s expect and scope first, then check only the changed child\'s effect on the parent\'s acceptance and nonGoals and on the division among siblings; if it still fits, update it with `split-ok <parent> --note "Checked B181\'s detail: not in the parent\'s nonGoals, no overlap with B182"`. Do not re-review after every port or scope command; several children detailed together can be checked together.\n- It is not a condition for `start` (in default or reject plans). Only needs-detail and missing inputs stop a start.\n\n**Branches and merges for agents**\n- When an `ask` has options and the answer changes the work that follows, add `--branch`: the box becomes a branch with one path (output) per option. `connect` each path to its first box, and put a `join` where the paths come together.\n- The split JSON can make them too: a child with `"branch": { "question": "...", "options": ["A", "B"] }` becomes a branch box (its outputs are the option names), `"join": true` a merge part. Example:\n  `{ "blocks": [{ "title": "Choose auth", "branch": { "question": "Which?", "options": ["Mail", "OAuth"] } }, { "title": "Mail impl", "outputs": ["Auth"] }, { "title": "OAuth impl", "outputs": ["Auth"] }, { "title": "Merge", "join": true }], "connections": [{ "from": "Choose auth.Mail", "to": "Mail impl" }, { "from": "Choose auth.OAuth", "to": "OAuth impl" }, { "from": "Mail impl.Auth", "to": "Merge" }, { "from": "OAuth impl.Auth", "to": "Merge" }, { "from": "Merge.Merge", "to": "parent.Auth" }] }`\n- `lint` reports a box that requires inputs from both exclusive paths of one branch (they never both arrive) as must-fix, and empty paths or single-input merges as review items.\n`parent.<name>` is an input / output of the box being split. `<block>` is a short ID (such as B12; shown in status) or a title.\nA box has one output per thing it makes (when one piece of work produces several things, list them all in outputs; set expect for the second and later ones with `port <block> --expect "<output>=<kind>:<hint>"`). Connected inputs and outputs share one name (renaming either end renames the other). Make the title a short phrase that tells "what is made".\nRecord dates and hours with `npx boxglow set <block> --due 2026-10-15 --start 2026-10-01 --estimate 8 --hours 3.5`.\nGive each box a kind of work (category): `--category design` / build / verify / evaluate / study / research / ui / improve / fix / docs / ops / other (other: when unsure). Set it at add time; to change it, use `npx boxglow set <block> --category verify`.\nThe receiving side of a connection can be just a title (`npx boxglow connect "A.Design doc" "B"` creates an input "Design doc" on B and connects it; boxes in other levels work too, the ports in between are created automatically. In split\'s connections, `to: "B"` also works). Connected inputs and outputs share one name (they are aligned when connected, and renaming either end renames everything on the same wire). To add inputs / outputs to an existing box or rename them, use `npx boxglow port <block> --in <name> --out <name> --remove <name> --rename <old>=<new>` (removing an input also removes the inputs of the boxes that use it; top-level inputs are `port inputs`; withdraw a mistaken question with `npx boxglow unask <block>`) (`project` = the first project box. This also renames the final deliverable). Remove a wire with `npx boxglow disconnect <title.output name> <title.input name>`, and remove a box itself with `npx boxglow remove <block>` (`--force` if it has boxes inside). The MCP tools (`boxglow_status` / `boxglow_start` / `boxglow_done` / `boxglow_ask` etc.; available after registration in your agent; `.mcp.json` is the Claude Code configuration) are another entry point to the same commands, and either way updates the same file. Export the plan as a document with `npx boxglow export --out docs/ROADMAP.md`.\n\n**Share project-wide decisions as policies**: when a box decides something many boxes depend on (technology choice, engine, art style), make that output a policy (`npx boxglow port <block> --policy "<output>"`; scope defaults to the same parent, `--policy-scope all` for the whole plan, `--advisory` to not block). It reaches every box in scope without wires, and the boxes in scope that have not started wait for it until it is decided (work in progress is not stopped). Read `policies` in `context` before working. Exclude unrelated boxes with `--skip-policy "<box>.<output>"`. If a policy changes after a box is done, it appears in `policyChanged` (check it again). Do not wire it to each box.\nIn a new project, first create 3-7 top-level items from the direction (the README or the request), confirm them with a human via `ask`, and then `split` only the item you are about to start (leave later stages coarse). Write each `ask` question so that it can be decided on its own, and put the premises, comparison and impact in `--context` (do not point outside the question, as in "Is this OK?"). When choosing one of several candidates, even if you decide by yourself, record it with `ask ... --options "A|B|C"` and `answer --by <yourself>` so that the candidates you did not choose are kept. To change direction, use `reopen <block> --note <reason>`. Everything works with the CLI alone (the screen is for humans to watch). If no human is in the loop, the AI records its decisions with `answer --by <yourself>` and proceeds.\nName each output after a "concrete deliverable" (e.g. `Design doc docs/design.md`, `PR #12`, `Public URL`, `Test results (vitest, 53 tests)`). Avoid abstract names such as "feature set" or "findings", and always attach a file, URL or commit with --artifact when you run done.\nMake sure every box\'s "input \u2192 output" is connected to something (an unconnected box is a hole in the plan. Unconnected inputs are raised to the top-level input node automatically).\nIf several people edit the same boxglow.json, each of them runs `npx boxglow git-setup` once in their own clone (changes are merged automatically per box, and changes to different boxes do not conflict).\nTo manage several repositories with one plan, put boxglow.json in the folder above them and set the environment variable BOXGLOW_FILE to its location in each repository (one project box per repository: `npx boxglow project "name" --repo <path>`).\nInputs are required by default. On the screen, mark an input as "Optional" if work can start without it. "Next candidates" in status lists boxes whose required inputs are ready first (each is marked "ready to start" or "waiting for required inputs").\nDo not write descriptions for inputs (the description of the connected output is used). Write the format and constraints in the output\'s description.\n\n\n### What runs automatically (hooks)\n\n`setup-agent` registers `boxglow hook` in the Claude Code / Codex hooks. After a session starts, resumes or is compacted, the plan\'s resume summary is injected into the context automatically. When you are about to finish a reply while a box started in this session has no handoff (done or checkpoint), you are told to record first and continue (a log entry is a progress note, not a handoff). Editing boxglow.json directly with Edit / Write / apply_patch is blocked (update it through the CLI or MCP). These are a safety net, not a substitute for the steps above: keep recording as instructed.\n\n### Context token and handoff\n\nThe context guard keeps an AI from continuing work on outdated instructions. `setup-agent` turns it on (on other plans, run `npx boxglow guard on`).\nWhile it is on, an AI\'s `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` need `--context-token <context token>`. Commands run by a person (`--actor human`) do not.\n\n```\nnpx boxglow context B12        # read the decisions (including acknowledged answers), input/output contracts and handoff notes. contextToken in the output is the context token\nnpx boxglow start B12 --note "<what you will do>" --context-token <context token>\nnpx boxglow ask B12 "<question>" --options "A|B" --context-token <context token>\n#   -> last line of the output: New context token: <token>\nnpx boxglow done B12 --artifact "<name>=<path>" --context-token <new context token>\n```\n\n- **The context token changes (you must reread)** when a person answers a decision or revises an answer, a person changes the instructions (title, description, input/output contracts), or another AI or a person updates the handoff note. The same applies when this happens on a parent box or an input provider. The old context token is rejected: reread `context`, take the change into account in your work, then retry\n- **The context token does not change** on `start` / `blocked` / `review` / `leave` / `ack`, on changes to progress, status, dates or category, when `check` verifies deliverables, or when boxes are moved on the screen. Keep using the same context token\n- **You can update it yourself**: when your own `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` etc. changes the context, the last line of its output is "New context token: <token>". You already know what you changed, so use it for the next command without rereading. `ask` / `decision` / `answer` / `reopen` run without a context token, but they print the new context token only when you pass the latest one\n- **Read the short form first**: `npx boxglow context <block> --brief` prints everything about the box itself (description, scope, decisions, handoff, inputs/outputs, deliverables) plus the plan description and, for parents and input providers, title, status, decisions (with their context and options; the history of earlier answers is left out) and the outputs that feed the box. The context token is the same as without `--brief`, so pass it to `--context-token` as is. Look at `target.missingInputs` (required inputs that are not ready) and `target.inputs[].sources` (which output of which box, with references to its deliverables) first. `omitted` counts what was left out. If an omitted description, contract or handoff may matter to your work, read without `--brief`, or read `context` of that box\n- **Precondition for starting from the short form**: the description of a parent or input provider that has any scope field set is left out of the short form (counted in `omitted.descriptions`). Set a scope only after moving the constraints written in the description (compatibility, prohibitions, deadlines) into it. On a plan where you cannot tell, or when `omitted.descriptions` is not 0, read once without `--brief` before you start. The short form is a starting point, not a guarantee that nothing else matters\n- Write so that the short form is enough: put the conditions that bind the work in the scope (non-goals / constraints / acceptance / consult) instead of burying them in a description. Only the latest handoff note is kept, so carry the open points, cautions and next steps forward each time you write one. Say where to start looking in the description of the box, in this form (a starting point, not a claim that those files are all there is to read):\n  `Change candidates: <path> \u2014 <why to start there>` / `Related checks: <path or command> \u2014 <what it verifies>`\n- Do not turn the guard off to get past an old context token (an AI needs the latest context token to run `guard off`)\n- With MCP, use `boxglow_context` and the `contextToken` argument of each tool (the new context token is the last line of the tool result)\n- If "Another Boxglow writer holds the file lock" persists after waiting and retrying, show the output of `npx boxglow unlock` (owner and verdict) to a person and ask them to remove it. Never add `--actor human` yourself or delete the lock folder directly\n\n### Readiness, current scope, and fresh resume information\n\n- Read current activity, pending decisions, and unread answers first. Candidates are grouped by current scope / other candidates, then ready / needs detail / waiting for inputs, with the reasons and missing input names. A candidate that needs detail or is waiting is not ready.\n- "Ready" is a mechanical check: the box makes at least one output itself, that output has a planned deliverable (expect), the acceptance criteria are written, and required inputs are in. It does not judge whether the text is specific (`expect = src/`, `acceptance = works` pass). Write them so a third party can follow the target, the work, the result and how it is checked.\n- Four optional scope fields are available: goal, non-goals, acceptance, and consult (when to consult before expanding scope). Read the target and parent scopes at the start of context before starting and finishing. Textual acceptance criteria are not automatically evaluated.\n- Use scope B12 --goal "Goal" --non-goals "Excluded" --acceptance "Checks" --consult "When to ask". scope B12 only reads; none or an empty string clears a field. In the inspector, use the More tab \u2192 Edit work scope. Only populated fields appear in the collapsed scope section.\n- focus B12 prioritizes that box and its descendants; focus reads the selection, and focus none clears it. Other candidates remain in a separate group. Being listed does not authorize expanding scope or publishing.\n- Missing required inputs warn on start by default but still allow the start. Supply --reason "Why starting early is appropriate" to proceed without a warning and save the reason in both activity and the log. Artifact-free done also remains warning-only by default. Existing output artifacts or --artifact count; reference material on the box does not.\n- Only enable strict checks when selected for the plan: policy --start reject --done reject --unprepared reject. Each can return to warn. A recorded start reason overrides the missing-input rejection, but not the needs-detail one (add detail first). The artifact requirement also applies to set --status white. Human operations (UI / --actor human) are never rejected. Do not impersonate a human or weaken policy to bypass rejection.\n- With guard enabled, scope writes, focus selection/clearing, and policy writes require --context-token. These changes print a new token: use it next. Read-only forms need no token.\n- resume hides completed handoff bodies and shows their count. Request resume --include-completed only when history is needed; context / show can still read individual notes.\n- descriptionUpdatedAt dates description changes; statusChangedAt dates status changes; handoffs use their existing at field. Notes predating a status change are marked. Unknown legacy dates stay unknown, and recency does not establish truth.\n- After Done, CLI, inspector, and resume flag descriptions that may still describe an earlier state. Text is never rewritten automatically. Review it, then update with set B12 --note "Current description" (none clears it) or Notes in the UI.\n- MCP: boxglow_scope / boxglow_focus / boxglow_policy, boxglow_claim, expect / self on boxglow_port, reason on boxglow_start, and includeCompleted on boxglow_resume. Pass contextToken for writes.\n- All data fields are optional; schema v5 is unchanged. Old versions (0.4.2 and earlier) do not enforce these checks and drop workflowPolicy / focusBlockId when saving. Align all writers (CLI, serve, web app, bundled extension app) to a supporting build before using these settings. Check build time as well as version.\n\n\n### Sync decisions\n\nAI may only sync already bound projects and inspect comparisons. If sync stops for a conflict or a human choice, summarize the differences and use ask to notify the user. Never resolve conflicts, create a new binding, relink, recover, adopt, restore, or confirm an account. A human must use the UI or explicitly run CLI with --actor human. AI must never add --actor human, including after a chat answer; record the answer and wait for the human to apply the sync choice.\n\nCodex must pass `--actor codex` on every CLI call; Claude Code must pass `--actor claude-code`. Execution markers may not survive a WSL boundary. Give subagents names such as `codex-task`; never impersonate a human.\n\n### Claims for parallel work\n\nWhen claims are enabled for the plan, fix a unique `BOXGLOW_INSTANCE_ID` for each independent CLI session. Do not share it between agents. Read `claims` and `context`, then acquire with `claim` (before adding detail or splitting) or `start` (to run); a claim taken with `claim` carries over to `start` (default block scope, `--scope subtree` for descendants). Keep the token from the successful CLAIM line and pass `--claim-token` on writes. MCP keeps its own instance ID and acquired receipts automatically. Renew with `claim-renew` / `boxglow_claim_renew` every 5 minutes (or within half the lease for shorter leases); checkpoint before handoff. done/leave releases the target claim. On expiry or a generation mismatch, reread context and acquire again. The same actor name does not make another instance yours. Ask a person to change claim settings, force release, or resolve sync conflicts; never impersonate human. Synced copies on different devices are not protected by a distributed lock. See `docs/CLAIMS.md`.\n\nNever use another instance\u2019s ID or receipt, including receipts reconstructed from plan data or claims output. After MCP restarts, the same actor is still a different instance: wait for expiry or ask a person to release it; never take it over automatically.\n\nAutomatically promoted inputs belong to the original box\u2019s scope. Changes to shared input content or other boxes\u2019 layout require claims for all affected boxes. For plan settings such as focus or group, use `context root` \u2192 `claim root` and pass that CLAIM receipt (`start root` also works, but `claim` does not mark it in progress). A block-scoped root claim does not include ordinary boxes and is sufficient for plan settings. A subtree claim on root blocks all parallel work: AI agents must not use it and must consult a person. End it with `leave root`. Context-guard tokens are still required.\n\n---\n\nHuman-only sync operations prevent accidental actions; they are not enforced authorization or OS-level isolation. AI must never identify itself with `--actor human`. Report the comparison and stop reason to the user. MCP and AI-identified CLI output do not provide executable human choice commands.\n\nHuman CLI actions also accept `--actor human:name`; AI must not impersonate a human using either form. The `boxglow sync --help` hint in AI halt output is for humans who inherited an AI environment, not permission for AI to apply their choice.\n';
+var AGENTS_SNIPPET_en_default = '# Instructions for agents using Boxglow (paste into AGENTS.md / CLAUDE.md)\n\nPaste the part between the "---" lines below, as is, into your repository\'s AGENTS.md (Codex) or CLAUDE.md (Claude Code).\nPut boxglow.json at the repository root (`npx boxglow init --name "<project name>"`).\n\n---\n\n## Boxglow (shared plan and progress)\n\n`boxglow.json` is the source of truth for this repository\'s plan and progress. Humans watch this file on the Boxglow screen.\nDo not edit the file directly; always update it with `npx boxglow` commands (this keeps the wiring rules and the history intact).\n\nA block = "a task that turns inputs into an output (deliverable)". It is done (WhiteBox) once the output\'s deliverable is settled.\nStatus: BlackBox (only the output is decided) \u2192 GrayBox (in progress) \u2192 WhiteBox (done).\n\n### What to do every time you work\n\n1. **Read first**: read `npx boxglow resume` (or `npx boxglow status --brief`) for work in progress, pending decisions, unread answers, next candidates, and handoffs for unfinished boxes. To continue a previous session, start from the handoff notes shown there. Check the inputs and outputs of your box with `npx boxglow show <block>`\n2. **Check readiness**: before taking on a box, read `npx boxglow context <block>`. Its `readiness` is the state of preparation: `state: "ready"` means you can start. `"unprepared"` (needs detail) means you add detail first, following the reasons in `unprepared` and the commands in `next`. `"waiting"` means a required input or a branch answer is missing\n3. **Hold, then add detail**: before adding detail or splitting, hold the box with `npx boxglow claim <block>` (this does not start it; on a plan without claims it prints "not needed" and succeeds). Then fill in what is missing:\n   - the output\'s planned deliverable: `npx boxglow port <block> --expect "<output>=file:src/x.ts"` (kind: file / dir / url / doc / note / decision / result; hint: a path or title. The file need not exist yet)\n   - the acceptance criteria: `npx boxglow scope <block> --acceptance "<when it counts as done>"`; the work itself with `--goal`; what the output must respect (performance, quality, size, dimensions, power, ...) with `--constraints`\n   - when you cannot see how to produce the output with a single box, place smaller boxes inside it with `npx boxglow split <block> --spec \'<JSON>\'`. Write expect / acceptance only for the children you will start now; later children need only a title and an output (they stay "needs detail"). Inputs can be omitted if unknown (they automatically become inputs of the level above)\n   - when you do not know which files are involved, do not invent paths: add a box "find the target" with a `note` output and start that\n4. **Record the start**: once ready, read `npx boxglow context <block>` again, then run `npx boxglow start <block> --note "<what you will do>"`. Work on at most 1-2 boxes at a time.\n   The started box is marked "now" (the boxes being worked on right now; any number when several agents or people work; a thick frame and a NOW tag on the canvas). Add another with `npx boxglow now <block>` (`--off` removes one, `now none` clears all); done / leave remove that box. People toggle it with the NOW button on the Status tab\n   On a plan with the context guard on, pass the `contextToken` (context token) from the context output:\n   `npx boxglow start <block> --note "<what you will do>" --context-token <context token>` (see "Context token and handoff" below)\n   Starting a box that still needs detail warns by default (with the reasons and the next commands). On a plan with `policy --unprepared reject` it is refused (`--reason` does not bypass it; human actions are allowed). A parent whose outputs are all made by its children has nothing to run itself: start the child instead\n5. **Record completion**: when the output\'s deliverable exists, run `npx boxglow done <block> --artifact "<name>=<path in the repository>"`. Record the verification in three fixed fields: `--checked` (checks run and their results, e.g. "vitest 53 passed; e2e home 34/34"), `--not-checked` (what was not tried), `--limits` (remaining limits / caveats). For non-code deliverables (documents etc.) write what you confirmed in `--checked`. It stays on the box and shows in context / show.\n   With the guard on, add `--context-token <context token>` (if your previous command printed "New context token: <token>", use that one).\n   An unchanged file already committed to HEAD is recorded as "commit + path + content hash" (nothing is uploaded). Uncommitted or untracked files remain local file references, and `npx boxglow check` turns them into Git references once they are committed; do not create a commit solely to satisfy Boxglow. Use full `npx boxglow status` when you need the entire tree. For PRs and external material, a URL is fine.\n   To attach a deliverable ahead of completion, use `npx boxglow artifact <block> <path>`. Record progress along the way with `npx boxglow set <block> --progress 60`\n6. **When a human decision is needed**: `npx boxglow ask <block> "<question>" --options "A|B"`. Do not proceed with that box until it is answered; move on to another box. A human\'s answer appears under "Answered" in `status`. After reading it, acknowledge it with `npx boxglow ack <block>` (`start` / `done` / `set` etc. on that box also acknowledge it automatically). Until you acknowledge it, it stays on the human\'s screen as "Not read by the AI yet" and the human can still revise the answer. If the answer contains a question back to you, record your own answer too with `ask` and `answer --by <yourself>`\n7. **When you are stuck**: If the cause is a missing input (a deliverable of an earlier box, or material), do not mark the box as blocked. Check its input wires with `npx boxglow show <block>`; if no box produces what is missing, create one outside (upstream) with `npx boxglow add` and wire it to this box\'s input with `npx boxglow connect` (the wire stays in the waiting color, so the diagram shows what the box is waiting for). If a choice between options would let you continue, use `ask`. Record only obstacles outside the plan (an environment that does not work, missing permissions or keys, waiting for an outside reply, a failure with no known cause) with `npx boxglow blocked <block> --note "<what is in the way>"` When a check or evaluation rejects an earlier deliverable, do not wire backwards (it would be a cycle): `npx boxglow sendback <evaluating box> --to <box to redo> --note "<reason>"` sends it back (that box returns to In Progress, its artifacts are kept as rejected, and the reason appears in context).\n8. **Check deliverables**: after moving or renaming files, run `npx boxglow check` (it detects the move and updates the path; if the file cannot be found, it is flagged)\n9. **Keep progress and findings**: `npx boxglow log <block> "<text>"` adds a dated, signed work-log entry to the box (Markdown). People read and write the same log in the Log tab. The handoff note (checkpoint) is overwritten; log entries accumulate\n10. **Before an interruption or a handoff**: before the session ends, the context is compacted, or you hand over to another AI or a person, save a handoff note with `npx boxglow checkpoint <block> --note "Findings; next steps; unresolved questions"` (with the guard on, add `--context-token <context token>`). It stays in the plan even when the chat history is gone, and the next session reads it with `resume` and `context`\n11. **Report**: at the end of your work, summarize `npx boxglow status --brief` and report it\n\n### Structural rules\n\n- **Show an undecided fork as a branch**: when, at planning time, later work (a path) depends on a decision that has not been made, create a branch box with `npx boxglow branch "<title>" --options "A|B" --question "<question>" --context "<background>"`. Each option becomes a path (output); `connect` each one to the first box of that path. Where the paths come together again, add a merge part with `npx boxglow join --title "<title>"`, `connect` the last output of each path to it, and connect its output to the next box (any one path arriving is enough). Once a person answers, the boxes on the paths not chosen are skipped and drop out of progress and next candidates. If a box you already made turns out to be an undecided fork, turn it into a branch with `npx boxglow branch --box <block> --options "A|B" --question "<question>"` (its output becomes the first option\'s path; wires stay). Before the answer, boxes on the paths wait for the branch and starting them warns (record a reason with `--reason`, e.g. for early research)\n- The top level contains only the "input node", the "final deliverable node" and "project boxes". Tasks go inside a project box (the default parent of `add` is the first project box)\n- There is no limit on depth. `split` can be used at any level\n- A box that could be reused in another project (e.g. converting input images to monochrome) can be turned into a template with `npx boxglow export-block <block> --out <name>.boxglow-block.json` and\n  inserted with `npx boxglow import-block <path> --parent <block>`. You may share templates by putting them in the repository\'s `boxglow-blocks/`\n\nWhen there are many top-level inputs, create a group with `npx boxglow group "<group name>"` and sort inputs into it with `npx boxglow group-set <input name> <group name>` (e.g. PCIe spec / DDR spec).\n\n### JSON format for split\n\n```json\n{\n  "blocks": [\n    { "title": "Find the target", "inputs": ["Repro steps"], "outputs": ["Notes"],\n      "expect": "note:the files and code paths involved, evidence, candidate changes, how to check, open questions", "acceptance": "the files and code to change are known and the following boxes can be given expect and acceptance; or the reason they cannot, and the decision needed, is clear",\n      "goal": "reproduce and trace the path; changing product code is out of scope here" },\n    { "title": "Refresh sync state after a retried save", "inputs": ["Notes"], "outputs": ["Fix"],\n      "expect": "file:src/sync/state.ts", "acceptance": "fail one save, retry, and the sync state and actions come back (covered by a test)" },\n    { "title": "Write the release note", "inputs": ["Fix"], "outputs": ["Note"] }\n  ],\n  "connections": [\n    { "from": "parent.Repro steps", "to": "Find the target.Repro steps" },\n    { "from": "Find the target.Notes", "to": "Refresh sync state after a retried save" },\n    { "from": "Refresh sync state after a retried save.Fix", "to": "Write the release note" },\n    { "from": "Write the release note.Note", "to": "parent.Output" }\n  ]\n}\n```\n\n`expect` (planned deliverable: `"kind:hint"` or `{ "kind", "hint" }`), `acceptance` and `goal` go only on the children you will start now.\nA child with just a title and an output, like the third one, stays "needs detail" until its turn; then set them with `port --expect` / `scope --acceptance`.\nOutputs the parent makes itself (integrating the children\'s results, for example) are marked with `"parentMakes": ["<output>"]` (if a child\'s wire also feeds it, readiness reports two makers).\n`"splitBy": "stage"` records in one word how the direct children are divided (stage / deliverable / feature; also `set <block> --split-by`). Siblings should follow the same division and the same level of detail.\n`split` refuses to save only a broken structure (a wire to nothing, a cycle, a malformed expect). Unfinished breakdowns (a single child, a parent output nobody makes yet) are saved and reported as gaps.\nAfter a split and before a start, read `npx boxglow lint <block>`. Fix the "must fix" items (parent outputs with no or two makers, both exclusive paths of one branch required, a box in progress without expect / acceptance, gaps on the box you are checking) before going on.\n"Fill in before starting" items (expect / acceptance of boxes not started yet) are filled when that child\'s turn comes (do not write token entries for later work now).\n"Review" items (a single child, unconnected outputs, token entries, empty branch paths, single-input merges, siblings with the same expect) are for you to judge (the tool never refuses on them). `context` also prints the counts and the top three.\n\n**Content review (meaning cannot be checked by the tool: an AI or a person reads the material, judges, and records the basis)**\n- After a split: read `npx boxglow review-split <parent>` (the parent\'s goal, constraints, acceptance and ports; the children\'s targets, ports, planned deliverables and acceptance; the wiring; a checklist). When reviewed, record it with `npx boxglow split-ok <parent> --note "<basis: what you checked>"`.\n- Before a start: read `npx boxglow review-box <block>` (target, work, planned deliverable, checks, input sources, upstream branch answers) and record with `npx boxglow box-ok <block> --note "<basis>"`.\n- A record says "reviewed, with this basis"; it does not prove validity. When the material changes, `reviews` in `context` becomes `stale` (with what changed and what to check). `stale` does not mean the breakdown is wrong; it means the material changed after the last review. Position, colours, progress and assignees do not make it stale. The breakdown record is not affected by branch answers; the readiness record is.\n- Adding detail to a later child at its turn always makes the parent\'s breakdown record `stale` (the children\'s expect / acceptance are part of the material). Finish that child\'s expect and scope first, then check only the changed child\'s effect on the parent\'s acceptance and nonGoals and on the division among siblings; if it still fits, update it with `split-ok <parent> --note "Checked B181\'s detail: not in the parent\'s nonGoals, no overlap with B182"`. Do not re-review after every port or scope command; several children detailed together can be checked together.\n- It is not a condition for `start` (in default or reject plans). Only needs-detail and missing inputs stop a start.\n\n**Branches and merges for agents**\n- When an `ask` has options and the answer changes the work that follows, add `--branch`: the box becomes a branch with one path (output) per option. `connect` each path to its first box, and put a `join` where the paths come together.\n- The split JSON can make them too: a child with `"branch": { "question": "...", "options": ["A", "B"] }` becomes a branch box (its outputs are the option names), `"join": true` a merge part. Example:\n  `{ "blocks": [{ "title": "Choose auth", "branch": { "question": "Which?", "options": ["Mail", "OAuth"] } }, { "title": "Mail impl", "outputs": ["Auth"] }, { "title": "OAuth impl", "outputs": ["Auth"] }, { "title": "Merge", "join": true }], "connections": [{ "from": "Choose auth.Mail", "to": "Mail impl" }, { "from": "Choose auth.OAuth", "to": "OAuth impl" }, { "from": "Mail impl.Auth", "to": "Merge" }, { "from": "OAuth impl.Auth", "to": "Merge" }, { "from": "Merge.Merge", "to": "parent.Auth" }] }`\n- `lint` reports a box that requires inputs from both exclusive paths of one branch (they never both arrive) as must-fix, and empty paths or single-input merges as review items.\n`parent.<name>` is an input / output of the box being split. `<block>` is a short ID (such as B12; shown in status) or a title.\nA box has one output per thing it makes (when one piece of work produces several things, list them all in outputs; set expect for the second and later ones with `port <block> --expect "<output>=<kind>:<hint>"`). Connected inputs and outputs share one name (renaming either end renames the other). Make the title a short phrase that tells "what is made".\nRecord dates and hours with `npx boxglow set <block> --due 2026-10-15 --start 2026-10-01 --estimate 8 --hours 3.5`.\nGive each box a kind of work (category): `--category design` / build / verify / evaluate / study / research / ui / improve / fix / docs / ops / other (other: when unsure). Set it at add time; to change it, use `npx boxglow set <block> --category verify`.\nThe receiving side of a connection can be just a title (`npx boxglow connect "A.Design doc" "B"` creates an input "Design doc" on B and connects it; boxes in other levels work too, the ports in between are created automatically. In split\'s connections, `to: "B"` also works). Connected inputs and outputs share one name (they are aligned when connected, and renaming either end renames everything on the same wire). To add inputs / outputs to an existing box or rename them, use `npx boxglow port <block> --in <name> --out <name> --remove <name> --rename <old>=<new>` (removing an input also removes the inputs of the boxes that use it; top-level inputs are `port inputs`; withdraw a mistaken question with `npx boxglow unask <block>`) (`project` = the first project box. This also renames the final deliverable). Remove a wire with `npx boxglow disconnect <title.output name> <title.input name>`, and remove a box itself with `npx boxglow remove <block>` (`--force` if it has boxes inside). The MCP tools (`boxglow_status` / `boxglow_start` / `boxglow_done` / `boxglow_ask` etc.; available after registration in your agent; `.mcp.json` is the Claude Code configuration) are another entry point to the same commands, and either way updates the same file. Export the plan as a document with `npx boxglow export --out docs/ROADMAP.md`.\n\n**Share project-wide decisions as policies**: when a box decides something many boxes depend on (technology choice, engine, art style), make that output a policy (`npx boxglow port <block> --policy "<output>"`; scope defaults to the same parent, `--policy-scope all` for the whole plan, `--advisory` to not block). It reaches every box in scope without wires, and the boxes in scope that have not started wait for it until it is decided (work in progress is not stopped). Read `policies` in `context` before working. Exclude unrelated boxes with `--skip-policy "<box>.<output>"`. If a policy changes after a box is done, it appears in `policyChanged` (check it again). Do not wire it to each box.\nIn a new project, first create 3-7 top-level items from the direction (the README or the request), confirm them with a human via `ask`, and then `split` only the item you are about to start (leave later stages coarse). Write each `ask` question so that it can be decided on its own, and put the premises, comparison and impact in `--context` (do not point outside the question, as in "Is this OK?"). When choosing one of several candidates, even if you decide by yourself, record it with `ask ... --options "A|B|C"` and `answer --by <yourself>` so that the candidates you did not choose are kept. To change direction, use `reopen <block> --note <reason>`. Everything works with the CLI alone (the screen is for humans to watch). If no human is in the loop, the AI records its decisions with `answer --by <yourself>` and proceeds.\nName each output after a "concrete deliverable" (e.g. `Design doc docs/design.md`, `PR #12`, `Public URL`, `Test results (vitest, 53 tests)`). Avoid abstract names such as "feature set" or "findings", and always attach a file, URL or commit with --artifact when you run done.\nMake sure every box\'s "input \u2192 output" is connected to something (an unconnected box is a hole in the plan. Unconnected inputs are raised to the top-level input node automatically).\nIf several people edit the same boxglow.json, each of them runs `npx boxglow git-setup` once in their own clone (changes are merged automatically per box, and changes to different boxes do not conflict).\nTo manage several repositories with one plan, put boxglow.json in the folder above them and set the environment variable BOXGLOW_FILE to its location in each repository (one project box per repository: `npx boxglow project "name" --repo <path>`).\nInputs are required by default. Mark an input as optional with `npx boxglow port <block> --optional <input name>` if work can start without it (`--required` turns it back). Describe a port with `--describe "<name>=<description>"`. "Next candidates" in status lists boxes whose required inputs are ready first (each is marked "ready to start" or "waiting for required inputs"). When a top-level plan input (Inputs) has no material (a spec, a scenario or other file or URL), every box that uses it waits. If the material is in the repository, attach it yourself instead of asking a person: `npx boxglow artifact inputs <path or URL> --input <input name>` (MCP: `boxglow_artifact` with block "inputs"). Remove a deliverable or material attached by mistake with `npx boxglow artifact <block|inputs> --remove <title or path>`. When a finished box shows "Policy: check again", check that the work matches the policy; if it does, clear the mark with `npx boxglow ack <block> --policy` (if not, reopen and fix it).\nDo not write descriptions for inputs (the description of the connected output is used). Write the format and constraints in the output\'s description.\n\n\n### What runs automatically (hooks)\n\n`setup-agent` registers `boxglow hook` in the Claude Code / Codex hooks. After a session starts, resumes or is compacted, the plan\'s resume summary is injected into the context automatically. When you are about to finish a reply while a box started in this session has no handoff (done or checkpoint), you are told to record first and continue (a log entry is a progress note, not a handoff). Editing boxglow.json directly with Edit / Write / apply_patch is blocked (update it through the CLI or MCP). These are a safety net, not a substitute for the steps above: keep recording as instructed.\n\n### Context token and handoff\n\nThe context guard keeps an AI from continuing work on outdated instructions. `setup-agent` turns it on (on other plans, run `npx boxglow guard on`).\nWhile it is on, an AI\'s `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` need `--context-token <context token>`. Commands run by a person (`--actor human`) do not.\n\n```\nnpx boxglow context B12        # read the decisions (including acknowledged answers), input/output contracts and handoff notes. contextToken in the output is the context token\nnpx boxglow start B12 --note "<what you will do>" --context-token <context token>\nnpx boxglow ask B12 "<question>" --options "A|B" --context-token <context token>\n#   -> last line of the output: New context token: <token>\nnpx boxglow done B12 --artifact "<name>=<path>" --context-token <new context token>\n```\n\n- **The context token changes (you must reread)** when a person answers a decision or revises an answer, a person changes the instructions (title, description, input/output contracts), or another AI or a person updates the handoff note. The same applies when this happens on a parent box or an input provider. The old context token is rejected: reread `context`, take the change into account in your work, then retry\n- **The context token does not change** on `start` / `blocked` / `review` / `leave` / `ack`, on changes to progress, status, dates or category, when `check` verifies deliverables, or when boxes are moved on the screen. Keep using the same context token\n- **You can update it yourself**: when your own `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` etc. changes the context, the last line of its output is "New context token: <token>". You already know what you changed, so use it for the next command without rereading. `ask` / `decision` / `answer` / `reopen` run without a context token, but they print the new context token only when you pass the latest one\n- **Read the short form first**: `npx boxglow context <block> --brief` prints everything about the box itself (description, scope, decisions, handoff, inputs/outputs, deliverables) plus the plan description and, for parents and input providers, title, status, decisions (with their context and options; the history of earlier answers is left out) and the outputs that feed the box. The context token is the same as without `--brief`, so pass it to `--context-token` as is. Look at `target.missingInputs` (required inputs that are not ready) and `target.inputs[].sources` (which output of which box, with references to its deliverables) first. `omitted` counts what was left out. If an omitted description, contract or handoff may matter to your work, read without `--brief`, or read `context` of that box\n- **Precondition for starting from the short form**: the description of a parent or input provider that has any scope field set is left out of the short form (counted in `omitted.descriptions`). Set a scope only after moving the constraints written in the description (compatibility, prohibitions, deadlines) into it. On a plan where you cannot tell, or when `omitted.descriptions` is not 0, read once without `--brief` before you start. The short form is a starting point, not a guarantee that nothing else matters\n- Write so that the short form is enough: put the conditions that bind the work in the scope (non-goals / constraints / acceptance / consult) instead of burying them in a description. Only the latest handoff note is kept, so carry the open points, cautions and next steps forward each time you write one. Say where to start looking in the description of the box, in this form (a starting point, not a claim that those files are all there is to read):\n  `Change candidates: <path> \u2014 <why to start there>` / `Related checks: <path or command> \u2014 <what it verifies>`\n- Do not turn the guard off to get past an old context token (an AI needs the latest context token to run `guard off`)\n- With MCP, use `boxglow_context` and the `contextToken` argument of each tool (the new context token is the last line of the tool result)\n- If "Another Boxglow writer holds the file lock" persists after waiting and retrying, show the output of `npx boxglow unlock` (owner and verdict) to a person and ask them to remove it. Never add `--actor human` yourself or delete the lock folder directly\n\n### Readiness, current scope, and fresh resume information\n\n- Read current activity, pending decisions, and unread answers first. Candidates are grouped by current scope / other candidates, then ready / needs detail / waiting for inputs, with the reasons and missing input names. A candidate that needs detail or is waiting is not ready.\n- "Ready" is a mechanical check: the box makes at least one output itself, that output has a planned deliverable (expect), the acceptance criteria are written, and required inputs are in. It does not judge whether the text is specific (`expect = src/`, `acceptance = works` pass). Write them so a third party can follow the target, the work, the result and how it is checked.\n- Four optional scope fields are available: goal, non-goals, acceptance, and consult (when to consult before expanding scope). Read the target and parent scopes at the start of context before starting and finishing. Textual acceptance criteria are not automatically evaluated.\n- Use scope B12 --goal "Goal" --non-goals "Excluded" --acceptance "Checks" --consult "When to ask". scope B12 only reads; none or an empty string clears a field. In the inspector, use the More tab \u2192 Edit work scope. Only populated fields appear in the collapsed scope section.\n- focus B12 prioritizes that box and its descendants; focus reads the selection, and focus none clears it. Other candidates remain in a separate group. Being listed does not authorize expanding scope or publishing.\n- Missing required inputs warn on start by default but still allow the start. Supply --reason "Why starting early is appropriate" to proceed without a warning and save the reason in both activity and the log. Artifact-free done also remains warning-only by default. Existing output artifacts or --artifact count; reference material on the box does not.\n- Only enable strict checks when selected for the plan: policy --start reject --done reject --unprepared reject. Each can return to warn. A recorded start reason overrides the missing-input rejection, but not the needs-detail one (add detail first). The artifact requirement also applies to set --status white. Human operations (UI / --actor human) are never rejected. Do not impersonate a human or weaken policy to bypass rejection.\n- With guard enabled, scope writes, focus selection/clearing, and policy writes require --context-token. These changes print a new token: use it next. Read-only forms need no token.\n- resume hides completed handoff bodies and shows their count. Request resume --include-completed only when history is needed; context / show can still read individual notes.\n- descriptionUpdatedAt dates description changes; statusChangedAt dates status changes; handoffs use their existing at field. Notes predating a status change are marked. Unknown legacy dates stay unknown, and recency does not establish truth.\n- After Done, CLI, inspector, and resume flag descriptions that may still describe an earlier state. Text is never rewritten automatically. Review it, then update with set B12 --note "Current description" (none clears it) or Notes in the UI.\n- MCP: boxglow_scope / boxglow_focus / boxglow_policy, boxglow_claim, expect / self on boxglow_port, reason on boxglow_start, and includeCompleted on boxglow_resume. Pass contextToken for writes.\n- All data fields are optional; schema v5 is unchanged. Old versions (0.4.2 and earlier) do not enforce these checks and drop workflowPolicy / focusBlockId when saving. Align all writers (CLI, serve, web app, bundled extension app) to a supporting build before using these settings. Check build time as well as version.\n\n\n### Sync decisions\n\nAI may only sync already bound projects and inspect comparisons. If sync stops for a conflict or a human choice, summarize the differences and use ask to notify the user. Never resolve conflicts, create a new binding, relink, recover, adopt, restore, or confirm an account. A human must use the UI or explicitly run CLI with --actor human. AI must never add --actor human, including after a chat answer; record the answer and wait for the human to apply the sync choice.\n\nCodex must pass `--actor codex` on every CLI call; Claude Code must pass `--actor claude-code`. Execution markers may not survive a WSL boundary. Give subagents names such as `codex-task`; never impersonate a human.\n\n### Claims for parallel work\n\nWhen claims are enabled for the plan, fix a unique `BOXGLOW_INSTANCE_ID` for each independent CLI session. Do not share it between agents. Read `claims` and `context`, then acquire with `claim` (before adding detail or splitting) or `start` (to run); a claim taken with `claim` carries over to `start` (default block scope, `--scope subtree` for descendants). Keep the token from the successful CLAIM line and pass `--claim-token` on writes. MCP keeps its own instance ID and acquired receipts automatically. Renew with `claim-renew` / `boxglow_claim_renew` every 5 minutes (or within half the lease for shorter leases); checkpoint before handoff. done/leave releases the target claim. On expiry or a generation mismatch, reread context and acquire again. The same actor name does not make another instance yours. Ask a person to change claim settings, force release, or resolve sync conflicts; never impersonate human. Synced copies on different devices are not protected by a distributed lock. See `docs/CLAIMS.md`.\n\nNever use another instance\u2019s ID or receipt, including receipts reconstructed from plan data or claims output. After MCP restarts, the same actor is still a different instance: wait for expiry or ask a person to release it; never take it over automatically.\n\nAutomatically promoted inputs belong to the original box\u2019s scope. Changes to shared input content or other boxes\u2019 layout require claims for all affected boxes. For plan settings such as focus or group, use `context root` \u2192 `claim root` and pass that CLAIM receipt (`start root` also works, but `claim` does not mark it in progress). A block-scoped root claim does not include ordinary boxes and is sufficient for plan settings. A subtree claim on root blocks all parallel work: AI agents must not use it and must consult a person. End it with `leave root`. Context-guard tokens are still required.\n\n---\n\nHuman-only sync operations prevent accidental actions; they are not enforced authorization or OS-level isolation. AI must never identify itself with `--actor human`. Report the comparison and stop reason to the user. MCP and AI-identified CLI output do not provide executable human choice commands.\n\nHuman CLI actions also accept `--actor human:name`; AI must not impersonate a human using either form. The `boxglow sync --help` hint in AI halt output is for humans who inherited an AI environment, not permission for AI to apply their choice.\n';
 
 // .claude/skills/boxglow/SKILL.md
-var SKILL_default = '---\nname: boxglow\ndescription: Boxglow (boxglow.json) \u3067\u8A08\u753B\u3068\u9032\u6357\u3092\u4EBA\u9593\u3068\u5171\u6709\u3059\u308B\u3002\u4F5C\u696D\u306E\u958B\u59CB\u30FB\u5206\u89E3\u30FB\u5B8C\u4E86\u30FB\u5224\u65AD\u5F85\u3061\u3092 npx boxglow \u3067\u8A18\u9332\u3059\u308B\u3002\u300C\u9032\u6357\u3092 Boxglow \u306B\u8A18\u9332\u3057\u3066\u300D\u300Cboxglow \u3067\u72B6\u6CC1\u3092\u898B\u3066\u300D\u300C/boxglow\u300D\u3067\u4F7F\u7528\u3002\n---\n\n# Boxglow \u3067\u8A08\u753B\u3068\u9032\u6357\u3092\u5171\u6709\u3059\u308B\n\n\u30EA\u30DD\u30B8\u30C8\u30EA\u76F4\u4E0B\u306E `boxglow.json` \u304C\u8A08\u753B\u306E\u6B63\u672C\u3002\u4EBA\u9593\u306F Boxglow \u306E\u753B\u9762 (https://boxglow.app/ \u3067\u300Cboxglow.json \u3092\u958B\u304F\u300D) \u3067\u898B\u3066\u3044\u308B\u3002\n\u76F4\u63A5\u7DE8\u96C6\u305B\u305A `npx boxglow` \u3067\u66F4\u65B0\u3059\u308B\u3002\n\n## \u6700\u521D\u306E\u8A08\u753B\u3065\u304F\u308A (\u65B0\u3057\u3044\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u3068\u304D)\n\n1. \u65B9\u91DD (README\u3001\u4F9D\u983C\u6587\u3001\u8981\u4EF6\u30E1\u30E2) \u3092\u8AAD\u307F\u3001`npx boxglow init --name "<\u540D\u524D>"` \u306E\u3042\u3068\u3001\u6700\u4E0A\u4F4D\u306B\u5927\u9805\u76EE (3\u301C7 \u500B) \u3092 `add` \u3067\u7F6E\u304F\u3002\n   \u5404\u5927\u9805\u76EE\u306B\u306F\u300C\u5165\u529B (\u4F55\u3092\u4F7F\u3046\u304B)\u300D\u3068\u300C\u51FA\u529B (\u5177\u4F53\u7684\u306A\u6210\u679C\u7269: \u30D5\u30A1\u30A4\u30EB\u30FBURL\u30FBPR)\u300D\u3092\u5FC5\u305A\u66F8\u304D\u3001\u6700\u7D42\u6210\u679C\u7269\u307E\u3067\u7DDA\u3067\u3064\u306A\u3050 (`connect`)\n2. \u4F5C\u3063\u305F\u3089 `npx boxglow ask <\u6700\u521D\u306E\u5927\u9805\u76EE> "\u3053\u306E\u5927\u9805\u76EE\u306E\u5206\u3051\u65B9\u3067\u3088\u3044\u3067\u3059\u304B?" --options "\u3088\u3044|\u76F4\u3057\u305F\u3044"` \u3067\u4EBA\u306E\u78BA\u8A8D\u3092\u53D6\u308B\u3002\n   \u4EBA\u306F\u753B\u9762\u3067\u3082\u3001`npx boxglow answer <block> "<\u56DE\u7B54>"` \u3067\u3082\u3001\u30C1\u30E3\u30C3\u30C8\u3067\u3082\u7B54\u3048\u3089\u308C\u308B\u3002\u30C1\u30E3\u30C3\u30C8\u3067\u7B54\u3048\u304C\u8FD4\u3063\u305F\u3089 AI \u304C `answer --by human` \u3067\u8A18\u9332\u3059\u308B\u3002\n   \u4EBA\u304C\u753B\u9762\u3092\u4F7F\u308F\u306A\u3044\u904B\u7528 (AI \u3060\u3051\u3067\u9032\u3081\u308B\u6307\u793A\u304C\u3042\u308B\u3068\u304D) \u306F\u3001AI \u81EA\u8EAB\u304C `answer --by claude-code "<\u5224\u65AD\u3068\u7406\u7531>"` \u3067\u8A18\u9332\u3057\u3066\u5148\u3078\u9032\u3080\u3002\u5224\u65AD\u306E\u8A18\u9332\u3092\u6B8B\u3059\u3053\u3068\u304C\u76EE\u7684\u3067\u3001\u753B\u9762\u306F\u5FC5\u9808\u3067\u306F\u306A\u3044\n3. \u7740\u624B\u3059\u308B\u5927\u9805\u76EE\u3060\u3051\u3092 `split` \u3067\u5206\u89E3\u3059\u308B (\u5148\u306E\u6BB5\u968E\u306F\u7C97\u3044\u307E\u307E\u3002\u9032\u3081\u306A\u304C\u3089\u7D30\u304B\u304F\u3059\u308B)\n\n## \u624B\u9806\n\n1. `npx boxglow resume` (\u307E\u305F\u306F `npx boxglow status --brief`) \u3092\u8AAD\u3080\u3002\u4F5C\u696D\u4E2D\u306E\u30DC\u30C3\u30AF\u30B9\u3001\u5224\u65AD\u5F85\u3061\u3001AI \u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u3001\u6B21\u306E\u5019\u88DC\u3001\u672A\u5B8C\u4E86\u306E\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u628A\u63E1\u3059\u308B\u3002\u5168\u968E\u5C64\u304C\u8981\u308B\u3068\u304D\u306F `npx boxglow status`\n2. \u62C5\u5F53\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u3092\u6C7A\u3081\u305F\u3089 `npx boxglow context <block>` \u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E `readiness.state` \u304C `ready` \u306A\u3089\u7740\u624B\u3067\u304D\u308B\u3002`unprepared` (\u8981\u5177\u4F53\u5316) \u306A\u3089 `unprepared` \u306E\u7406\u7531\u3068 `next` \u306E\u6B21\u306E\u4E00\u624B\u306B\u5F93\u3063\u3066\u5148\u306B\u5177\u4F53\u5316\u3059\u308B\u3002`waiting` \u306F\u5FC5\u9808\u306E\u5165\u529B\u304B\u5206\u5C90\u306E\u7B54\u3048\u3092\u5F85\u3063\u3066\u3044\u308B\n3. \u5177\u4F53\u5316\u3084\u5206\u89E3\u306E\u524D\u306B `npx boxglow claim <block>` \u3067\u53D7\u3051\u6301\u3061\u3060\u3051\u3092\u53D6\u308B (\u5B9F\u884C\u4E2D\u306B\u306F\u306A\u3089\u306A\u3044\u3002\u53D7\u3051\u6301\u3061\u5236\u5FA1\u304C\u7121\u52B9\u306A\u8A08\u753B\u3067\u306F\u300C\u53D6\u5F97\u4E0D\u8981\u300D\u3067\u6B63\u5E38\u7D42\u4E86\u3059\u308B)\u3002\u4E0D\u8DB3\u3092\u57CB\u3081\u308B:\n   \u51FA\u529B\u306E\u4E88\u5B9A\u6210\u679C\u7269 `npx boxglow port <block> --expect "<\u51FA\u529B\u540D>=file:src/x.ts"` (kind \u306F file / dir / url / doc / note / decision / result\u3002\u307E\u3060\u7121\u3044\u30D5\u30A1\u30A4\u30EB\u3067\u3088\u3044)\u3001\u5B8C\u4E86\u6761\u4EF6 `npx boxglow scope <block> --acceptance "<\u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6>"`\u3002\n   \u5927\u304D\u3044\u30DC\u30C3\u30AF\u30B9\u306F `npx boxglow split <block> --spec \'<JSON>\'` \u3067\u5206\u89E3\u3059\u308B (\u5F62\u5F0F\u306F `npx boxglow help`)\u3002\u4ECA\u56DE\u7740\u624B\u3059\u308B\u5B50\u3060\u3051 expect / acceptance \u3092\u66F8\u304D\u3001\u5148\u306E\u5B50\u306F\u984C\u540D\u3068\u51FA\u529B\u3060\u3051\u3067\u3088\u3044\u3002\n   \u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u304C\u5206\u304B\u3089\u306A\u3044\u3068\u304D\u306F\u3001\u67B6\u7A7A\u306E\u30D1\u30B9\u3092\u66F8\u304B\u305A\u300C\u5BFE\u8C61\u3092\u7279\u5B9A\u3059\u308B\u8ABF\u67FB\u300D\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u51FA\u529B `note` \u3067\u4F5C\u3063\u3066\u59CB\u3081\u308B\u3002\n   \u5206\u89E3\u306E\u5F8C\u306F `npx boxglow lint <block>` \u3092\u8AAD\u307F\u3001\u300C\u5FC5\u305A\u76F4\u3059\u300D\u3092\u76F4\u3057\u3066\u304B\u3089\u9032\u3080 (\u300C\u898B\u76F4\u3057\u5019\u88DC\u300D\u306F\u5185\u5BB9\u3092\u898B\u3066\u5224\u65AD)\u3002\u76F4\u4E0B\u306E\u5B50\u306E\u5206\u3051\u65B9\u306F `"splitBy": "\u5DE5\u7A0B"` (\u307E\u305F\u306F `set --split-by`) \u3067\u4E00\u8A9E\u6B8B\u3059\u3002\n   \u5185\u5BB9\u306E\u30EC\u30D3\u30E5\u30FC: `review-split <\u89AA>` \u306E\u6750\u6599\u3068\u30C1\u30A7\u30C3\u30AF\u9805\u76EE\u3092\u8AAD\u3093\u3067 `split-ok <\u89AA> --note "<\u6839\u62E0>"`\u3001\u7740\u624B\u306E\u524D\u306F `review-box <block>` \u2192 `box-ok <block> --note "<\u6839\u62E0>"` (\u6750\u6599\u304C\u5909\u308F\u308B\u3068 context \u306E reviews \u304C stale \u306B\u306A\u308B)\u3002\n   \u7B54\u3048\u3067\u5F8C\u306E\u4F5C\u696D\u304C\u5206\u304B\u308C\u308B\u554F\u3044\u306F `ask ... --options "A|B" --branch` \u3067\u5206\u5C90\u306B\u3059\u308B (split \u306E JSON \u3067\u3082 `"branch": { question, options }` / `"join": true`)\n4. \u6E96\u5099\u304C\u3067\u304D\u305F\u3089 `npx boxglow context <block>` \u3092\u8AAD\u307F\u76F4\u3057\u3001`npx boxglow start <block> --note "<\u4F55\u3092\u3059\u308B\u304B>"`\u3002\n   \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u304C\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001\u51FA\u529B\u306E `contextToken` (\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3) \u3092 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3067\u4ED8\u3051\u308B\u3002\n   \u8981\u5177\u4F53\u5316\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u306E start \u306F\u65E2\u5B9A\u3067\u306F\u8B66\u544A\u3001`policy --unprepared reject` \u306E\u8A08\u753B\u3067\u306F\u958B\u59CB\u3067\u304D\u306A\u3044 (`--reason` \u3067\u306F\u901A\u308C\u306A\u3044)\u3002\u51FA\u529B\u3092\u5B50\u306B\u4EFB\u305B\u304D\u308A\u306E\u89AA\u306F\u5B9F\u884C\u3059\u308B\u3082\u306E\u304C\u7121\u3044\u306E\u3067\u3001\u5B50\u3092 start \u3059\u308B\n5. \u6210\u679C\u7269\u304C\u3067\u304D\u305F\u3089 `npx boxglow done <block> --artifact "<\u540D\u524D>=<URL \u307E\u305F\u306F\u30D1\u30B9>" --checked "<\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C>"` (\u691C\u67FB\u7D50\u679C\u306F `--checked` \u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C / `--not-checked` \u8A66\u3057\u3066\u3044\u306A\u3044\u3053\u3068 / `--limits` \u6B8B\u308B\u5236\u9650 \u306E 3 \u3064\u3067\u6B8B\u3059\u3002\u30B3\u30FC\u30C9\u4EE5\u5916\u306E\u6210\u679C\u7269\u306F\u300C\u78BA\u8A8D\u3057\u305F\u3053\u3068\u300D\u3092\u66F8\u304F\u3002guard \u304C\u6709\u52B9\u306A\u3089 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3092\u4ED8\u3051\u308B\u3002\u76F4\u524D\u306E\u81EA\u5206\u306E\u64CD\u4F5C\u306E\u51FA\u529B\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u3066\u3044\u308C\u3070\u3001\u305D\u308C\u3092\u4F7F\u3046)\n6. \u4EBA\u9593\u306E\u5224\u65AD\u304C\u8981\u308B\u3068\u304D\u306F `npx boxglow ask <block> "<\u8CEA\u554F>" --options "A|B"` \u3057\u3066\u4ED6\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u79FB\u308B\n7. \u8A70\u307E\u3063\u305F\u3089: \u5165\u529B (\u524D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u6210\u679C\u7269\u30FB\u8CC7\u6599) \u304C\u8DB3\u308A\u306A\u3044\u3053\u3068\u304C\u539F\u56E0\u306A\u3089\u3001\u8A70\u307E\u308A\u306B\u3057\u306A\u3044\u3002`npx boxglow show <block>` \u3067\u5165\u529B\u306E\u914D\u7DDA\u3092\u78BA\u304B\u3081\u3001\u8DB3\u308A\u306A\u3044\u3082\u306E\u3092\u4F5C\u308B\u30DC\u30C3\u30AF\u30B9\u304C\u7121\u3051\u308C\u3070 `npx boxglow add` \u3067\u5916 (\u4E0A\u6D41) \u306B\u4F5C\u308A\u3001`npx boxglow connect` \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5165\u529B\u306B\u3064\u306A\u3050 (\u914D\u7DDA\u304C\u300C\u5F85\u3061\u300D\u306E\u8272\u3067\u6B8B\u308A\u3001\u4F55\u3092\u5F85\u3063\u3066\u3044\u308B\u304B\u304C\u56F3\u3067\u898B\u3048\u308B)\u3002\u9078\u629E\u80A2\u304B\u3089\u9078\u3093\u3067\u3082\u3089\u3048\u3070\u9032\u3081\u308B\u306A\u3089 `ask`\u3002\u305D\u308C\u4EE5\u5916\u306E\u3001\u8A08\u753B\u306E\u5916\u306B\u3042\u308B\u969C\u5BB3 (\u74B0\u5883\u304C\u52D5\u304B\u306A\u3044\u3001\u6A29\u9650\u3084\u30AD\u30FC\u304C\u7121\u3044\u3001\u5916\u90E8\u306E\u8FD4\u4E8B\u5F85\u3061\u3001\u539F\u56E0\u306E\u5206\u304B\u3089\u306A\u3044\u5931\u6557) \u3060\u3051\u3092 `npx boxglow blocked <block> --note "<\u56F0\u3063\u3066\u3044\u308B\u3053\u3068>"` \u3067\u8A18\u9332\u3059\u308B\n8. \u4E2D\u65AD\u30FB\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306E\u5727\u7E2E\u30FB\u5F15\u304D\u7D99\u304E\u306E\u524D\u306B `npx boxglow checkpoint <block> --note "\u5206\u304B\u3063\u305F\u3053\u3068; \u6B21\u306B\u3059\u308B\u3053\u3068; \u672A\u89E3\u6C7A\u306E\u3053\u3068"` \u3067\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u6B8B\u3059\n9. \u6700\u5F8C\u306B `npx boxglow status --brief` \u3092\u8981\u7D04\u3057\u3066\u5831\u544A\u3059\u308B\n\n## \u7D04\u675F\n\n- **\u307E\u3060\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u306F\u5206\u5C90\u3067\u8868\u3059**: \u8A08\u753B\u3092\u4F5C\u308B\u6642\u70B9\u3067\u3001\u5224\u65AD\u6B21\u7B2C\u3067\u5F8C\u306E\u4F5C\u696D (\u9053) \u304C\u5909\u308F\u308B\u3068\u304D\u306F `npx boxglow branch "<\u984C\u540D>" --options "A|B" --question "<\u554F\u3044>" --context "<\u5224\u65AD\u6750\u6599>"` \u3067\u5206\u5C90\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u4F5C\u308B\u3002\u9078\u629E\u80A2\u3054\u3068\u306B\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u308B\u306E\u3067\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u521D\u306E\u30DC\u30C3\u30AF\u30B9\u3078 `connect` \u3059\u308B\u3002\u9053\u304C\u5F8C\u3067 1 \u3064\u306B\u307E\u3068\u307E\u308B\u3068\u3053\u308D\u306B\u306F `npx boxglow join --title "<\u984C\u540D>"` \u3067\u5408\u6D41\u306E\u90E8\u54C1\u3092\u7F6E\u304D\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u5F8C\u306E\u51FA\u529B\u3092\u3053\u306E\u90E8\u54C1\u3078 `connect` \u3057\u3001\u90E8\u54C1\u306E\u51FA\u529B\u3092\u5148\u306E\u7BB1\u3078\u3064\u306A\u3050 (\u3069\u308C\u304B 1 \u3064\u306E\u9053\u304C\u5C4A\u3051\u3070\u5148\u3078\u9032\u3080)\u3002\u4EBA\u304C\u7B54\u3048\u308B\u3068\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u9053\u306E\u5148\u306F\u300C\u898B\u9001\u308A\u300D\u306B\u306A\u308A\u3001\u9032\u6357\u3068\u6B21\u306E\u5019\u88DC\u304B\u3089\u5916\u308C\u308B\u3002\u3059\u3067\u306B\u4F5C\u3063\u305F\u30DC\u30C3\u30AF\u30B9\u304C\u5B9F\u306F\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u3060\u3068\u5206\u304B\u3063\u305F\u3089\u3001`npx boxglow branch --box <block> --options "A|B" --question "<\u554F\u3044>"` \u3067\u5206\u5C90\u306B\u5909\u3048\u308B (\u4ECA\u306E\u51FA\u529B\u304C 1 \u3064\u76EE\u306E\u9078\u629E\u80A2\u306E\u9053\u306B\u306A\u308A\u3001\u7DDA\u306F\u6B8B\u308B)\u3002\u7B54\u3048\u304C\u51FA\u308B\u524D\u306E\u9053\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u300C\u5206\u5C90\u5F85\u3061\u300D\u3067\u3001\u7740\u624B\u3059\u308B\u3068\u8B66\u544A\u3055\u308C\u308B (\u5148\u306B\u4E0B\u8ABF\u3079\u3059\u308B\u306A\u3069\u7406\u7531\u304C\u3042\u308C\u3070 `--reason` \u3067\u8A18\u9332\u3059\u308B)\n- `ask` \u306E\u8CEA\u554F\u306F\u3001\u305D\u308C\u3060\u3051\u3067\u5224\u65AD\u3067\u304D\u308B\u3088\u3046\u306B\u66F8\u304F\u3002\u300C\u3053\u308C\u3067\u3088\u3044\u3067\u3059\u304B\u300D\u300C\u4E0A\u8A18\u306E\u6848\u300D\u306E\u3088\u3046\u306B\u5916\u3092\u6307\u3055\u305A\u3001\u524D\u63D0\u30FB\u6BD4\u8F03\u30FB\u5F71\u97FF\u3092 `--context` \u306B\u66F8\u304F (\u4EBA\u306F\u4E00\u89A7\u306E\u4E2D\u306E\u8CEA\u554F\u3060\u3051\u3092\u8AAD\u3093\u3067\u7B54\u3048\u308B)\n- \u5019\u88DC\u304B\u3089 1 \u3064\u3092\u9078\u3076\u5834\u9762 (\u65B9\u5F0F\u30FB\u30E9\u30A4\u30D6\u30E9\u30EA\u30FB\u8A2D\u8A08\u306E\u9078\u629E) \u3067\u306F\u3001AI \u304C\u81EA\u5206\u3067\u6C7A\u3081\u308B\u3068\u304D\u3082 `ask <block> "<\u554F\u3044>" --options "A|B|C"` \u2192 `answer --by claude-code "<\u9078\u3093\u3060\u3082\u306E>\u3002\u7406\u7531: ..."` \u306E\u5F62\u3067\u8A18\u9332\u3057\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u5019\u88DC\u3092\u30DC\u30C3\u30AF\u30B9\u306B\u6B8B\u3059 (\u65B9\u91DD\u8EE2\u63DB\u306E\u3068\u304D\u306B\u623B\u308C\u308B)\n- \u65B9\u91DD\u8EE2\u63DB\u306F `reopen <block> --note "<\u7406\u7531>"` \u3067\u524D\u306E\u7B54\u3048\u3092\u5C65\u6B74\u306B\u6B8B\u3057\u3066\u9078\u3073\u76F4\u3059 (\u5019\u88DC\u306F\u6D88\u3055\u306A\u3044)\n\n- \u540C\u6642\u306B\u4F5C\u696D\u4E2D\u306B\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u306F 1\u301C2 \u500B\u307E\u3067\n- \u6210\u679C\u7269 (artifact) \u306F\u5F8C\u304B\u3089\u4EBA\u304C\u958B\u3051\u308B\u3082\u306E (\u30B3\u30DF\u30C3\u30C8\u3001PR\u3001\u30D5\u30A1\u30A4\u30EB\u306E\u30D1\u30B9) \u306B\u3059\u308B\n- \u51FA\u529B\u306F\u5177\u4F53\u7684\u306A\u6210\u679C\u7269\u306E\u540D\u524D\u306B\u3059\u308B (\u30D5\u30A1\u30A4\u30EB\u30FBPR\u30FBURL\u30FB\u30C6\u30B9\u30C8\u7D50\u679C)\u3002\u62BD\u8C61\u7684\u306A\u540D\u524D (\u6A5F\u80FD\u4E00\u5F0F\u3001\u6240\u898B) \u306F\u907F\u3051\u308B\u30021 \u3064\u306E\u4F5C\u696D\u3067\u8907\u6570\u306E\u7269\u304C\u3067\u304D\u308B\u306A\u3089\u51FA\u529B\u3092\u5206\u3051\u308B (`port <block> --out "<\u540D\u524D>"` \u3067\u8DB3\u3059)\n- \u7D50\u7DDA\u306E\u53D7\u3051\u5074\u306F\u984C\u540D\u3060\u3051\u3067\u3088\u3044 (`connect "A.\u8A2D\u8A08\u66F8" "B"` \u3067 B \u306B\u5165\u529B\u300C\u8A2D\u8A08\u66F8\u300D\u304C\u4F5C\u3089\u308C\u308B)\u3002\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306F 1 \u3064\u306E\u540D\u524D (\u3069\u3061\u3089\u5074\u3067\u5909\u3048\u3066\u3082\u3001\u3064\u306A\u304C\u308B\u5148\u3082\u540C\u3058\u540D\u524D\u306B\u306A\u308B)\n- \u30DC\u30C3\u30AF\u30B9\u306F\u5FC5\u305A\u300C\u5165\u529B \u2192 \u51FA\u529B\u300D\u3067\u3064\u306A\u3050\u3002\u8DB3\u308A\u306A\u3044\u5165\u51FA\u529B\u306F `port`\u3001\u5916\u3059\u306E\u306F `disconnect`\u3001\u30DC\u30C3\u30AF\u30B9\u305D\u306E\u3082\u306E\u3092\u6D88\u3059\u306E\u306F `remove`\u3002\u6587\u66F8\u5316\u306F `export --out docs/ROADMAP.md`\n- \u30DC\u30C3\u30AF\u30B9\u3092 add \u3059\u308B\u3068\u304D\u306F\u4ED5\u4E8B\u306E\u7A2E\u985E\u3092 `--category` \u3067\u4ED8\u3051\u308B (design \u8A2D\u8A08 / build \u5B9F\u88C5 / verify \u691C\u8A3C / evaluate \u8A55\u4FA1 / study \u691C\u8A0E / research \u8ABF\u67FB / ui \u30C7\u30B6\u30A4\u30F3 / improve \u6539\u5584 / fix \u8AB2\u984C\u89E3\u6C7A / docs \u6587\u66F8 / ops \u904B\u7528 / other \u305D\u306E\u4ED6)\u3002\u753B\u9762\u3067\u306F\u8272\u306E\u5E2F\u3068\u672D\u306B\u306A\u308B\n- boxglow.json \u304C\u307E\u3060\u7121\u3051\u308C\u3070 `npx boxglow init --name "<\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D>"` \u3067\u4F5C\u308A\u3001\u6700\u7D42\u6210\u679C\u7269\u3068\u6700\u4E0A\u4F4D\u306E\u30DC\u30C3\u30AF\u30B9\u3092 `add` \u3067\u7F6E\u304F\n\n## \u81EA\u52D5\u3067\u52D5\u304F\u4ED5\u7D44\u307F (hooks)\n\n`setup-agent` \u304C Claude Code / Codex \u306E hooks \u306B `boxglow hook` \u3092\u767B\u9332\u3057\u3066\u3044\u308B\u3002\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u958B\u59CB\u30FB\u518D\u958B\u30FB\u5727\u7E2E\u306E\u5F8C\u306B\u8A08\u753B\u306E\u518D\u958B\u306E\u6982\u8981 (resume) \u304C\u6587\u8108\u306B\u5165\u308B\u3002\u5FDC\u7B54\u3092\u7D42\u3048\u308B\u3068\u304D\u3001\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067 start \u3057\u305F\u7BB1\u306B\u5F15\u304D\u7D99\u304E (done \u304B checkpoint) \u304C\u7121\u3051\u308C\u3070\u300C\u8A18\u9332\u3057\u3066\u304B\u3089\u7D42\u3048\u308B\u300D\u3088\u3046\u7D9A\u884C\u304C\u6307\u793A\u3055\u308C\u308B (log \u306F\u9032\u6357\u306E\u30E1\u30E2\u3067\u3001\u5F15\u304D\u7D99\u304E\u306E\u4EE3\u308F\u308A\u306B\u306A\u3089\u306A\u3044)\u3002boxglow.json \u3092\u76F4\u63A5\u66F8\u304D\u63DB\u3048\u308B\u64CD\u4F5C (Edit / Write / apply_patch) \u306F\u6B62\u3081\u3089\u308C\u308B\u3002\u3053\u308C\u306F\u5FD8\u308C\u305F\u3068\u304D\u306E\u4FDD\u967A\u3067\u3001\u4E0A\u306E\u624B\u9806\u3069\u304A\u308A\u306B\u81EA\u5206\u3067\u8A18\u9332\u3059\u308B\u3002\n\u5206\u89E3\u3084\u7740\u624B\u6E96\u5099\u306E\u30EC\u30D3\u30E5\u30FC\u306F\u3001\u30B5\u30D6\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 `boxglow-review` \u306B\u4EFB\u305B\u3089\u308C\u308B (review-split / review-box \u306E\u6750\u6599\u3092\u8AAD\u3093\u3067\u8A55\u4FA1\u3068\u6839\u62E0\u3092\u8FD4\u3059\u3002split-ok / box-ok \u306E\u8A18\u9332\u306F\u3001\u8FD4\u3063\u3066\u304D\u305F\u6839\u62E0\u3067\u89AA\u3067\u3042\u308B\u81EA\u5206\u304C\u884C\u3046)\u3002\n\n## \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3068\u5F15\u304D\u7D99\u304E\n\n\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u306F\u3001AI \u304C\u53E4\u3044\u6307\u793A\u306E\u307E\u307E\u4F5C\u696D\u3092\u9032\u3081\u308B\u306E\u3092\u9632\u3050\u4ED5\u7D44\u307F\u3002`setup-agent` \u304C\u6709\u52B9\u306B\u3059\u308B (\u305D\u308C\u4EE5\u5916\u306E\u8A08\u753B\u3067\u306F `npx boxglow guard on`)\u3002\n\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001AI \u306E `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` \u306B `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u304C\u8981\u308B\u3002\u4EBA\u306E\u64CD\u4F5C (`--actor human`) \u306B\u306F\u8981\u6C42\u3055\u308C\u306A\u3044\u3002\n\n```\nnpx boxglow context B12        # \u5224\u65AD (\u5F15\u304D\u53D6\u308A\u6E08\u307F\u306E\u56DE\u7B54\u3092\u542B\u3080)\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6\u30FB\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E contextToken \u304C\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\nnpx boxglow start B12 --note "<\u4F55\u3092\u3059\u308B\u304B>" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\nnpx boxglow ask B12 "<\u8CEA\u554F>" --options "A|B" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n#   \u2192 \u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C: \u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\nnpx boxglow done B12 --artifact "<\u540D\u524D>=<\u30D1\u30B9>" --context-token <\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n```\n\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u308B\u5834\u5408 (\u8AAD\u307F\u76F4\u3057\u304C\u8981\u308B)**: \u4EBA\u304C\u56DE\u7B54\u3057\u305F\u30FB\u56DE\u7B54\u3092\u76F4\u3057\u305F\u3001\u4EBA\u304C\u6307\u793A (\u984C\u540D\u30FB\u8AAC\u660E\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6) \u3092\u5909\u3048\u305F\u3001\u4ED6\u306E AI \u3084\u4EBA\u304C\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u66F4\u65B0\u3057\u305F\u3002\u89AA\u3084\u5165\u529B\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u3067\u8D77\u304D\u305F\u5834\u5408\u3082\u540C\u3058\u3002\u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F\u62D2\u5426\u3055\u308C\u308B\u306E\u3067\u3001`context` \u3092\u8AAD\u307F\u76F4\u3057\u3001\u5909\u308F\u3063\u305F\u5185\u5BB9\u3092\u4F5C\u696D\u306B\u53CD\u6620\u3057\u3066\u304B\u3089\u3084\u308A\u76F4\u3059\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u3089\u306A\u3044\u5834\u5408**: `start` / `blocked` / `review` / `leave` / `ack`\u3001\u9032\u6357\u30FB\u72B6\u614B\u30FB\u671F\u65E5\u30FB\u30AB\u30C6\u30B4\u30EA\u306E\u5909\u66F4\u3001`check` \u306B\u3088\u308B\u6210\u679C\u7269\u306E\u78BA\u8A8D\u3001\u753B\u9762\u3067\u306E\u914D\u7F6E\u306E\u5909\u66F4\u3002\u540C\u3058\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4F7F\u3044\u7D9A\u3051\u3089\u308C\u308B\n- **\u81EA\u5206\u3067\u66F4\u65B0\u3067\u304D\u308B\u5834\u5408**: \u81EA\u5206\u306E `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` \u306A\u3069\u3067\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5909\u308F\u3063\u305F\u3068\u304D\u306F\u3001\u305D\u306E\u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u308B\u3002\u8AAD\u307F\u76F4\u3055\u305A\u306B\u6B21\u306E\u64CD\u4F5C\u3078\u4F7F\u3046\u3002`ask` / `decision` / `answer` / `reopen` \u306F\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u7121\u3057\u3067\u3082\u5B9F\u884C\u3067\u304D\u308B\u304C\u3001\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4ED8\u3051\u305F\u3068\u304D\u3060\u3051\n- \u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u901A\u3059\u305F\u3081\u306B guard \u3092\u7121\u52B9\u306B\u3057\u306A\u3044 (AI \u304C `guard off` \u3059\u308B\u306B\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u8981\u308B)\n- \u518D\u958B\u3059\u308B\u3068\u304D\u306F `npx boxglow resume` \u3092\u8AAD\u307F\u3001\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u306E\u3042\u308B\u30DC\u30C3\u30AF\u30B9\u306F `context` \u3067\u4E2D\u8EAB\u3092\u78BA\u304B\u3081\u3066\u304B\u3089\u7D9A\u3051\u308B\u3002\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u306F\u4F1A\u8A71\u306E\u5C65\u6B74\u3084\u6D3B\u52D5\u30ED\u30B0\u306E\u4E0A\u9650\u3068\u306F\u5225\u306B\u3001\u8A08\u753B\u306E\u4E2D\u306B\u6B8B\u308B\n- MCP \u3067\u306F `boxglow_context` \u3068\u3001\u5404\u30C4\u30FC\u30EB\u306E `contextToken` \u5F15\u6570\u3092\u4F7F\u3046\n- \u300C\u4ED6\u306E Boxglow \u304C\u66F8\u304D\u8FBC\u307F\u4E2D (\u30ED\u30C3\u30AF\u4E2D)\u300D\u3068\u51FA\u3066\u3001\u5C11\u3057\u5F85\u3063\u3066\u3084\u308A\u76F4\u3057\u3066\u3082\u89E3\u3051\u306A\u3044\u3068\u304D\u306F\u3001`npx boxglow unlock` \u306E\u8868\u793A (\u6301\u3061\u4E3B\u3068\u5224\u5B9A) \u3092\u4EBA\u306B\u898B\u305B\u3066\u89E3\u9664\u3092\u983C\u3080\u3002\u81EA\u5206\u3067 `--actor human` \u3092\u4ED8\u3051\u305F\u308A\u3001\u30ED\u30C3\u30AF\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u76F4\u63A5\u6D88\u3057\u305F\u308A\u3057\u306A\u3044\n\n\n### \u7740\u624B\u30FB\u5B8C\u4E86\u3001\u4ECA\u56DE\u306E\u7BC4\u56F2\u3001\u8A18\u9332\u306E\u9BAE\u5EA6\n\n- \u6700\u521D\u306B resume \u306E\u73FE\u6CC1 (\u6D3B\u52D5\u30FB\u5224\u65AD\u5F85\u3061\u30FB\u672A\u78BA\u8A8D\u56DE\u7B54) \u3092\u8AAD\u3080\u3002\u5019\u88DC\u306F\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2 / \u305D\u306E\u4ED6\u300D\u306E\u5404\u7D44\u3067\u300C\u7740\u624B\u3067\u304D\u308B / \u8981\u5177\u4F53\u5316 / \u5165\u529B\u5F85\u3061\u300D\u306B\u5206\u304B\u308C\u3001\u8981\u5177\u4F53\u5316\u306E\u7406\u7531\u3068\u4E0D\u8DB3\u3059\u308B\u5165\u529B\u540D\u304C\u51FA\u308B\u3002\u8981\u5177\u4F53\u5316\u3084\u5165\u529B\u5F85\u3061\u3092\u3001\u6E96\u5099\u6E08\u307F\u3068\u53D6\u308A\u9055\u3048\u306A\u3044\u3002\u300C\u7740\u624B\u3067\u304D\u308B\u300D\u306F\u6A5F\u68B0\u691C\u67FB (\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B\u30FBexpect\u30FBacceptance\u30FB\u5FC5\u9808\u306E\u5165\u529B) \u306E\u7D50\u679C\u3067\u3001\u5185\u5BB9\u306E\u5177\u4F53\u3055\u307E\u3067\u306F\u4FDD\u8A3C\u3057\u306A\u3044\u3002\n- \u30DC\u30C3\u30AF\u30B9\u306E\u4EFB\u610F5\u9805\u76EE\u3092 scope \u3067\u8A2D\u5B9A\u3059\u308B\u3002goal = \u4ECA\u56DE\u9054\u6210\u3059\u308B\u3053\u3068\u3001non-goals = \u4ECA\u56DE\u306F\u6271\u308F\u306A\u3044\u3053\u3068\u3001constraints = \u51FA\u529B\u3092\u4F5C\u308B\u3046\u3048\u3067\u5B88\u308B\u6761\u4EF6 (\u6027\u80FD\u30FB\u54C1\u8CEA\u30FB\u30B5\u30A4\u30BA\u30FB\u5BF8\u6CD5\u30FB\u6D88\u8CBB\u96FB\u529B\u306A\u3069)\u3001acceptance = \u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6\u3001consult = \u7BC4\u56F2\u3092\u5E83\u3052\u308B\u524D\u306B\u76F8\u8AC7\u3059\u308B\u6761\u4EF6\u3002context \u306E\u5148\u982D\u3067\u5BFE\u8C61\u3068\u89AA\u306E\u7BC4\u56F2\u3092\u8AAD\u307F\u3001\u7740\u624B\u524D\u3068\u5B8C\u4E86\u524D\u306B\u7167\u5408\u3059\u308B\u3002\u5B8C\u4E86\u6761\u4EF6\u306E\u672C\u6587\u3092AI\u304C\u6E80\u305F\u3057\u305F\u304B\u306F\u81EA\u52D5\u5224\u5B9A\u3057\u306A\u3044\u3002\n- scope B12 --goal "\u9054\u6210\u3059\u308B\u3053\u3068" --non-goals "\u4ECA\u56DE\u6271\u308F\u306A\u3044\u3053\u3068" --constraints "\u5B88\u308B\u6761\u4EF6" --acceptance "\u78BA\u8A8D\u3059\u308B\u6761\u4EF6" --consult "\u76F8\u8AC7\u3059\u308B\u6761\u4EF6" \u3067\u8A2D\u5B9A\u3059\u308B\u3002scope B12 \u306F\u8868\u793A\u3060\u3051\u3002\u5404\u9805\u76EE\u306B none \u307E\u305F\u306F\u7A7A\u6587\u5B57\u3092\u6E21\u3059\u3068\u6D88\u3059\u3002\u753B\u9762\u3067\u306F\u8A73\u7D30\u30D1\u30CD\u30EB\u306E\u300C\u305D\u306E\u4ED6\u300D\u30BF\u30D6 \u2192\u300C\u4F5C\u696D\u7BC4\u56F2\u3092\u7DE8\u96C6\u300D\u3002\u8A18\u5165\u6E08\u307F\u306E\u9805\u76EE\u3060\u3051\u304C\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2\u300D\u306B\u51FA\u308B\u3002\n- focus B12 \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u3068\u914D\u4E0B\u3092\u6B21\u5019\u88DC\u306E\u5148\u982D\u306B\u3059\u308B\u3002focus \u306F\u73FE\u5728\u306E\u5BFE\u8C61\u306E\u8868\u793A\u3001focus none \u306F\u89E3\u9664\u3002\u5BFE\u8C61\u5916\u3082\u5225\u306E\u7D44\u306B\u6B8B\u308B\u3002\u5019\u88DC\u306B\u51FA\u308B\u3053\u3068\u81EA\u4F53\u306F\u4F5C\u696D\u7BC4\u56F2\u306E\u62E1\u5927\u3084\u516C\u958B\u3092\u8A31\u53EF\u3057\u306A\u3044\u3002\n- start \u306E\u5FC5\u9808\u5165\u529B\u4E0D\u8DB3\u306F\u65E2\u5B9A\u3067\u8B66\u544A\u3059\u308B\u304C\u3001\u5F93\u6765\u3069\u304A\u308A\u958B\u59CB\u3067\u304D\u308B\u3002\u5148\u884C\u4F5C\u696D\u304C\u5FC5\u8981\u306A\u3089 --reason "\u5148\u306B\u884C\u3046\u7406\u7531" \u3092\u4ED8\u3051\u308B\u3002\u8B66\u544A\u306F\u51FA\u305A\u3001\u7406\u7531\u306F\u6D3B\u52D5\u3068\u30ED\u30B0\u306B\u6B8B\u308B\u3002done \u306E\u51FA\u529B\u6210\u679C\u7269\u306A\u3057\u3082\u65E2\u5B9A\u3067\u8B66\u544A\u306E\u307F\u3002\u65E2\u5B58\u306E\u51FA\u529B\u6210\u679C\u7269\u307E\u305F\u306F --artifact \u3092\u6570\u3048\u3001\u30DC\u30C3\u30AF\u30B9\u306E\u53C2\u8003\u8CC7\u6599\u306F\u6570\u3048\u306A\u3044\u3002\n- \u8A08\u753B\u3067\u9078\u3076\u5834\u5408\u3060\u3051 policy --start reject --done reject --unprepared reject \u306B\u3059\u308B\u3002\u305D\u308C\u305E\u308C warn \u306B\u623B\u305B\u308B\u3002\u5165\u529B\u5F85\u3061\u306E\u62D2\u5426\u3067\u3082\u7406\u7531\u4ED8\u304D\u306E\u958B\u59CB\u306F\u53EF\u80FD\u3060\u304C\u3001\u8981\u5177\u4F53\u5316\u306E\u62D2\u5426\u306F\u7406\u7531\u3067\u306F\u901A\u308C\u306A\u3044\u3002\u6210\u679C\u7269\u306A\u3057\u306E\u62D2\u5426\u306F set --status white \u306B\u3082\u52B9\u304F\u3002\u4EBA\u306E\u64CD\u4F5C (\u753B\u9762 / --actor human) \u306F\u62D2\u5426\u3057\u306A\u3044\u3002AI\u304C\u62D2\u5426\u3092\u907F\u3051\u308B\u305F\u3081\u306B\u4EBA\u3092\u540D\u4E57\u3063\u305F\u308A\u3001\u8A2D\u5B9A\u3092\u5F31\u3081\u305F\u308A\u3057\u306A\u3044\u3002\n- guard \u6709\u52B9\u6642\u3001scope \u306E\u5909\u66F4\u3001focus \u306E\u8A2D\u5B9A\u30FB\u89E3\u9664\u3001policy \u306E\u5909\u66F4\u306B\u3082 --context-token \u304C\u5FC5\u8981\u3002scope/focus/policy \u3092\u5909\u3048\u308B\u3068\u65B0\u3057\u3044\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u3067\u3001\u6B21\u306E\u64CD\u4F5C\u306F\u305D\u308C\u3092\u4F7F\u3046\u3002\u8868\u793A\u3060\u3051\u306B\u306F\u4E0D\u8981\u3002\n- resume \u306F\u5B8C\u4E86\u6E08\u307F\u306E\u5F15\u304D\u7D99\u304E\u672C\u6587\u3092\u96A0\u3057\u3001\u4EF6\u6570\u3060\u3051\u793A\u3059\u3002\u5C65\u6B74\u304C\u5FC5\u8981\u306A\u5834\u5408\u3060\u3051 resume --include-completed \u3067\u5C55\u958B\u3059\u308B (context / show \u3067\u306F\u500B\u5225\u306B\u8AAD\u3081\u308B)\u3002\n- \u8AAC\u660E\u306F descriptionUpdatedAt\u3001\u72B6\u614B\u306F statusChangedAt\u3001\u5F15\u304D\u7D99\u304E\u306F\u65E2\u5B58\u306E at \u3067\u65E5\u6642\u3092\u78BA\u8A8D\u3067\u304D\u308B\u3002\u72B6\u614B\u5909\u66F4\u3088\u308A\u53E4\u3044\u30E1\u30E2\u306F\u305D\u306E\u65E8\u3092\u793A\u3059\u3002\u65E7\u8A18\u9332\u306E\u4E0D\u660E\u306A\u65E5\u6642\u306F\u88DC\u308F\u306A\u3044\u3002\u300C\u65B0\u3057\u3044\u8A18\u9332\u300D\u306F\u771F\u507D\u306E\u4FDD\u8A3C\u3067\u306F\u306A\u3044\u3002\n- Done \u3067\u53E4\u3044\u72B6\u6CC1\u8AAC\u660E\u304C\u6B8B\u308B\u53EF\u80FD\u6027\u304C\u3042\u308B\u5834\u5408\u3001CLI\u30FB\u8A73\u7D30\u30D1\u30CD\u30EB\u30FBresume \u306B\u898B\u76F4\u3057\u6848\u5185\u304C\u51FA\u308B\u3002\u672C\u6587\u306F\u81EA\u52D5\u3067\u6D88\u3055\u306A\u3044\u3002\u5185\u5BB9\u3092\u78BA\u8A8D\u3057\u3001\u5FC5\u8981\u306A\u3089 set B12 --note "\u73FE\u5728\u306E\u8AAC\u660E" (none \u3067\u6D88\u53BB) \u307E\u305F\u306F\u753B\u9762\u306E Notes \u3067\u76F4\u3059\u3002\n- MCP \u306F boxglow_scope / boxglow_focus / boxglow_policy\u3001boxglow_start \u306E reason\u3001boxglow_resume \u306E includeCompleted \u3092\u4F7F\u3046\u3002\u5909\u66F4\u306B\u306F contextToken \u3092\u4ED8\u3051\u308B\u3002\n- \u30C7\u30FC\u30BF\u5F62\u5F0F\u306F v5 \u306E\u307E\u307E\u3067\u5168\u9805\u76EE\u306F\u4EFB\u610F\u3002\u65E7\u7248 (0.4.2\u4EE5\u524D) \u306F\u65B0\u3057\u3044\u898F\u5247\u3092\u5B9F\u884C\u305B\u305A\u3001\u4FDD\u5B58\u6642\u306B\u8A08\u753B\u306E workflowPolicy / focusBlockId \u3092\u843D\u3068\u3059\u3002\u3053\u308C\u3089\u3092\u4F7F\u3046\u8A08\u753B\u306E\u66F8\u304D\u624B (CLI\u30FBserve\u30FB\u753B\u9762\u30FB\u62E1\u5F35\u5185\u306E\u30A2\u30D7\u30EA) \u306F\u5BFE\u5FDC\u3057\u305F\u30D3\u30EB\u30C9\u306B\u63C3\u3048\u308B\u3002\u7248\u756A\u53F7\u3060\u3051\u3067\u306A\u304F\u30D3\u30EB\u30C9\u65E5\u6642\u3082\u78BA\u8A8D\u3059\u308B\u3002\n';
+var SKILL_default = '---\nname: boxglow\ndescription: Boxglow (boxglow.json) \u3067\u8A08\u753B\u3068\u9032\u6357\u3092\u4EBA\u9593\u3068\u5171\u6709\u3059\u308B\u3002\u4F5C\u696D\u306E\u958B\u59CB\u30FB\u5206\u89E3\u30FB\u5B8C\u4E86\u30FB\u5224\u65AD\u5F85\u3061\u3092 npx boxglow \u3067\u8A18\u9332\u3059\u308B\u3002\u300C\u9032\u6357\u3092 Boxglow \u306B\u8A18\u9332\u3057\u3066\u300D\u300Cboxglow \u3067\u72B6\u6CC1\u3092\u898B\u3066\u300D\u300C/boxglow\u300D\u3067\u4F7F\u7528\u3002\n---\n\n# Boxglow \u3067\u8A08\u753B\u3068\u9032\u6357\u3092\u5171\u6709\u3059\u308B\n\n\u30EA\u30DD\u30B8\u30C8\u30EA\u76F4\u4E0B\u306E `boxglow.json` \u304C\u8A08\u753B\u306E\u6B63\u672C\u3002\u4EBA\u9593\u306F Boxglow \u306E\u753B\u9762 (https://boxglow.app/ \u3067\u300Cboxglow.json \u3092\u958B\u304F\u300D) \u3067\u898B\u3066\u3044\u308B\u3002\n\u76F4\u63A5\u7DE8\u96C6\u305B\u305A `npx boxglow` \u3067\u66F4\u65B0\u3059\u308B\u3002\n\n## \u6700\u521D\u306E\u8A08\u753B\u3065\u304F\u308A (\u65B0\u3057\u3044\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u3068\u304D)\n\n1. \u65B9\u91DD (README\u3001\u4F9D\u983C\u6587\u3001\u8981\u4EF6\u30E1\u30E2) \u3092\u8AAD\u307F\u3001`npx boxglow init --name "<\u540D\u524D>"` \u306E\u3042\u3068\u3001\u6700\u4E0A\u4F4D\u306B\u5927\u9805\u76EE (3\u301C7 \u500B) \u3092 `add` \u3067\u7F6E\u304F\u3002\n   \u5404\u5927\u9805\u76EE\u306B\u306F\u300C\u5165\u529B (\u4F55\u3092\u4F7F\u3046\u304B)\u300D\u3068\u300C\u51FA\u529B (\u5177\u4F53\u7684\u306A\u6210\u679C\u7269: \u30D5\u30A1\u30A4\u30EB\u30FBURL\u30FBPR)\u300D\u3092\u5FC5\u305A\u66F8\u304D\u3001\u6700\u7D42\u6210\u679C\u7269\u307E\u3067\u7DDA\u3067\u3064\u306A\u3050 (`connect`)\n2. \u4F5C\u3063\u305F\u3089 `npx boxglow ask <\u6700\u521D\u306E\u5927\u9805\u76EE> "\u3053\u306E\u5927\u9805\u76EE\u306E\u5206\u3051\u65B9\u3067\u3088\u3044\u3067\u3059\u304B?" --options "\u3088\u3044|\u76F4\u3057\u305F\u3044"` \u3067\u4EBA\u306E\u78BA\u8A8D\u3092\u53D6\u308B\u3002\n   \u4EBA\u306F\u753B\u9762\u3067\u3082\u3001`npx boxglow answer <block> "<\u56DE\u7B54>"` \u3067\u3082\u3001\u30C1\u30E3\u30C3\u30C8\u3067\u3082\u7B54\u3048\u3089\u308C\u308B\u3002\u30C1\u30E3\u30C3\u30C8\u3067\u7B54\u3048\u304C\u8FD4\u3063\u305F\u3089 AI \u304C `answer --by human` \u3067\u8A18\u9332\u3059\u308B\u3002\n   \u4EBA\u304C\u753B\u9762\u3092\u4F7F\u308F\u306A\u3044\u904B\u7528 (AI \u3060\u3051\u3067\u9032\u3081\u308B\u6307\u793A\u304C\u3042\u308B\u3068\u304D) \u306F\u3001AI \u81EA\u8EAB\u304C `answer --by claude-code "<\u5224\u65AD\u3068\u7406\u7531>"` \u3067\u8A18\u9332\u3057\u3066\u5148\u3078\u9032\u3080\u3002\u5224\u65AD\u306E\u8A18\u9332\u3092\u6B8B\u3059\u3053\u3068\u304C\u76EE\u7684\u3067\u3001\u753B\u9762\u306F\u5FC5\u9808\u3067\u306F\u306A\u3044\n3. \u7740\u624B\u3059\u308B\u5927\u9805\u76EE\u3060\u3051\u3092 `split` \u3067\u5206\u89E3\u3059\u308B (\u5148\u306E\u6BB5\u968E\u306F\u7C97\u3044\u307E\u307E\u3002\u9032\u3081\u306A\u304C\u3089\u7D30\u304B\u304F\u3059\u308B)\n\n## \u624B\u9806\n\n1. `npx boxglow resume` (\u307E\u305F\u306F `npx boxglow status --brief`) \u3092\u8AAD\u3080\u3002\u4F5C\u696D\u4E2D\u306E\u30DC\u30C3\u30AF\u30B9\u3001\u5224\u65AD\u5F85\u3061\u3001AI \u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u3001\u6B21\u306E\u5019\u88DC\u3001\u672A\u5B8C\u4E86\u306E\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u628A\u63E1\u3059\u308B\u3002\u5168\u968E\u5C64\u304C\u8981\u308B\u3068\u304D\u306F `npx boxglow status`\n2. \u62C5\u5F53\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u3092\u6C7A\u3081\u305F\u3089 `npx boxglow context <block>` \u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E `readiness.state` \u304C `ready` \u306A\u3089\u7740\u624B\u3067\u304D\u308B\u3002`unprepared` (\u8981\u5177\u4F53\u5316) \u306A\u3089 `unprepared` \u306E\u7406\u7531\u3068 `next` \u306E\u6B21\u306E\u4E00\u624B\u306B\u5F93\u3063\u3066\u5148\u306B\u5177\u4F53\u5316\u3059\u308B\u3002`waiting` \u306F\u5FC5\u9808\u306E\u5165\u529B\u304B\u5206\u5C90\u306E\u7B54\u3048\u3092\u5F85\u3063\u3066\u3044\u308B\n3. \u5177\u4F53\u5316\u3084\u5206\u89E3\u306E\u524D\u306B `npx boxglow claim <block>` \u3067\u53D7\u3051\u6301\u3061\u3060\u3051\u3092\u53D6\u308B (\u5B9F\u884C\u4E2D\u306B\u306F\u306A\u3089\u306A\u3044\u3002\u53D7\u3051\u6301\u3061\u5236\u5FA1\u304C\u7121\u52B9\u306A\u8A08\u753B\u3067\u306F\u300C\u53D6\u5F97\u4E0D\u8981\u300D\u3067\u6B63\u5E38\u7D42\u4E86\u3059\u308B)\u3002\u4E0D\u8DB3\u3092\u57CB\u3081\u308B:\n   \u51FA\u529B\u306E\u4E88\u5B9A\u6210\u679C\u7269 `npx boxglow port <block> --expect "<\u51FA\u529B\u540D>=file:src/x.ts"` (kind \u306F file / dir / url / doc / note / decision / result\u3002\u307E\u3060\u7121\u3044\u30D5\u30A1\u30A4\u30EB\u3067\u3088\u3044)\u3001\u5B8C\u4E86\u6761\u4EF6 `npx boxglow scope <block> --acceptance "<\u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6>"`\u3002\n   \u5927\u304D\u3044\u30DC\u30C3\u30AF\u30B9\u306F `npx boxglow split <block> --spec \'<JSON>\'` \u3067\u5206\u89E3\u3059\u308B (\u5F62\u5F0F\u306F `npx boxglow help`)\u3002\u4ECA\u56DE\u7740\u624B\u3059\u308B\u5B50\u3060\u3051 expect / acceptance \u3092\u66F8\u304D\u3001\u5148\u306E\u5B50\u306F\u984C\u540D\u3068\u51FA\u529B\u3060\u3051\u3067\u3088\u3044\u3002\n   \u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u304C\u5206\u304B\u3089\u306A\u3044\u3068\u304D\u306F\u3001\u67B6\u7A7A\u306E\u30D1\u30B9\u3092\u66F8\u304B\u305A\u300C\u5BFE\u8C61\u3092\u7279\u5B9A\u3059\u308B\u8ABF\u67FB\u300D\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u51FA\u529B `note` \u3067\u4F5C\u3063\u3066\u59CB\u3081\u308B\u3002\n   \u5206\u89E3\u306E\u5F8C\u306F `npx boxglow lint <block>` \u3092\u8AAD\u307F\u3001\u300C\u5FC5\u305A\u76F4\u3059\u300D\u3092\u76F4\u3057\u3066\u304B\u3089\u9032\u3080 (\u300C\u898B\u76F4\u3057\u5019\u88DC\u300D\u306F\u5185\u5BB9\u3092\u898B\u3066\u5224\u65AD)\u3002\u76F4\u4E0B\u306E\u5B50\u306E\u5206\u3051\u65B9\u306F `"splitBy": "\u5DE5\u7A0B"` (\u307E\u305F\u306F `set --split-by`) \u3067\u4E00\u8A9E\u6B8B\u3059\u3002\n   \u5185\u5BB9\u306E\u30EC\u30D3\u30E5\u30FC: `review-split <\u89AA>` \u306E\u6750\u6599\u3068\u30C1\u30A7\u30C3\u30AF\u9805\u76EE\u3092\u8AAD\u3093\u3067 `split-ok <\u89AA> --note "<\u6839\u62E0>"`\u3001\u7740\u624B\u306E\u524D\u306F `review-box <block>` \u2192 `box-ok <block> --note "<\u6839\u62E0>"` (\u6750\u6599\u304C\u5909\u308F\u308B\u3068 context \u306E reviews \u304C stale \u306B\u306A\u308B)\u3002\n   \u7B54\u3048\u3067\u5F8C\u306E\u4F5C\u696D\u304C\u5206\u304B\u308C\u308B\u554F\u3044\u306F `ask ... --options "A|B" --branch` \u3067\u5206\u5C90\u306B\u3059\u308B (split \u306E JSON \u3067\u3082 `"branch": { question, options }` / `"join": true`)\n4. \u6E96\u5099\u304C\u3067\u304D\u305F\u3089 `npx boxglow context <block>` \u3092\u8AAD\u307F\u76F4\u3057\u3001`npx boxglow start <block> --note "<\u4F55\u3092\u3059\u308B\u304B>"`\u3002\n   \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u304C\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001\u51FA\u529B\u306E `contextToken` (\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3) \u3092 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3067\u4ED8\u3051\u308B\u3002\n   \u8981\u5177\u4F53\u5316\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u306E start \u306F\u65E2\u5B9A\u3067\u306F\u8B66\u544A\u3001`policy --unprepared reject` \u306E\u8A08\u753B\u3067\u306F\u958B\u59CB\u3067\u304D\u306A\u3044 (`--reason` \u3067\u306F\u901A\u308C\u306A\u3044)\u3002\u51FA\u529B\u3092\u5B50\u306B\u4EFB\u305B\u304D\u308A\u306E\u89AA\u306F\u5B9F\u884C\u3059\u308B\u3082\u306E\u304C\u7121\u3044\u306E\u3067\u3001\u5B50\u3092 start \u3059\u308B\n5. \u6210\u679C\u7269\u304C\u3067\u304D\u305F\u3089 `npx boxglow done <block> --artifact "<\u540D\u524D>=<URL \u307E\u305F\u306F\u30D1\u30B9>" --checked "<\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C>"` (\u691C\u67FB\u7D50\u679C\u306F `--checked` \u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C / `--not-checked` \u8A66\u3057\u3066\u3044\u306A\u3044\u3053\u3068 / `--limits` \u6B8B\u308B\u5236\u9650 \u306E 3 \u3064\u3067\u6B8B\u3059\u3002\u30B3\u30FC\u30C9\u4EE5\u5916\u306E\u6210\u679C\u7269\u306F\u300C\u78BA\u8A8D\u3057\u305F\u3053\u3068\u300D\u3092\u66F8\u304F\u3002guard \u304C\u6709\u52B9\u306A\u3089 `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u3092\u4ED8\u3051\u308B\u3002\u76F4\u524D\u306E\u81EA\u5206\u306E\u64CD\u4F5C\u306E\u51FA\u529B\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u3066\u3044\u308C\u3070\u3001\u305D\u308C\u3092\u4F7F\u3046)\n6. \u4EBA\u9593\u306E\u5224\u65AD\u304C\u8981\u308B\u3068\u304D\u306F `npx boxglow ask <block> "<\u8CEA\u554F>" --options "A|B"` \u3057\u3066\u4ED6\u306E\u30DC\u30C3\u30AF\u30B9\u3078\u79FB\u308B\n7. \u8A70\u307E\u3063\u305F\u3089: \u5165\u529B (\u524D\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u6210\u679C\u7269\u30FB\u8CC7\u6599) \u304C\u8DB3\u308A\u306A\u3044\u3053\u3068\u304C\u539F\u56E0\u306A\u3089\u3001\u8A70\u307E\u308A\u306B\u3057\u306A\u3044\u3002`npx boxglow show <block>` \u3067\u5165\u529B\u306E\u914D\u7DDA\u3092\u78BA\u304B\u3081\u3001\u8DB3\u308A\u306A\u3044\u3082\u306E\u3092\u4F5C\u308B\u30DC\u30C3\u30AF\u30B9\u304C\u7121\u3051\u308C\u3070 `npx boxglow add` \u3067\u5916 (\u4E0A\u6D41) \u306B\u4F5C\u308A\u3001`npx boxglow connect` \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u5165\u529B\u306B\u3064\u306A\u3050 (\u914D\u7DDA\u304C\u300C\u5F85\u3061\u300D\u306E\u8272\u3067\u6B8B\u308A\u3001\u4F55\u3092\u5F85\u3063\u3066\u3044\u308B\u304B\u304C\u56F3\u3067\u898B\u3048\u308B)\u3002\u9078\u629E\u80A2\u304B\u3089\u9078\u3093\u3067\u3082\u3089\u3048\u3070\u9032\u3081\u308B\u306A\u3089 `ask`\u3002\u305D\u308C\u4EE5\u5916\u306E\u3001\u8A08\u753B\u306E\u5916\u306B\u3042\u308B\u969C\u5BB3 (\u74B0\u5883\u304C\u52D5\u304B\u306A\u3044\u3001\u6A29\u9650\u3084\u30AD\u30FC\u304C\u7121\u3044\u3001\u5916\u90E8\u306E\u8FD4\u4E8B\u5F85\u3061\u3001\u539F\u56E0\u306E\u5206\u304B\u3089\u306A\u3044\u5931\u6557) \u3060\u3051\u3092 `npx boxglow blocked <block> --note "<\u56F0\u3063\u3066\u3044\u308B\u3053\u3068>"` \u3067\u8A18\u9332\u3059\u308B\n8. \u4E2D\u65AD\u30FB\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306E\u5727\u7E2E\u30FB\u5F15\u304D\u7D99\u304E\u306E\u524D\u306B `npx boxglow checkpoint <block> --note "\u5206\u304B\u3063\u305F\u3053\u3068; \u6B21\u306B\u3059\u308B\u3053\u3068; \u672A\u89E3\u6C7A\u306E\u3053\u3068"` \u3067\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u6B8B\u3059\n9. \u6700\u5F8C\u306B `npx boxglow status --brief` \u3092\u8981\u7D04\u3057\u3066\u5831\u544A\u3059\u308B\n\n## \u7D04\u675F\n\n- **\u307E\u3060\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u306F\u5206\u5C90\u3067\u8868\u3059**: \u8A08\u753B\u3092\u4F5C\u308B\u6642\u70B9\u3067\u3001\u5224\u65AD\u6B21\u7B2C\u3067\u5F8C\u306E\u4F5C\u696D (\u9053) \u304C\u5909\u308F\u308B\u3068\u304D\u306F `npx boxglow branch "<\u984C\u540D>" --options "A|B" --question "<\u554F\u3044>" --context "<\u5224\u65AD\u6750\u6599>"` \u3067\u5206\u5C90\u306E\u30DC\u30C3\u30AF\u30B9\u3092\u4F5C\u308B\u3002\u9078\u629E\u80A2\u3054\u3068\u306B\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u308B\u306E\u3067\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u521D\u306E\u30DC\u30C3\u30AF\u30B9\u3078 `connect` \u3059\u308B\u3002\u9053\u304C\u5F8C\u3067 1 \u3064\u306B\u307E\u3068\u307E\u308B\u3068\u3053\u308D\u306B\u306F `npx boxglow join --title "<\u984C\u540D>"` \u3067\u5408\u6D41\u306E\u90E8\u54C1\u3092\u7F6E\u304D\u3001\u305D\u308C\u305E\u308C\u306E\u9053\u306E\u6700\u5F8C\u306E\u51FA\u529B\u3092\u3053\u306E\u90E8\u54C1\u3078 `connect` \u3057\u3001\u90E8\u54C1\u306E\u51FA\u529B\u3092\u5148\u306E\u7BB1\u3078\u3064\u306A\u3050 (\u3069\u308C\u304B 1 \u3064\u306E\u9053\u304C\u5C4A\u3051\u3070\u5148\u3078\u9032\u3080)\u3002\u4EBA\u304C\u7B54\u3048\u308B\u3068\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u9053\u306E\u5148\u306F\u300C\u898B\u9001\u308A\u300D\u306B\u306A\u308A\u3001\u9032\u6357\u3068\u6B21\u306E\u5019\u88DC\u304B\u3089\u5916\u308C\u308B\u3002\u3059\u3067\u306B\u4F5C\u3063\u305F\u30DC\u30C3\u30AF\u30B9\u304C\u5B9F\u306F\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053\u3060\u3068\u5206\u304B\u3063\u305F\u3089\u3001`npx boxglow branch --box <block> --options "A|B" --question "<\u554F\u3044>"` \u3067\u5206\u5C90\u306B\u5909\u3048\u308B (\u4ECA\u306E\u51FA\u529B\u304C 1 \u3064\u76EE\u306E\u9078\u629E\u80A2\u306E\u9053\u306B\u306A\u308A\u3001\u7DDA\u306F\u6B8B\u308B)\u3002\u7B54\u3048\u304C\u51FA\u308B\u524D\u306E\u9053\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u300C\u5206\u5C90\u5F85\u3061\u300D\u3067\u3001\u7740\u624B\u3059\u308B\u3068\u8B66\u544A\u3055\u308C\u308B (\u5148\u306B\u4E0B\u8ABF\u3079\u3059\u308B\u306A\u3069\u7406\u7531\u304C\u3042\u308C\u3070 `--reason` \u3067\u8A18\u9332\u3059\u308B)\n- `ask` \u306E\u8CEA\u554F\u306F\u3001\u305D\u308C\u3060\u3051\u3067\u5224\u65AD\u3067\u304D\u308B\u3088\u3046\u306B\u66F8\u304F\u3002\u300C\u3053\u308C\u3067\u3088\u3044\u3067\u3059\u304B\u300D\u300C\u4E0A\u8A18\u306E\u6848\u300D\u306E\u3088\u3046\u306B\u5916\u3092\u6307\u3055\u305A\u3001\u524D\u63D0\u30FB\u6BD4\u8F03\u30FB\u5F71\u97FF\u3092 `--context` \u306B\u66F8\u304F (\u4EBA\u306F\u4E00\u89A7\u306E\u4E2D\u306E\u8CEA\u554F\u3060\u3051\u3092\u8AAD\u3093\u3067\u7B54\u3048\u308B)\n- \u5019\u88DC\u304B\u3089 1 \u3064\u3092\u9078\u3076\u5834\u9762 (\u65B9\u5F0F\u30FB\u30E9\u30A4\u30D6\u30E9\u30EA\u30FB\u8A2D\u8A08\u306E\u9078\u629E) \u3067\u306F\u3001AI \u304C\u81EA\u5206\u3067\u6C7A\u3081\u308B\u3068\u304D\u3082 `ask <block> "<\u554F\u3044>" --options "A|B|C"` \u2192 `answer --by claude-code "<\u9078\u3093\u3060\u3082\u306E>\u3002\u7406\u7531: ..."` \u306E\u5F62\u3067\u8A18\u9332\u3057\u3001\u9078\u3070\u306A\u304B\u3063\u305F\u5019\u88DC\u3092\u30DC\u30C3\u30AF\u30B9\u306B\u6B8B\u3059 (\u65B9\u91DD\u8EE2\u63DB\u306E\u3068\u304D\u306B\u623B\u308C\u308B)\n- \u65B9\u91DD\u8EE2\u63DB\u306F `reopen <block> --note "<\u7406\u7531>"` \u3067\u524D\u306E\u7B54\u3048\u3092\u5C65\u6B74\u306B\u6B8B\u3057\u3066\u9078\u3073\u76F4\u3059 (\u5019\u88DC\u306F\u6D88\u3055\u306A\u3044)\n\n- \u540C\u6642\u306B\u4F5C\u696D\u4E2D\u306B\u3059\u308B\u30DC\u30C3\u30AF\u30B9\u306F 1\u301C2 \u500B\u307E\u3067\n- \u6210\u679C\u7269 (artifact) \u306F\u5F8C\u304B\u3089\u4EBA\u304C\u958B\u3051\u308B\u3082\u306E (\u30B3\u30DF\u30C3\u30C8\u3001PR\u3001\u30D5\u30A1\u30A4\u30EB\u306E\u30D1\u30B9) \u306B\u3059\u308B\n- \u51FA\u529B\u306F\u5177\u4F53\u7684\u306A\u6210\u679C\u7269\u306E\u540D\u524D\u306B\u3059\u308B (\u30D5\u30A1\u30A4\u30EB\u30FBPR\u30FBURL\u30FB\u30C6\u30B9\u30C8\u7D50\u679C)\u3002\u62BD\u8C61\u7684\u306A\u540D\u524D (\u6A5F\u80FD\u4E00\u5F0F\u3001\u6240\u898B) \u306F\u907F\u3051\u308B\u30021 \u3064\u306E\u4F5C\u696D\u3067\u8907\u6570\u306E\u7269\u304C\u3067\u304D\u308B\u306A\u3089\u51FA\u529B\u3092\u5206\u3051\u308B (`port <block> --out "<\u540D\u524D>"` \u3067\u8DB3\u3059)\n- \u7D50\u7DDA\u306E\u53D7\u3051\u5074\u306F\u984C\u540D\u3060\u3051\u3067\u3088\u3044 (`connect "A.\u8A2D\u8A08\u66F8" "B"` \u3067 B \u306B\u5165\u529B\u300C\u8A2D\u8A08\u66F8\u300D\u304C\u4F5C\u3089\u308C\u308B)\u3002\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306F 1 \u3064\u306E\u540D\u524D (\u3069\u3061\u3089\u5074\u3067\u5909\u3048\u3066\u3082\u3001\u3064\u306A\u304C\u308B\u5148\u3082\u540C\u3058\u540D\u524D\u306B\u306A\u308B)\n- \u30DC\u30C3\u30AF\u30B9\u306F\u5FC5\u305A\u300C\u5165\u529B \u2192 \u51FA\u529B\u300D\u3067\u3064\u306A\u3050\u3002\u8DB3\u308A\u306A\u3044\u5165\u51FA\u529B\u306F `port`\u3001\u5916\u3059\u306E\u306F `disconnect`\u3001\u30DC\u30C3\u30AF\u30B9\u305D\u306E\u3082\u306E\u3092\u6D88\u3059\u306E\u306F `remove`\u3002\u6587\u66F8\u5316\u306F `export --out docs/ROADMAP.md`\n- \u30DC\u30C3\u30AF\u30B9\u3092 add \u3059\u308B\u3068\u304D\u306F\u4ED5\u4E8B\u306E\u7A2E\u985E\u3092 `--category` \u3067\u4ED8\u3051\u308B (design \u8A2D\u8A08 / build \u5B9F\u88C5 / verify \u691C\u8A3C / evaluate \u8A55\u4FA1 / study \u691C\u8A0E / research \u8ABF\u67FB / ui \u30C7\u30B6\u30A4\u30F3 / improve \u6539\u5584 / fix \u8AB2\u984C\u89E3\u6C7A / docs \u6587\u66F8 / ops \u904B\u7528 / other \u305D\u306E\u4ED6)\u3002\u753B\u9762\u3067\u306F\u8272\u306E\u5E2F\u3068\u672D\u306B\u306A\u308B\n- boxglow.json \u304C\u307E\u3060\u7121\u3051\u308C\u3070 `npx boxglow init --name "<\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D>"` \u3067\u4F5C\u308A\u3001\u6700\u7D42\u6210\u679C\u7269\u3068\u6700\u4E0A\u4F4D\u306E\u30DC\u30C3\u30AF\u30B9\u3092 `add` \u3067\u7F6E\u304F\n\n## \u81EA\u52D5\u3067\u52D5\u304F\u4ED5\u7D44\u307F (hooks)\n\n`setup-agent` \u304C Claude Code / Codex \u306E hooks \u306B `boxglow hook` \u3092\u767B\u9332\u3057\u3066\u3044\u308B\u3002\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u958B\u59CB\u30FB\u518D\u958B\u30FB\u5727\u7E2E\u306E\u5F8C\u306B\u8A08\u753B\u306E\u518D\u958B\u306E\u6982\u8981 (resume) \u304C\u6587\u8108\u306B\u5165\u308B\u3002\u5FDC\u7B54\u3092\u7D42\u3048\u308B\u3068\u304D\u3001\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067 start \u3057\u305F\u7BB1\u306B\u5F15\u304D\u7D99\u304E (done \u304B checkpoint) \u304C\u7121\u3051\u308C\u3070\u300C\u8A18\u9332\u3057\u3066\u304B\u3089\u7D42\u3048\u308B\u300D\u3088\u3046\u7D9A\u884C\u304C\u6307\u793A\u3055\u308C\u308B (log \u306F\u9032\u6357\u306E\u30E1\u30E2\u3067\u3001\u5F15\u304D\u7D99\u304E\u306E\u4EE3\u308F\u308A\u306B\u306A\u3089\u306A\u3044)\u3002boxglow.json \u3092\u76F4\u63A5\u66F8\u304D\u63DB\u3048\u308B\u64CD\u4F5C (Edit / Write / apply_patch) \u306F\u6B62\u3081\u3089\u308C\u308B\u3002\u3053\u308C\u306F\u5FD8\u308C\u305F\u3068\u304D\u306E\u4FDD\u967A\u3067\u3001\u4E0A\u306E\u624B\u9806\u3069\u304A\u308A\u306B\u81EA\u5206\u3067\u8A18\u9332\u3059\u308B\u3002\n\u5206\u89E3\u3084\u7740\u624B\u6E96\u5099\u306E\u30EC\u30D3\u30E5\u30FC\u306F\u3001\u30B5\u30D6\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 `boxglow-review` \u306B\u4EFB\u305B\u3089\u308C\u308B (review-split / review-box \u306E\u6750\u6599\u3092\u8AAD\u3093\u3067\u8A55\u4FA1\u3068\u6839\u62E0\u3092\u8FD4\u3059\u3002split-ok / box-ok \u306E\u8A18\u9332\u306F\u3001\u8FD4\u3063\u3066\u304D\u305F\u6839\u62E0\u3067\u89AA\u3067\u3042\u308B\u81EA\u5206\u304C\u884C\u3046)\u3002\n\n## \u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3068\u5F15\u304D\u7D99\u304E\n\n\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306E\u8981\u6C42 (guard) \u306F\u3001AI \u304C\u53E4\u3044\u6307\u793A\u306E\u307E\u307E\u4F5C\u696D\u3092\u9032\u3081\u308B\u306E\u3092\u9632\u3050\u4ED5\u7D44\u307F\u3002`setup-agent` \u304C\u6709\u52B9\u306B\u3059\u308B (\u305D\u308C\u4EE5\u5916\u306E\u8A08\u753B\u3067\u306F `npx boxglow guard on`)\u3002\n\u6709\u52B9\u306A\u8A08\u753B\u3067\u306F\u3001AI \u306E `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` \u306B `--context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>` \u304C\u8981\u308B\u3002\u4EBA\u306E\u64CD\u4F5C (`--actor human`) \u306B\u306F\u8981\u6C42\u3055\u308C\u306A\u3044\u3002\n\n```\nnpx boxglow context B12        # \u5224\u65AD (\u5F15\u304D\u53D6\u308A\u6E08\u307F\u306E\u56DE\u7B54\u3092\u542B\u3080)\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6\u30FB\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u8AAD\u3080\u3002\u51FA\u529B\u306E contextToken \u304C\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\nnpx boxglow start B12 --note "<\u4F55\u3092\u3059\u308B\u304B>" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\nnpx boxglow ask B12 "<\u8CEA\u554F>" --options "A|B" --context-token <\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n#   \u2192 \u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C: \u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\nnpx boxglow done B12 --artifact "<\u540D\u524D>=<\u30D1\u30B9>" --context-token <\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3>\n```\n\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u308B\u5834\u5408 (\u8AAD\u307F\u76F4\u3057\u304C\u8981\u308B)**: \u4EBA\u304C\u56DE\u7B54\u3057\u305F\u30FB\u56DE\u7B54\u3092\u76F4\u3057\u305F\u3001\u4EBA\u304C\u6307\u793A (\u984C\u540D\u30FB\u8AAC\u660E\u30FB\u5165\u51FA\u529B\u306E\u6761\u4EF6) \u3092\u5909\u3048\u305F\u3001\u4ED6\u306E AI \u3084\u4EBA\u304C\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u3092\u66F4\u65B0\u3057\u305F\u3002\u89AA\u3084\u5165\u529B\u5143\u306E\u30DC\u30C3\u30AF\u30B9\u3067\u8D77\u304D\u305F\u5834\u5408\u3082\u540C\u3058\u3002\u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u306F\u62D2\u5426\u3055\u308C\u308B\u306E\u3067\u3001`context` \u3092\u8AAD\u307F\u76F4\u3057\u3001\u5909\u308F\u3063\u305F\u5185\u5BB9\u3092\u4F5C\u696D\u306B\u53CD\u6620\u3057\u3066\u304B\u3089\u3084\u308A\u76F4\u3059\n- **\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u5909\u308F\u3089\u306A\u3044\u5834\u5408**: `start` / `blocked` / `review` / `leave` / `ack`\u3001\u9032\u6357\u30FB\u72B6\u614B\u30FB\u671F\u65E5\u30FB\u30AB\u30C6\u30B4\u30EA\u306E\u5909\u66F4\u3001`check` \u306B\u3088\u308B\u6210\u679C\u7269\u306E\u78BA\u8A8D\u3001\u753B\u9762\u3067\u306E\u914D\u7F6E\u306E\u5909\u66F4\u3002\u540C\u3058\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4F7F\u3044\u7D9A\u3051\u3089\u308C\u308B\n- **\u81EA\u5206\u3067\u66F4\u65B0\u3067\u304D\u308B\u5834\u5408**: \u81EA\u5206\u306E `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` \u306A\u3069\u3067\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5909\u308F\u3063\u305F\u3068\u304D\u306F\u3001\u305D\u306E\u51FA\u529B\u306E\u6700\u5F8C\u306E\u884C\u306B\u300C\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3: <token>\u300D\u304C\u51FA\u308B\u3002\u8AAD\u307F\u76F4\u3055\u305A\u306B\u6B21\u306E\u64CD\u4F5C\u3078\u4F7F\u3046\u3002`ask` / `decision` / `answer` / `reopen` \u306F\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u7121\u3057\u3067\u3082\u5B9F\u884C\u3067\u304D\u308B\u304C\u3001\u65B0\u3057\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u4ED8\u3051\u305F\u3068\u304D\u3060\u3051\n- \u53E4\u3044\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u3092\u901A\u3059\u305F\u3081\u306B guard \u3092\u7121\u52B9\u306B\u3057\u306A\u3044 (AI \u304C `guard off` \u3059\u308B\u306B\u306F\u6700\u65B0\u306E\u78BA\u8A8D\u30C8\u30FC\u30AF\u30F3\u304C\u8981\u308B)\n- \u518D\u958B\u3059\u308B\u3068\u304D\u306F `npx boxglow resume` \u3092\u8AAD\u307F\u3001\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u306E\u3042\u308B\u30DC\u30C3\u30AF\u30B9\u306F `context` \u3067\u4E2D\u8EAB\u3092\u78BA\u304B\u3081\u3066\u304B\u3089\u7D9A\u3051\u308B\u3002\u5F15\u304D\u7D99\u304E\u30E1\u30E2\u306F\u4F1A\u8A71\u306E\u5C65\u6B74\u3084\u6D3B\u52D5\u30ED\u30B0\u306E\u4E0A\u9650\u3068\u306F\u5225\u306B\u3001\u8A08\u753B\u306E\u4E2D\u306B\u6B8B\u308B\n- MCP \u3067\u306F `boxglow_context` \u3068\u3001\u5404\u30C4\u30FC\u30EB\u306E `contextToken` \u5F15\u6570\u3092\u4F7F\u3046\n- \u300C\u4ED6\u306E Boxglow \u304C\u66F8\u304D\u8FBC\u307F\u4E2D (\u30ED\u30C3\u30AF\u4E2D)\u300D\u3068\u51FA\u3066\u3001\u5C11\u3057\u5F85\u3063\u3066\u3084\u308A\u76F4\u3057\u3066\u3082\u89E3\u3051\u306A\u3044\u3068\u304D\u306F\u3001`npx boxglow unlock` \u306E\u8868\u793A (\u6301\u3061\u4E3B\u3068\u5224\u5B9A) \u3092\u4EBA\u306B\u898B\u305B\u3066\u89E3\u9664\u3092\u983C\u3080\u3002\u81EA\u5206\u3067 `--actor human` \u3092\u4ED8\u3051\u305F\u308A\u3001\u30ED\u30C3\u30AF\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u76F4\u63A5\u6D88\u3057\u305F\u308A\u3057\u306A\u3044\n\n\n### \u7740\u624B\u30FB\u5B8C\u4E86\u3001\u4ECA\u56DE\u306E\u7BC4\u56F2\u3001\u8A18\u9332\u306E\u9BAE\u5EA6\n\n- \u6700\u521D\u306B resume \u306E\u73FE\u6CC1 (\u6D3B\u52D5\u30FB\u5224\u65AD\u5F85\u3061\u30FB\u672A\u78BA\u8A8D\u56DE\u7B54) \u3092\u8AAD\u3080\u3002\u5019\u88DC\u306F\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2 / \u305D\u306E\u4ED6\u300D\u306E\u5404\u7D44\u3067\u300C\u7740\u624B\u3067\u304D\u308B / \u8981\u5177\u4F53\u5316 / \u5165\u529B\u5F85\u3061\u300D\u306B\u5206\u304B\u308C\u3001\u8981\u5177\u4F53\u5316\u306E\u7406\u7531\u3068\u4E0D\u8DB3\u3059\u308B\u5165\u529B\u540D\u304C\u51FA\u308B\u3002\u8981\u5177\u4F53\u5316\u3084\u5165\u529B\u5F85\u3061\u3092\u3001\u6E96\u5099\u6E08\u307F\u3068\u53D6\u308A\u9055\u3048\u306A\u3044\u3002\u300C\u7740\u624B\u3067\u304D\u308B\u300D\u306F\u6A5F\u68B0\u691C\u67FB (\u81EA\u8EAB\u304C\u4F5C\u308B\u51FA\u529B\u30FBexpect\u30FBacceptance\u30FB\u5FC5\u9808\u306E\u5165\u529B) \u306E\u7D50\u679C\u3067\u3001\u5185\u5BB9\u306E\u5177\u4F53\u3055\u307E\u3067\u306F\u4FDD\u8A3C\u3057\u306A\u3044\u3002\n- \u30DC\u30C3\u30AF\u30B9\u306E\u4EFB\u610F5\u9805\u76EE\u3092 scope \u3067\u8A2D\u5B9A\u3059\u308B\u3002goal = \u4ECA\u56DE\u9054\u6210\u3059\u308B\u3053\u3068\u3001non-goals = \u4ECA\u56DE\u306F\u6271\u308F\u306A\u3044\u3053\u3068\u3001constraints = \u51FA\u529B\u3092\u4F5C\u308B\u3046\u3048\u3067\u5B88\u308B\u6761\u4EF6 (\u6027\u80FD\u30FB\u54C1\u8CEA\u30FB\u30B5\u30A4\u30BA\u30FB\u5BF8\u6CD5\u30FB\u6D88\u8CBB\u96FB\u529B\u306A\u3069)\u3001acceptance = \u5B8C\u4E86\u3068\u5224\u65AD\u3059\u308B\u6761\u4EF6\u3001consult = \u7BC4\u56F2\u3092\u5E83\u3052\u308B\u524D\u306B\u76F8\u8AC7\u3059\u308B\u6761\u4EF6\u3002context \u306E\u5148\u982D\u3067\u5BFE\u8C61\u3068\u89AA\u306E\u7BC4\u56F2\u3092\u8AAD\u307F\u3001\u7740\u624B\u524D\u3068\u5B8C\u4E86\u524D\u306B\u7167\u5408\u3059\u308B\u3002\u5B8C\u4E86\u6761\u4EF6\u306E\u672C\u6587\u3092AI\u304C\u6E80\u305F\u3057\u305F\u304B\u306F\u81EA\u52D5\u5224\u5B9A\u3057\u306A\u3044\u3002\n- scope B12 --goal "\u9054\u6210\u3059\u308B\u3053\u3068" --non-goals "\u4ECA\u56DE\u6271\u308F\u306A\u3044\u3053\u3068" --constraints "\u5B88\u308B\u6761\u4EF6" --acceptance "\u78BA\u8A8D\u3059\u308B\u6761\u4EF6" --consult "\u76F8\u8AC7\u3059\u308B\u6761\u4EF6" \u3067\u8A2D\u5B9A\u3059\u308B\u3002scope B12 \u306F\u8868\u793A\u3060\u3051\u3002\u5404\u9805\u76EE\u306B none \u307E\u305F\u306F\u7A7A\u6587\u5B57\u3092\u6E21\u3059\u3068\u6D88\u3059\u3002\u753B\u9762\u3067\u306F\u8A73\u7D30\u30D1\u30CD\u30EB\u306E\u300C\u305D\u306E\u4ED6\u300D\u30BF\u30D6 \u2192\u300C\u4F5C\u696D\u7BC4\u56F2\u3092\u7DE8\u96C6\u300D\u3002\u8A18\u5165\u6E08\u307F\u306E\u9805\u76EE\u3060\u3051\u304C\u300C\u4ECA\u56DE\u306E\u7BC4\u56F2\u300D\u306B\u51FA\u308B\u3002\n- focus B12 \u3067\u3053\u306E\u30DC\u30C3\u30AF\u30B9\u3068\u914D\u4E0B\u3092\u6B21\u5019\u88DC\u306E\u5148\u982D\u306B\u3059\u308B\u3002focus \u306F\u73FE\u5728\u306E\u5BFE\u8C61\u306E\u8868\u793A\u3001focus none \u306F\u89E3\u9664\u3002\u5BFE\u8C61\u5916\u3082\u5225\u306E\u7D44\u306B\u6B8B\u308B\u3002\u5019\u88DC\u306B\u51FA\u308B\u3053\u3068\u81EA\u4F53\u306F\u4F5C\u696D\u7BC4\u56F2\u306E\u62E1\u5927\u3084\u516C\u958B\u3092\u8A31\u53EF\u3057\u306A\u3044\u3002\n- \u8A08\u753B\u306E\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306B\u8CC7\u6599\u304C\u7121\u3044\u3068\u3001\u4F7F\u3046\u7BB1\u306F\u3059\u3079\u3066\u5165\u529B\u5F85\u3061\u306B\u306A\u308B\u3002\u8CC7\u6599\u304C\u30EA\u30DD\u30B8\u30C8\u30EA\u306B\u3042\u308C\u3070 `npx boxglow artifact inputs <\u30D1\u30B9\u304B URL> --input <\u5165\u529B\u540D>` \u3067\u81EA\u5206\u3067\u4ED8\u3051\u308B (\u4EBA\u306B\u983C\u307E\u306A\u3044)\u3002\u5916\u3059\u306E\u306F `artifact <block|inputs> --remove <\u984C\u540D\u304B\u30D1\u30B9>`\u3002\u7121\u304F\u3066\u3082\u7740\u624B\u3067\u304D\u308B\u5165\u529B\u306F `port <block> --optional <\u5165\u529B\u540D>`\u3002\n- \u6E08\u3093\u3060\u7BB1\u306E\u300C\u65B9\u91DD: \u78BA\u304B\u3081\u76F4\u3057\u300D\u306F\u3001\u4F5C\u696D\u304C\u65B9\u91DD\u306B\u5408\u3063\u3066\u3044\u308C\u3070 `npx boxglow ack <block> --policy` \u3067\u6D88\u3059 (\u5408\u3063\u3066\u3044\u306A\u3051\u308C\u3070 reopen)\u3002\n- start \u306E\u5FC5\u9808\u5165\u529B\u4E0D\u8DB3\u306F\u65E2\u5B9A\u3067\u8B66\u544A\u3059\u308B\u304C\u3001\u5F93\u6765\u3069\u304A\u308A\u958B\u59CB\u3067\u304D\u308B\u3002\u5148\u884C\u4F5C\u696D\u304C\u5FC5\u8981\u306A\u3089 --reason "\u5148\u306B\u884C\u3046\u7406\u7531" \u3092\u4ED8\u3051\u308B\u3002\u8B66\u544A\u306F\u51FA\u305A\u3001\u7406\u7531\u306F\u6D3B\u52D5\u3068\u30ED\u30B0\u306B\u6B8B\u308B\u3002done \u306E\u51FA\u529B\u6210\u679C\u7269\u306A\u3057\u3082\u65E2\u5B9A\u3067\u8B66\u544A\u306E\u307F\u3002\u65E2\u5B58\u306E\u51FA\u529B\u6210\u679C\u7269\u307E\u305F\u306F --artifact \u3092\u6570\u3048\u3001\u30DC\u30C3\u30AF\u30B9\u306E\u53C2\u8003\u8CC7\u6599\u306F\u6570\u3048\u306A\u3044\u3002\n- \u8A08\u753B\u3067\u9078\u3076\u5834\u5408\u3060\u3051 policy --start reject --done reject --unprepared reject \u306B\u3059\u308B\u3002\u305D\u308C\u305E\u308C warn \u306B\u623B\u305B\u308B\u3002\u5165\u529B\u5F85\u3061\u306E\u62D2\u5426\u3067\u3082\u7406\u7531\u4ED8\u304D\u306E\u958B\u59CB\u306F\u53EF\u80FD\u3060\u304C\u3001\u8981\u5177\u4F53\u5316\u306E\u62D2\u5426\u306F\u7406\u7531\u3067\u306F\u901A\u308C\u306A\u3044\u3002\u6210\u679C\u7269\u306A\u3057\u306E\u62D2\u5426\u306F set --status white \u306B\u3082\u52B9\u304F\u3002\u4EBA\u306E\u64CD\u4F5C (\u753B\u9762 / --actor human) \u306F\u62D2\u5426\u3057\u306A\u3044\u3002AI\u304C\u62D2\u5426\u3092\u907F\u3051\u308B\u305F\u3081\u306B\u4EBA\u3092\u540D\u4E57\u3063\u305F\u308A\u3001\u8A2D\u5B9A\u3092\u5F31\u3081\u305F\u308A\u3057\u306A\u3044\u3002\n- guard \u6709\u52B9\u6642\u3001scope \u306E\u5909\u66F4\u3001focus \u306E\u8A2D\u5B9A\u30FB\u89E3\u9664\u3001policy \u306E\u5909\u66F4\u306B\u3082 --context-token \u304C\u5FC5\u8981\u3002scope/focus/policy \u3092\u5909\u3048\u308B\u3068\u65B0\u3057\u3044\u30C8\u30FC\u30AF\u30F3\u304C\u51FA\u308B\u306E\u3067\u3001\u6B21\u306E\u64CD\u4F5C\u306F\u305D\u308C\u3092\u4F7F\u3046\u3002\u8868\u793A\u3060\u3051\u306B\u306F\u4E0D\u8981\u3002\n- resume \u306F\u5B8C\u4E86\u6E08\u307F\u306E\u5F15\u304D\u7D99\u304E\u672C\u6587\u3092\u96A0\u3057\u3001\u4EF6\u6570\u3060\u3051\u793A\u3059\u3002\u5C65\u6B74\u304C\u5FC5\u8981\u306A\u5834\u5408\u3060\u3051 resume --include-completed \u3067\u5C55\u958B\u3059\u308B (context / show \u3067\u306F\u500B\u5225\u306B\u8AAD\u3081\u308B)\u3002\n- \u8AAC\u660E\u306F descriptionUpdatedAt\u3001\u72B6\u614B\u306F statusChangedAt\u3001\u5F15\u304D\u7D99\u304E\u306F\u65E2\u5B58\u306E at \u3067\u65E5\u6642\u3092\u78BA\u8A8D\u3067\u304D\u308B\u3002\u72B6\u614B\u5909\u66F4\u3088\u308A\u53E4\u3044\u30E1\u30E2\u306F\u305D\u306E\u65E8\u3092\u793A\u3059\u3002\u65E7\u8A18\u9332\u306E\u4E0D\u660E\u306A\u65E5\u6642\u306F\u88DC\u308F\u306A\u3044\u3002\u300C\u65B0\u3057\u3044\u8A18\u9332\u300D\u306F\u771F\u507D\u306E\u4FDD\u8A3C\u3067\u306F\u306A\u3044\u3002\n- Done \u3067\u53E4\u3044\u72B6\u6CC1\u8AAC\u660E\u304C\u6B8B\u308B\u53EF\u80FD\u6027\u304C\u3042\u308B\u5834\u5408\u3001CLI\u30FB\u8A73\u7D30\u30D1\u30CD\u30EB\u30FBresume \u306B\u898B\u76F4\u3057\u6848\u5185\u304C\u51FA\u308B\u3002\u672C\u6587\u306F\u81EA\u52D5\u3067\u6D88\u3055\u306A\u3044\u3002\u5185\u5BB9\u3092\u78BA\u8A8D\u3057\u3001\u5FC5\u8981\u306A\u3089 set B12 --note "\u73FE\u5728\u306E\u8AAC\u660E" (none \u3067\u6D88\u53BB) \u307E\u305F\u306F\u753B\u9762\u306E Notes \u3067\u76F4\u3059\u3002\n- MCP \u306F boxglow_scope / boxglow_focus / boxglow_policy\u3001boxglow_start \u306E reason\u3001boxglow_resume \u306E includeCompleted \u3092\u4F7F\u3046\u3002\u5909\u66F4\u306B\u306F contextToken \u3092\u4ED8\u3051\u308B\u3002\n- \u30C7\u30FC\u30BF\u5F62\u5F0F\u306F v5 \u306E\u307E\u307E\u3067\u5168\u9805\u76EE\u306F\u4EFB\u610F\u3002\u65E7\u7248 (0.4.2\u4EE5\u524D) \u306F\u65B0\u3057\u3044\u898F\u5247\u3092\u5B9F\u884C\u305B\u305A\u3001\u4FDD\u5B58\u6642\u306B\u8A08\u753B\u306E workflowPolicy / focusBlockId \u3092\u843D\u3068\u3059\u3002\u3053\u308C\u3089\u3092\u4F7F\u3046\u8A08\u753B\u306E\u66F8\u304D\u624B (CLI\u30FBserve\u30FB\u753B\u9762\u30FB\u62E1\u5F35\u5185\u306E\u30A2\u30D7\u30EA) \u306F\u5BFE\u5FDC\u3057\u305F\u30D3\u30EB\u30C9\u306B\u63C3\u3048\u308B\u3002\u7248\u756A\u53F7\u3060\u3051\u3067\u306A\u304F\u30D3\u30EB\u30C9\u65E5\u6642\u3082\u78BA\u8A8D\u3059\u308B\u3002\n';
 
 // .claude/skills/boxglow/SKILL.en.md
-var SKILL_en_default = '---\nname: boxglow\ndescription: Share the plan and progress with humans through Boxglow (boxglow.json). Record starting, splitting, finishing and pending decisions with npx boxglow. Use for "record progress in Boxglow", "check the status with boxglow", or "/boxglow".\n---\n\n# Share the plan and progress with Boxglow\n\n`boxglow.json` at the repository root is the source of truth for the plan. Humans watch it on the Boxglow screen (https://boxglow.app/, "Open boxglow.json").\nDo not edit it directly; update it with `npx boxglow`.\n\n## Making the first plan (for a new project)\n\n1. Read the direction (README, the request, requirement notes), run `npx boxglow init --name "<name>"`, then place the top-level items (3-7 of them) with `add`.\n   For each item, always write its "inputs (what it uses)" and "output (a concrete deliverable: file, URL, PR)", and connect them all the way to the final deliverable (`connect`)\n2. Once created, get a human\'s confirmation with `npx boxglow ask <first top-level item> "Is this breakdown into top-level items OK?" --options "OK|Needs changes"`.\n   The human can answer on the screen, with `npx boxglow answer <block> "<answer>"`, or in chat. If the answer comes back in chat, the AI records it with `answer --by human`.\n   If the human does not use the screen (when you are told to proceed with the AI alone), the AI records its own decision with `answer --by claude-code "<decision and reason>"` and moves on. The point is to keep a record of decisions; the screen is not required\n3. `split` only the item you are about to start (leave later stages coarse, and refine them as you go)\n\n## Steps\n\n1. Read `npx boxglow resume` (or `npx boxglow status --brief`). Take in the handoff notes, the answers not yet read by the AI, the pending decisions, the boxes in progress and the next candidates. Use `npx boxglow status` when you need the whole tree\n2. Once you have chosen a box, read `npx boxglow context <block>`. If `readiness.state` is `ready` you can start. `unprepared` (needs detail) means you add detail first, following the reasons in `unprepared` and the commands in `next`. `waiting` means a required input or a branch answer is missing\n3. Before adding detail or splitting, hold the box with `npx boxglow claim <block>` (it does not start the box; on a plan without claims it prints "not needed" and succeeds). Fill in what is missing:\n   the output\'s planned deliverable `npx boxglow port <block> --expect "<output>=file:src/x.ts"` (kind: file / dir / url / doc / note / decision / result; the file need not exist yet) and the acceptance criteria `npx boxglow scope <block> --acceptance "<when it counts as done>"`.\n   Split a large box with `npx boxglow split <block> --spec \'<JSON>\'` (see `npx boxglow help` for the format). Write expect / acceptance only for the children you will start now; later children need only a title and an output.\n   When you do not know which files are involved, do not invent paths: add a box "find the target" with a `note` output and start that.\n   After a split, read `npx boxglow lint <block>` and fix the "must fix" items before going on ("review" items are yours to judge). Record how the children are divided with `"splitBy": "stage"` (or `set --split-by`).\n   Content review: read `review-split <parent>` (material and checklist) and record `split-ok <parent> --note "<basis>"`; before a start, `review-box <block>` \u2192 `box-ok <block> --note "<basis>"` (when the material changes, `reviews` in context goes stale).\n   When an answer changes the work that follows, `ask ... --options "A|B" --branch` turns the box into a branch (in the split JSON: `"branch": { question, options }` / `"join": true`)\n4. Once ready, read `npx boxglow context <block>` again and run `npx boxglow start <block> --note "<what you will do>"`.\n   On a plan with the context guard on, pass the `contextToken` (context token) from the context output as `--context-token <context token>`.\n   Starting a box that still needs detail warns by default; on a plan with `policy --unprepared reject` it is refused (`--reason` does not bypass it). A parent whose outputs are all made by its children has nothing to run itself: start the child instead\n5. When the deliverable exists, run `npx boxglow done <block> --artifact "<name>=<URL or path>" --checked "<checks run and results>"` (record the verification in three fixed fields: `--checked` checks run and results / `--not-checked` what was not tried / `--limits` remaining limits; for non-code deliverables write what you confirmed) (with the guard on, add `--context-token <context token>`; if your previous command printed "New context token: <token>", use that one)\n6. When a human decision is needed, run `npx boxglow ask <block> "<question>" --options "A|B"` and move on to another box\n7. When you are stuck: If the cause is a missing input (a deliverable of an earlier box, or material), do not mark the box as blocked. Check its input wires with `npx boxglow show <block>`; if no box produces what is missing, create one outside (upstream) with `npx boxglow add` and wire it to this box\'s input with `npx boxglow connect` (the wire stays in the waiting color, so the diagram shows what the box is waiting for). If a choice between options would let you continue, use `ask`. Record only obstacles outside the plan (an environment that does not work, missing permissions or keys, waiting for an outside reply, a failure with no known cause) with `npx boxglow blocked <block> --note "<what is in the way>"`\n8. Before an interruption, context compaction or a handoff, save a handoff note with `npx boxglow checkpoint <block> --note "Findings; next steps; unresolved questions"`\n9. At the end, summarize `npx boxglow status --brief` and report it\n\n## Rules\n\n- **Show an undecided fork as a branch**: when, at planning time, later work (a path) depends on a decision that has not been made, create a branch box with `npx boxglow branch "<title>" --options "A|B" --question "<question>" --context "<background>"`. Each option becomes a path (output); `connect` each one to the first box of that path. Where the paths come together again, add a merge part with `npx boxglow join --title "<title>"`, `connect` the last output of each path to it, and connect its output to the next box (any one path arriving is enough). Once a person answers, the boxes on the paths not chosen are skipped and drop out of progress and next candidates. If a box you already made turns out to be an undecided fork, turn it into a branch with `npx boxglow branch --box <block> --options "A|B" --question "<question>"` (its output becomes the first option\'s path; wires stay). Before the answer, boxes on the paths wait for the branch and starting them warns (record a reason with `--reason`, e.g. for early research)\n- Write each `ask` question so that it can be decided on its own. Do not point outside the question, as in "Is this OK?" or "the plan above"; put the premises, comparison and impact in `--context` (the human reads only the question in a list and answers it)\n- When choosing one of several candidates (an approach, a library, a design choice), even if the AI decides by itself, record it as `ask <block> "<question>" --options "A|B|C"` \u2192 `answer --by claude-code "<the choice>. Reason: ..."` so that the candidates not chosen stay on the box (you can come back to them when the direction changes)\n- To change direction, use `reopen <block> --note "<reason>"`: the previous answer stays in the history and you choose again (candidates are not deleted)\n\n- Keep at most 1-2 boxes in progress at a time\n- Make deliverables (artifacts) something a human can open later (a commit, a PR, a file path)\n- Name outputs after concrete deliverables (file, PR, URL, test results). Avoid abstract names (feature set, findings). When one piece of work produces several things, give it one output per thing (`port <block> --out "<name>"` adds one)\n- The receiving side of a connection can be just a title (`connect "A.Design doc" "B"` creates an input "Design doc" on B). Connected inputs and outputs share one name (renaming either end renames the other)\n- Always connect boxes as "input \u2192 output". Add missing inputs / outputs with `port`, remove a wire with `disconnect`, and remove a box itself with `remove`. Export a document with `export --out docs/ROADMAP.md`\n- When you add a box, give it a kind of work with `--category` (design / build / verify / evaluate / study / research / ui / improve / fix / docs / ops / other). On the screen it becomes a colored band and a tag\n- If boxglow.json does not exist yet, create it with `npx boxglow init --name "<project name>"` and place the final deliverable and the top-level boxes with `add`\n\n## What runs automatically (hooks)\n\n`setup-agent` registers `boxglow hook` in the Claude Code / Codex hooks. After a session starts, resumes or is compacted, the plan\'s resume summary is injected into the context. When you are about to finish a reply while a box started in this session has no handoff (done or checkpoint), you are told to record first and continue (a log entry is a progress note, not a handoff). Editing boxglow.json directly (Edit / Write / apply_patch) is blocked. This is a safety net; keep recording as the steps above say.\nReviews of a split or of readiness can be delegated to the subagent `boxglow-review` (it reads review-split / review-box and returns its evaluation and reasoning; you, the parent, record split-ok / box-ok with that reasoning).\n\n## Context token and handoff\n\nThe context guard keeps an AI from continuing work on outdated instructions. `setup-agent` turns it on (on other plans, run `npx boxglow guard on`).\nWhile it is on, an AI\'s `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` need `--context-token <context token>`. Commands run by a person (`--actor human`) do not.\n\n```\nnpx boxglow context B12        # read the decisions (including acknowledged answers), input/output contracts and handoff notes. contextToken in the output is the context token\nnpx boxglow start B12 --note "<what you will do>" --context-token <context token>\nnpx boxglow ask B12 "<question>" --options "A|B" --context-token <context token>\n#   -> last line of the output: New context token: <token>\nnpx boxglow done B12 --artifact "<name>=<path>" --context-token <new context token>\n```\n\n- **The context token changes (you must reread)** when a person answers a decision or revises an answer, a person changes the instructions (title, description, input/output contracts), or another AI or a person updates the handoff note. The same applies when this happens on a parent box or an input provider. The old context token is rejected: reread `context`, take the change into account in your work, then retry\n- **The context token does not change** on `start` / `blocked` / `review` / `leave` / `ack`, on changes to progress, status, dates or category, when `check` verifies deliverables, or when boxes are moved on the screen. Keep using the same context token\n- **You can update it yourself**: when your own `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` etc. changes the context, the last line of its output is "New context token: <token>". Use it for the next command without rereading. `ask` / `decision` / `answer` / `reopen` run without a context token, but they print the new context token only when you pass the latest one\n- Do not turn the guard off to get past an old context token (an AI needs the latest context token to run `guard off`)\n- When resuming, read `npx boxglow resume`, and check a box that has a handoff note with `context` before continuing. Handoff notes stay in the plan, independent of the chat history and the activity-log limit\n- With MCP, use `boxglow_context` and the `contextToken` argument of each tool\n- If "Another Boxglow writer holds the file lock" persists after waiting and retrying, show the output of `npx boxglow unlock` (owner and verdict) to a person and ask them to remove it. Never add `--actor human` yourself or delete the lock folder directly\n\n\n### Readiness, current scope, and fresh resume information\n\n- Read current activity, pending decisions, and unread answers first. Candidates are grouped by current scope / other candidates, then ready / needs detail / waiting for inputs, with the reasons and missing input names. A candidate that needs detail or is waiting is not ready. "Ready" is a mechanical check (an output of its own, expect, acceptance, required inputs) and does not judge how specific the text is.\n- Four optional scope fields are available: goal, non-goals, acceptance, and consult (when to consult before expanding scope). Read the target and parent scopes at the start of context before starting and finishing. Textual acceptance criteria are not automatically evaluated.\n- Use scope B12 --goal "Goal" --non-goals "Excluded" --acceptance "Checks" --consult "When to ask". scope B12 only reads; none or an empty string clears a field. In the inspector, use the More tab \u2192 Edit work scope. Only populated fields appear in the collapsed scope section.\n- focus B12 prioritizes that box and its descendants; focus reads the selection, and focus none clears it. Other candidates remain in a separate group. Being listed does not authorize expanding scope or publishing.\n- Missing required inputs warn on start by default but still allow the start. Supply --reason "Why starting early is appropriate" to proceed without a warning and save the reason in both activity and the log. Artifact-free done also remains warning-only by default. Existing output artifacts or --artifact count; reference material on the box does not.\n- Only enable strict checks when selected for the plan: policy --start reject --done reject --unprepared reject. Each can return to warn. A recorded start reason overrides the missing-input rejection, but not the needs-detail one. The artifact requirement also applies to set --status white. Human operations (UI / --actor human) are never rejected. Do not impersonate a human or weaken policy to bypass rejection.\n- With guard enabled, scope writes, focus selection/clearing, and policy writes require --context-token. These changes print a new token: use it next. Read-only forms need no token.\n- resume hides completed handoff bodies and shows their count. Request resume --include-completed only when history is needed; context / show can still read individual notes.\n- descriptionUpdatedAt dates description changes; statusChangedAt dates status changes; handoffs use their existing at field. Notes predating a status change are marked. Unknown legacy dates stay unknown, and recency does not establish truth.\n- After Done, CLI, inspector, and resume flag descriptions that may still describe an earlier state. Text is never rewritten automatically. Review it, then update with set B12 --note "Current description" (none clears it) or Notes in the UI.\n- MCP: boxglow_scope / boxglow_focus / boxglow_policy, reason on boxglow_start, and includeCompleted on boxglow_resume. Pass contextToken for writes.\n- All data fields are optional; schema v5 is unchanged. Old versions (0.4.2 and earlier) do not enforce these checks and drop workflowPolicy / focusBlockId when saving. Align all writers (CLI, serve, web app, bundled extension app) to a supporting build before using these settings. Check build time as well as version.\n';
+var SKILL_en_default = '---\nname: boxglow\ndescription: Share the plan and progress with humans through Boxglow (boxglow.json). Record starting, splitting, finishing and pending decisions with npx boxglow. Use for "record progress in Boxglow", "check the status with boxglow", or "/boxglow".\n---\n\n# Share the plan and progress with Boxglow\n\n`boxglow.json` at the repository root is the source of truth for the plan. Humans watch it on the Boxglow screen (https://boxglow.app/, "Open boxglow.json").\nDo not edit it directly; update it with `npx boxglow`.\n\n## Making the first plan (for a new project)\n\n1. Read the direction (README, the request, requirement notes), run `npx boxglow init --name "<name>"`, then place the top-level items (3-7 of them) with `add`.\n   For each item, always write its "inputs (what it uses)" and "output (a concrete deliverable: file, URL, PR)", and connect them all the way to the final deliverable (`connect`)\n2. Once created, get a human\'s confirmation with `npx boxglow ask <first top-level item> "Is this breakdown into top-level items OK?" --options "OK|Needs changes"`.\n   The human can answer on the screen, with `npx boxglow answer <block> "<answer>"`, or in chat. If the answer comes back in chat, the AI records it with `answer --by human`.\n   If the human does not use the screen (when you are told to proceed with the AI alone), the AI records its own decision with `answer --by claude-code "<decision and reason>"` and moves on. The point is to keep a record of decisions; the screen is not required\n3. `split` only the item you are about to start (leave later stages coarse, and refine them as you go)\n\n## Steps\n\n1. Read `npx boxglow resume` (or `npx boxglow status --brief`). Take in the handoff notes, the answers not yet read by the AI, the pending decisions, the boxes in progress and the next candidates. Use `npx boxglow status` when you need the whole tree\n2. Once you have chosen a box, read `npx boxglow context <block>`. If `readiness.state` is `ready` you can start. `unprepared` (needs detail) means you add detail first, following the reasons in `unprepared` and the commands in `next`. `waiting` means a required input or a branch answer is missing\n3. Before adding detail or splitting, hold the box with `npx boxglow claim <block>` (it does not start the box; on a plan without claims it prints "not needed" and succeeds). Fill in what is missing:\n   the output\'s planned deliverable `npx boxglow port <block> --expect "<output>=file:src/x.ts"` (kind: file / dir / url / doc / note / decision / result; the file need not exist yet) and the acceptance criteria `npx boxglow scope <block> --acceptance "<when it counts as done>"`.\n   Split a large box with `npx boxglow split <block> --spec \'<JSON>\'` (see `npx boxglow help` for the format). Write expect / acceptance only for the children you will start now; later children need only a title and an output.\n   When you do not know which files are involved, do not invent paths: add a box "find the target" with a `note` output and start that.\n   After a split, read `npx boxglow lint <block>` and fix the "must fix" items before going on ("review" items are yours to judge). Record how the children are divided with `"splitBy": "stage"` (or `set --split-by`).\n   Content review: read `review-split <parent>` (material and checklist) and record `split-ok <parent> --note "<basis>"`; before a start, `review-box <block>` \u2192 `box-ok <block> --note "<basis>"` (when the material changes, `reviews` in context goes stale).\n   When an answer changes the work that follows, `ask ... --options "A|B" --branch` turns the box into a branch (in the split JSON: `"branch": { question, options }` / `"join": true`)\n4. Once ready, read `npx boxglow context <block>` again and run `npx boxglow start <block> --note "<what you will do>"`.\n   On a plan with the context guard on, pass the `contextToken` (context token) from the context output as `--context-token <context token>`.\n   Starting a box that still needs detail warns by default; on a plan with `policy --unprepared reject` it is refused (`--reason` does not bypass it). A parent whose outputs are all made by its children has nothing to run itself: start the child instead\n5. When the deliverable exists, run `npx boxglow done <block> --artifact "<name>=<URL or path>" --checked "<checks run and results>"` (record the verification in three fixed fields: `--checked` checks run and results / `--not-checked` what was not tried / `--limits` remaining limits; for non-code deliverables write what you confirmed) (with the guard on, add `--context-token <context token>`; if your previous command printed "New context token: <token>", use that one)\n6. When a human decision is needed, run `npx boxglow ask <block> "<question>" --options "A|B"` and move on to another box\n7. When you are stuck: If the cause is a missing input (a deliverable of an earlier box, or material), do not mark the box as blocked. Check its input wires with `npx boxglow show <block>`; if no box produces what is missing, create one outside (upstream) with `npx boxglow add` and wire it to this box\'s input with `npx boxglow connect` (the wire stays in the waiting color, so the diagram shows what the box is waiting for). If a choice between options would let you continue, use `ask`. Record only obstacles outside the plan (an environment that does not work, missing permissions or keys, waiting for an outside reply, a failure with no known cause) with `npx boxglow blocked <block> --note "<what is in the way>"`\n8. Before an interruption, context compaction or a handoff, save a handoff note with `npx boxglow checkpoint <block> --note "Findings; next steps; unresolved questions"`\n9. At the end, summarize `npx boxglow status --brief` and report it\n\n## Rules\n\n- **Show an undecided fork as a branch**: when, at planning time, later work (a path) depends on a decision that has not been made, create a branch box with `npx boxglow branch "<title>" --options "A|B" --question "<question>" --context "<background>"`. Each option becomes a path (output); `connect` each one to the first box of that path. Where the paths come together again, add a merge part with `npx boxglow join --title "<title>"`, `connect` the last output of each path to it, and connect its output to the next box (any one path arriving is enough). Once a person answers, the boxes on the paths not chosen are skipped and drop out of progress and next candidates. If a box you already made turns out to be an undecided fork, turn it into a branch with `npx boxglow branch --box <block> --options "A|B" --question "<question>"` (its output becomes the first option\'s path; wires stay). Before the answer, boxes on the paths wait for the branch and starting them warns (record a reason with `--reason`, e.g. for early research)\n- Write each `ask` question so that it can be decided on its own. Do not point outside the question, as in "Is this OK?" or "the plan above"; put the premises, comparison and impact in `--context` (the human reads only the question in a list and answers it)\n- When choosing one of several candidates (an approach, a library, a design choice), even if the AI decides by itself, record it as `ask <block> "<question>" --options "A|B|C"` \u2192 `answer --by claude-code "<the choice>. Reason: ..."` so that the candidates not chosen stay on the box (you can come back to them when the direction changes)\n- To change direction, use `reopen <block> --note "<reason>"`: the previous answer stays in the history and you choose again (candidates are not deleted)\n\n- Keep at most 1-2 boxes in progress at a time\n- Make deliverables (artifacts) something a human can open later (a commit, a PR, a file path)\n- Name outputs after concrete deliverables (file, PR, URL, test results). Avoid abstract names (feature set, findings). When one piece of work produces several things, give it one output per thing (`port <block> --out "<name>"` adds one)\n- The receiving side of a connection can be just a title (`connect "A.Design doc" "B"` creates an input "Design doc" on B). Connected inputs and outputs share one name (renaming either end renames the other)\n- Always connect boxes as "input \u2192 output". Add missing inputs / outputs with `port`, remove a wire with `disconnect`, and remove a box itself with `remove`. Export a document with `export --out docs/ROADMAP.md`\n- When you add a box, give it a kind of work with `--category` (design / build / verify / evaluate / study / research / ui / improve / fix / docs / ops / other). On the screen it becomes a colored band and a tag\n- If boxglow.json does not exist yet, create it with `npx boxglow init --name "<project name>"` and place the final deliverable and the top-level boxes with `add`\n\n## What runs automatically (hooks)\n\n`setup-agent` registers `boxglow hook` in the Claude Code / Codex hooks. After a session starts, resumes or is compacted, the plan\'s resume summary is injected into the context. When you are about to finish a reply while a box started in this session has no handoff (done or checkpoint), you are told to record first and continue (a log entry is a progress note, not a handoff). Editing boxglow.json directly (Edit / Write / apply_patch) is blocked. This is a safety net; keep recording as the steps above say.\nReviews of a split or of readiness can be delegated to the subagent `boxglow-review` (it reads review-split / review-box and returns its evaluation and reasoning; you, the parent, record split-ok / box-ok with that reasoning).\n\n## Context token and handoff\n\nThe context guard keeps an AI from continuing work on outdated instructions. `setup-agent` turns it on (on other plans, run `npx boxglow guard on`).\nWhile it is on, an AI\'s `start` / `done` / `set` / `split` / `artifact` / `ack` / `blocked` / `review` / `leave` / `checkpoint` need `--context-token <context token>`. Commands run by a person (`--actor human`) do not.\n\n```\nnpx boxglow context B12        # read the decisions (including acknowledged answers), input/output contracts and handoff notes. contextToken in the output is the context token\nnpx boxglow start B12 --note "<what you will do>" --context-token <context token>\nnpx boxglow ask B12 "<question>" --options "A|B" --context-token <context token>\n#   -> last line of the output: New context token: <token>\nnpx boxglow done B12 --artifact "<name>=<path>" --context-token <new context token>\n```\n\n- **The context token changes (you must reread)** when a person answers a decision or revises an answer, a person changes the instructions (title, description, input/output contracts), or another AI or a person updates the handoff note. The same applies when this happens on a parent box or an input provider. The old context token is rejected: reread `context`, take the change into account in your work, then retry\n- **The context token does not change** on `start` / `blocked` / `review` / `leave` / `ack`, on changes to progress, status, dates or category, when `check` verifies deliverables, or when boxes are moved on the screen. Keep using the same context token\n- **You can update it yourself**: when your own `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` etc. changes the context, the last line of its output is "New context token: <token>". Use it for the next command without rereading. `ask` / `decision` / `answer` / `reopen` run without a context token, but they print the new context token only when you pass the latest one\n- Do not turn the guard off to get past an old context token (an AI needs the latest context token to run `guard off`)\n- When resuming, read `npx boxglow resume`, and check a box that has a handoff note with `context` before continuing. Handoff notes stay in the plan, independent of the chat history and the activity-log limit\n- With MCP, use `boxglow_context` and the `contextToken` argument of each tool\n- If "Another Boxglow writer holds the file lock" persists after waiting and retrying, show the output of `npx boxglow unlock` (owner and verdict) to a person and ask them to remove it. Never add `--actor human` yourself or delete the lock folder directly\n\n\n### Readiness, current scope, and fresh resume information\n\n- Read current activity, pending decisions, and unread answers first. Candidates are grouped by current scope / other candidates, then ready / needs detail / waiting for inputs, with the reasons and missing input names. A candidate that needs detail or is waiting is not ready. "Ready" is a mechanical check (an output of its own, expect, acceptance, required inputs) and does not judge how specific the text is.\n- Four optional scope fields are available: goal, non-goals, acceptance, and consult (when to consult before expanding scope). Read the target and parent scopes at the start of context before starting and finishing. Textual acceptance criteria are not automatically evaluated.\n- Use scope B12 --goal "Goal" --non-goals "Excluded" --acceptance "Checks" --consult "When to ask". scope B12 only reads; none or an empty string clears a field. In the inspector, use the More tab \u2192 Edit work scope. Only populated fields appear in the collapsed scope section.\n- focus B12 prioritizes that box and its descendants; focus reads the selection, and focus none clears it. Other candidates remain in a separate group. Being listed does not authorize expanding scope or publishing.\n- When a top-level plan input has no material, every box that uses it waits. If the material is in the repository, attach it yourself with `npx boxglow artifact inputs <path or URL> --input <input name>` (do not ask a person). Remove one with `artifact <block|inputs> --remove <title or path>`. Make an input optional with `port <block> --optional <input name>`.\n- When a finished box shows "Policy: check again" and the work matches the policy, clear it with `npx boxglow ack <block> --policy` (otherwise reopen it).\n- Missing required inputs warn on start by default but still allow the start. Supply --reason "Why starting early is appropriate" to proceed without a warning and save the reason in both activity and the log. Artifact-free done also remains warning-only by default. Existing output artifacts or --artifact count; reference material on the box does not.\n- Only enable strict checks when selected for the plan: policy --start reject --done reject --unprepared reject. Each can return to warn. A recorded start reason overrides the missing-input rejection, but not the needs-detail one. The artifact requirement also applies to set --status white. Human operations (UI / --actor human) are never rejected. Do not impersonate a human or weaken policy to bypass rejection.\n- With guard enabled, scope writes, focus selection/clearing, and policy writes require --context-token. These changes print a new token: use it next. Read-only forms need no token.\n- resume hides completed handoff bodies and shows their count. Request resume --include-completed only when history is needed; context / show can still read individual notes.\n- descriptionUpdatedAt dates description changes; statusChangedAt dates status changes; handoffs use their existing at field. Notes predating a status change are marked. Unknown legacy dates stay unknown, and recency does not establish truth.\n- After Done, CLI, inspector, and resume flag descriptions that may still describe an earlier state. Text is never rewritten automatically. Review it, then update with set B12 --note "Current description" (none clears it) or Notes in the UI.\n- MCP: boxglow_scope / boxglow_focus / boxglow_policy, reason on boxglow_start, and includeCompleted on boxglow_resume. Pass contextToken for writes.\n- All data fields are optional; schema v5 is unchanged. Old versions (0.4.2 and earlier) do not enforce these checks and drop workflowPolicy / focusBlockId when saving. Align all writers (CLI, serve, web app, bundled extension app) to a supporting build before using these settings. Check build time as well as version.\n';
 
 // src/model/export.ts
 var STATUS_LABEL = {
@@ -13675,7 +13780,7 @@ function terminalHeight(p, which) {
 }
 
 // cli/main.ts
-import { dirname as dirname10, join as join12, resolve as resolve6 } from "node:path";
+import { dirname as dirname11, join as join13, resolve as resolve7 } from "node:path";
 
 // src/model/report.ts
 var quoted = (title) => t("\u300C{title}\u300D", { title });
@@ -13893,8 +13998,8 @@ var STATUS_LABEL2 = {
 
 // cli/git.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { existsSync as existsSync12, statSync as statSync6 } from "node:fs";
-import { dirname as dirname9, relative as relative2, resolve as resolve5 } from "node:path";
+import { existsSync as existsSync13, statSync as statSync7 } from "node:fs";
+import { dirname as dirname10, relative as relative2, resolve as resolve6 } from "node:path";
 function git(args, cwd) {
   try {
     return execFileSync2("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
@@ -13912,9 +14017,9 @@ function remoteToWeb(remote) {
   return null;
 }
 function gitRefFor(filePath) {
-  const abs = resolve5(filePath);
-  if (!existsSync12(abs) || !statSync6(abs).isFile()) return null;
-  const root = git(["rev-parse", "--show-toplevel"], dirname9(abs));
+  const abs = resolve6(filePath);
+  if (!existsSync13(abs) || !statSync7(abs).isFile()) return null;
+  const root = git(["rev-parse", "--show-toplevel"], dirname10(abs));
   if (!root) return null;
   const rel = relative2(root, abs).replace(/\\/g, "/");
   const commit = git(["rev-parse", "HEAD"], root) ?? "";
@@ -13928,14 +14033,14 @@ function gitRefFor(filePath) {
 }
 function findGitRef(recorded, bases) {
   for (const base of bases) {
-    const ref = gitRefFor(resolve5(base, recorded));
+    const ref = gitRefFor(resolve6(base, recorded));
     if (ref) return ref;
   }
   return null;
 }
 function currentRef(root, rel) {
   const commit = git(["rev-parse", "HEAD"], root) ?? "";
-  const blob = git(["hash-object", "--path", rel, "--", resolve5(root, rel)], root) ?? "";
+  const blob = git(["hash-object", "--path", rel, "--", resolve6(root, rel)], root) ?? "";
   const repo = git(["config", "--get", "remote.origin.url"], root) ?? "";
   const web = repo ? remoteToWeb(repo) : null;
   return { path: rel, commit, blob, url: web && commit ? `${web}/blob/${commit}/${rel}` : "" };
@@ -13943,7 +14048,7 @@ function currentRef(root, rel) {
 function checkGitRef(ref, cwd) {
   const root = git(["rev-parse", "--show-toplevel"], cwd);
   if (!root || !ref.path) return { state: "missing" };
-  if (existsSync12(resolve5(root, ref.path))) return { state: "ok", path: ref.path };
+  if (existsSync13(resolve6(root, ref.path))) return { state: "ok", path: ref.path };
   if (ref.blob) {
     const tree = git(["ls-tree", "-r", "HEAD"], root) ?? "";
     for (const line of tree.split("\n")) {
@@ -13961,7 +14066,7 @@ function checkGitRef(ref, cwd) {
         if (m && m[1] === cur) cur = m[2];
       }
     }
-    if (cur !== ref.path && existsSync12(resolve5(root, cur))) return { state: "moved", ...currentRef(root, cur) };
+    if (cur !== ref.path && existsSync13(resolve6(root, cur))) return { state: "moved", ...currentRef(root, cur) };
   }
   return { state: "missing" };
 }
@@ -14200,11 +14305,11 @@ var claimRequest;
 var CONFLICT_RETRIES = 8;
 function load(path) {
   const text2 = planIO().read(path);
-  readRevisions.set(resolve6(path), revisionOf(text2));
+  readRevisions.set(resolve7(path), revisionOf(text2));
   return fromJSON(text2);
 }
 function save(path, p) {
-  const expected = readRevisions.has(resolve6(path)) ? readRevisions.get(resolve6(path)) : null;
+  const expected = readRevisions.has(resolve7(path)) ? readRevisions.get(resolve7(path)) : null;
   const normalized = normalizePortNames(p).project;
   let text2 = toJSON(normalized) + "\n";
   const warnings = [];
@@ -14214,12 +14319,12 @@ function save(path, p) {
     return text2;
   } });
   for (const warning of warnings) out(warning);
-  readRevisions.set(resolve6(path), revision);
+  readRevisions.set(resolve7(path), revision);
   lastSavedText = text2;
 }
 function writeExport(target, text2) {
   let guarded = false;
-  if (existsSync13(target)) {
+  if (existsSync14(target)) {
     try {
       guarded = claimsEnabled(fromJSON(readFileSync14(target, "utf8")));
     } catch {
@@ -14281,6 +14386,9 @@ function reviewSummary(p, blockId) {
     howToGet: `boxglow review-split ${b.key ?? b.id} / boxglow review-box ${b.key ?? b.id}`
   };
 }
+function isInputsRef(ref) {
+  return ref === "inputs" || ref === "Inputs" || ref === ROOT_ID;
+}
 function mustFind(p, ref, what = "block") {
   if (!ref) throw new Error(t("<{what}> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044 (id \u307E\u305F\u306F\u984C\u540D)", { what }));
   const rootClaim = ref === ROOT_ID && claimsEnabled(p) && ["context", "start", "claim", "leave", "checkpoint", "claim-renew", "claim-release"].includes(claimRequest.command);
@@ -14421,10 +14529,10 @@ boxglow CLI: AI \u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 (Claude Code / Codex \u306A
   claim <block> [--scope block|subtree] [--note]    \u53D7\u3051\u6301\u3061\u3060\u3051\u3092\u53D6\u308B (\u5B9F\u884C\u4E2D\u306B\u306F\u3057\u306A\u3044)\u3002\u5206\u89E3\u30FB\u5177\u4F53\u5316\u306E\u524D\u306B: context \u2192 claim \u2192 split / port / scope \u2192 context \u2192 start\u3002\u53D7\u3051\u6301\u3061\u5236\u5FA1\u304C\u7121\u52B9\u306A\u8A08\u753B\u3067\u306F\u300C\u53D6\u5F97\u4E0D\u8981\u300D
   branch <\u984C\u540D> --options "A|B" | --option <A> --option <B> [--question <\u554F\u3044>] [--context <\u5224\u65AD\u6750\u6599>] [--in <\u5165\u529B\u540D>]... [--parent <block>]   \u307E\u3060\u6C7A\u307E\u3063\u3066\u3044\u306A\u3044\u5206\u304B\u308C\u9053 (\u5206\u5C90) \u3092\u8DB3\u3059\u3002\u9078\u629E\u80A2\u3054\u3068\u306B\u9053 (\u51FA\u529B) \u304C\u3067\u304D\u3001answer \u3067\u7B54\u3048\u308B\u3068\u9078\u3070\u306A\u304B\u3063\u305F\u9053\u306F\u898B\u9001\u308A
   branch --box <block> --options "A|B" [--question <\u554F\u3044>] [--context <\u5224\u65AD\u6750\u6599>]   \u4ECA\u3042\u308B\u30DC\u30C3\u30AF\u30B9\u3092\u5206\u5C90\u306B\u5909\u3048\u308B (\u4ECA\u306E\u51FA\u529B\u306F 1 \u3064\u76EE\u306E\u9078\u629E\u80A2\u306E\u9053\u306B\u306A\u308B\u3002\u4E2D\u306B\u30DC\u30C3\u30AF\u30B9\u3092\u6301\u3064\u3082\u306E\u306F\u4E0D\u53EF)
-  branch --box <block> --add-option <\u9053> / --remove-option <\u9053>   \u5206\u5C90\u306E\u9053 (\u9078\u629E\u80A2) \u3092\u8DB3\u3059 / \u6D88\u3059 (\u7B54\u3048\u308B\u524D\u3060\u3051\u3002\u9053\u306F 2 \u3064\u4EE5\u4E0A\u6B8B\u3059)
+  branch --box <block> --add-option <\u9053> / --remove-option <\u9053>   \u5206\u5C90\u306E\u9053 (\u9078\u629E\u80A2) \u3092\u8DB3\u3059 / \u6D88\u3059 (\u7B54\u3048\u305F\u5F8C\u3082\u3067\u304D\u308B)
   join [--title <\u984C\u540D>] [--parent <block>]           \u5408\u6D41\u306E\u90E8\u54C1\u3092\u8DB3\u3059 (\u5206\u304B\u308C\u305F\u9053\u3092 1 \u3064\u306B\u307E\u3068\u3081\u308B\u3002\u9053\u306E\u51FA\u529B\u3092 connect \u3067\u3064\u306A\u3050\u3068\u3001\u3069\u308C\u304B 1 \u3064\u304C\u5C4A\u3051\u3070\u5148\u3078\u9032\u3080)
   move <block> --parent <block|project>            \u30DC\u30C3\u30AF\u30B9\u3092\u5225\u306E\u89AA\u306E\u4E2D\u3078\u79FB\u3059 (\u7DDA\u306F\u9593\u306E\u30DC\u30C3\u30AF\u30B9\u306E\u30DD\u30FC\u30C8\u3092\u7D4C\u7531\u3057\u3066\u3064\u306A\u304C\u3063\u305F\u307E\u307E)
-  port <block|project|inputs> [--in <\u540D\u524D>]... [--out <\u540D\u524D>]... [--remove <\u540D\u524D>]... [--policy <\u51FA\u529B\u540D> [--policy-scope all|<block>] [--advisory]]... [--no-policy <\u51FA\u529B\u540D>]... [--skip-policy <\u7BB1>.<\u51FA\u529B\u540D>]... [--expect "<\u51FA\u529B\u540D>=<kind>:<hint>"]... [--self <\u51FA\u529B\u540D>]... [--no-self <\u51FA\u529B\u540D>]... [--rename <\u65E7\u540D>=<\u65B0\u540D>] [--any-of <\u5165\u529B\u540D>]... [--all-of <\u5165\u529B\u540D>]...   \u65E2\u5B58\u306E\u30DC\u30C3\u30AF\u30B9\u306B\u5165\u529B / \u51FA\u529B\u3092\u8DB3\u3059\u3001\u6D88\u3059 (\u5165\u529B\u3092\u6D88\u3059\u3068\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B\u3002\u6700\u5F8C\u306E\u51FA\u529B\u306F\u6D88\u305B\u306A\u3044)\u3001\u540D\u524D\u3092\u5909\u3048\u308B\u3002--any-of \u3067\u5408\u6D41\u306E\u5165\u529B (\u3069\u308C\u304B 1 \u3064\u304C\u5C4A\u3051\u3070\u3088\u3044) \u306B\u3059\u308B (project = \u6700\u521D\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u3001inputs = \u6700\u4E0A\u4F4D\u306E\u5165\u529B)
+  port <block|project|inputs> [--in <\u540D\u524D>]... [--out <\u540D\u524D>]... [--remove <\u540D\u524D>]... [--policy <\u51FA\u529B\u540D> [--policy-scope all|<block>] [--advisory]]... [--no-policy <\u51FA\u529B\u540D>]... [--skip-policy <\u7BB1>.<\u51FA\u529B\u540D>]... [--expect "<\u51FA\u529B\u540D>=<kind>:<hint>"]... [--self <\u51FA\u529B\u540D>]... [--no-self <\u51FA\u529B\u540D>]... [--rename <\u65E7\u540D>=<\u65B0\u540D>] [--optional <\u5165\u529B\u540D>]... [--required <\u5165\u529B\u540D>]... [--describe "<\u540D\u524D>=<\u8AAC\u660E>"]... [--any-of <\u5165\u529B\u540D>]... [--all-of <\u5165\u529B\u540D>]...   \u65E2\u5B58\u306E\u30DC\u30C3\u30AF\u30B9\u306B\u5165\u529B / \u51FA\u529B\u3092\u8DB3\u3059\u3001\u6D88\u3059 (\u5165\u529B\u3092\u6D88\u3059\u3068\u4F7F\u3046\u7BB1\u306E\u5165\u529B\u3082\u6D88\u3048\u308B)\u3001\u540D\u524D\u3092\u5909\u3048\u308B\u3002--any-of \u3067\u5408\u6D41\u306E\u5165\u529B (\u3069\u308C\u304B 1 \u3064\u304C\u5C4A\u3051\u3070\u3088\u3044) \u306B\u3059\u308B (project = \u6700\u521D\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u3001inputs = \u6700\u4E0A\u4F4D\u306E\u5165\u529B)
   disconnect <\u984C\u540D.\u51FA\u529B\u540D> <\u984C\u540D.\u5165\u529B\u540D>          \u7DDA\u3092\u5916\u3059
   tidy                                              \u30D5\u30A1\u30A4\u30EB\u3092\u898F\u5247\u306B\u305D\u308D\u3048\u3066\u4FDD\u5B58\u3057\u76F4\u3059 (\u7DDA\u3067\u3064\u306A\u304C\u308B\u5165\u51FA\u529B\u306E\u540D\u524D\u3092\u305D\u308D\u3048\u308B\u3001\u91CD\u306A\u308A\u3092\u89E3\u304F)
   remove <block> [--force]                          \u30DC\u30C3\u30AF\u30B9\u3092\u6D88\u3059 (\u4E2D\u306B\u30DC\u30C3\u30AF\u30B9\u304C\u3042\u308B\u3068\u304D\u30FB\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u306F --force\u3002\u6700\u5F8C\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30DC\u30C3\u30AF\u30B9\u306F\u6D88\u305B\u306A\u3044\u3002\u4E2D\u306B\u30DC\u30C3\u30AF\u30B9\u304C\u3042\u308B\u3068\u304D\u306F --force\u3002\u7DDA\u3082\u5916\u308C\u308B\u3002\u5143\u306B\u623B\u305B\u306A\u3044\u306E\u3067 Git \u3067\u7BA1\u7406\u3057\u3066\u3044\u308B\u3053\u3068)
@@ -14438,6 +14546,8 @@ boxglow CLI: AI \u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 (Claude Code / Codex \u306A
   done <block> [--artifact <\u984C\u540D>=<URL \u307E\u305F\u306F\u30D1\u30B9>]... [--output <\u51FA\u529B\u540D>] [--note] [--checked <\u5B9F\u884C\u3057\u305F\u691C\u67FB\u3068\u7D50\u679C>] [--not-checked <\u672A\u5B9F\u65BD>] [--limits <\u6B8B\u308B\u5236\u9650>]   \u5B8C\u4E86 (\u6210\u679C\u7269\u3092\u4ED8\u3051\u3066 white)
                                                  \u30D1\u30B9\u304C Git \u7BA1\u7406\u4E0B\u306A\u3089\u300C\u30B3\u30DF\u30C3\u30C8 + \u30D1\u30B9 + blob\u300D\u3067\u8A18\u9332\u3059\u308B (\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u3057\u306A\u3044)\u3002--checked \u4EE5\u4E0B\u306F\u691C\u67FB\u7D50\u679C\u3068\u3057\u3066\u7BB1\u306B\u6B8B\u308B (context\u30FBshow \u306B\u51FA\u308B)
   artifact <block> <URL \u307E\u305F\u306F\u30D1\u30B9> [--title <\u984C\u540D>] [--output <\u51FA\u529B\u540D>]   \u6210\u679C\u7269\u3060\u3051\u4ED8\u3051\u308B (\u5B8C\u4E86\u306B\u306F\u3057\u306A\u3044)
+  artifact inputs <URL \u307E\u305F\u306F\u30D1\u30B9> [--input <\u5165\u529B\u540D>] [--title <\u984C\u540D>]   \u8A08\u753B\u306E\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306B\u8CC7\u6599\u3092\u4ED8\u3051\u308B (\u5165\u529B\u304C 1 \u3064\u306A\u3089 --input \u306F\u7701\u7565\u53EF)
+  artifact <block|inputs> --remove <\u984C\u540D\u304B\u30D1\u30B9\u304B URL> [--output <\u51FA\u529B\u540D> | --input <\u5165\u529B\u540D>]   \u4ED8\u3051\u305F\u6210\u679C\u7269\u30FB\u8CC7\u6599\u3092\u5916\u3059
   check                                          Git \u306E\u6210\u679C\u7269\u304C\u4ECA\u3082\u898B\u3064\u304B\u308B\u304B\u78BA\u8A8D\u3057\u3001\u79FB\u52D5\u3057\u3066\u3044\u308C\u3070\u30D1\u30B9\u3092\u4ED8\u3051\u66FF\u3048\u308B\u3002\u672A\u30B3\u30DF\u30C3\u30C8\u306E\u3068\u304D\u306B\u8A18\u9332\u3057\u305F\u6210\u679C\u7269\u306F\u3001\u30B3\u30DF\u30C3\u30C8\u6E08\u307F\u306B\u306A\u3063\u3066\u3044\u308C\u3070 Git \u306E\u53C2\u7167\u306B\u88DC\u5B8C\u3059\u308B
   blocked <block> --note <\u56F0\u3063\u3066\u3044\u308B\u3053\u3068>          \u8A70\u307E\u308A
   sendback <block> --to <block> --note <\u7406\u7531>     \u5DEE\u3057\u623B\u3057 (\u8A55\u4FA1\u30FB\u691C\u67FB\u304C\u901A\u3089\u306A\u304B\u3063\u305F\u6210\u679C\u7269\u3092\u4F5C\u3063\u305F\u7BB1\u3078\u623B\u3059\u3002\u305D\u306E\u7BB1\u306F In Progress \u306B\u623B\u308A\u3001\u6210\u679C\u7269\u306F\u5DEE\u3057\u623B\u3057\u6E08\u307F\u306B\u3002\u7DDA\u3067\u306F\u623B\u3055\u306A\u3044)
@@ -14446,6 +14556,7 @@ boxglow CLI: AI \u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 (Claude Code / Codex \u306A
   decision <block> --id <decision id> [--question] [--options "A|B"] [--context]   \u672A\u56DE\u7B54\u306E\u5224\u65AD\u3092\u66F8\u304D\u76F4\u3059
   answer <block> <\u56DE\u7B54> [--id <decision id>] [--by <\u540D\u524D>]   \u5224\u65AD\u306B\u7B54\u3048\u308B (\u65E2\u5B9A\u306F\u6700\u65B0\u306E\u672A\u56DE\u7B54)
   ack <block> [--id <decision id>]                \u4EBA\u306E\u56DE\u7B54\u3092\u8AAD\u3093\u3067\u5F15\u304D\u53D6\u3063\u305F\u3068\u8A18\u9332\u3059\u308B (status \u306E\u300C\u56DE\u7B54\u3042\u308A\u300D\u304B\u3089\u6D88\u3048\u308B\u3002start / done / blocked / review / set / split \u3067\u3082\u81EA\u52D5\u3067\u5F15\u304D\u53D6\u308B)
+  ack <block> --policy [<\u65B9\u91DD\u306E\u51FA\u529B\u540D>]           \u6E08\u3093\u3060\u4F5C\u696D\u304C\u3001\u5B8C\u4E86\u306E\u5F8C\u306B\u6C7A\u307E\u3063\u305F\u30FB\u5909\u308F\u3063\u305F\u65B9\u91DD\u306B\u5408\u3063\u3066\u3044\u308B\u3053\u3068\u3092\u78BA\u304B\u3081\u305F (\u300C\u65B9\u91DD: \u78BA\u304B\u3081\u76F4\u3057\u300D\u3092\u6D88\u3059)
   reopen <block> [--id <decision id>] [--note <\u7406\u7531>]   \u5224\u65AD\u3092\u3084\u308A\u76F4\u3059 (\u65B9\u91DD\u8EE2\u63DB)\u3002\u524D\u306E\u7B54\u3048\u306F\u5C65\u6B74\u306B\u3001\u5019\u88DC\u306F\u305D\u306E\u307E\u307E\u6B8B\u308B
   unask <block> [--id <decision id>]                 \u554F\u3044\u3092\u53D6\u308A\u4E0B\u3052\u308B (\u672A\u56DE\u7B54\u3060\u3051\u3002\u5206\u5C90\u306E\u554F\u3044\u306F\u6D88\u305B\u306A\u3044)
   set <block> [--status black|gray|white] [--progress 0..100|auto] [--title <\u984C\u540D>] [--note <\u8AAC\u660E>] [--category <\u30AB\u30C6\u30B4\u30EA>|none] [--repo <\u30D1\u30B9>|none] [--issue <URL>|none]
@@ -14544,9 +14655,10 @@ Usage (npx boxglow <command> ...):
   claim <block> [--scope block|subtree] [--note]    Hold a box without starting it. Before planning: context \u2192 claim \u2192 split / port / scope \u2192 context \u2192 start. Prints "not needed" when claims are off
   branch <title> --options "A|B" | --option <A> --option <B> [--question <question>] [--context <background>] [--in <input name>]... [--parent <block>]   Add an undecided fork (branch). Each option gets a path (output); answering it with answer skips the paths not chosen
   branch --box <block> --options "A|B" [--question <question>] [--context <background>]   Turn an existing box into a branch (its output becomes the first option's path; not for boxes with children)
+  branch --box <block> --add-option <path> / --remove-option <path>   Add / remove a path (option) of a branch (also after it was answered)
   join [--title <title>] [--parent <block>]          Add a merge part (where paths come together; connect the paths' outputs to it, and any one of them arriving lets the work go on)
   move <block> --parent <block|project>            Move a box into another parent (wires stay connected through the ports of the boxes in between)
-  port <block|project|inputs> [--in <name>]... [--out <name>]... [--remove <name>]... [--policy <output> [--policy-scope all|<block>] [--advisory]]... [--no-policy <output>]... [--skip-policy <box>.<output>]... [--expect "<output>=<kind>:<hint>"]... [--self <output>]... [--no-self <output>]... [--rename <old>=<new>] [--any-of <input>]... [--all-of <input>]...   Add inputs / outputs to an existing box, remove them (removing an input also removes the inputs it feeds; the last output stays), rename them, set an output's planned deliverable (expect: kind file / dir / url / doc / note / decision / result + a path or title) or mark it as made by this box itself (--self). --any-of makes inputs a merge (any one of them is enough) (project = the first project box)
+  port <block|project|inputs> [--in <name>]... [--out <name>]... [--remove <name>]... [--policy <output> [--policy-scope all|<block>] [--advisory]]... [--no-policy <output>]... [--skip-policy <box>.<output>]... [--expect "<output>=<kind>:<hint>"]... [--self <output>]... [--no-self <output>]... [--rename <old>=<new>] [--optional <input>]... [--required <input>]... [--describe "<name>=<description>"]... [--any-of <input>]... [--all-of <input>]...   Add inputs / outputs to an existing box, remove them (removing an input also removes the inputs it feeds), rename them, set an output's planned deliverable (expect: kind file / dir / url / doc / note / decision / result + a path or title) or mark it as made by this box itself (--self). --any-of makes inputs a merge (any one of them is enough) (project = the first project box)
   disconnect <title.output> <title.input>          Remove a wire
   tidy                                              Normalize the file and save it again (give connected inputs and outputs one name, resolve overlaps)
   remove <block> [--force]                          Delete a box (--force if it contains boxes or is a project box; the last project box cannot be deleted. Its wires are removed too. This cannot be undone, so keep the file in Git)
@@ -14560,6 +14672,8 @@ Usage (npx boxglow <command> ...):
   done <block> [--artifact <title>=<URL or path>]... [--output <output name>] [--note] [--checked <checks run and results>] [--not-checked <not tried>] [--limits <remaining limits>]   Finish (attach artifacts and turn it white)
                                                  If the path is tracked by Git, it is recorded as "commit + path + blob" (nothing is uploaded). --checked etc. stay on the box as its verification (shown by context / show)
   artifact <block> <URL or path> [--title <title>] [--output <output name>]   Attach an artifact only (does not finish the box)
+  artifact inputs <URL or path> [--input <input name>] [--title <title>]   Attach material to a top-level plan input (--input may be omitted when there is only one)
+  artifact <block|inputs> --remove <title, path or URL> [--output <output name> | --input <input name>]   Remove an attached deliverable or material
   check                                          Check that Git artifacts can still be found, and update the path if they moved. Artifacts recorded while uncommitted become Git references once they are committed
   blocked <block> --note <what is blocking you>    Blocked
   sendback <block> --to <block> --note <reason>   Send back (the box that made the rejected deliverable goes back to In Progress; its artifacts are kept as rejected; no wire goes backwards)
@@ -14568,6 +14682,7 @@ Usage (npx boxglow <command> ...):
   decision <block> --id <decision id> [--question] [--options "A|B"] [--context]   Rewrite an unanswered decision
   answer <block> <answer> [--id <decision id>] [--by <name>]   Answer a decision (default: the latest unanswered one)
   ack <block> [--id <decision id>]                Record that you have read a person's answer and taken it on (removes it from "Answered" in status. start / done / blocked / review / set / split also do this automatically)
+  ack <block> --policy [<policy output>]          Record that finished work still matches a policy decided or changed after it was done (clears "Policy: check again")
   reopen <block> [--id <decision id>] [--note <reason>]   Reopen a decision (change of direction). The previous answer stays in the history and the options are kept
   unask <block> [--id <decision id>]                 Withdraw a question (unanswered only; a branch's question cannot be removed)
   set <block> [--status black|gray|white] [--progress 0..100|auto] [--title <title>] [--note <description>] [--category <category>|none] [--repo <path>|none] [--issue <URL>|none]
@@ -14677,7 +14792,7 @@ function main(argv) {
   if (cmd === "init") {
     const path2 = locateFile(str2(options.file), true);
     if (planIO().exists(path2) && !options.force) throw new Error(t("{path} \u306F\u65E2\u306B\u3042\u308A\u307E\u3059 (--force \u3067\u4E0A\u66F8\u304D)", { path: path2 }));
-    readRevisions.set(resolve6(path2), existsSync13(path2) ? revisionOf(readFileSync14(path2, "utf8")) : null);
+    readRevisions.set(resolve7(path2), existsSync14(path2) ? revisionOf(readFileSync14(path2, "utf8")) : null);
     const lang = explicitLang(options) ?? envLang();
     setLang(lang);
     const from = str2(options.from);
@@ -14692,7 +14807,7 @@ function main(argv) {
     if (!basePath || !oursPath || !theirsPath) throw new Error(t("merge <base> <ours> <theirs> \u306E 3 \u3064\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"));
     const read2 = (f) => {
       const text2 = readFileSync14(f, "utf8");
-      readRevisions.set(resolve6(f), revisionOf(text2));
+      readRevisions.set(resolve7(f), revisionOf(text2));
       return text2.trim() ? fromJSON(text2) : null;
     };
     const base = read2(basePath);
@@ -14709,7 +14824,7 @@ function main(argv) {
       const message = kept.includes(c) ? t("\u30DE\u30FC\u30B8\u3067\u7247\u65B9\u304C\u524A\u9664\u30FB\u7247\u65B9\u304C\u5909\u66F4: {path} (\u5909\u66F4\u3055\u308C\u305F\u5074\u3092\u6B8B\u3057\u307E\u3057\u305F\u3002\u524A\u9664\u3057\u305F\u5074: {side})", { path: c.path, side: c.ours === void 0 ? t("\u81EA\u5206") : t("\u76F8\u624B") }) : t("\u30DE\u30FC\u30B8\u3067\u4E21\u5074\u304C\u5909\u66F4: {path} (\u63A1\u7528: {ours} / \u76F8\u624B: {theirs})", { path: c.path, ours: JSON.stringify(c.ours), theirs: JSON.stringify(c.theirs) });
       q = { ...q, log: [...q.log, { id: `m${Math.random().toString(36).slice(2, 10)}`, at: (/* @__PURE__ */ new Date()).toISOString(), actor: "merge", kind: "note", message }] };
     }
-    commitFile(oursPath, toJSON(q) + "\n", readRevisions.get(resolve6(oursPath)));
+    commitFile(oursPath, toJSON(q) + "\n", readRevisions.get(resolve7(oursPath)));
     const both = r.conflicts.length - kept.length;
     out(
       t("\u30DE\u30FC\u30B8: \u76F8\u624B\u306E\u5909\u66F4 {count} \u4EF6\u3092\u53D6\u308A\u8FBC\u307F", { count: r.merged }) + (both ? t("\u3001\u4E21\u5074\u3067\u5909\u66F4\u304C {count} \u4EF6 (\u81EA\u5206\u306E\u5024\u3092\u63A1\u7528\u3057\u3001\u76F8\u624B\u306E\u5024\u306F\u30ED\u30B0\u306B\u8A18\u9332)", { count: both }) : "") + (kept.length ? t("\u3001\u524A\u9664\u3068\u5909\u66F4\u306E\u7AF6\u5408\u304C {count} \u4EF6 (\u5909\u66F4\u3055\u308C\u305F\u5074\u3092\u6B8B\u3057\u3001\u30ED\u30B0\u306B\u8A18\u9332)", { count: kept.length }) : "")
@@ -14723,7 +14838,10 @@ function main(argv) {
   const token = str2(options["context-token"]);
   let tokenTarget;
   if (p.contextGuard && !isHumanActor(actor)) {
-    if (GUARDED_COMMANDS.includes(cmd) || cmd === "scope" && Object.keys(SCOPE_OPTIONS).some((k) => options[k] !== void 0)) {
+    if (cmd === "artifact" && isInputsRef(rest[0])) {
+      if (!isCurrentToken(p, token)) throw new Error(t("\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306B\u8CC7\u6599\u3092\u4ED8\u3051\u308B\u524D\u306B context \u3092\u8AAD\u307F\u3001--context-token \u3092\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044\u3002"));
+      tokenTarget = Object.keys(p.blocks).find((id) => contextReceipt(p, id).contextToken === token);
+    } else if (GUARDED_COMMANDS.includes(cmd) || cmd === "scope" && Object.keys(SCOPE_OPTIONS).some((k) => options[k] !== void 0)) {
       const id = mustFind(p, rest[0]).id;
       requireContext(p, id, token, actor);
       tokenTarget = id;
@@ -14964,7 +15082,7 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
       return;
     }
     case "setup-agent": {
-      const root = str2(options.dir) ? resolve6(str2(options.dir)) : dirname10(path);
+      const root = str2(options.dir) ? resolve7(str2(options.dir)) : dirname11(path);
       const agent = str2(options.agent) ?? "all";
       if (options.check) {
         out(checkAgentSetup(root, agent).join("\n"));
@@ -15097,10 +15215,10 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
       return;
     }
     case "git-setup": {
-      const root = dirname10(path);
-      const attrs = join12(root, ".gitattributes");
+      const root = dirname11(path);
+      const attrs = join13(root, ".gitattributes");
       const line = "boxglow.json merge=boxglow";
-      const cur = existsSync13(attrs) ? readFileSync14(attrs, "utf8") : "";
+      const cur = existsSync14(attrs) ? readFileSync14(attrs, "utf8") : "";
       if (!cur.split(/\r?\n/).includes(line)) writeFileSync8(attrs, (cur && !cur.endsWith("\n") ? cur + "\n" : cur) + line + "\n", "utf8");
       execFileSync3("git", ["config", "merge.boxglow.name", "Boxglow plan merge (box level)"], { cwd: root });
       execFileSync3("git", ["config", "merge.boxglow.driver", "npx boxglow merge %O %A %B"], { cwd: root });
@@ -15306,7 +15424,27 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
         p = updatePort(p, port2.id, { name: to });
         added.push(`${from} -> ${to}`);
       }
-      if (added.length === 0) throw new Error(t("--in <\u540D\u524D> / --out <\u540D\u524D> / --remove <\u540D\u524D> / --policy <\u51FA\u529B\u540D> / --expect <\u51FA\u529B\u540D>=<kind>:<hint> / --self <\u51FA\u529B\u540D> / --rename <\u65E7\u540D>=<\u65B0\u540D> / --any-of <\u5165\u529B\u540D> / --all-of <\u5165\u529B\u540D> \u306E\u3044\u305A\u308C\u304B\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"));
+      for (const [flag, required] of [["optional", false], ["required", true]]) {
+        for (const name of list(options[flag])) {
+          const port2 = portsOf(p, blockId, "in").find((x) => x.name === name);
+          if (!port2) throw new Error(t("\u5165\u529B\u300C{name}\u300D\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093", { name }));
+          p = updatePort(p, port2.id, { required });
+          added.push(required ? t("\u5FC5\u9808 {name}", { name }) : t("\u4EFB\u610F {name}", { name }));
+        }
+      }
+      for (const spec of list(options.describe)) {
+        const eq = spec.indexOf("=");
+        if (eq < 0) throw new Error(t("--describe \u306F <\u540D\u524D>=<\u8AAC\u660E> \u306E\u5F62\u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044: {spec}", { spec }));
+        const key = spec.slice(0, eq);
+        const dir2 = key.startsWith("in:") ? "in" : key.startsWith("out:") ? "out" : void 0;
+        const name = dir2 ? key.slice(dir2.length + 1) : key;
+        const hits = portsOf(p, blockId, dir2).filter((x) => x.name === name);
+        if (hits.length === 0) throw new Error(t("\u30DD\u30FC\u30C8\u300C{name}\u300D\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093", { name }));
+        if (hits.length > 1) throw new Error(t("\u300C{name}\u300D\u306F\u5165\u529B\u3068\u51FA\u529B\u306E\u4E21\u65B9\u306B\u3042\u308A\u307E\u3059\u3002in:{name} / out:{name} \u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044", { name }));
+        p = updatePort(p, hits[0].id, { description: spec.slice(eq + 1) });
+        added.push(t("\u8AAC\u660E {name}", { name }));
+      }
+      if (added.length === 0) throw new Error(t("--in <\u540D\u524D> / --out <\u540D\u524D> / --remove <\u540D\u524D> / --policy <\u51FA\u529B\u540D> / --expect <\u51FA\u529B\u540D>=<kind>:<hint> / --self <\u51FA\u529B\u540D> / --rename <\u65E7\u540D>=<\u65B0\u540D> / --any-of <\u5165\u529B\u540D> / --all-of <\u5165\u529B\u540D> / --optional <\u5165\u529B\u540D> / --required <\u5165\u529B\u540D> / --describe <\u540D\u524D>=<\u8AAC\u660E> \u306E\u3044\u305A\u308C\u304B\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"));
       save(path, p);
       out(t("\u30DD\u30FC\u30C8: {title}: {list}", { title: p.blocks[blockId]?.title ?? "project", list: added.join(", ") }));
       return;
@@ -15447,6 +15585,30 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
       return;
     }
     case "artifact": {
+      if (options.remove !== void 0) {
+        const key = str2(options.remove);
+        if (!key) throw new Error(t("--remove <\u984C\u540D\u304B\u30D1\u30B9\u304B URL> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"));
+        const inputs = isInputsRef(rest[0]);
+        const ports = inputs ? portsOf(p, ROOT_ID, "in").filter((x) => !str2(options.input) || x.name === str2(options.input)) : portsOf(p, mustFind(p, rest[0]).id, "out").filter((x) => !str2(options.output) || x.name === str2(options.output));
+        const match = (a2) => a2.title === key || a2.url === key || a2.path === key;
+        const hit = ports.filter((x) => x.artifacts.some(match));
+        if (hit.length === 0) throw new Error(t("\u300C{key}\u300D\u3068\u3044\u3046\u6210\u679C\u7269\u30FB\u8CC7\u6599\u306F\u4ED8\u3044\u3066\u3044\u307E\u305B\u3093 ({list})", { key, list: ports.flatMap((x) => x.artifacts.map((a2) => `${x.name}: ${a2.title}`)).join(", ") || "-" }));
+        for (const port2 of hit) p = updatePort(p, port2.id, { artifacts: port2.artifacts.filter((a2) => !match(a2)) });
+        save(path, p);
+        out(t("\u5916\u3057\u307E\u3057\u305F: {key} ({list})", { key, list: hit.map((x) => x.name).join(", ") }));
+        return;
+      }
+      if (isInputsRef(rest[0])) {
+        if (!rest[1]) throw new Error(t("<URL \u307E\u305F\u306F\u30D1\u30B9> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"));
+        const ins = portsOf(p, ROOT_ID, "in");
+        const name = str2(options.input);
+        const target2 = name ? ins.find((x) => x.name === name) : ins.length === 1 ? ins[0] : void 0;
+        if (!target2) throw new Error(name ? t("\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u300C{name}\u300D\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093 ({list})", { name, list: ins.map((x) => x.name).join(", ") }) : t("\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u304C\u8907\u6570\u3042\u308A\u307E\u3059\u3002--input <\u5165\u529B\u540D> \u3067\u9078\u3093\u3067\u304F\u3060\u3055\u3044 ({list})", { list: ins.map((x) => x.name).join(", ") }));
+        const a2 = artifactFrom(rest[1], str2(options.title));
+        save(path, updatePort(p, target2.id, { artifacts: [...target2.artifacts, a2] }));
+        out(t("\u6700\u4E0A\u4F4D\u306E\u5165\u529B\u306B\u8CC7\u6599\u3092\u4ED8\u3051\u307E\u3057\u305F: \u300C{port}\u300D <- {artifact}", { port: target2.name, artifact: a2.title }) + `${a2.kind === "git" ? ` (git ${a2.path} @ ${(a2.commit ?? "").slice(0, 7)})` : ""}`);
+        return;
+      }
       const b = mustFind(p, rest[0]);
       p = ackDecisions(p, b.id, actor);
       if (!rest[1]) throw new Error(t("<URL \u307E\u305F\u306F\u30D1\u30B9> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"));
@@ -15465,7 +15627,7 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
         for (const a of port2.artifacts) {
           const owner = p.blocks[port2.blockId]?.title ?? "?";
           if (a.kind === "file" && a.path) {
-            const ref = findGitRef(a.path, [dirname10(path), process.cwd()]);
+            const ref = findGitRef(a.path, [dirname11(path), process.cwd()]);
             if (ref) {
               a.kind = "git";
               a.repo = ref.repo;
@@ -15482,7 +15644,7 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
           }
           if (a.kind !== "git") continue;
           if (!a.commit && a.path) {
-            const ref = gitRefFor(resolve6(dirname10(path), a.path));
+            const ref = gitRefFor(resolve7(dirname11(path), a.path));
             if (ref?.commit) {
               a.commit = ref.commit;
               a.blob = ref.blob;
@@ -15494,7 +15656,7 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
               continue;
             }
           }
-          const r = checkGitRef(a, dirname10(path));
+          const r = checkGitRef(a, dirname11(path));
           if (r.state === "moved" && r.path) {
             lines.push(t("- [\u79FB\u52D5] {owner}.{port} \u300C{title}\u300D {from} -> {to}", { owner, port: port2.name, title: a.title, from: String(a.path), to: r.path }));
             a.path = r.path;
@@ -15556,6 +15718,21 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
     }
     case "ack": {
       const b = mustFind(p, rest[0]);
+      if (options.policy !== void 0) {
+        const changed = changedPolicies(p, b.id);
+        const name = typeof options.policy === "string" ? options.policy : void 0;
+        const targets = name ? changed.filter((q3) => q3.name === name) : changed;
+        if (name && targets.length === 0) throw new Error(t("\u300C{title}\u300D\u306B\u78BA\u304B\u3081\u76F4\u3057\u306E\u65B9\u91DD\u300C{name}\u300D\u306F\u3042\u308A\u307E\u305B\u3093 ({list})", { title: b.title, name, list: changed.map((q3) => q3.name).join(", ") || "-" }));
+        if (targets.length === 0) {
+          out(t("\u300C{title}\u300D\u306B\u78BA\u304B\u3081\u76F4\u3057\u306E\u65B9\u91DD\u306F\u3042\u308A\u307E\u305B\u3093", { title: b.title }));
+          return;
+        }
+        let q2 = p;
+        for (const port2 of targets) q2 = ackPolicy(q2, b.id, port2.id);
+        save(path, q2);
+        out(t("\u65B9\u91DD\u3092\u78BA\u304B\u3081\u307E\u3057\u305F: \u300C{title}\u300D <- {list}", { title: b.title, list: targets.map((x) => x.name).join(", ") }));
+        return;
+      }
       const q = ackDecisions(p, b.id, actor, str2(options.id));
       if (q === p) {
         out(t("\u300C{title}\u300D\u306B\u672A\u78BA\u8A8D\u306E\u56DE\u7B54\u306F\u3042\u308A\u307E\u305B\u3093", { title: b.title }));
@@ -15643,7 +15820,7 @@ function runCommand(cmd, rest, options, actor, path, p, AGENTS_SNIPPET, SKILL_MD
 function cliMain(argv) {
   if (argv[0] === "mcp") {
     const { options } = parseArgs(argv.slice(1));
-    if (str2(options.file)) process.env.BOXGLOW_FILE = resolve6(str2(options.file));
+    if (str2(options.file)) process.env.BOXGLOW_FILE = resolve7(str2(options.file));
     if (str2(options.actor)) process.env.BOXGLOW_ACTOR = str2(options.actor);
     if (str2(options.lang)) process.env.BOXGLOW_LANG = str2(options.lang);
     const mcpFile = locateFile(str2(options.file));
@@ -15698,10 +15875,10 @@ function cliMain(argv) {
       claimRequest = claimCommand("combine", void 0, options, actorOf(str2(options.actor), process.env));
       const outPath = str2(options.out);
       if (positional.length < 2 || !outPath) throw new Error("boxglow combine <\u8A08\u753B\u30D5\u30A1\u30A4\u30EB> <\u8A08\u753B\u30D5\u30A1\u30A4\u30EB>... --out <path>");
-      if (existsSync13(outPath) && !options.force) throw new Error(t("{path} \u306F\u65E2\u306B\u3042\u308A\u307E\u3059 (--force \u3067\u4E0A\u66F8\u304D)", { path: outPath }));
+      if (existsSync14(outPath) && !options.force) throw new Error(t("{path} \u306F\u65E2\u306B\u3042\u308A\u307E\u3059 (--force \u3067\u4E0A\u66F8\u304D)", { path: outPath }));
       let merged = load(positional[0]);
       for (const file of positional.slice(1)) merged = combineProjects(merged, load(file), basename4(file));
-      readRevisions.set(resolve6(outPath), existsSync13(outPath) ? revisionOf(readFileSync14(outPath, "utf8")) : null);
+      readRevisions.set(resolve7(outPath), existsSync14(outPath) ? revisionOf(readFileSync14(outPath, "utf8")) : null);
       save(outPath, merged);
       console.log(t("\u7D50\u5408: {n} \u500B\u306E\u8A08\u753B\u3092 {path} \u306B\u307E\u3068\u3081\u307E\u3057\u305F (\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u7BB1 {m} \u500B)", { n: String(positional.length), path: outPath, m: String(projectBlocks(merged).length) }));
     } catch (e) {
@@ -15715,14 +15892,14 @@ function cliMain(argv) {
       claimRequest = claimCommand("split-file", void 0, options, actorOf(str2(options.actor), process.env));
       const outPath = str2(options.out);
       if (!positional[0] || !outPath) throw new Error("boxglow split-file <\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u7BB1> --out <path> [--file <\u8A08\u753B>]");
-      if (existsSync13(outPath) && !options.force) throw new Error(t("{path} \u306F\u65E2\u306B\u3042\u308A\u307E\u3059 (--force \u3067\u4E0A\u66F8\u304D)", { path: outPath }));
+      if (existsSync14(outPath) && !options.force) throw new Error(t("{path} \u306F\u65E2\u306B\u3042\u308A\u307E\u3059 (--force \u3067\u4E0A\u66F8\u304D)", { path: outPath }));
       const path = locateFile(str2(options.file));
       const p = load(path);
       const found = findBlock(p, positional[0]);
       if (!found.block) throw new Error(t("\u30D6\u30ED\u30C3\u30AF\u300C{ref}\u300D\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002", { ref: positional[0] }));
       const box = found.block;
       const { remaining, extracted } = splitProject(p, box.id, str2(options.name));
-      readRevisions.set(resolve6(outPath), existsSync13(outPath) ? revisionOf(readFileSync14(outPath, "utf8")) : null);
+      readRevisions.set(resolve7(outPath), existsSync14(outPath) ? revisionOf(readFileSync14(outPath, "utf8")) : null);
       save(outPath, extracted);
       save(path, remaining);
       console.log(t("\u5206\u5272: \u300C{title}\u300D\u3092 {out} \u306B\u5207\u308A\u51FA\u3057\u307E\u3057\u305F ({path} \u306B\u306F\u6B8B\u308A {m} \u500B\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u7BB1)", { title: box.title, out: outPath, path, m: String(projectBlocks(remaining).length) }));
@@ -15788,7 +15965,7 @@ function cliMain(argv) {
       }
       const command = positional[0] ?? "list";
       const write = command === "connect" ? !(options["read-only"] === true || options["read-only"] === "true") : options.write === true || options.write === "true";
-      process.exitCode = await runAgentToken({ server, out: (line) => console.log(line), command, name: str2(options.name), write, id: positional[1], target: command === "connect" ? positional[1] : void 0, projectId, dir: file ? dirname10(file) : process.cwd() });
+      process.exitCode = await runAgentToken({ server, out: (line) => console.log(line), command, name: str2(options.name), write, id: positional[1], target: command === "connect" ? positional[1] : void 0, projectId, dir: file ? dirname11(file) : process.cwd() });
     })().catch((e) => {
       console.error(`[boxglow agent-token] ${e instanceof Error ? e.message : String(e)}`);
       process.exitCode = 1;