PCE Collection Skill
Context Deltaを収集し、潜在的コンテキストプールを拡充する。
収集対象
1. 意思決定の痕跡
yaml
decision: what: 何を決定したか why: なぜその選択をしたか alternatives: 検討した他の選択肢 rejected_reasons: 却下した理由 constraints: 効いた制約条件 trade_offs: 受け入れたトレードオフ
2. エラー解決策
yaml
error_resolution: symptom: 症状・エラーメッセージ root_cause: 根本原因 solution: 解決策 prevention: 再発防止策 related_files: 関連ファイル
3. パターン発見
yaml
pattern: name: パターン名 context: 適用コンテキスト problem: 解決する問題 solution: 解決方法 consequences: 結果と影響 examples: 実例
収集プロセス
- •観察: 作業中の重要な判断・発見を特定
- •抽出: 上記フォーマットで構造化
- •検証: 記録内容の正確性を確認
- •保存: pce-memoryまたは適切な場所に記録
出力先の選択
| 知見の種類 | 出力先 |
|---|---|
| 即時参照が必要 | pce-memory (upsert) |
| アーキテクチャ決定 | docs/adr/ |
| プロジェクト共通 | ルートCLAUDE.md |
| ドメイン固有 | 該当フォルダのCLAUDE.md |
使用例
code
User: このAPIエンドポイントの設計判断を記録して Claude: 収集した意思決定: - what: REST APIではなくGraphQLを採用 - why: クライアント側でのデータ取得柔軟性 - alternatives: REST, gRPC - rejected_reasons: RESTは過剰取得問題、gRPCはWeb対応コスト - constraints: フロントエンドチームのGraphQL経験 - trade_offs: 学習コストを許容 → 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回以上）
- •観測不能な変更の増加（物差しで検証できない変更）
- •ロールバック線の崩壊（戻せない変更の発生）