PCE Structuring Skill

収集した知識を適切な構造で永続化し、後続プロセスで参照可能にする。

構造化の原則

1. 適切な粒度: 1つの記録 = 1つの関心事
2. 検索可能性: 後で見つけられるタグ/キーワード
3. 文脈保持: なぜそうなったかの経緯
4. 鮮度管理: 最終更新日と有効期限

出力先と形式

1. pce-memory (即時参照用)

pce_memory_upsert:
  category: pattern | decision | error | rule
  content: 構造化された知識
  tags: [検索用タグ]

2. CLAUDE.md (プロジェクト指針)

ルートCLAUDE.md - 一般化された原則

## 設計原則
- 原則1: 理由と適用範囲

## コーディング規約
- ...

フォルダCLAUDE.md - ドメイン固有

## このモジュールの責務
- ...

3. ADR (アーキテクチャ決定記録)

# ADR-XXX: タイトル

## Status
Accepted | Deprecated | Superseded by ADR-YYY

## Context
決定が必要になった背景

## Decision
決定内容

## Consequences
結果と影響

構造化ワークフロー

1. 収集された知見を分類
2. 出力先を決定（pce-memory / CLAUDE.md / ADR）
3. 適切なフォーマットで記録
4. 関連する既存知識との整合性確認

整理のタイミング

• セッション終了時
• マイルストーン完了時
• 知見が5件以上蓄積した時
• 明示的な整理依頼時

---

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