プロジェクト成果物
テンプレートはフランスの統合プロジェクト実務(DAT、DEX、fiche MEP、PV de recette)に従い、英語の見出しとフランス語名(括弧内)を使用しています。これらはスケルトンです:見出し、表、および置換または削除するためのイタリック体(_..._)の短いガイダンスが含まれています。
各テンプレートの使用タイミング
| ニーズ | テンプレート | 通常のリードエージェント | 貢献者 | フェーズ |
|---|---|---|---|---|
| 対象の技術ソリューションを説明し、選択を正当化する | dat.md | enterprise-architect | infra, dba, devsecops, integration, erp, ibmi | 設計、本番稼動まで更新 |
| システムを運用に引き継ぐ | dex.md | infra-expert | scheduling, dba, integration, ibmi, erp | 構築 → 本番稼動前 |
| 本番リリースを計画・実行する | release-sheet.md | project-manager | 関係するすべての技術エージェント | 各リリース |
| 2つのシステム間の1つのインターフェースを特定する | interface-contract.md | integration-expert | erp, ibmi, dba, devsecops | 設計、変更のたびにバージョン管理 |
| ネットワークフローを要求・文書化する | flow-matrix.md | infra-expert | devsecops, integration | 設計 → ファイアウォール要求 |
| 誰が何を行うかを明確にする | raci.md | project-manager | 全員 | 枠組み設定、フェーズごとにレビュー |
| リスク、前提条件、課題、依存関係を追跡する | raid.md | project-manager | 全員 | プロジェクト全体、毎週レビュー |
| 納品の受諾を記録する | uat-signoff.md | project-manager | business owner, テスター | 各受入テストキャンペーンの終了時 |
| 組織の環境に関する事実を一度記録し、すべてのエキスパートが読めるようにする | environment-sheet.md | project-manager(/tiger-team:discover経由) | 全員 | エンゲージメント開始時、最新に保つ |
テンプレートのインスタンス化方法
- テンプレートをフルパス(以下のインデックスを参照)で読み取ります。
- インスタンスをユーザーのプロジェクトに作成します(慣例がない場合は場所を尋ねます)。例:
docs/<deliverable>/<ID>-<short-name>.md。テンプレート自体は決して変更しないでください。 - すべての
<プレースホルダー>を埋めます。不明な点については、作り上げるのではなく、TBD(所有者、日付)のマーカーを残します。 - セクションが埋まったら、イタリック体のガイダンス行を削除します。該当しないオプションのセクションは、監査人が期待する場所に「N/A:<理由>」と記載して削除します。
- 関連する成果物(同じID、バージョン、ホスト名、所有者)との一貫性を相互チェックします。
記述ルール(すべての成果物共通)
- 文書管理を最初に:識別ブロック、バージョン表(バージョン、日付、作成者、変更内容)、レビュアーおよび承認者(日付付き)。バージョン:
0.x草稿、1.0初回承認、1.x軽微な更新、2.0構造変更。ステータス:草稿 / レビュー中 / 承認済み / 廃止。 - 読者層:上部に明記し(アーキテクト、運用担当者、ビジネス、監査人、ホモロゲーション委員会)、それに合わせて記述します。運用担当者にはコマンドとしきい値が必要であり、スポンサーには決定事項とリスクが必要です。
- トレーサビリティ:各設計要素、テストケース、および保留事項を、要件ID、ADR、チケット、またはRAIDアイテムにリンクします。成果物間で安定したIDを使用します。項目:
REQ-、ADR-(4桁、ADR-0001)、INT-(インターフェース)、FLW-(フロー)、JOB-、MON-(監視チェック)、KE-(既知のエラー)、RSK-、ASM-、ISS-、DEP-、TC-、DEF-、RES-(保留事項)、PRE-/GNG-/RB-(リリース前提条件、Go/No-Goチェックポイント、ロールバック手順)。文書:DAT-、DEX-、FLM-(フローマトリクス)、REL-(リリース)、PVR-(PV de recette)、RACI-、RAID-。 - 実際のデータは使用しない:架空のホスト名、文書化用IP範囲(RFC 5737)、シークレットのプレースホルダー、合成例、個人の連絡先詳細の代わりに一般的な役割名を使用します。
sector-complianceスキルの機密保持ルールを適用します。機密または拡散制限(Diffusion Restreinte)システムを説明する成果物は、ここではなく、保護された環境内で作成します。 - 機密ラベル:組織の文書機密ラベルをヘッダーに配置します(例:内部、機密)。本番セキュリティを説明する成果物(フローマトリクス、DATのセキュリティセクション)は、通常、少なくとも「機密」です。
- 正確性:日付はISO 8601(
2026-10-22)、時刻はタイムゾーン付き(21:30 Europe/Paris)、容量は単位と期間付き(120 000 msg/day, peak 40 msg/s)、期間は明示的(RTO 4 h)。 - 単一情報源:コピーするのではなく、他の成果物を参照します(DATはインターフェース契約書とフローマトリクスをリンクし、DEXはDATをリンクします)。
- 決定事項と証拠:誰がいつ何を決定したかを記録します。成果物は監査証拠です(DORA、ACPR、PCI DSS、HDS、ホモロゲーション)。
- 言語:英語の見出し。契約上または規制上の名称である場合(MEP、PV de recette、réserves)、フランス語の用語を括弧内に保持します。
- 各記入済み文書はレビュー可能な状態を保ちます:散文よりも表、1行に1つの事実、マーケティング用語は使用禁止。
テンプレートインデックス
templates/dat.md— 技術アーキテクチャ文書(DAT) — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dat.mdtemplates/dex.md— 運用マニュアル(DEX):ラン��ック、監視、バッチ、バックアップ、再起動、連絡先、エスカレーション — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dex.mdtemplates/release-sheet.md— 本番リリースシート(Fiche de mise en production、fiche MEP):タイムドランシート、所有者、Go/No-Go、ロールバック — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/release-sheet.mdtemplates/interface-contract.md— インターフェース契約書(Contrat d'interface):当事者、トリガー、トランスポート、フォーマット、マッピング、ボリューム、SLA、エラーとリプレイ、セキュリティ、監視、テスト — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/interface-contract.mdtemplates/flow-matrix.md— ネットワークフローマトリクス(Matrice des flux)、レビューチェックリスト付き — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/flow-matrix.mdtemplates/raci.md— RACIマトリクス(Matrice RACI) — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raci.mdtemplates/raid.md— RAIDログ(Registre des risques、hypothèses、problèmes et dépendances) — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raid.mdtemplates/uat-signoff.md— UAT承認書(Procès-verbal de recette):スコープ、キャンペーンサマリー、不具合、保留事項、決定、署名 — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/uat-signoff.mdtemplates/environment-sheet.md— 環境シート(Fiche d'environnement):組織の環境に関するドメインごとの事実、出典と未解決事項を含む。docs/tiger-team/environment.mdに保存 — フルパス${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/environment-sheet.md