specdojo 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +100 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/generate.js +144 -13
  5. package/dist/commands/agent.js +33 -0
  6. package/dist/commands/init.js +2 -0
  7. package/dist/commands/orchestrator.js +10 -1
  8. package/dist/deliverable/deliverable.js +77 -4
  9. package/dist/devcontainer/command.js +18 -0
  10. package/dist/devcontainer/host-script.js +21 -0
  11. package/dist/devcontainer/scaffold.js +4 -3
  12. package/dist/exec/antigravity-session.js +154 -0
  13. package/dist/exec/core.js +1 -0
  14. package/dist/exec/parent-validation.js +14 -0
  15. package/dist/exec/plan-markdownlint.js +89 -0
  16. package/dist/exec/plans-core.js +46 -1
  17. package/dist/exec/plans-generation.js +45 -5
  18. package/dist/exec/plans-planning.js +1 -1
  19. package/dist/exec/plans-storage.js +1 -0
  20. package/dist/exec/product-branch-records.js +105 -0
  21. package/dist/exec/product-branches.js +52 -0
  22. package/dist/exec/register-product-message.js +50 -0
  23. package/dist/exec/register-resume.js +28 -0
  24. package/dist/exec/register.js +6 -0
  25. package/dist/exec/repo-integration-sync.js +4 -2
  26. package/dist/exec/repo-integration.js +41 -4
  27. package/dist/exec/repo-trace.js +2 -0
  28. package/dist/exec/results.js +9 -5
  29. package/dist/exec/run/lifecycle-commands.js +85 -16
  30. package/dist/exec/run/register-command.js +22 -0
  31. package/dist/exec/run/register-resume.js +11 -1
  32. package/dist/exec/run/register-worktree.js +29 -8
  33. package/dist/exec/run/schedule-mode.js +22 -2
  34. package/dist/exec/run/schedule-prepare.js +49 -4
  35. package/dist/exec/run/schedule-task.js +3 -0
  36. package/dist/exec/strategy.js +2 -1
  37. package/dist/exec/task-repos.js +78 -16
  38. package/dist/exec/worktree-command.js +2 -2
  39. package/dist/exec/worktree-ops-commit.js +1 -13
  40. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  41. package/dist/exec/worktree.js +3 -3
  42. package/dist/register/core.js +5 -0
  43. package/dist/register/create-commands.js +54 -2
  44. package/dist/register/deliverable-target.js +24 -17
  45. package/dist/register/event-merge.js +4 -0
  46. package/dist/register/events.js +6 -0
  47. package/dist/register/external-project.js +2 -0
  48. package/dist/register/input.js +168 -0
  49. package/dist/register/item.js +61 -0
  50. package/dist/register/register.js +33 -25
  51. package/dist/register/renumber.js +4 -0
  52. package/dist/register/update.js +6 -0
  53. package/dist/schedule/approach.js +9 -0
  54. package/dist/schedule/strategy-profiles.js +22 -2
  55. package/dist/shared/agent-types.js +4 -1
  56. package/dist/shared/branch-template.js +26 -0
  57. package/dist/shared/commit-message-template.js +38 -0
  58. package/dist/shared/commit-types.js +15 -0
  59. package/dist/shared/git.js +7 -0
  60. package/dist/shared/provider-scaffold.js +2 -0
  61. package/dist/shared/specdojo-config.js +35 -4
  62. package/dist/shared/specdojo-gitignore.js +1 -0
  63. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  64. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  65. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  66. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  67. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  68. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  69. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  70. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  71. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  72. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  73. package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
  74. package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
  75. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  76. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  77. package/docs/ja/specdojo/guides/register-operation-guide.md +16 -1
  78. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  79. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  80. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  81. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  82. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  83. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  84. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  85. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  86. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  87. package/docs/ja/specdojo/references/command-reference.md +111 -46
  88. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  89. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  90. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  91. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  92. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  93. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  94. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  95. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  96. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  97. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  98. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  99. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  100. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  101. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  102. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  103. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  104. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  105. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  106. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  107. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  108. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  109. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  110. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  111. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  112. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  113. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  114. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  115. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  116. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
  117. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  118. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  119. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  120. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
  121. package/package.json +6 -2
  122. package/templates/antigravity/README.md +19 -46
  123. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  124. package/templates/antigravity/orchestrator.md +2 -0
  125. package/templates/antigravity/settings.edit.json +73 -0
  126. package/templates/antigravity/settings.orchestrator.json +15 -0
  127. package/templates/antigravity/settings.report.json +7 -0
  128. package/templates/antigravity/settings.review.json +7 -0
  129. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  130. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  131. package/templates/codex/orchestrator.md +2 -0
  132. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  133. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
  134. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  135. package/templates/init-agent-members.yaml +1 -0
  136. package/templates/init-exec-defaults.yaml +1 -1
  137. package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
