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
|
@@ -45,11 +45,11 @@ SpecDojo の特色は、この三つを別々の正本として保守しなが
|
|
|
45
45
|
|
|
46
46
|
### 2.1. 三つの概念と役割
|
|
47
47
|
|
|
48
|
-
| 概念 | 読み | 答える問い | SpecDojo 上の実体 | 正本
|
|
49
|
-
| ---- | ---- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
50
|
-
| Kata | 型 | この成果物には何を書き、どう作り、完成形はどうなるか | 実践の型: rulebook / recipe / sample / template | [
|
|
51
|
-
| Waza | 技 | 計画・実行・状態管理・機械検証をどう遂行するか | `specdojo` CLI: catalog / schedule / exec / register / routine / grade など | [遂行の技活用ガイド](../guides/waza-guide.md)、[CLIコマンドリファレンス](../references/command-reference.md)
|
|
52
|
-
| Ryu | 流 | 型の整備状況と目的に応じて、型をどこまで基準にして進めるか | `approach`: fully-guided / recipe-guided / freeform と、retrofit / bootstrap / maintenance 系 / finalize 系 | [実践の進め方ガイド](../guides/ryu-guide.md)、[Schedule設計ガイド](../guides/schedule-design-guide.md)
|
|
48
|
+
| 概念 | 読み | 答える問い | SpecDojo 上の実体 | 正本 |
|
|
49
|
+
| ---- | ---- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
50
|
+
| Kata | 型 | この成果物には何を書き、どう作り、完成形はどうなるか | 実践の型: rulebook / recipe / sample / template | [型の構成ガイド](../guides/practice-system-composition-guide.md)、[実践の型活用ガイド](../guides/kata-guide.md) |
|
|
51
|
+
| Waza | 技 | 計画・実行・状態管理・機械検証をどう遂行するか | `specdojo` CLI: catalog / schedule / exec / register / routine / grade など | [遂行の技活用ガイド](../guides/waza-guide.md)、[CLIコマンドリファレンス](../references/command-reference.md) |
|
|
52
|
+
| Ryu | 流 | 型の整備状況と目的に応じて、型をどこまで基準にして進めるか | `approach`: fully-guided / recipe-guided / freeform と、retrofit / bootstrap / maintenance 系 / finalize 系 | [実践の進め方ガイド](../guides/ryu-guide.md)、[Schedule設計ガイド](../guides/schedule-design-guide.md) |
|
|
53
53
|
|
|
54
54
|
Kata は「何を・どう書くか」の基準を文書として持ちます。Waza は基準そのものを定義せず、成果物カタログから Schedule・タスク・plan・result へ展開して遂行し、結果を記録・検証します。Ryu は両者の間に立ち、今回のタスクで Kata をどこまで基準にするかを決めます。
|
|
55
55
|
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:bps-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: draft
|
|
6
|
+
rulebook: specdojo:bps-rulebook
|
|
7
|
+
sample: specdojo:bps-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 業務プロセス仕様 作成レシピ
|
|
11
|
+
|
|
12
|
+
Business Process Specification Writing Recipe
|
|
13
|
+
|
|
14
|
+
一つのプロセス領域に属し、共通の起点から一つの業務成果へ至る流れを、業務担当者が合意でき、設計者とテスト担当者が後続作業へ利用できる粒度へ具体化する手順です。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 最初に CDFD から対象領域、個別プロセス、主要な入出力、データストアを抜き出し、一つの起点と業務成果に流れを限定します。
|
|
19
|
+
- 次に、業務担当者への聞き取りからトリガー、前提条件、担当、判断、例外を集め、開始から終了までを処理ステップとして並べます。
|
|
20
|
+
- その後、各ステップの入力、出力、完了条件を補い、BR、BES、STSD、データ定義へ委ねる情報を分離します。
|
|
21
|
+
- 最後に、正常系、条件付き処理、主要例外を業務成果と確認記録までたどり、第三者が受入可否を判定できるかを確認します。
|
|
22
|
+
|
|
23
|
+
この成果物は、プロセス領域が担う業務目的を Why、開始条件と確定する業務成果を What、担当・処理・例外対応を How、トリガー ID・ステップ ID・例外 ID・参照先の対応を Trace として整理します。判断式、イベント契約、状態定義、データ項目定義は複製せず、利用箇所から参照します。
|
|
24
|
+
|
|
25
|
+
## 2. 作成前に集める情報
|
|
26
|
+
|
|
27
|
+
| 項目 | 集める情報 |
|
|
28
|
+
| ---------- | ------------------------------------------------------------------------------------------- |
|
|
29
|
+
| 対象領域 | CDFD のプロセス領域 ID・名称・業務目的・主担当・起点イベント |
|
|
30
|
+
| 対象の流れ | 共通の起点から一つの業務成果へ至る個別プロセスと、その開始・終了 |
|
|
31
|
+
| 利用者 | 流れを実施・承認する役割と、成果を設計・テスト・後続業務へ利用する役割 |
|
|
32
|
+
| トリガー | 発生時点を観測できる出来事、発生元、受領情報、開始条件 |
|
|
33
|
+
| 前提条件 | 開始前に yes / no で確認する業務条件と、不成立時の扱い |
|
|
34
|
+
| 入力と正本 | 業務上の入力名、入手元、利用目的、必須性、正本 |
|
|
35
|
+
| 処理と責任 | CDFD の個別プロセス、各活動・判断の担当、順序、分岐、完了条件 |
|
|
36
|
+
| 業務成果 | 確定する記録、状態変化、通知、判断結果、受け手、後続処理 |
|
|
37
|
+
| 参照仕様 | 判断を定める BR、イベントを定める BES、状態を定める STSD、項目の意味を定めるデータ仕様の ID |
|
|
38
|
+
| 主要例外 | 正常な成果または後続起動を妨げる事象、停止範囲、処置、再開条件、代替成果 |
|
|
39
|
+
| 受入根拠 | 正常・条件付き・例外の各経路で結果を確認できる記録 |
|
|
40
|
+
| 未決事項 | 調査不足、意思決定待ち、仮置き前提と、その影響・決定者・決定時期 |
|
|
41
|
+
|
|
42
|
+
## 3. 全体の作成手順
|
|
43
|
+
|
|
44
|
+
1. CDFD から一つのプロセス領域を選び、領域 ID、名称、個別プロセス、主要入出力、データストアを控えます。
|
|
45
|
+
2. 起点と業務成果の組を列挙し、独立して変更・承認される組が複数あれば文書を分けます。
|
|
46
|
+
3. 選んだ流れについて、業務目的、対象者、主担当、開始点、終了点、対象外を定めます。
|
|
47
|
+
4. 開始を観測できる出来事をトリガーとして記載し、発生元、受領情報、開始条件、不成立時の扱いを対応させます。
|
|
48
|
+
5. 開始前に確認する前提条件を yes / no で書き、不成立時に非起動、差戻し、例外のどれに進むかを決めます。
|
|
49
|
+
6. 流れで使用する入力を業務上の論理名で整理し、入手元、利用目的、必須性、正本を特定します。
|
|
50
|
+
7. 正常な順序に沿って処理ステップを並べ、各行に CDFD プロセス、担当、入力、活動または判断、出力、完了条件を記載します。
|
|
51
|
+
8. 判断式、イベント契約、状態定義、データ項目定義を参照先へ移し、この流れでの利用目的と結果だけを残します。
|
|
52
|
+
9. 分岐ごとに合流先または終了先を確認し、正常終了と条件付き終了の業務成果を受け手、確定条件、正本、後続処理とともに整理します。
|
|
53
|
+
10. 業務成果または後続起動を変える主要例外を選び、検出条件、停止範囲、担当、処置、再開条件または代替成果を記載します。
|
|
54
|
+
11. 正常系、条件付き処理、主要例外ごとに、入力条件、期待する業務成果、確認可能な記録を対応させます。
|
|
55
|
+
12. トリガー ID、ステップ ID、例外 ID、プロセス ID、参照仕様 ID を照合し、開始から終了までの欠落、名称ゆれ、責任の空白を解消します。
|
|
56
|
+
|
|
57
|
+
## 4. 各章の書き方
|
|
58
|
+
|
|
59
|
+
### 4.1. 導入文と概要
|
|
60
|
+
|
|
61
|
+
問い:
|
|
62
|
+
|
|
63
|
+
- 何が起きたら始まり、誰または何を対象にし、何が確定したら終わりますか。
|
|
64
|
+
- この流れが必要な理由と、扱わない場合に損なわれる業務価値は何ですか。
|
|
65
|
+
- 対象は CDFD の一つのプロセス領域に収まっていますか。
|
|
66
|
+
- 主担当、実施者、成果を利用する役割を区別できますか。
|
|
67
|
+
- 前後のプロセス、横断順序、実装方式のどこから先を対象外にしますか。
|
|
68
|
+
|
|
69
|
+
導入文は起点、対象、業務成果を一文で結びます。概要では目的と境界を固定し、「在庫管理を行う」のように複数の起点と成果を含む広い表現を避けます。
|
|
70
|
+
|
|
71
|
+
### 4.2. トリガー
|
|
72
|
+
|
|
73
|
+
問い:
|
|
74
|
+
|
|
75
|
+
- 出来事の発生時点を、記録または人の確認から特定できますか。
|
|
76
|
+
- 発生元と受領情報から、開始対象を一意に特定できますか。
|
|
77
|
+
- 開始条件を yes / no で判定できますか。
|
|
78
|
+
- 条件不成立は正常な非起動、差戻し、主要例外のどれですか。
|
|
79
|
+
- 複数トリガーは同じ業務成果へ収束しますか。
|
|
80
|
+
|
|
81
|
+
「在庫が少ないとき」のような状態だけでなく、「在庫確認で現在庫が補充基準を下回ったと判定された」のように観測できる出来事として書きます。成果が異なるトリガーは同じ表へ追加せず、流れを分けます。
|
|
82
|
+
|
|
83
|
+
### 4.3. 前提条件
|
|
84
|
+
|
|
85
|
+
問い:
|
|
86
|
+
|
|
87
|
+
- トリガー発生後、処理を始める前に確認すべき販売状態、権限、正本、重複の有無は何ですか。
|
|
88
|
+
- 条件の真偽を確認する情報源はありますか。
|
|
89
|
+
- 不成立時に処理を開始しないのか、差し戻すのか、例外へ進むのかが明確ですか。
|
|
90
|
+
- 前提条件と最初の処理ステップで同じ判断を二重に定義していませんか。
|
|
91
|
+
|
|
92
|
+
条件と不成立時の扱いを一組で記述します。処理中に初めて判明する事象は、前提条件ではなく該当ステップと主要例外へ置きます。
|
|
93
|
+
|
|
94
|
+
### 4.4. 入力
|
|
95
|
+
|
|
96
|
+
問い:
|
|
97
|
+
|
|
98
|
+
- 各入力はどのステップの判断または活動に使われますか。
|
|
99
|
+
- 入手元と正本を区別でき、同じ論理名を CDFD と関連仕様で使っていますか。
|
|
100
|
+
- 必須入力が欠けた場合の非起動または例外を特定できますか。
|
|
101
|
+
- 物理テーブル、画面項目、API 項目ではなく業務上の情報として記述していますか。
|
|
102
|
+
|
|
103
|
+
参照仕様の定義を写さず、BPS ではその入力をいつ、何のために利用するかを示します。条件付き入力には利用条件と欠落時の扱いを添えます。
|
|
104
|
+
|
|
105
|
+
### 4.5. 処理
|
|
106
|
+
|
|
107
|
+
問い:
|
|
108
|
+
|
|
109
|
+
- 各ステップは一人または一つの責任主体が完了を判断できる単位ですか。
|
|
110
|
+
- CDFD のどの個別プロセスを具体化しているかを示せますか。
|
|
111
|
+
- 入力から活動または判断を経て、次へ渡す出力と完了条件へつながりますか。
|
|
112
|
+
- 分岐条件と、分岐後の合流先または終了先をたどれますか。
|
|
113
|
+
- BR を参照する判断では、ルール ID と判断結果だけを残していますか。
|
|
114
|
+
|
|
115
|
+
画面操作やシステム内部の呼び出し順ではなく、業務上の活動と判断を書きます。複数主体の承認や引き渡しは別ステップとし、完了条件は記録や成果から yes / no で判定できる文にします。
|
|
116
|
+
|
|
117
|
+
### 4.6. 出力
|
|
118
|
+
|
|
119
|
+
問い:
|
|
120
|
+
|
|
121
|
+
- 正常終了と条件付き終了で確定する業務成果をすべて挙げていますか。
|
|
122
|
+
- 受け手は誰で、何がそろえば確定と判断できますか。
|
|
123
|
+
- 成果の正本と、起動する後続処理を特定できますか。
|
|
124
|
+
- 状態変化またはイベント発行を参照仕様へ接続し、定義を複製していませんか。
|
|
125
|
+
|
|
126
|
+
「処理完了」ではなく、確定する記録、状態変化、通知、判断結果、または引き渡しを名詞で示します。後続処理がない場合も「なし」と明記し、暗黙の連鎖を残しません。
|
|
127
|
+
|
|
128
|
+
### 4.7. 例外・代替経路
|
|
129
|
+
|
|
130
|
+
問い:
|
|
131
|
+
|
|
132
|
+
- その事象は正常な非起動ではなく、業務成果または後続処理を変えますか。
|
|
133
|
+
- どのステップで、どの条件から検出できますか。
|
|
134
|
+
- 何を確定または起動してはならないかを停止範囲として示せますか。
|
|
135
|
+
- 誰が何を処置し、どの事実がそろえばどこから再開できますか。
|
|
136
|
+
- 再開しない場合に確定する代替成果を示せますか。
|
|
137
|
+
|
|
138
|
+
内部エラーやログを網羅せず、業務判断を要する主要例外へ絞ります。例外がない場合は、確認した正常系、条件付き処理、入力不足、出力確定失敗の範囲と、業務成果を変える例外がないという結論を記述します。
|
|
139
|
+
|
|
140
|
+
### 4.8. 検証・受入観点
|
|
141
|
+
|
|
142
|
+
問い:
|
|
143
|
+
|
|
144
|
+
- 正常系、条件付き処理、主要例外を少なくとも一つずつ確認できますか。
|
|
145
|
+
- 入力条件と期待する業務成果の組から、結果を一意に判定できますか。
|
|
146
|
+
- 確認可能な記録は、出力の正本または例外時の保留・差戻し記録と一致しますか。
|
|
147
|
+
- 後続のテスト担当者が、画面や実装方式を仮定せず受入シナリオを設計できますか。
|
|
148
|
+
|
|
149
|
+
「正しく処理される」ではなく、件数、確定項目、非作成、保留内容など観測できる結果を書きます。テスト手順や操作列ではなく、受け入れられる業務成果を定義します。
|
|
150
|
+
|
|
151
|
+
### 4.9. 未決事項(任意)
|
|
152
|
+
|
|
153
|
+
- 調査で確定できる不足情報は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置き前提は _ASSUMPTION_: とします。
|
|
154
|
+
- 論点ごとに影響する章またはステップ、区分、決定者、決定時期を記載します。
|
|
155
|
+
- 未決事項がない場合は章を省略し、空表や「なし」だけの章を残しません。
|
|
156
|
+
|
|
157
|
+
## 5. 深掘り手順
|
|
158
|
+
|
|
159
|
+
1. 終了点の業務成果から逆向きにたどり、その成果を確定する最後のステップ、必要な判断、入力を確認します。
|
|
160
|
+
2. トリガーから順方向にたどり、各ステップの出力が次のステップの入力になるかを確認します。
|
|
161
|
+
3. 各ステップで担当を外した場合に完了判断が曖昧にならないかを確認し、責任主体が複数ならステップを分けます。
|
|
162
|
+
4. 分岐条件を一つずつ反転し、合流、正常終了、例外、非起動のいずれにも到達しない経路を探します。
|
|
163
|
+
5. BR、BES、STSD、データ仕様と同じ定義文を探し、参照 ID と利用目的へ置き換えます。
|
|
164
|
+
6. 主要例外ごとに、検出前に確定した記録、停止する後続、再開位置、代替成果を順に確認します。
|
|
165
|
+
7. 正常系、条件付き処理、主要例外の各経路について、入力条件から確認可能な記録までを一行で説明できるか確認します。
|
|
166
|
+
8. CDFD のプロセス ID、入出力、データストア名と照合し、BPS だけで追加・削除・改名した要素を解消します。
|
|
167
|
+
|
|
168
|
+
## 6. 良い例 / 悪い例
|
|
169
|
+
|
|
170
|
+
| 観点 | 良い例 | 悪い例 |
|
|
171
|
+
| ---------- | -------------------------------------------------------------------- | ------------------------------------ |
|
|
172
|
+
| 文書境界 | 在庫基準割れの検出から補充依頼の確定までを扱う | 在庫管理と仕入と販売をすべて扱う |
|
|
173
|
+
| トリガー | 現在庫が補充基準を下回ったと在庫確認で判定された | 補充が必要になった |
|
|
174
|
+
| 前提条件 | 商品が販売中でない場合は補充不要として記録し、処理を開始しない | 商品を確認して問題がなければ開始する |
|
|
175
|
+
| 入力 | 現在庫を在庫記録から取得し、補充要否の判断に使う | 在庫テーブルの数量列を読む |
|
|
176
|
+
| 処理 | 店主代表が判断根拠を確認し、商品と数量を持つ補充依頼を承認する | 登録ボタンを押して API を呼ぶ |
|
|
177
|
+
| 完了条件 | 商品、数量、判断根拠、承認者、承認時刻を持つ補充依頼が確定している | 問題なく完了している |
|
|
178
|
+
| 主要例外 | 補充基準を取得できない場合は依頼を確定せず、補完後に判定から再開する | エラー時は適切に再試行する |
|
|
179
|
+
| 受入観点 | 未完了依頼がある場合は新規依頼を作らず、重複確認記録を確認できる | 重複が正しく処理される |
|
|
180
|
+
| 参照の境界 | `br-reorder-point` の判定結果を使い、計算式は参照先を正本とする | 発注点の計算式を本文へ再掲する |
|
|
181
|
+
|
|
182
|
+
## 7. レビュー観点
|
|
183
|
+
|
|
184
|
+
| 観点 | 確認内容 | 主な確認者 |
|
|
185
|
+
| ---------- | ---------------------------------------------------------------------------------------- | -------------------------- |
|
|
186
|
+
| 業務目的 | 起点から業務成果までが一つの価値と責任境界を持ち、対象外を説明できる | 店主代表、業務分析担当 |
|
|
187
|
+
| CDFD 整合 | プロセス領域、プロセス ID、主要入出力、データストア名が CDFD と矛盾しない | 業務分析担当 |
|
|
188
|
+
| 開始条件 | トリガーと前提条件を記録から yes / no で判定でき、不成立時の扱いが明確である | 店主代表、品質確認担当 |
|
|
189
|
+
| 責任と完了 | 各ステップに一つの責任主体、入力、活動または判断、出力、判定可能な完了条件がある | 業務分析担当 |
|
|
190
|
+
| 正本の分離 | 判断、イベント、状態、データ定義を複製せず、参照 ID とこの流れでの利用目的からたどれる | アーキテクト、業務分析担当 |
|
|
191
|
+
| 例外 | 主要例外の検出条件、停止範囲、担当、処置、再開条件または代替成果を説明できる | 品質確認担当、店主代表 |
|
|
192
|
+
| 検証可能性 | 正常・条件付き・例外の入力条件、期待成果、確認記録から受入可否を第三者が判定できる | 品質確認担当 |
|
|
193
|
+
| 実装非依存 | 画面操作、物理データ構造、詳細 API、クラス、内部エラーを業務プロセスとして記述していない | アーキテクト |
|
|
194
|
+
|
|
195
|
+
「業務分析担当」「品質確認担当」「アーキテクト」は、対象プロジェクトのロール定義または責任分担文書で正式な担当へ対応付けます。
|
|
196
|
+
|
|
197
|
+
## 8. 仕上げチェック
|
|
198
|
+
|
|
199
|
+
- 一文書が一つのプロセス領域に属し、共通の起点と一つの業務成果を持つ流れだけを扱っている。
|
|
200
|
+
- 導入文から起点、対象、業務成果を一文で説明できる。
|
|
201
|
+
- 業務目的、対象者、主担当、開始点、終了点、対象外があり、前後のプロセスと横断順序の境界を説明できる。
|
|
202
|
+
- 各トリガーに発生元、受領情報、開始条件、不成立時の扱いがある。
|
|
203
|
+
- 前提条件が yes / no で判定でき、不成立時の非起動、差戻し、例外を特定できる。
|
|
204
|
+
- 各入力に入手元、利用目的、必須性、正本があり、欠落時の扱いをたどれる。
|
|
205
|
+
- 全処理ステップに CDFD プロセス、担当、入力、活動または判断、出力、完了条件、例外の対応がある。
|
|
206
|
+
- 分岐から合流先または終了先をたどれ、正常終了と条件付き終了の業務成果が出力にある。
|
|
207
|
+
- BR、BES、STSD、データ仕様を正本として参照し、その定義を複製していない。
|
|
208
|
+
- 主要例外に検出条件、停止範囲、担当、処置、再開条件または代替成果がある。
|
|
209
|
+
- 正常系、条件付き処理、主要例外の受入観点に、入力条件、期待する業務成果、確認可能な記録がある。
|
|
210
|
+
- CDFD とプロセス ID、主要入出力、データストア名が一致し、BPS だけの追加・削除・改名がない。
|
|
211
|
+
- 画面操作、SQL、物理カラム、詳細 API、クラス、ログ文言を業務仕様へ持ち込んでいない。
|
|
212
|
+
- _TODO_ が残っていない。未決事項がある場合は区分、影響、決定者、決定時期がある。
|
|
213
|
+
- 個人情報、秘密情報、非公開の組織情報など、公開範囲に不適切な内容を含めていない。
|
|
@@ -9,141 +9,76 @@ specdojo:
|
|
|
9
9
|
|
|
10
10
|
# メンバー定義 作成レシピ
|
|
11
11
|
|
|
12
|
-
Project Member Roster Writing Recipe
|
|
12
|
+
Project Human Member Roster Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
人間の実行主体と Role code の対応を `pm-members.yaml` に整理し、agent の実行定義を保護設定へ混在させないための作成手順です。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
18
|
+
- 組織定義とロール定義から、人間が担う最終判断と使用可能な Role code を確認します。
|
|
19
|
+
- 実行ログへ残す人間の nickname、公開可能な表示名、兼務を整理します。
|
|
20
|
+
- agent の provider、能力、優先度、command は `.specdojo/agent-members.yaml` へ分離します。
|
|
21
|
+
- 既存名簿に agent がある場合は、手編集より先に移行コマンドの dry-run を確認します。
|
|
22
22
|
|
|
23
23
|
## 2. 作成前に集める情報
|
|
24
24
|
|
|
25
|
-
| 項目
|
|
26
|
-
|
|
|
27
|
-
| 組織定義
|
|
28
|
-
| ロール定義
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
| agent
|
|
32
|
-
|
|
|
33
|
-
| 公開制約 | 個人情報、連絡先、非公開組織情報、認証情報を含めない条件 |
|
|
25
|
+
| 項目 | 集める情報 |
|
|
26
|
+
| ----------- | ------------------------------------------------------------ |
|
|
27
|
+
| 組織定義 | 最終判断の集約先、公開方針、兼務方針 |
|
|
28
|
+
| ロール定義 | `members[].roles` に使える Role code |
|
|
29
|
+
| 人間 member | 安定 nickname、公開可能な表示名・連絡先、対応 Role code |
|
|
30
|
+
| 実行ログ | 既に使われ、変更してはいけない nickname |
|
|
31
|
+
| agent 定義 | 人間 nickname と重複しないことを確認するための nickname 一覧 |
|
|
32
|
+
| 公開制約 | 個人情報、私用連絡先、非公開組織情報を含めない条件 |
|
|
34
33
|
|
|
35
34
|
## 3. 全体の作成手順
|
|
36
35
|
|
|
37
|
-
1. `
|
|
38
|
-
2. `
|
|
39
|
-
3. `
|
|
40
|
-
4.
|
|
41
|
-
5.
|
|
42
|
-
6.
|
|
43
|
-
7. PO が承認できるよう、実行主体の過不足、公開可否、説明責任の所在を確認する。
|
|
36
|
+
1. `project_id`、成果物 ID、`based_on` を確定します。
|
|
37
|
+
2. 人間の実行主体だけを列挙し、`type: human` とします。
|
|
38
|
+
3. `pm-roles.yaml` と照合して各 member の `roles` を割り当てます。
|
|
39
|
+
4. 実行ログと `.specdojo/agent-members.yaml` を確認し、nickname の重複と改名を避けます。
|
|
40
|
+
5. 非公開の連絡先は `null` にし、最終判断範囲を `note` に簡潔に記載します。
|
|
41
|
+
6. schema 検証で agent 用フィールドや未定義キーが混入していないことを確認します。
|
|
44
42
|
|
|
45
|
-
## 4.
|
|
43
|
+
## 4. 深掘りする問い
|
|
46
44
|
|
|
47
|
-
### 4.1.
|
|
45
|
+
### 4.1. 実行主体
|
|
48
46
|
|
|
49
|
-
|
|
47
|
+
- 人間として最終判断、受入、公開可否を担う主体は誰ですか。
|
|
48
|
+
- 人物が交代しても意味が変わらない nickname になっていますか。
|
|
49
|
+
- 兼務する Role code は責務正本と一致していますか。
|
|
50
|
+
- 公開できない個人情報を推測で補っていませんか。
|
|
50
51
|
|
|
51
|
-
|
|
52
|
-
- `project_id` は配置先プロジェクトと一致しているか。
|
|
53
|
-
- `based_on` は member 割り当ての根拠を指しているか。
|
|
52
|
+
### 4.2. agent との境界
|
|
54
53
|
|
|
55
|
-
|
|
54
|
+
- `type: agent`、`provider`、`command`、`mode`、`stage_role` が名簿に残っていませんか。
|
|
55
|
+
- 人間 nickname が repository 共通の agent nickname と重複していませんか。
|
|
56
|
+
- agent の追加・優先度変更を通常成果物の編集として扱っていませんか。
|
|
57
|
+
- 既存 agent の移行には `specdojo config migrate-members --dry-run` を先に使いましたか。
|
|
56
58
|
|
|
57
|
-
|
|
58
|
-
- `rulebook` には `specdojo:pm-members-rulebook` を記載する。
|
|
59
|
-
- 根拠 ID は、内容を実際に確認した文書だけを記載する。
|
|
59
|
+
### 4.3. Role と履歴
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
- `roles` は `pm-roles.yaml` に存在する値だけですか。
|
|
62
|
+
- Schedule の `owner` と member nickname を混同していませんか。
|
|
63
|
+
- 実行ログに記録済みの nickname を変更していませんか。
|
|
64
|
+
- nickname を廃止する場合も履歴参照を維持できる記録がありますか。
|
|
62
65
|
|
|
63
|
-
|
|
66
|
+
## 5. レビュー観点
|
|
64
67
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
-
|
|
68
|
+
| 観点 | 確認内容 |
|
|
69
|
+
| ---------------- | ------------------------------------------------------------- |
|
|
70
|
+
| schema | `pm-members.schema.yaml` に適合し、人間だけを含む |
|
|
71
|
+
| Role code | `members[].roles` がロール定義と一致する |
|
|
72
|
+
| nickname | project 内と agent 定義との合成後に一意で、履歴上安定している |
|
|
73
|
+
| 責任境界 | 人間の最終判断と agent の実行支援が混在していない |
|
|
74
|
+
| 公開適性 | 私用連絡先、秘密情報、非公開組織情報を含まない |
|
|
75
|
+
| トレーサビリティ | 組織定義、ロール定義、変更記録から割り当て理由を追える |
|
|
68
76
|
|
|
69
|
-
|
|
77
|
+
## 6. 完了チェック
|
|
70
78
|
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
- agent
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
問い:
|
|
78
|
-
|
|
79
|
-
- 各 Role code は `pm-roles.yaml` の `roles[].code` に存在するか。
|
|
80
|
-
- 兼務が必要な人間 member には、対応 Role code が過不足なく入っているか。
|
|
81
|
-
- 汎用 agent の `roles: []` を、承認責任の空白として扱っていないか。
|
|
82
|
-
|
|
83
|
-
書き方:
|
|
84
|
-
|
|
85
|
-
- Role code は大文字の標準表記で記載する。
|
|
86
|
-
- 汎用 agent は `roles: []` としてよいが、実行時にはタスク `owner` または plan で対象 Role を補う。
|
|
87
|
-
- Schedule の `owner` に member nickname を書く代替として `roles` を使わない。
|
|
88
|
-
|
|
89
|
-
### 4.4. agent 用フィールド
|
|
90
|
-
|
|
91
|
-
問い:
|
|
92
|
-
|
|
93
|
-
- `mode` は edit / review のどちらに対応するか。
|
|
94
|
-
- `proficiency` と `priority` は scheduler の選択条件として使えるか。
|
|
95
|
-
- `provider` に対応する `command_template` が `.specdojo/exec-defaults.yaml` に存在するか。
|
|
96
|
-
- `command` を上書きする場合、秘密情報や個人環境依存のパスを含めていないか。
|
|
97
|
-
|
|
98
|
-
書き方:
|
|
99
|
-
|
|
100
|
-
- `provider` は実行する CLI 種別を表す。起動コマンドはこの値で `providers.<provider>.command_template` から解決される。
|
|
101
|
-
- `command` は、テンプレートを持たない構成(`provider: custom` など)に限って 1 行の上書きとして記載する。
|
|
102
|
-
- `capabilities` は `web_search` などのツール能力に限定する。
|
|
103
|
-
- agent の `note` には、最終判断を持たないことを明示する。
|
|
104
|
-
|
|
105
|
-
## 5. 深掘り手順
|
|
106
|
-
|
|
107
|
-
1. 組織定義から、PO が最終判断する範囲と agent 委任範囲を抜き出す。
|
|
108
|
-
2. ロール定義から、`members[].roles` に使える Role code を一覧化する。
|
|
109
|
-
3. 実行ログ、Schedule、既存 event から、使われている nickname を確認する。
|
|
110
|
-
4. 各 member を「人間の最終判断主体」「Role 固定 agent」「汎用 agent(executor)」「汎用 agent(reporter)」に分類する。
|
|
111
|
-
5. agent ごとに、mode、provider、proficiency、priority、capabilities の不足と、provider に対応する command template の有無を確認する。
|
|
112
|
-
6. 公開文書に残してよい表示名、連絡先、コマンドだけになっているか確認する。
|
|
113
|
-
7. PO 以外に最終承認、公開可否、説明責任が移っていないことを確認する。
|
|
114
|
-
|
|
115
|
-
## 6. 良い例 / 悪い例
|
|
116
|
-
|
|
117
|
-
| 観点 | 良い例 | 悪い例 |
|
|
118
|
-
| -------------- | ------------------------------------------------ | --------------------------------------------------- |
|
|
119
|
-
| nickname | `codex-executor` | `Codex Expert Executor` |
|
|
120
|
-
| roles | `roles: [PO, PM, OPS]` | `owner: po` |
|
|
121
|
-
| 汎用 agent | `roles: []` とし、実行時の owner で文脈を補う | `roles` 未記載のまま承認責任を曖昧にする |
|
|
122
|
-
| agent の責務 | 草案作成と整合確認を支援し、承認しない | agent が公開可否を判断する |
|
|
123
|
-
| provider | `provider: custom` のように実行種別が分かる | `provider` を省略して実行主体が曖昧になる |
|
|
124
|
-
| 起動コマンド | member には書かず command template で解決する | テンプレートで解決できる member に `command` を書く |
|
|
125
|
-
| command 上書き | 認証情報を含まない CLI コマンド | トークンや秘密鍵を含むコマンド |
|
|
126
|
-
| 公開可否 | `email: null` とし、公開不要な個人情報を出さない | 私用メールアドレスを公開する |
|
|
127
|
-
|
|
128
|
-
## 7. レビュー観点
|
|
129
|
-
|
|
130
|
-
| 観点 | 確認内容 |
|
|
131
|
-
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
|
|
132
|
-
| 目的・スコープとの整合 | 組織定義で採用した運用規模と agent 委任方針に合っているか |
|
|
133
|
-
| 承認判断 | PO が実行主体、兼務、agent 支援範囲を承認、保留、差し戻しできるか |
|
|
134
|
-
| Role code 整合 | `members[].roles` が `pm-roles.yaml` の `roles[].code` に存在するか |
|
|
135
|
-
| provider 整合 | agent の `provider` に対応する `command_template` が `.specdojo/exec-defaults.yaml` にあるか(無い構成のみ `command` 上書き) |
|
|
136
|
-
| 実行可能性 | `--by` に指定する nickname と、agent 実行に必要な情報が揃っているか |
|
|
137
|
-
| 公開可否 | 個人情報、非公開情報、認証情報、agent への最終判断委任が含まれていないか |
|
|
138
|
-
| 下流入力 | scheduler、exec run、実行ログが参照できる安定した member 台帳になっているか |
|
|
139
|
-
|
|
140
|
-
## 8. 仕上げチェック
|
|
141
|
-
|
|
142
|
-
- 「全体の作成手順」で示した構成と必須項目がそろっている。
|
|
143
|
-
- 人間と agent の違いが分かる粒度で書けている。
|
|
144
|
-
- `members[].roles` に未定義 Role code、member nickname、人名、agent 名が混ざっていない。
|
|
145
|
-
- agent の `provider`、`mode`、`proficiency` が揃っており、command template から起動コマンドを解決できる。
|
|
146
|
-
- `command` を上書きしている場合、秘密情報や個人環境に閉じた値が含まれていない。
|
|
147
|
-
- `pm-organization.md` と `pm-roles.yaml` の方針と矛盾していない。
|
|
148
|
-
- 公開してよい情報だけで構成され、最終判断と説明責任が人間の PO に残っている。
|
|
149
|
-
- 各 member の採用理由、Role code、実行属性を、`based_on` と既存フィールドの対応から追跡できる。
|
|
79
|
+
- `members[]` はすべて `type: human` です。
|
|
80
|
+
- nickname、`display_name`、`roles` が全 member にあります。
|
|
81
|
+
- agent 用の選択属性と起動設定は含まれていません。
|
|
82
|
+
- `pm-members.schema.yaml` の検証を通過します。
|
|
83
|
+
- agent 定義と合成したとき nickname が重複しません。
|
|
84
|
+
- 最終判断と公開可否を担う人間の範囲が読み取れます。
|