specdojo 0.2.0 → 0.3.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.
- package/.github/agents/specdojo-orchestrator.md +165 -0
- package/CHANGELOG.md +280 -0
- package/README.md +143 -30
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/dashboard.js +140 -9
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-format.js +13 -4
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans.js +115 -113
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration.js +811 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter.js +613 -132
- package/dist/exec-results.js +81 -56
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run.js +1585 -356
- package/dist/exec-shared.js +7 -0
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial.js +51 -25
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops.js +502 -57
- package/dist/exec-worktree.js +114 -27
- package/dist/exec.js +13 -6
- package/dist/grade-result.js +128 -0
- package/dist/grade.js +809 -72
- package/dist/init-command.js +443 -0
- package/dist/job.js +160 -10
- package/dist/orchestrator.js +213 -0
- package/dist/package-paths.js +19 -1
- package/dist/register-event-merge.js +169 -0
- package/dist/register-item.js +7 -1
- package/dist/register.js +294 -86
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +111 -1
- package/dist/review-types.js +40 -1
- package/dist/routine.js +72 -5
- package/dist/schedule-build.js +2 -2
- package/dist/schedule.js +17 -4
- package/dist/specdojo-config.js +466 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +8 -1
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +261 -32
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +184 -0
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +336 -93
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +16 -9
- package/templates/antigravity/README.md +60 -0
- package/templates/antigravity/agent-members-snippet.yaml +61 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +39 -0
- package/templates/antigravity/orchestrator.md +157 -0
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +164 -0
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +165 -0
- package/templates/codex/orchestrator.md +157 -0
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +72 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +204 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
|
@@ -208,86 +208,3 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
208
208
|
| クローズ条件を未記載にする | 収束判定ができないため |
|
|
209
209
|
| `otp-<term>` に共通方針を重複記載し、`otp-index` と矛盾させる | SSOTが崩れ、参照が割れるため |
|
|
210
210
|
| 「関連ドキュメント」セクションを省略する | 導線が失われ、参照先が分散するため |
|
|
211
|
-
|
|
212
|
-
## 8. サンプル(最小・整合版)
|
|
213
|
-
|
|
214
|
-
注:以下はルール文書内の例示です。生成する `otp-<term>` では `## 1...` から始まります。
|
|
215
|
-
|
|
216
|
-
### 8.1. `otp-<term>`(個別:例)
|
|
217
|
-
|
|
218
|
-
```yaml
|
|
219
|
-
---
|
|
220
|
-
id: otp-hypercare
|
|
221
|
-
type: project
|
|
222
|
-
title: 運用切替計画: ハイパーケア
|
|
223
|
-
status: draft
|
|
224
|
-
based_on:
|
|
225
|
-
- otp-index
|
|
226
|
-
- mip-index
|
|
227
|
-
supersedes: []
|
|
228
|
-
---
|
|
229
|
-
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
#### 8.1.1. 概要(hypercare)
|
|
233
|
-
|
|
234
|
-
切替後の初期不具合・問い合わせ増に対応するため、ハイパーケア体制(増員・SLA・運用手順)を具体化する。
|
|
235
|
-
共通方針は `otp-index` を正とし、本書はハイパーケアの運用詳細に限定する。
|
|
236
|
-
|
|
237
|
-
#### 8.1.2. 監視/アラート
|
|
238
|
-
|
|
239
|
-
| 監視対象 | 指標/閾値 | 通知先 | 初動ルール | 備考 |
|
|
240
|
-
| -------- | --------- | ------ | -------------------- | ------- |
|
|
241
|
-
| API | 5xx > 1% | #ops | P1は30分以内一次応答 | 5分平均 |
|
|
242
|
-
| バッチ | 失敗=1回 | #ops | 影響範囲を即共有 | 日次 |
|
|
243
|
-
|
|
244
|
-
#### 8.1.3. バックアップ/リストア
|
|
245
|
-
|
|
246
|
-
- 方式: 夜間フル + 日中差分(保持30日)
|
|
247
|
-
- リストア責任者: 運用責任者
|
|
248
|
-
- 完了基準: 主要業務のスモーク成功 + 整合性照合レポートOK
|
|
249
|
-
|
|
250
|
-
#### 8.1.4. 権限/アカウント移行
|
|
251
|
-
|
|
252
|
-
- 追加権限: ハイパーケア担当に限定付与(期間終了で剥奪)
|
|
253
|
-
- 検証: 当番ロールで監視/ログ参照/障害対応が可能であること
|
|
254
|
-
|
|
255
|
-
#### 8.1.5. 運用手順の変更点
|
|
256
|
-
|
|
257
|
-
| 手順 | 旧 | 新 | 変更理由 | 影響 | 参照 |
|
|
258
|
-
| ---------- | ------ | -------- | ----------- | ------------ | ------------------ |
|
|
259
|
-
| 問合せ受付 | メール | #support | 集約/可視化 | チャネル統一 | (運用手順リンク) |
|
|
260
|
-
|
|
261
|
-
#### 8.1.6. 問合せ窓口/一次対応
|
|
262
|
-
|
|
263
|
-
- 受付: #support / 09:00-18:00(期間中は延長運用あり)
|
|
264
|
-
- 一次対応: 既知不具合案内、ログ採取依頼、再現条件ヒアリング
|
|
265
|
-
- エスカレーション: P1は即時 #ops と #po に共有
|
|
266
|
-
|
|
267
|
-
#### 8.1.7. 障害対応フロー
|
|
268
|
-
|
|
269
|
-
- 指揮: 運用責任者(必要に応じてPO)
|
|
270
|
-
- 連絡: #ops → #po → 利用者告知(#comms)
|
|
271
|
-
|
|
272
|
-
#### 8.1.8. 初期増員体制(期間・当番・SLA)
|
|
273
|
-
|
|
274
|
-
| 期間 | 体制(当番/時間帯) | SLA目安 | 判断者 | 備考 |
|
|
275
|
-
| ----------- | ----------------------------------------------- | ---------------------- | ---------- | ------------------------ |
|
|
276
|
-
| 切替後2週間 | 8:00-20:00は常駐(Ops2 + Biz1)/ 夜間オンコール | P1:30分一次連絡、P2:2h | 運用責任者 | 延長はクローズ条件で判断 |
|
|
277
|
-
|
|
278
|
-
#### 8.1.9. 旧システムの停止/参照方針
|
|
279
|
-
|
|
280
|
-
- 参照依頼は一次窓口で受付し、参照手順に従い対応する
|
|
281
|
-
- 参照期間終了後は「アーカイブ照会手順」に切替える(リンク)
|
|
282
|
-
|
|
283
|
-
#### 8.1.10. 移行完了後のクローズ条件
|
|
284
|
-
|
|
285
|
-
- P1=0が30日、P2が収束傾向、問い合わせが基準以下
|
|
286
|
-
- 既知不具合一覧がクローズ/運用引継ぎ完了
|
|
287
|
-
|
|
288
|
-
#### 8.1.11. 関連ドキュメント
|
|
289
|
-
|
|
290
|
-
- `otp-index`:運用切替計画のSSOT(共通方針/期間/SLA/クローズ基準)
|
|
291
|
-
- `mip-index`:移行計画(ハイパーケア方針)
|
|
292
|
-
- `cop-index`:切替当日の計画(前提・影響)
|
|
293
|
-
- (必要に応じて)`mtp-index`:リハーサル計画(運用観点の検証)
|
|
@@ -71,10 +71,11 @@ Project Register Documentation Rules
|
|
|
71
71
|
| `completed_at` | 完了・却下・決定日時 | 条件 |
|
|
72
72
|
| `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
|
|
73
73
|
| `conclusion` | 終端時の結論要約 | 任意 |
|
|
74
|
+
| `targets` | 変更対象文書の doc id リスト | 任意 |
|
|
74
75
|
|
|
75
76
|
- `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
|
|
76
77
|
- `item_type`、`item_status`、`priority` の値は schema の enum だけを使用する。
|
|
77
|
-
- `block_reason`
|
|
78
|
+
- `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
|
|
78
79
|
- Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
|
|
79
80
|
|
|
80
81
|
### 3.1. 日時と日付の使い分け
|
|
@@ -130,11 +131,12 @@ Project Register Documentation Rules
|
|
|
130
131
|
- 対応・判断内容には、実施または採択した範囲と、明示的に対象外とした範囲を記載する。
|
|
131
132
|
- 結果・結論には、完了を判定した根拠と後続対応を記載する。
|
|
132
133
|
- 関連ドキュメントには、判断根拠、変更対象、影響先、追跡先のうち該当する文書を記載する。
|
|
134
|
+
- 本項目の実施において確実に変更する対象文書が分かっている場合は、その文書 ID を Frontmatter の `targets` 配列へ宣言する。宣言した `targets` は agent 実行時の変更網羅検証(target coverage)に用いられる。未知の場合や対象を固定しない場合は宣言を省略する。
|
|
133
135
|
|
|
134
136
|
### 5.2. 構造化フィールドと生成
|
|
135
137
|
|
|
136
138
|
- 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
|
|
137
|
-
- 担当・期限・結論・topic などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。待機理由は `register wait --reason`
|
|
139
|
+
- 担当・期限・結論・topic などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
|
|
138
140
|
- `register build` は個票を読み取り、一覧・派生ビューを再生成する。一覧を編集して個票へ反映する経路はない。
|
|
139
141
|
- `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時もコマンドが既定値を記録する。
|
|
140
142
|
- 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
|
|
@@ -13,178 +13,106 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
# プロジェクトメンバー定義 作成ルール
|
|
15
15
|
|
|
16
|
-
Project Member Roster Documentation Rulebook
|
|
16
|
+
Project Human Member Roster Documentation Rulebook
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
`pm-members.yaml` を、人間の実行主体と対応 Role code を管理するプロジェクト成果物として作成・更新するためのルールです。実行可能な agent の定義は、リポジトリ共通の保護設定へ分離します。
|
|
19
19
|
|
|
20
20
|
## 1. 全体方針
|
|
21
21
|
|
|
22
|
-
- `pm-members.yaml`
|
|
23
|
-
-
|
|
24
|
-
- Member
|
|
25
|
-
- `members[].roles`
|
|
26
|
-
-
|
|
27
|
-
-
|
|
22
|
+
- `pm-members.yaml` には人間の member だけを記載し、`members[].type` は `human` とします。
|
|
23
|
+
- 実行可能な agent は `.specdojo/agent-members.yaml` を正本とし、`pm-members.yaml` に複製しません。
|
|
24
|
+
- Member は実行主体、Role code は責務を表します。Schedule の `owner` には member nickname を書きません。
|
|
25
|
+
- `members[].roles` には `pm-roles.yaml` に存在する Role code だけを記載します。
|
|
26
|
+
- 公開文書には、不要な個人名、私用メールアドレス、非公開組織情報、アクセス情報を記載しません。
|
|
27
|
+
- 人間の最終承認、公開可否、説明責任は agent 定義へ移しません。
|
|
28
28
|
|
|
29
29
|
## 2. 位置づけと用語定義
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
| 情報 | 正本 | 粒度 |
|
|
32
|
+
| ----------------------------- | ------------------------------ | ---------- |
|
|
33
|
+
| 人間の identity・連絡先・兼務 | `pm-members.yaml` | project |
|
|
34
|
+
| agent の identity・選択属性 | `.specdojo/agent-members.yaml` | repository |
|
|
35
|
+
| provider の起動コマンド | `.specdojo/exec-defaults.yaml` | repository |
|
|
36
|
+
| Role code と責務 | `pm-roles.yaml` | project |
|
|
37
|
+
| Schedule の主責任 | Schedule の `owner` | task |
|
|
32
38
|
|
|
33
|
-
|
|
34
|
-
| -------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------- |
|
|
35
|
-
| `pm-organization.md` | ロール・メンバー構成の方針と設計根拠を記述する | 採用方針、最終判断の集約先、見直し条件 |
|
|
36
|
-
| `pm-roles.yaml` | 採用した Role code を machine-readable な YAML として一覧化する | `owner` 語彙、Role code 名、プロジェクト固有メモ |
|
|
37
|
-
| `pm-members.yaml` | 実行主体と対応する Role code の対応を管理する | member nickname、人間または agent、兼務割り当て、agent の選択属性 |
|
|
38
|
-
| `pm-raci.md` | 必要時の責任分担を記述する | 成果物・プロセスごとの責任分担 |
|
|
39
|
-
|
|
40
|
-
agent の起動コマンドは `pm-members.yaml` には置かず、`.specdojo/exec-defaults.yaml` の `providers.<provider>.command_template` を member 属性(`nickname` / `mode` / `proficiency`)で展開して解決する。`pm-members.yaml` は「誰が・どの能力で・どの優先度か」に加え、pipeline 専用 agent の場合だけ「どの stage を担当するか」を表し、モデル名や CLI フラグなどの実行基盤設定を持ち込まない。
|
|
41
|
-
|
|
42
|
-
用語は次のように使い分ける。
|
|
43
|
-
|
|
44
|
-
| 用語 | 意味 | `pm-members.yaml` での扱い |
|
|
45
|
-
| ----------------- | -------------------------------------------------- | ------------------------------- |
|
|
46
|
-
| Role code | 責務・判断権限・専門性を表す短い識別子 | `members[].roles` に列挙する |
|
|
47
|
-
| Member | 実際に作業または支援する主体 | `members[]` に列挙する |
|
|
48
|
-
| nickname | CLI と実行ログで使う Member の安定識別子 | `members[].nickname` に記載する |
|
|
49
|
-
| legacy agent | pipeline を使わない従来の単一 agent 実行主体 | `stage_role` を省略する |
|
|
50
|
-
| pipeline executor | 成果物編集と検証を担う pipeline の第 1 stage agent | `stage_role: executor` とする |
|
|
51
|
-
| pipeline reporter | evidence から結果を構成する第 2 stage agent | `stage_role: reporter` とする |
|
|
39
|
+
`loadMemberRoster` は人間名簿と agent 定義を schema 検証した後に合成します。合成後の nickname は一意でなければならず、`--by` と実行イベントはこの合成名簿を参照します。
|
|
52
40
|
|
|
53
41
|
## 3. ファイル命名・ID規則
|
|
54
42
|
|
|
55
|
-
- ファイル名は `pm-members.yaml`
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
- `
|
|
59
|
-
-
|
|
60
|
-
|
|
61
|
-
- `members[].nickname` は英小文字、数字、ハイフン、アンダースコアで記述する。
|
|
62
|
-
|
|
63
|
-
- 一度実行ログに記録した `nickname` は変更せず、改名が必要な場合は新しい member を追加する。
|
|
43
|
+
- ファイル名は `pm-members.yaml` とします。
|
|
44
|
+
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-members.yaml` を推奨します。
|
|
45
|
+
- `id` は `<project-id>:pm-members`、`project_id` は配置先 project ID と一致させます。
|
|
46
|
+
- `members[].nickname` は英小文字または数字で始め、英小文字、数字、ハイフン、アンダースコアだけを使います。
|
|
47
|
+
- 実行ログへ記録済みの nickname は変更せず、交代時は新しい member を追加します。
|
|
48
|
+
- 同じ nickname を `.specdojo/agent-members.yaml` に定義しません。
|
|
64
49
|
|
|
65
50
|
## 4. 推奨メタ項目
|
|
66
51
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
72
|
-
| `
|
|
73
|
-
| `
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
76
|
-
| `
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
|
90
|
-
|
|
91
|
-
| `
|
|
92
|
-
| `
|
|
93
|
-
| `
|
|
94
|
-
| `
|
|
95
|
-
| `
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
98
|
-
| `
|
|
99
|
-
|
|
100
|
-
`members[]` は次のフィールドを標準とする。
|
|
101
|
-
|
|
102
|
-
| フィールド | 必須 | 内容 |
|
|
103
|
-
| -------------- | ---- | -------------------------------------- |
|
|
104
|
-
| `nickname` | ○ | `--by` で指定する安定識別子 |
|
|
105
|
-
| `display_name` | ○ | 表示名。公開文書では個人名を避けてよい |
|
|
106
|
-
|
|
107
|
-
| `email` | 任意 | 公開可能な連絡先。非公開または不要なら `null` |
|
|
108
|
-
| `roles` | ○ | 対応する Role code のリスト。汎用 agent は `[]` 可 |
|
|
109
|
-
| `type` | ○ | `human` または `agent` |
|
|
110
|
-
| `provider` | agent 必須 | agent を実行する CLI 種別(`opencode` など) |
|
|
111
|
-
| `priority` | agent 推奨 | 同条件の agent 候補間での優先度。小さい値を優先する |
|
|
112
|
-
|
|
113
|
-
| `mode` | agent 推奨 | `edit` / `review` / `report`。agent の起動プロファイルを表す |
|
|
114
|
-
|
|
115
|
-
| `stage_role` | 任意 | pipeline 専用 agent の `executor` / `reporter` |
|
|
116
|
-
| `proficiency` | agent 推奨 | `normal` / `expert` などの品質 tier |
|
|
117
|
-
|
|
118
|
-
| `persona` | 任意 | 実行姿勢やレビュー観点を表す短いラベル |
|
|
119
|
-
| `focus` | 任意 | 重視する観点の配列 |
|
|
120
|
-
| `capabilities` | agent 推奨 | `web_search` などのツール能力 |
|
|
121
|
-
| `command` | 任意 | provider の command template を使わない場合の上書き |
|
|
122
|
-
| `disabled` | 任意 | `true` で `exec run --auto` の候補から一時除外する |
|
|
123
|
-
| `scheduler_strategy` | 任意 | 既定の scheduler 戦略 |
|
|
124
|
-
| `note` | 任意 | 補足。責務境界や公開上の注意を簡潔に書く |
|
|
52
|
+
| 項目 | 必須 | 内容 |
|
|
53
|
+
| ------------ | ---- | -------------------------------- |
|
|
54
|
+
| `id` | ○ | `<project-id>:pm-members` |
|
|
55
|
+
| `type` | ○ | `project` |
|
|
56
|
+
| `status` | ○ | `draft` / `ready` / `deprecated` |
|
|
57
|
+
| `title` | ○ | 名簿の表示名 |
|
|
58
|
+
| `rulebook` | ○ | `specdojo:pm-members-rulebook` |
|
|
59
|
+
| `based_on` | 任意 | 根拠文書 ID |
|
|
60
|
+
| `version` | ○ | 1 以上のデータ版 |
|
|
61
|
+
| `project_id` | ○ | 対象 project ID |
|
|
62
|
+
|
|
63
|
+
schema にないメタ項目は追加しません。成果物の `status` は作成中は `draft` とし、`ready` への変更は人間が判断します。
|
|
64
|
+
|
|
65
|
+
## 5. 本文要件
|
|
66
|
+
|
|
67
|
+
| 要素 | 必須 | 内容 |
|
|
68
|
+
| --------- | ---- | ------------------------------------- |
|
|
69
|
+
| `members` | ○ | 人間 member の配列 |
|
|
70
|
+
| `rules` | 任意 | 名簿利用時の project 固有の運用ルール |
|
|
71
|
+
|
|
72
|
+
`members[]` は次のフィールドを使用します。
|
|
73
|
+
|
|
74
|
+
| フィールド | 必須 | 内容 |
|
|
75
|
+
| -------------------- | ---- | --------------------------------------------------------- |
|
|
76
|
+
| `nickname` | ○ | CLI と履歴で使う安定識別子 |
|
|
77
|
+
| `display_name` | ○ | 公開可能な表示名 |
|
|
78
|
+
| `email` | 任意 | 公開可能な連絡先。不要または非公開なら `null` |
|
|
79
|
+
| `roles` | ○ | 対応可能な Role code の配列 |
|
|
80
|
+
| `type` | ○ | `human` 固定 |
|
|
81
|
+
| `persona` | 任意 | 作業姿勢を示す短いラベル |
|
|
82
|
+
| `focus` | 任意 | 重視する観点の配列 |
|
|
83
|
+
| `scheduler_strategy` | 任意 | `critical-first` / `dependency-first` / `fifo` / `manual` |
|
|
84
|
+
| `note` | 任意 | 稼働条件や最終判断範囲などの公開可能な補足 |
|
|
125
85
|
|
|
126
86
|
## 6. 記述ガイド
|
|
127
87
|
|
|
128
|
-
### 6.1.
|
|
129
|
-
|
|
130
|
-
- `members` には、実行ログに残る可能性がある人間と agent を過不足なく記載する。
|
|
131
|
-
- PO などの人間 member は、最終判断・公開可否・説明責任を担う範囲を `note` で明示する。
|
|
132
|
-
- agent member は、支援範囲、実行モード、能力、provider が分かる粒度で記載する。
|
|
133
|
-
- 一時的に使うだけの個人名、ローカル端末名、秘密情報を member として記載しない。
|
|
134
|
-
|
|
135
|
-
### 6.2. `members[].nickname`
|
|
136
|
-
|
|
137
|
-
- `nickname` は CLI、実行ログ、イベント履歴で参照されるため、短く安定した値にする。
|
|
138
|
-
- 人間の member には `po`、agent には `ba-agent` のように、用途が分かる値を使う。
|
|
139
|
-
- 表示名や担当範囲が変わっても、実行ログ記録後の `nickname` は変更しない。
|
|
140
|
-
- 大文字、空白、記号を含む表示名を `nickname` にしない。
|
|
141
|
-
|
|
142
|
-
### 6.3. `members[].roles`
|
|
143
|
-
|
|
144
|
-
- `members[].roles` には、`pm-roles.yaml` の `roles[].code` に存在する Role code だけを記載する。
|
|
145
|
-
- 兼務がある場合は複数の Role code を列挙する。
|
|
146
|
-
- 特定 Role に固定しない汎用 agent は `roles: []` としてよい。
|
|
147
|
-
- `roles` は member 側の対応ロールを表す。Schedule の `owner` の代替として使わない。
|
|
148
|
-
|
|
149
|
-
### 6.4. `members[].type` と agent 用フィールド
|
|
88
|
+
### 6.1. 人間 member
|
|
150
89
|
|
|
151
|
-
-
|
|
152
|
-
- `
|
|
153
|
-
-
|
|
154
|
-
- `
|
|
155
|
-
- `stage_role` は pipeline 専用 agent にだけ指定し、`executor` または `reporter` とする。人間 member には指定しない。
|
|
156
|
-
- `stage_role` を省略した agent は従来の単一 agent フロー専用とする。`stage_role` を持つ agent と持たない agent は、自動選択時に相互の代替候補にしない。
|
|
157
|
-
- pipeline stage の agent は、strategy の stage に宣言された `stage_role`、`capabilities`、`proficiency` と member 属性が一致する候補から選ぶ。strategy に member nickname を固定しない。
|
|
158
|
-
- 起動コマンドは member には書かず、`.specdojo/exec-defaults.yaml` の `providers.<provider>.command_template` から member 属性で解決する。モデル名や CLI フラグの変更は member 定義に影響させない。
|
|
159
|
-
- `command` は、テンプレートで表現できない特殊構成(`provider: custom` など)に限って上書きとして使う。記載する場合も、認証情報、秘密鍵、トークン、個人環境に閉じたパスを含めない。
|
|
160
|
-
- `disabled: true` を指定した agent は `exec run --auto` の候補選択(rate limit 時のフォールバックを含む)から一時的に除外される。特定 provider の挙動(例: rate limit)をテストする際に、member 定義を削除せずに他 agent を止める用途で使う。省略時または `false` は通常どおり選択対象になる。
|
|
90
|
+
- 個人名を必要としない場合は、`po` や `store-owner` のような役割ベースの nickname と表示名を使います。
|
|
91
|
+
- `roles` は兼務を表し、責務定義そのものは `pm-roles.yaml` に委ねます。
|
|
92
|
+
- 最終判断、公開可否、説明責任を担う範囲は `note` に短く記載します。
|
|
93
|
+
- 連絡先を公開できない場合は推測で補わず `email: null` とします。
|
|
161
94
|
|
|
162
|
-
### 6.
|
|
95
|
+
### 6.2. 合成名簿との整合
|
|
163
96
|
|
|
164
|
-
-
|
|
165
|
-
- `
|
|
166
|
-
- `
|
|
167
|
-
-
|
|
97
|
+
- nickname が `.specdojo/agent-members.yaml` と重複しないことを確認します。
|
|
98
|
+
- `--by` に人間または agent の nickname を指定する場合、合成名簿に一意に存在する値を使います。
|
|
99
|
+
- `pm-members.yaml` に `type: agent` が残る場合は、`specdojo config migrate-members --dry-run` で移行内容を確認します。
|
|
100
|
+
- agent の追加・優先度・能力変更は、保護設定を変更できる人間または orchestrator が行います。
|
|
168
101
|
|
|
169
|
-
### 6.
|
|
102
|
+
### 6.3. 運用ルール
|
|
170
103
|
|
|
171
|
-
- `rules`
|
|
172
|
-
-
|
|
173
|
-
-
|
|
174
|
-
-
|
|
175
|
-
- 公開文書で扱わない個人情報や非公開組織情報を記載しない方針を含める。
|
|
104
|
+
- `rules` には `owner`、`roles`、`--by` の使い分けを判定可能な文として記載します。
|
|
105
|
+
- project 固有の公開制約や交代時の扱いだけを記載し、共通 schema を再掲しません。
|
|
106
|
+
- agent の provider、モデル、起動 command は記載しません。
|
|
107
|
+
- 名簿の変更理由は project の変更管理記録に残します。
|
|
176
108
|
|
|
177
109
|
## 7. 禁止事項
|
|
178
110
|
|
|
179
|
-
| 禁止事項
|
|
180
|
-
|
|
|
181
|
-
| `
|
|
182
|
-
|
|
|
183
|
-
|
|
|
184
|
-
|
|
|
185
|
-
|
|
|
186
|
-
|
|
|
187
|
-
| provider の command template で解決できる member に `command` を書く | 起動設定が `.specdojo/exec-defaults.yaml` と二重管理になるため |
|
|
188
|
-
| 人間 member に `stage_role` を指定する | pipeline stage は agent 実行だけを対象とするため |
|
|
189
|
-
| pipeline stage の指定に member nickname を使う | strategy と実行主体が密結合し、候補選択と差し替えができなくなるため |
|
|
190
|
-
| 実行ログ記録後に `nickname` を変更する | 履歴との対応が壊れるため |
|
|
111
|
+
| 禁止事項 | 理由 |
|
|
112
|
+
| ------------------------------------------------------ | ---------------------------------------- |
|
|
113
|
+
| `type: agent` の member を記載する | 保護設定との責務境界が崩れるため |
|
|
114
|
+
| `provider`、`command`、`mode`、`stage_role` を記載する | agent 実行設定を成果物から変更できるため |
|
|
115
|
+
| Schedule の `owner` に nickname や人名を書く | 責務と実行主体を混同するため |
|
|
116
|
+
| 未定義の Role code を `roles` に書く | ロール正本との整合が失われるため |
|
|
117
|
+
| 実行ログ記録後の nickname を変更する | 履歴の参照先が不明になるため |
|
|
118
|
+
| 秘密情報、私用連絡先、非公開組織情報を記載する | 公開適性と安全性を損なうため |
|
|
@@ -15,7 +15,7 @@ specdojo:
|
|
|
15
15
|
|
|
16
16
|
Project Role Definition Documentation Rulebook
|
|
17
17
|
|
|
18
|
-
本ドキュメントは、`pm-roles.yaml` を一貫した構造で作成・更新するためのルールを定義する。`pm-roles.yaml` は、プロジェクトで使用する全 Role code の machine-readable な一覧であり、Schedule の `owner` や RACI
|
|
18
|
+
本ドキュメントは、`pm-roles.yaml` を一貫した構造で作成・更新するためのルールを定義する。`pm-roles.yaml` は、プロジェクトで使用する全 Role code の machine-readable な一覧であり、Schedule の `owner` や RACI の列として使用できる責務語彙を定義する。人間の実行主体と兼務の割り当ては `pm-members.yaml`、agent は `.specdojo/agent-members.yaml` の `members[].roles` で管理する。
|
|
19
19
|
|
|
20
20
|
## 1. 全体方針
|
|
21
21
|
|
|
@@ -23,7 +23,7 @@ Project Role Definition Documentation Rulebook
|
|
|
23
23
|
|
|
24
24
|
- 標準 Role code は `PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS` を基本セットとし、プロジェクト内で採用する責務語彙をこの集合から選ぶ。
|
|
25
25
|
- Role code の共通定義・責務・規模別パターンは上位標準を参照し、本ファイルに再掲しない。
|
|
26
|
-
- 兼務の割り当て、member nickname、agent 名、個人名は `pm-members.yaml` で管理し、本ファイルに記載しない。
|
|
26
|
+
- 兼務の割り当て、member nickname、agent 名、個人名は `pm-members.yaml` と `.specdojo/agent-members.yaml` で管理し、本ファイルに記載しない。
|
|
27
27
|
- ロール採用の方針・根拠、最終判断の集約先、見直し条件は `pm-organization.md` を参照し、本ファイルに重複して記載しない。
|
|
28
28
|
- `pm-roles.yaml` の `roles[].code` は、Schedule の `owner` および `pm-members.yaml` の `members[].roles` で使用できる Role code の語彙一覧として機能する。
|
|
29
29
|
- PO が全 Role code とプロジェクト固有メモを承認できるよう、各 `project_note` は公開可能な内容だけで簡潔に記載する。
|
|
@@ -38,7 +38,8 @@ Project Role Definition Documentation Rulebook
|
|
|
38
38
|
| `pm-organization.md` | ロール・メンバー構成の方針と設計根拠を記述する | 採用方針、最終判断の集約先、見直し条件 |
|
|
39
39
|
|
|
40
40
|
| `pm-roles.yaml` | 採用した Role code を machine-readable な YAML として一覧化する | `owner` 語彙、Role code 名、プロジェクト固有メモ |
|
|
41
|
-
| `pm-members.yaml` |
|
|
41
|
+
| `pm-members.yaml` | 人間の実行主体と対応する Role code を管理する | member nickname、人間、兼務割り当て |
|
|
42
|
+
| `.specdojo/agent-members.yaml` | agent と対応する Role code を管理する | agent nickname、選択属性、兼務割り当て |
|
|
42
43
|
| `pm-raci.md` | 必要時の責任分担を記述する | 成果物・プロセスごとの責任分担 |
|
|
43
44
|
|
|
44
45
|
用語は次のように使い分ける。
|
|
@@ -139,7 +140,7 @@ schema に定義されていないメタ項目は `pm-roles.yaml` には追加
|
|
|
139
140
|
| -------------------------------------------------------------------------- | --------------------------------------------------- |
|
|
140
141
|
| 標準にない独自 Role code を追加する | Schedule、RACI、member 定義との接続が壊れるため |
|
|
141
142
|
| `roles[].code` に member nickname、agent 名、個人名、stakeholder ID を書く | Role と実行主体が混同されるため |
|
|
142
|
-
| 兼務の割り当てや実行主体を本ファイルに記載する |
|
|
143
|
+
| 兼務の割り当てや実行主体を本ファイルに記載する | member 名簿の責務であり重複管理になるため |
|
|
143
144
|
| ロール採用の根拠・方針・見直し条件を長く記載する | `pm-organization.md` の責務であり重複管理になるため |
|
|
144
145
|
| 公開できない個人情報、連絡先、非公開組織情報、アクセス情報を記載する | PO の公開可否判断と説明責任を損なうため |
|
|
145
146
|
| AI Agent に最終承認、公開可否、説明責任を持たせる記述を置く | 人間の PO が最終判断を担う前提に反するため |
|
|
@@ -25,7 +25,7 @@ Schedule は「いつ・誰が・どの順で作業するか」を定義する
|
|
|
25
25
|
- 成果物カタログの `kind: work` エントリを実行タスクへ展開し、期間・担当・依存関係を付与する。成果物パスと完了条件はカタログが管理する([[specdojo:schedule-design-guide]] の `成果物カタログとの責務分担` を参照)。
|
|
26
26
|
- `sch-strategy-<track>.yaml` が存在するトラックでは、strategy と成果物カタログを SSOT とし、`sch-track-<track>.yaml` は `specdojo schedule build` で再生成可能な生成物として扱う。生成後の track を直接編集しない。
|
|
27
27
|
- strategy を更新する場合は、DCT・Timeline・strategy の `approach_rules`・Kata の grade・標準 strategy profile を入力とする `schedule strategy generate` を使用する。
|
|
28
|
-
- Schedule の `owner` には Role code
|
|
28
|
+
- Schedule の `owner` には Role code のみを記載し、人間の実行主体との対応は `pm-members.yaml`、agent との対応は `.specdojo/agent-members.yaml` で管理する。
|
|
29
29
|
|
|
30
30
|
## 2. 位置づけと用語定義
|
|
31
31
|
|
|
@@ -119,14 +119,3 @@ stateDiagram-v2
|
|
|
119
119
|
- 初期点を省略したり、一つのコードブロック内で同じ `state_id` を異なる状態へ割り当てたりしません。
|
|
120
120
|
- 分割図で共有する状態の表示名や `state_id` を図ごとに変更しません。
|
|
121
121
|
- 状態の意味・成立条件を図中の長文ノートへ複製しません。
|
|
122
|
-
|
|
123
|
-
## 8. サンプル
|
|
124
|
-
|
|
125
|
-
```mermaid
|
|
126
|
-
stateDiagram-v2
|
|
127
|
-
[*] --> 記録済み : つけ登録 / 顧客と金額を確認済み
|
|
128
|
-
記録済み --> 清算済み : 代金受領 / 残高がゼロ
|
|
129
|
-
記録済み --> 取消済み : 記録取消 / 店主代表が承認
|
|
130
|
-
清算済み --> [*] : 清算記録確定 / 支払記録と一致
|
|
131
|
-
取消済み --> [*] : 取消記録確定 / 取消理由を記録済み
|
|
132
|
-
```
|
|
@@ -152,64 +152,3 @@ Status Definition Documentation Rulebook
|
|
|
152
152
|
- `<<choice>>` など、状態一覧にない疑似状態を分岐のために追加しません。
|
|
153
153
|
- 親状態と下位状態を持つ複合状態を使用しません。階層化が必要な異なる対象を一つの STSD に混在させません。
|
|
154
154
|
- CDFD、業務データ辞書、用語集に同じ状態一覧や遷移表を複製しません。
|
|
155
|
-
|
|
156
|
-
## 8. サンプル
|
|
157
|
-
|
|
158
|
-
````markdown
|
|
159
|
-
---
|
|
160
|
-
specdojo:
|
|
161
|
-
id: stsd-product
|
|
162
|
-
type: data
|
|
163
|
-
status: draft
|
|
164
|
-
rulebook: specdojo:stsd-rulebook
|
|
165
|
-
---
|
|
166
|
-
|
|
167
|
-
# 商品のステータス定義
|
|
168
|
-
|
|
169
|
-
## 1. 概要
|
|
170
|
-
|
|
171
|
-
店頭商品の現行業務(AS-IS)について、納品受入から販売または返品による終了までの状態と遷移を定義する。店主代表と家族利用者代表は現在状態の判断に、開発担当と同行レビュー担当は状態変更の設計・検証に利用する。
|
|
172
|
-
|
|
173
|
-
- 対象: 店舗が納品を受けた商品
|
|
174
|
-
- 状態の正本: 仕入記録、在庫記録、販売記録
|
|
175
|
-
- 状態変更の業務範囲: 入荷受入、検品、売場補充、販売、返品
|
|
176
|
-
- 一意判定: 正本記録を時系列で照合し、最後に成立した遷移の遷移先を現在状態とする。後続遷移が成立した時点で遷移元の状態は終了する
|
|
177
|
-
|
|
178
|
-
## 2. 状態一覧
|
|
179
|
-
|
|
180
|
-
| 値 | 状態名 | 通称 | 意味 | 成立条件 | 管理場所 |
|
|
181
|
-
| -------------- | -------- | ---------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------- |
|
|
182
|
-
| received | 入荷済み | 入った品 | 店舗が受領し、検品結果が未確定の商品 | 受入日時と数量を仕入記録へ記録し、検品結果をまだ記録していない | 仕入記録 |
|
|
183
|
-
| inspected | 検品済み | 検品した品 | 検品結果を記録し、結果に応じた配置または分離の途中の商品 | 検品結果と理由を仕入記録へ記録し、在庫更新・売場配置または返品保管箱への分離が完了していない | 仕入記録、検品場所 |
|
|
184
|
-
| sellable | 販売可能 | 売れる品 | 検品に合格し、売場で販売できる商品 | 在庫数量を更新して売場棚へ配置し、販売完了をまだ記録していない | 在庫記録、売場棚 |
|
|
185
|
-
| sold | 販売済み | 売れた品 | 会計を終え、顧客への引き渡しを完了した商品 | 販売記録を確定し、在庫を減算して、顧客が商品を受領した | 販売記録 |
|
|
186
|
-
| return-pending | 返品待ち | 返す品 | 検品不合格により仕入先への返品を待つ商品 | 不合格理由を仕入記録へ記録して返品保管箱へ分け、返品日と数量をまだ記録していない | 仕入記録、返品保管箱 |
|
|
187
|
-
| returned | 返品済み | 返した品 | 仕入先へ返却し、店舗の管理対象を外れた商品 | 仕入先が商品を受領し、返品日と数量を仕入記録へ記録した | 仕入記録 |
|
|
188
|
-
|
|
189
|
-
## 3. 状態遷移図
|
|
190
|
-
|
|
191
|
-
```mermaid
|
|
192
|
-
stateDiagram-v2
|
|
193
|
-
[*] --> 入荷済み : 入荷受入 / 商品受領後に受入日時と数量を仕入記録へ記録した
|
|
194
|
-
入荷済み --> 検品済み : 検品結果記録 / 検品結果と理由を仕入記録へ記録した
|
|
195
|
-
検品済み --> 販売可能 : 検品完了 / 結果が合格で在庫を更新し売場へ配置した
|
|
196
|
-
検品済み --> 返品待ち : 検品完了 / 結果が数量違いまたは品質不良で返品保管箱へ分けた
|
|
197
|
-
販売可能 --> 販売済み : 商品引渡し / 会計・在庫減算・顧客受領が完了した
|
|
198
|
-
返品待ち --> 返品済み : 返品処理完了 / 仕入先へ引き渡し返品日と数量を仕入記録へ記録した
|
|
199
|
-
販売済み --> [*] : 販売処理確定 / 販売記録と在庫記録が一致した
|
|
200
|
-
返品済み --> [*] : 返品処理確定 / 返品商品と仕入記録が一致した
|
|
201
|
-
```
|
|
202
|
-
|
|
203
|
-
## 4. 遷移の説明
|
|
204
|
-
|
|
205
|
-
| 遷移 ID | 遷移元 | 遷移先 | イベント | 条件 | 補足 |
|
|
206
|
-
| ------- | -------- | -------- | ------------ | ------------------------------------------------ | -------------------------------- |
|
|
207
|
-
| `T-01` | 開始 | 入荷済み | 入荷受入 | 商品受領後に受入日時と数量を仕入記録へ記録した | 検品前の商品を識別する |
|
|
208
|
-
| `T-02` | 入荷済み | 検品済み | 検品結果記録 | 検品結果と理由を仕入記録へ記録した | 後続作業中も現在状態を判定できる |
|
|
209
|
-
| `T-03` | 検品済み | 販売可能 | 検品完了 | 結果が合格で在庫を更新し売場へ配置した | 販売グループへ引き渡せる |
|
|
210
|
-
| `T-04` | 検品済み | 返品待ち | 検品完了 | 結果が数量違いまたは品質不良で返品保管箱へ分けた | 合格条件と相互排他的に判定する |
|
|
211
|
-
| `T-05` | 販売可能 | 販売済み | 商品引渡し | 会計・在庫減算・顧客受領が完了した | 販売記録を正本とする |
|
|
212
|
-
| `T-06` | 返品待ち | 返品済み | 返品処理完了 | 仕入先へ引き渡し返品日と数量を仕入記録へ記録した | 仕入記録へ返品日を残す |
|
|
213
|
-
| `T-07` | 販売済み | 終了 | 販売処理確定 | 販売記録と在庫記録が一致した | 販売経路を終了する |
|
|
214
|
-
| `T-08` | 返品済み | 終了 | 返品処理確定 | 返品商品と仕入記録が一致した | 返品経路を終了する |
|
|
215
|
-
````
|
|
@@ -5,7 +5,7 @@ specdojo:
|
|
|
5
5
|
status: draft
|
|
6
6
|
target_format: yaml
|
|
7
7
|
recipe: not-needed
|
|
8
|
-
sample:
|
|
8
|
+
sample: specdojo:tml-sample
|
|
9
9
|
template: not-needed
|
|
10
10
|
based_on:
|
|
11
11
|
- specdojo:rulebook-authoring-standard
|
|
@@ -136,52 +136,7 @@ schema で機械検証できない記述規範だけを定める。トラック
|
|
|
136
136
|
- プロジェクトごとに `tml-index.yaml` を複数置くこと、またはトラック単位へ分割すること。
|
|
137
137
|
- `specdojo timeline build` の生成物を直接編集すること。
|
|
138
138
|
|
|
139
|
-
## 7.
|
|
140
|
-
|
|
141
|
-
最小構成の例を示す。`launch` を起点に、業務仕様のドメイン別トラックを並行候補として並べている。
|
|
142
|
-
|
|
143
|
-
```yaml
|
|
144
|
-
id: prj-0001:tml-index
|
|
145
|
-
type: project
|
|
146
|
-
status: draft
|
|
147
|
-
title: トラック順序計画
|
|
148
|
-
rulebook: specdojo:tml-rulebook
|
|
149
|
-
version: 1
|
|
150
|
-
project_id: prj-0001
|
|
151
|
-
|
|
152
|
-
tracks:
|
|
153
|
-
- track: launch
|
|
154
|
-
domains: [project-definition, project-management]
|
|
155
|
-
catalog_status: primary
|
|
156
|
-
order: 1
|
|
157
|
-
depends_on: []
|
|
158
|
-
note: プロジェクト全体の前提を定義する起点トラック。
|
|
159
|
-
|
|
160
|
-
- track: data-flow
|
|
161
|
-
domains: [data-flow]
|
|
162
|
-
catalog_status: primary
|
|
163
|
-
order: 2
|
|
164
|
-
parallel_group: business-specs
|
|
165
|
-
depends_on: [launch]
|
|
166
|
-
|
|
167
|
-
- track: data-model
|
|
168
|
-
domains: [data-model]
|
|
169
|
-
catalog_status: draft
|
|
170
|
-
catalog_duration_estimate_days: 3
|
|
171
|
-
order: 2
|
|
172
|
-
parallel_group: business-specs
|
|
173
|
-
depends_on: [launch]
|
|
174
|
-
note: data-flow と同じ入力を使うため並行候補とする。
|
|
175
|
-
|
|
176
|
-
- track: architecture
|
|
177
|
-
domains: [architecture]
|
|
178
|
-
catalog_status: not_started
|
|
179
|
-
catalog_duration_estimate_days: 2
|
|
180
|
-
order: 3
|
|
181
|
-
depends_on: [data-flow, data-model]
|
|
182
|
-
```
|
|
183
|
-
|
|
184
|
-
## 8. 今後の検討
|
|
139
|
+
## 7. 今後の検討
|
|
185
140
|
|
|
186
141
|
- 現時点の `catalog_status` は3値の軽量フィールドであり、カタログ作成作業そのものを子カタログ(`done_criteria` 付きの成果物エントリ)として管理する「フル成果物カタログ化」は採用していない。カタログ作成の工数管理をタスク粒度で行う必要が出た場合に、フル化を再検討する。
|
|
187
142
|
- フル化する場合でも `tml-index.yaml` はトラック粒度の計画層として残し、カタログ作成タスクは Schedule 側へ展開する方針を想定する。
|