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 でノート作成 |
| 担当者交代 | フル引き継ぎドキュメント |
| 新メンバー参加 | オンボーディング資料 |
| マイルストーン | 進捗サマリー |
| プロジェクト完了 | 振り返りと学びの記録 |
使用例
code
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統合)
核心原則
- •Epistemic Humility: 推測を事実として扱わない。
unknownと言う勇気を持つ - •Evidence First: 結論ではなく因果と証拠を中心にする
- •Minimal Change: 最小単位で変更し、即時検証する
- •Grounded Laws: Lawは検証可能・観測可能でなければならない
- •Source of Truth: 真実は常に現在のコード。要約はインデックス
「速さより質」の実践
- •要件の曖昧さによる手戻りを根本から排除
- •テストなし実装を許さない
- •観測不能な変更を防ぐ
完了の定義
- • Evidence Ladder目標レベル達成
- • Issue Contractの物差し満足
- • Law/Termが接地している(Grounding Map確認)
- • Link Mapに孤立がない
- • ロールバック可能な状態
停止条件
以下が発生したら即座に停止し、追加計測またはスコープ縮小:
- •予測と現実の継続的乖離(想定外テスト失敗3回以上)
- •観測不能な変更の増加(物差しで検証できない変更)
- •ロールバック線の崩壊(戻せない変更の発生)