@@ -98,6 +98,8 @@ type は次のように使い分ける。
98
98
 
99
99
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
100
100
 
101
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
102
+
101
103
  ```bash
102
104
  npx specdojo register add --project <project-id> \
103
105
  --type todo --title "<title>" --description "<description>" \
@@ -0,0 +1,217 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # devcontainer-tmux.sh
4
+ #
5
+ # SpecDojo が配布する、ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体です。
6
+ # workspace の .specdojo/host/devcontainer-tmux.sh へ書き出され、ホスト側のラッパーから呼ばれます。
7
+ #
8
+ # 対応 OS:
9
+ # - macOS
10
+ # - Linux
11
+ # - Windows WSL2
12
+ #
13
+ set -euo pipefail
14
+
15
+ if [ $# -lt 1 ] || [ -z "${1:-}" ]; then
16
+ echo "Usage: $0 <workspace-path>" >&2
17
+ exit 1
18
+ fi
19
+
20
+ workspace_dir_input="$1"
21
+ if [ ! -d "$workspace_dir_input" ]; then
22
+ echo "Workspace directory not found: $workspace_dir_input" >&2
23
+ exit 1
24
+ fi
25
+
26
+ workspace_dir="$(cd "$workspace_dir_input" && pwd -P)"
27
+
28
+ devcontainer_json="$workspace_dir/.devcontainer/devcontainer.json"
29
+ if [ ! -f "$devcontainer_json" ]; then
30
+ if [ -f "$workspace_dir/.devcontainer.json" ]; then
31
+ devcontainer_json="$workspace_dir/.devcontainer.json"
32
+ else
33
+ echo "devcontainer.json was not found in $workspace_dir" >&2
34
+ exit 1
35
+ fi
36
+ fi
37
+
38
+ remote_user="$(sed -E -e 's,//.*$,,' -e 's,/\*.*\*/,,' "$devcontainer_json" | grep -E '"remoteUser"[[:space:]]*:' | head -n 1 | sed -E 's/.*"remoteUser"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/' || true)"
39
+
40
+ if [ -z "$remote_user" ]; then
41
+ echo "remoteUser is not defined in $devcontainer_json" >&2
42
+ exit 1
43
+ fi
44
+
45
+ # docker の探索は最初の呼び出しより前に行う。SSH の PATH だけには依存しない。
46
+ docker_dir=""
47
+ docker_search_path="$PATH"
48
+ docker_login_shell="${SHELL:-/bin/bash}"
49
+ docker_candidates=(
50
+ /usr/local/bin
51
+ /opt/homebrew/bin
52
+ "${HOME:-}/.docker/bin"
53
+ /Applications/Docker.app/Contents/Resources/bin
54
+ /snap/bin
55
+ /usr/bin
56
+ )
57
+
58
+ select_docker() {
59
+ local candidate="$1" candidate_dir
60
+ # command -v が返す alias や関数の説明は受け付けない。
61
+ case "$candidate" in
62
+ */docker) ;;
63
+ *) return 1 ;;
64
+ esac
65
+ [ -f "$candidate" ] && [ -x "$candidate" ] || return 1
66
+ candidate_dir="${candidate%/*}"
67
+ candidate_dir="$(cd "${candidate_dir:-/}" && pwd -P)" || return 1
68
+ docker_dir="$candidate_dir"
69
+ }
70
+
71
+ docker_hint() {
72
+ local failure="$1" host_os kernel
73
+ host_os="$(uname -s 2>/dev/null || true)"
74
+ kernel="$(uname -r 2>/dev/null || true)"
75
+ case "$host_os" in
76
+ Darwin)
77
+ if [ "$failure" = missing ]; then
78
+ echo "macOS: Install Docker Desktop." >&2
79
+ else
80
+ echo "macOS: Start Docker Desktop and check the Docker context." >&2
81
+ fi
82
+ ;;
83
+ Linux)
84
+ if printf '%s\n' "$kernel" | grep -qi microsoft || grep -qi microsoft /proc/version 2>/dev/null; then
85
+ echo "WSL2: Start Docker Desktop and enable WSL integration for this distribution." >&2
86
+ elif [ "$failure" = missing ]; then
87
+ echo "Linux: Install Docker Engine." >&2
88
+ else
89
+ echo "Linux: Start the docker service and check membership in the docker group (then log in again)." >&2
90
+ fi
91
+ ;;
92
+ *) echo "Install and start Docker, and check the Docker context and access permissions." >&2 ;;
93
+ esac
94
+ }
95
+
96
+ if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
97
+ # 明示指定はディレクトリ。誤指定を別の Docker で隠さず、下で診断する。
98
+ select_docker "$SPECDOJO_DOCKER_BIN/docker" || true
99
+ else
100
+ if ! select_docker "$(command -v docker || true)"; then
101
+ # 起動時のメッセージを無視し、問い合わせの印が付いた実行ファイルだけを採る。
102
+ # shellcheck disable=SC2016
103
+ login_output="$("$docker_login_shell" -lc 'printf "\n__SPECDOJO_DOCKER__"; command -v docker' 2>/dev/null)" || login_output=""
104
+ while IFS= read -r line; do
105
+ case "$line" in
106
+ __SPECDOJO_DOCKER__*)
107
+ if select_docker "${line#__SPECDOJO_DOCKER__}"; then
108
+ break
109
+ fi
110
+ ;;
111
+ esac
112
+ done <<< "$login_output"
113
+ if [ -z "$docker_dir" ]; then
114
+ for candidate_dir in "${docker_candidates[@]}"; do
115
+ if select_docker "$candidate_dir/docker"; then
116
+ break
117
+ fi
118
+ done
119
+ fi
120
+ fi
121
+ fi
122
+
123
+ if [ -z "$docker_dir" ]; then
124
+ echo "Docker executable not found." >&2
125
+ if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
126
+ echo "Searched SPECDOJO_DOCKER_BIN: $SPECDOJO_DOCKER_BIN/docker (must be an executable file)." >&2
127
+ else
128
+ echo "Searched PATH: $docker_search_path" >&2
129
+ echo "Queried login shell: $docker_login_shell -lc 'command -v docker'" >&2
130
+ printf 'Searched directory: %s\n' "${docker_candidates[@]}" >&2
131
+ fi
132
+ docker_hint missing
133
+ exit 1
134
+ fi
135
+
136
+ export PATH="$docker_dir:$PATH"
137
+ if ! docker info >/dev/null 2>&1; then
138
+ echo "Docker is not usable: $docker_dir/docker (docker info failed)." >&2
139
+ docker_hint unavailable
140
+ exit 1
141
+ fi
142
+
143
+ # 1. 動いているコンテナを探す
144
+ container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
145
+
146
+ # 2. 止まっているコンテナがあれば docker start で起こす
147
+ if [ -z "$container_id" ]; then
148
+ stopped_id="$(docker ps -a -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
149
+ if [ -n "$stopped_id" ]; then
150
+ docker start "$stopped_id" >/dev/null
151
+ container_id="$stopped_id"
152
+ fi
153
+ fi
154
+
155
+ # 3. コンテナが無いときだけ devcontainer up を動かす
156
+ if [ -z "$container_id" ]; then
157
+ echo "Starting devcontainer for $workspace_dir..." >&2
158
+ if [ -n "${SPECDOJO_NODE_BIN:-}" ]; then
159
+ PATH="$docker_dir:$SPECDOJO_NODE_BIN:$PATH" devcontainer up --workspace-folder "$workspace_dir" >&2
160
+ else
161
+ # shellcheck disable=SC2016
162
+ "${SHELL:-/bin/bash}" -lic 'export PATH="$1:$PATH"; exec devcontainer up --workspace-folder "$2"' devcontainer-launcher "$docker_dir" "$workspace_dir" >&2
163
+ fi
164
+ container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
165
+ fi
166
+
167
+ if [ -z "$container_id" ]; then
168
+ echo "Failed to start or find devcontainer for $workspace_dir" >&2
169
+ exit 1
170
+ fi
171
+
172
+ # 4. コンテナ内の作業ディレクトリをマウント情報から求める
173
+ mounts_info="$(docker inspect --format '{{range .Mounts}}{{printf "%s\t%s\t%s\n" .Type .Source .Destination}}{{end}}' "$container_id")"
174
+ best_match_src=""
175
+ best_match_dst=""
176
+
177
+ while IFS=$'\t' read -r m_type m_src m_dst; do
178
+ [ "$m_type" != "bind" ] && continue
179
+ [ -z "$m_src" ] && continue
180
+
181
+ norm_src="$m_src"
182
+ if [ -d "$m_src" ]; then
183
+ norm_src="$(cd "$m_src" && pwd -P)"
184
+ fi
185
+
186
+ if [ "$workspace_dir" = "$norm_src" ]; then
187
+ best_match_src="$norm_src"
188
+ best_match_dst="$m_dst"
189
+ break
190
+ elif [ "${workspace_dir#"$norm_src"/}" != "$workspace_dir" ]; then
191
+ if [ ${#norm_src} -gt ${#best_match_src} ]; then
192
+ best_match_src="$norm_src"
193
+ best_match_dst="$m_dst"
194
+ fi
195
+ fi
196
+ done <<< "$mounts_info"
197
+
198
+ if [ -z "$best_match_src" ]; then
199
+ echo "Could not determine container workspace directory from mounts for: $workspace_dir" >&2
200
+ exit 1
201
+ fi
202
+
203
+ if [ "$workspace_dir" = "$best_match_src" ]; then
204
+ container_workspace_dir="$best_match_dst"
205
+ else
206
+ rel_path="${workspace_dir#"$best_match_src"/}"
207
+ container_workspace_dir="${best_match_dst%/}/$rel_path"
208
+ fi
209
+
210
+ if ! docker exec "$container_id" test -d "$container_workspace_dir"; then
211
+ echo "Workspace directory '$container_workspace_dir' does not exist in container '$container_id'." >&2
212
+ exit 1
213
+ fi
214
+
215
+ # 5. tmux セッションへ入る
216
+ session_name="${SPECDOJO_TMUX_SESSION:-specdojo}"
217
+ exec docker exec -it --detach-keys="ctrl-]" -u "$remote_user" -w "$container_workspace_dir" "$container_id" tmux new-session -A -s "$session_name"
@@ -5,98 +5,16 @@
5
5
  # 常時稼働ホスト上で devcontainer 内の tmux セッションへ入るためのスクリプトです。
6
6
  # ホスト側の ~/bin/specdojo-tmux.sh などへコピーし、実行権限(chmod +x)を付与して使用してください。
7
7
  #
8
- # 前提ツール:
9
- # - Docker (Docker Desktop または Docker Engine): コンテナの実行環境
10
- # - Dev Container CLI (@devcontainers/cli): コンテナの起動に使用 (npm install -g @devcontainers/cli)
11
- # - tmux: コンテナ内にインストールされている必要があります
12
- #
13
- # 起動コマンド:
14
- # - コンテナ起動: devcontainer up --workspace-folder "$workspace_dir"
15
- # - セッション接続: docker exec -it ... tmux new-session -A -s <名前>
8
+ # 実際の処理本体は各 workspace の .specdojo/host/devcontainer-tmux.sh が行います。
9
+ # 本体のスクリプトは `npx specdojo devcontainer host-script` で書き出せます。
16
10
  #
17
- # 利用者(ユーザー)の変更:
18
- # - devcontainer.json の remoteUser(既定は node)に合わせて -u でコンテナに入ります。
19
- # - remoteUser を変更した場合は、下記 container_user の値を変更してください。
20
- #
21
- # PATH の設定(SSH 経由での実行):
22
- # - ssh の RemoteCommand は非対話シェルで動くため、Mac の通常端末で読み込まれる
23
- # ~/.zshrc などの PATH の設定が反映されません。
24
- # - ホスト側の通常端末で node と devcontainer の配置場所を確認し、必要に応じて
25
- # 下記 node_bin_dir を設定してください:
26
- # dirname "$(command -v devcontainer)"
27
- # - Homebrew の例: node_bin_dir="/opt/homebrew/bin"
28
- # - nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
29
- # - mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
30
- # - node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
11
+ # 前提ツール:
12
+ # - Docker (Docker Desktop または Docker Engine)
13
+ # - Dev Container CLI (@devcontainers/cli): コンテナ未作成時のみ起動に使用
31
14
  #
32
15
  set -euo pipefail
33
16
 
34
- # コンテナ内とホスト側の作業ディレクトリ(実際の環境に合わせて設定してください)
35
- container_workspace_dir="/workspaces/<workspace-name>/<repo-name>"
36
- workspace_dir="${HOME}/<path-to-workspace>/<repo-name>"
37
-
38
- # コンテナ内の実行ユーザー(devcontainer.json の remoteUser に合わせます。既定は node です)
39
- # remoteUser を変更した場合は、この値を変更してください。
40
- container_user="node"
41
-
42
- # セッション名(必要に応じて変更してください)
43
- session_name="specdojo"
44
-
45
- # Mac や Linux の通常端末で確認した実際のディレクトリへ置き換えてください。
46
- # Homebrew の例: node_bin_dir="/opt/homebrew/bin"
47
- # nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
48
- # mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
49
- # node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
50
- node_bin_dir="/absolute/path/to/node/bin"
51
- export PATH="$node_bin_dir:/opt/homebrew/bin:/usr/local/bin:$PATH"
52
-
53
- find_container() {
54
- local id
55
- id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
56
- if [ -n "$id" ]; then
57
- echo "$id"
58
- return
59
- fi
60
- docker ps --format '{{.Names}}\t{{.Image}}' | awk '$2 ~ /^vsc-/ {print $1; exit}'
61
- }
62
-
63
- if [ ! -f "$workspace_dir/.devcontainer/devcontainer.json" ]; then
64
- echo "devcontainer.json was not found: $workspace_dir" >&2
65
- echo "Set workspace_dir to the repository path on the host." >&2
66
- exit 1
67
- fi
68
-
69
- if ! command -v devcontainer >/dev/null 2>&1; then
70
- echo "Dev Container CLI is not installed or not in PATH." >&2
71
- echo "Current PATH: $PATH" >&2
72
- echo "Check the location on the host terminal with: dirname \"\$(command -v devcontainer)\"" >&2
73
- echo "Install it with: npm install -g @devcontainers/cli" >&2
74
- exit 1
75
- fi
76
-
77
- if ! command -v docker >/dev/null 2>&1; then
78
- echo "Docker command was not found in PATH." >&2
79
- echo "Current PATH: $PATH" >&2
80
- echo "Check the location on the host terminal with: dirname \"\$(command -v docker)\"" >&2
81
- exit 1
82
- fi
83
-
84
- if ! docker info >/dev/null 2>&1; then
85
- echo "Docker is not running on the host." >&2
86
- exit 1
87
- fi
88
-
89
- container_name="$(find_container)"
90
-
91
- if [ -z "$container_name" ]; then
92
- echo "Starting devcontainer..." >&2
93
- devcontainer up --workspace-folder "$workspace_dir"
94
- container_name="$(find_container)"
95
- fi
96
-
97
- if [ -z "$container_name" ]; then
98
- echo "The devcontainer did not start." >&2
99
- exit 1
100
- fi
17
+ # ホスト上のワークスペースのパス(実際の配置場所に合わせて書き換えてください)
18
+ workspace_dir="${1:-$HOME/<path-to-workspace>/<repo-name>}"
101
19
 
102
- exec docker exec -it --detach-keys="ctrl-]" -u "$container_user" -w "$container_workspace_dir" "$container_name" tmux new-session -A -s "$session_name"
20
+ exec bash "$workspace_dir/.specdojo/host/devcontainer-tmux.sh" "$workspace_dir"
@@ -8,8 +8,10 @@ Host <host>
8
8
 
9
9
  # devcontainer 内の tmux セッションへ直接入る接続用
10
10
  # RemoteCommand は非対話シェルで動くため、接続先端末の ~/.zshrc などの PATH 設定は読み込まれません。
11
+ # 通常の接続(コンテナ稼働中または停止中)では Node.js は不要です(docker のみ使用)。
12
+ # コンテナ未作成時のみ Dev Container CLI が自動起動されます。
11
13
  # 接続元から「ssh <host> 'command -v devcontainer'」を実行して Dev Container CLI が見つかるか確認できます。
12
- # 見つからない場合は、ホスト側の ~/bin/specdojo-tmux.sh の node_bin_dir を設定してください。
14
+ # 見つからない場合は、ホストの環境変数 SPECDOJO_NODE_BIN を設定するか、ログインシェルの PATH を確認してください。
13
15
  Host <host>-tmux
14
16
  HostName <host>
15
17
  User <user>
@@ -282,6 +282,7 @@ members:
282
282
  type: agent
283
283
  provider: antigravity
284
284
  model: gemini-3.8-flash-high
285
+ mode: report
285
286
  stage_role: reporter
286
287
  capabilities: []
287
288
  proficiency: normal
@@ -92,7 +92,7 @@ providers:
92
92
  # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
93
93
  # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
94
94
  # model の ID は実体の member の model に書く(PJR-ZM1K)。
95
- command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
95
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
96
96
  rate_limit_detection:
97
97
  stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
98
98
  copilot:
@@ -199,6 +199,8 @@ type は次のように使い分ける。
199
199
 
200
200
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
201
201
 
202
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
203
+
202
204
  ```bash
203
205
  npx specdojo register add --project <project-id> \
204
206
  --type todo --title "<title>" --description "<description>" \