PDDと品質チェックリストの改善

生成されたプロセス設計書 (PDD) を会話を通じて更新するための改良パターンと、ハンドオフ前に完了する品質チェックリスト。

プロセス設計書 (PDD) を生成したら、ダウンロードしたファイルを直接編集するのではなく、会話を通じてドキュメントを改良し、引き渡しの前に完了していることを確認します。

改良の仕組み

1. 何を変える必要があるかを 地図製作者 に平易な言葉で伝えてください。
2. 更新されたセクションを確認して確定します。

結果: Cartographer によって基になるプロセス ノートが更新され、影響を受ける PDD セクションが自動的に再投影されます。

ヒント:

対象を絞った更新を行うには、セクションの下部にある [セクションを絞り込む] リンクを使用します。この方法では、更新のスコープがそのセクションにのみ設定されるため、一般的な更新を要求するよりも高速です。ダウンロードした .docx ファイルを手作業で編集してから再同期を試みないでください。Word で直接変更すると、ソース ノートとの不整合が生じる可能性があります。

改良のクイック リファレンス

状況	何を言うべきか	更新される内容
ステップが誤って記載されている	「ステップ N — 説明は..."	AS-ISステップとPDDのステップセクション
ビジネス ルールの欠落	「私たちはルールを見逃していました。[条件/アクション]..."	ビジネス ルール レジスターと [ビジネス ルール] セクション
間違ったオートメーション モード	「[ステップ]を[モード]から[モード]に変更するから..."	デリバリーモデル、TO-BEステップ、および将来の状態のプロセスマップ
例外パスが見つからない	「私たちが捉えなかった例外があります。[説明]..."	PDDの例外処理(AS-ISおよび/またはTO-BE)セクション
遅延ギャップの解決	「[ギャップ]に対する答えがあります。[答え]..."	ギャップ レジスタ、影響を受けるステップ、および [既知のギャップ] セクション
ロールまたはシステムがない	「[名前]を含めるのを忘れていました。彼らは[説明]します..."	エンティティ ファイル、影響を受けるステップ、および [ロール] セクション
利点には詳細が必要です	「以下の詳細で特典を拡大してください。[詳細]..."	PDDの福利厚生ノートおよび福利厚生セクション
メタデータの更新が必要	「[バージョン/作成者/組織名] を [値] に更新してください..."	ドキュメントのヘッダー、フッター、表紙

注:

修正は監査証跡に追加されます。情報を修正しても、元のファイルは削除されず、変更が理由と日付とともにログに記録されます。これは、監査人が変更された箇所とその理由を確認するコンプライアンス レビューで役立ちます。

ハンドオフ前の品質チェックリスト

現状 (AS-IS) の完全性

• すべてのステップには、そのステップを担当するネームド ロールまたはチームがあります。
• すべてのステップでは、使用するシステムまたはアプリケーションに名前を付けるだけでなく、「システム」だけでなく、使用するシステムまたはアプリケーションに名前を付けます。
• すべての判断ポイントには、少なくとも 2 つの名前付きパスがあります。
• すべてのビジネス ルールには、条件と結果のアクションがあります。
• すべての例外パスは、ルーティング先とともに文書化されます。
• プロセス マップは、ステップ バイ ステップのウォークスルーと一致します。
• すべてのギャップが解決されるか、指定された所有者によって明示的に延期されます。

TO-BEの完全性

• すべてのステップには、自動化モードが割り当てられています。
• 人間によるレビュー ステップ: 承認者の名前と通知メカニズム。
• エージェントのステップでは、AI がどのような種類の判断やバリエーションを処理するかを記述します。
• デリバリー モデルの表では、現状 (AS-IS) のすべてのステップが考慮されます。
• AS-IS と TO-BE の例外処理の違いが記載されています。
• 将来の状態のプロセス マップは、デリバリー モデルを正確に反映します。

ドキュメントの品質

• ドキュメントのバージョンが正しく設定されている (下書きは 0.x、最終版は 1.0)。
• 組織名は全体を通して正確で一貫性がある。
• 著者名は正確です。
• 「未定」「プレースホルダー」「追加予定の図」を含むセクションはありません。
• すべての重要な事実には出典の帰属が記載されています。