PCE Knowledge Transfer Skill

PCE Knowledge Transfer Skill

セッション/メンバー間での知識の連続性を確保する。

移転対象の知識

1. 明示的知識（Explicit）

• ドキュメント化された設計判断
• ADR（アーキテクチャ決定記録）
• コーディング規約
• API仕様

2. 暗黙的知識（Tacit）

• 「なぜそうしたか」の経緯
• 試行錯誤の過程
• 却下した選択肢と理由
• 既知の問題と回避策

3. コンテキスト知識

• プロジェクトの背景
• ステークホルダーの期待
• 技術的制約の由来
• チームの慣習

引き継ぎドキュメント構造

# Knowledge Transfer: [プロジェクト/機能名]

## 1. 現状サマリー
### 完了したこと
- [成果1]
- [成果2]

### 進行中のこと
- [タスク1]: [進捗%] [次のアクション]

### 未着手だが予定
- [タスク2]: [優先度] [依存関係]

## 2. 重要な決定事項
| 決定 | 理由 | 日付 | 参照 |
|------|------|------|------|
| [決定1] | [理由] | YYYY-MM-DD | ADR-XXX |

## 3. 既知の問題と注意点
### 技術的課題
- [課題1]: [回避策]

### プロセス上の注意
- [注意点1]

## 4. キーファイル・リソース
| ファイル | 役割 | 備考 |
|---------|------|------|
| [ファイル1] | [役割] | [備考] |

## 5. 連絡先・エスカレーション
- [担当者/チーム]: [連絡先]

## 6. 次のアクション
1. [ ] [最優先タスク]
2. [ ] [次のタスク]

移転のタイミング

使用例

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回以上）
• 観測不能な変更の増加（物差しで検証できない変更）
• ロールバック線の崩壊（戻せない変更の発生）