customer-workspace

顧客ワークスペース

セットアップ用の生成物と実際の記録を混同せずに、顧客ワークスペースをセットアップまたは運用します。

使用する場面

• 顧客ごとのワークスペースを作成するとき。
• 既存のワークスペースを運用するとき：受信箱の更新、会議メモ、質問、アクション、ワークストリーム、引き継ぎなど。
• 顧客情報の振り分けや会議メモのワークフローを追加するとき。
• 引き継ぎの前に、現在の担当者、次のアクション、元となる記録を確認するとき。

最初にモードを選択する

アクションを選ぶ前に、ワークスペースを確認します。.github/copilot-instructions.md、.github/prompts/、workspace-summary.md、_customer/profile.md、_inbox/、workstreams/などの管理対象レコードがある場合は、既存のワークスペースとして扱います。 集約運用ワークスペースには、簡易的な Customers/{id}/ プロファイル、タスクリスト、受信箱、会議記録が含まれていることがあります。それらの記録がある場所に、顧客ワークスペース全体を初期化しないでください。専用の顧客管理が必要な場合は、別の配置先を確認してください。

モード	使用する場面	最初のアクション
セットアップ	管理対象の構造が存在しない	ひな形を作成し、振り分けに必要な情報を記録します。
運用	管理対象のワークスペースに新しい情報が届いた	入力内容に対応する正規レコードを更新します。
レビュー／引き継ぎ	ステータス、担当者、継続性が確認された場合	最初に現在のインデックスを読み、情報源、担当者、次のアクションを報告します。

• 生成されたアセットの上書きが明示的に依頼されていない限り、既存のワークスペースで初期化処理を再実行したり、-Forceを使用したりしないでください。
• 既存のレコードを正とします。明示的に依頼された不足アセットのみを追加し、実際に使用されているメモ、タスク、ワークストリームのレコードをテンプレートで置き換えないでください。

---

新しいワークスペースをセットアップする

# Basic
.\scripts\Initialize-CustomerWorkspace.ps1 -CustomerName "Contoso Inc"

# Full options
.\scripts\Initialize-CustomerWorkspace.ps1 `
  -CustomerName "Contoso Inc" `
  -ContractType "Ongoing support" `
  -ContractPeriod "2025/04 - 2028/03" `
  -KeyContacts "John Doe (Infra Lead)"

PowerShellを使用できない場合は、同じフォルダーを手動で作成し、assets/から必要なプロンプトファイルとテンプレートファイルのみをコピーします。

管理対象の構造が存在しない場合にのみセットアップを行います。初期化処理は、管理対象アセットが存在する場合、デフォルトで停止します。生成されたプロンプトとテンプレートの置き換えが明示的に承認されている場合にのみ、-Forceを使用してください。

セットアップ時の聞き取り

振り分けに必要な情報のみを収集します。対象ワークスペースの範囲、共有の境界、自チームの別名、主要な役割、会議の頻度、主な入力情報を記録します。詳細な技術情報の一覧は、後の受信箱や会議記録に記載します。

正規レコード

必要なもの	正規レコード
ナビゲーションと引き継ぎ	README.md、workspace-summary.md
未加工の更新情報と未解決の質問	_inbox/、_questions/
顧客のコンテキスト	_customer/profile.md
会議とフォローアップ	meeting-notes/、next-actions/
継続的な範囲と詳細な履歴	workstreams/、pj_{topic}/
成果物と再利用可能な知見	research-reports/、_knowledge/

Initialize-CustomerWorkspace.ps1は、管理対象のひな形とテンプレートを作成します。ワークストリームのフォルダー、会議メモ、次のアクション、プロジェクトスレッド、資料フォルダーは、運用ワークフローで必要になった場合にのみ作成してください。 複数顧客にまたがる活動レポートとグローバルなタスクインデックスは、それらを管理する運用ワークスペースに置きます。必要に応じてリンクし、顧客レコードにコピーしないでください。

調査レポート

生成したMarkdown成果物にはresearch-reports/を使用し、ワークスペースのルートはエントリーファイルと管理用ファイルのために使用します。配置とサニタイズの詳細なルールは、ナレッジ台帳のルールを参照してください。

ナレッジ台帳

ユーザーが抽出または一般化を明示的に依頼した場合に限り、簡潔で再利用可能な学びを_knowledge/に保存します。書き込む前にナレッジ台帳のルールを適用してください。

任意の資料フォルダー

変更不可の原本、内部編集用、共有可能なコピーを分けます。ユーザーが別の保存先を指定しない限り、_received/、_working/、_provided/を使用してください。要約を根拠にする前に、アクセス可能な原本を取り込んでください。名前を変更しても匿名化にはなりません。制限対象のソースコンテンツは、非表示のスライドやノートも含め、共有先のファイルに含めないでください。ファイルを移動または改名する前に顧客資料のライフサイクルを適用してください。

---

