--- name: eld-record-knowledge-transfer description: | PCE (Process-Context Engine) の知識移転スキル。セッション/メンバー間での知識の連続性を確保し、引き継ぎを円滑にする。 トリガー条件: - 「引き継ぎ資料を作って」 - 「次の人に渡す情報をまとめて」 - 新メンバーのオンボーディング時 - 長期プロジェクトの節目 - 「プロジェクトの状況を共有して」 --- # PCE Knowledge Transfer Skill セッション/メンバー間での知識の連続性を確保する。 ## 移転対象の知識 ### 1. 明示的知識(Explicit) - ドキュメント化された設計判断 - ADR(アーキテクチャ決定記録) - コーディング規約 - API仕様 ### 2. 暗黙的知識(Tacit) - 「なぜそうしたか」の経緯 - 試行錯誤の過程 - 却下した選択肢と理由 - 既知の問題と回避策 ### 3. コンテキスト知識 - プロジェクトの背景 - ステークホルダーの期待 - 技術的制約の由来 - チームの慣習 ## 引き継ぎドキュメント構造 ```markdown # Knowledge Transfer: [プロジェクト/機能名] ## 1. 現状サマリー ### 完了したこと - [成果1] - [成果2] ### 進行中のこと - [タスク1]: [進捗%] [次のアクション] ### 未着手だが予定 - [タスク2]: [優先度] [依存関係] ## 2. 重要な決定事項 | 決定 | 理由 | 日付 | 参照 | |------|------|------|------| | [決定1] | [理由] | YYYY-MM-DD | ADR-XXX | ## 3. 既知の問題と注意点 ### 技術的課題 - [課題1]: [回避策] ### プロセス上の注意 - [注意点1] ## 4. キーファイル・リソース | ファイル | 役割 | 備考 | |---------|------|------| | [ファイル1] | [役割] | [備考] | ## 5. 連絡先・エスカレーション - [担当者/チーム]: [連絡先] ## 6. 次のアクション 1. [ ] [最優先タスク] 2. [ ] [次のタスク] ``` ## 移転のタイミング | シーン | 実施内容 | |--------|---------| | セッション終了 | pce-compact でノート作成 | | 担当者交代 | フル引き継ぎドキュメント | | 新メンバー参加 | オンボーディング資料 | | マイルストーン | 進捗サマリー | | プロジェクト完了 | 振り返りと学びの記録 | ## 使用例 ``` User: 認証機能の引き継ぎ資料を作って Claude: # Knowledge Transfer: 認証機能 ## 1. 現状サマリー ### 完了したこと - JWT認証基盤実装 - ログイン/ログアウトAPI - 単体テスト (82%カバレッジ) ### 進行中 - トークンリフレッシュ: 60% [次: エラーハンドリング] ### 未着手 - E2Eテスト: High [リフレッシュ完了後] ## 2. 重要な決定事項 | 決定 | 理由 | 参照 | |------|------|------| | JWT採用 | ステートレス要件 | ADR-003 | | httpOnly Cookie | XSS対策 | セキュリティレビュー | | リフレッシュ7日 | UXとセキュリティのバランス | チーム合意 | ## 3. 既知の問題 - トークン失効時のフロントエンド挙動未定義 → フロントチームと要調整 ## 4. キーファイル | ファイル | 役割 | |---------|------| | src/auth/jwt.service.ts | トークン生成・検証 | | src/auth/auth.controller.ts | エンドポイント | | docs/adr/ADR-003.md | 認証方式決定 | ## 5. 次のアクション 1. [ ] リフレッシュのエラーハンドリング完了 2. [ ] フロントチームと失効時挙動を合意 3. [ ] E2Eテスト作成 → pce-memoryに保存完了 ``` --- ## 品質優先原則(Superpowers統合) ### 核心原則 1. **Epistemic Humility**: 推測を事実として扱わない。`unknown`と言う勇気を持つ 2. **Evidence First**: 結論ではなく因果と証拠を中心にする 3. **Minimal Change**: 最小単位で変更し、即時検証する 4. **Grounded Laws**: Lawは検証可能・観測可能でなければならない 5. **Source of Truth**: 真実は常に現在のコード。要約はインデックス ### 「速さより質」の実践 - 要件の曖昧さによる手戻りを根本から排除 - テストなし実装を許さない - 観測不能な変更を防ぐ ### 完了の定義 - [ ] Evidence Ladder目標レベル達成 - [ ] Issue Contractの物差し満足 - [ ] Law/Termが接地している(Grounding Map確認) - [ ] Link Mapに孤立がない - [ ] ロールバック可能な状態 ### 停止条件 以下が発生したら即座に停止し、追加計測またはスコープ縮小: - 予測と現実の継続的乖離(想定外テスト失敗3回以上) - 観測不能な変更の増加(物差しで検証できない変更) - ロールバック線の崩壊(戻せない変更の発生)