majiayu000 PCE Structuring Skill
収集した知識を適切な構造で永続化し、後続プロセスで参照可能にする。
構造化の原則
- 適切な粒度: 1つの記録 = 1つの関心事
- 検索可能性: 後で見つけられるタグ/キーワード
- 文脈保持: なぜそうなったかの経緯
- 鮮度管理: 最終更新日と有効期限
出力先と形式
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
結果と影響
構造化ワークフロー
- 収集された知見を分類
- 出力先を決定（pce-memory / CLAUDE.md / ADR）
- 適切なフォーマットで記録
- 関連する既存知識との整合性確認
整理のタイミング
- セッション終了時
- マイルストーン完了時
- 知見が5件以上蓄積した時
- 明示的な整理依頼時
品質優先原則（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回以上）
- 観測不能な変更の増加（物差しで検証できない変更）
- ロールバック線の崩壊（戻せない変更の発生）