既存のワークスペースを運用する

入力または依頼	対応
短いチャット、メール、または形式化されていない更新	_inbox/に保存し、分類します。
会議メモまたはTeams AIの記録	1つの会議メモを作成または更新し、同じ処理で質問やアクションを抽出します。
確認済みの1つのワークストリームに関する明確な更新	ソースへのリンクと状況の変化を記載して、そのREADMEを更新します。
新規、曖昧、または複数のワークストリームに関する入力	workstreams/_candidates.mdに記録し、確認を求めます。
期限のあるフォローアップ	next-actions/で追跡します。次回会議の日付が分からない場合に限り、ongoing/を使用します。
状況確認または引き継ぎ	報告する前に、workspace-summary.md、ポートフォリオ、進行中のアクション、未解決の質問を確認します。

ソース記録を正本として扱います。要約やワークストリームからは、会議メモや受信トレイの記録にリンクし、内容を重複させないでください。

作業を追跡する

• ワークストリームのREADMEには、現在の状況、担当者、アクション、タイムラインを記載します。ポートフォリオはそのインデックスです。名称と範囲が確認されてから、ワークストリームを作成してください。
• 顧客のフォローアップが既存の質問または回答済みの内容に関するものである場合は、元のやり取りが確認できる状態を保ち、該当する成果物またはスレッドに時系列順でフォローアップを追記します。後から得られた根拠によって既存の要確認が解決した場合は、別のソース記録を作成するのではなく、該当する項目に解決内容と根拠を追記します。月単位の_questions台帳では、前月分を書き換えず、元の項目を参照して当月分に追記します。
• 顧客と合意した宿題、自発的な提案、補足調査は、それぞれ別のnext-actions/フォルダーに保存します。タスクのヘッダーから会議ソースにリンクします。一方、顧客と共有する会議テーブルにはローカルのタスクパスを含めないでください。
• 使用できるステータスはcandidate、not-started、in-progress、blocked、done、droppedのみです。not-startedまたはdoneを割り当てる前に、タスクにリンクされた外部作業場所を確認してください。ワークスペースに存在しないことだけでは、成果物がないとは判断できません。外部での進捗と成果物によって完了が確認できた場合は、正本となるアクション記録とインデックスを同じ処理で更新します。資料のライフサイクルで必要とされない限り、外部の成果物をコピーしないでください。blockedの記録には、現在の担当者と、ステータスが変わる条件を記載します。
• トピックが複数の会議にまたがり、プロジェクトスレッドを分割する詳細条件を満たす場合に限り、pj_{topic}/を作成します。

Meeting Notes Quality Gate

Before calling meeting notes done:

• Mark uncertain names, times, product names, prices, and support boundaries as 要確認; record the available transcript range and keep uncorroborated AI follow-ups provisional rather than assigning confirmed owners, deadlines, or deliverables.
• Omit credentials and token-bearing image URLs from saved source text. After saving, ask for a Teams meeting/recap/recording URL if absent; record supplied links without asking again, and distinguish link capture from full-content verification.
• Extract open questions and work needing follow-up into _questions/{YYYY-MM}.md and next-actions/ in the same operation.
• Keep local paths, internal links, internal speculation, and commercial terms out of customer-shareable content.
• Default to one working meeting note. Do not create *_internal.md solely for unverified technical details; separate only on explicit request or when sensitive material cannot remain in a clearly marked internal section.
• Customer highlights contain only confirmed items and split cross-side coordination into one 双方 (両者で調整) bucket. Apply Meeting Minutes Rules for details.

---

Done Criteria

• Setup: the managed scaffold exists and routing facts are captured.
• Operate: the canonical record, related question/action ledger, and relevant index reflect the input without duplicate source content.
• Review / Handoff: the report identifies authoritative sources, current owner, next action, and unresolved questions.

Key References

• Inbox Rules
• Meeting Minutes Rules
• Workspace Summary Rules
• Workstream Portfolio Rules
• Knowledge Ledger Rules
• Customer Material Lifecycle
• Project Thread Rules

Assets

Note: assets/ 配下の prompt / instruction / template は、新しい顧客ワークスペースを初期化するときの コピー元 として使う scaffolding 用ファイル。ホスト workspace の .github/prompts/ や .github/copilot-instructions.md とは独立に進化させてよい（同期は必須ではない）。ホスト側で機能追加した場合に scaffolding にも反映したいときは、明示的にこのフォルダへ back-port する。

• assets/_templates/: next-actions, knowledge ledger, attachments, and workspace templates
• assets/*.prompt.md: inbox, meeting-note conversion, and question extraction prompts. Prompt files load only in the VS Code Local agent (not Agent Host sessions), so the routing rules in copilot-instructions.md must work without them.
• assets/copilot-instructions.md: generated workspace auto-routing rules
• scripts/Test-ReceivedMaterialPlacement.ps1 - Read-only root audit for unclassified received-material candidates