/si:promote — 学習をルールに昇格する
Claudeの自動記憶から確立されたパターンをプロジェクトのルールシステムに移行し、背景メモではなく強制される指示にします。
使用方法
/si:promote <パターン説明> # 最適なターゲットを自動検出
/si:promote <パターン> --target claude.md # CLAUDE.mdに昇格
/si:promote <パターン> --target rules/testing.md # スコープルールに昇格
/si:promote <パターン> --target rules/api.md --paths "src/api/**/*.ts" # パス指定ありスコープ
ワークフロー
ステップ1: パターンを理解する
ユーザーの説明を解析します。曖昧な場合は、確認の質問を1つ行います:
- 「Claudeが従うべき具体的な振る舞いは何ですか?」
- 「これはすべてのファイルに適用されますか、それとも特定のパスに適用されますか?」
ステップ2: 自動記憶内のパターンを見つける
# MEMORY.mdから関連エントリを検索
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<キーワード>" "$MEMORY_DIR/MEMORY.md"
マッチしたエントリを表示し、ユーザーの意図と一致するか確認します。
ステップ3: 適切なターゲットを決定する
| パターンのスコープ | ターゲット | 例 |
|---|---|---|
| プロジェクト全体に適用 | ./CLAUDE.md | "pnpmを使用し、npmは使用しない" |
| 特定のファイルタイプに適用 | .claude/rules/<トピック>.md | "APIハンドラにはバリデーションが必要" |
| すべてのプロジェクトに適用 | ~/.claude/CLAUDE.md | "明示的なエラーハンドリングを優先する" |
ユーザーがターゲットを指定していない場合は、スコープに基づいて推奨します。
ステップ4: 簡潔なルールに蒸留する
自動記憶のメモ形式から、CLAUDE.mdの命令形式に学習内容を変換します。
変換前 (MEMORY.md — 説明的):
このプロジェクトはpnpmワークスペースを使用しています。npm installを試みると失敗しました。ロックファイルはpnpm-lock.yamlです。依存関係にはpnpm installを使用する必要があります。
変換後 (CLAUDE.md — 指示的):
## ビルドと依存関係
- パッケージマネージャー: pnpm(npmではない)。`pnpm install`を使用します。
蒸留のルール:
- 可能な限りルールは1行で記述
- 命令形で記述("Xを使用する"、"常にYする"、"決してZしない")
- 概念だけでなく、コマンドまたは例を含める
- 背景情報は不要 — 指示のみ
ステップ5: ターゲットに書き込む
CLAUDE.mdの場合:
- 既存のCLAUDE.mdを読み込む
- 適切なセクションを見つける(または作成する)
- 新しいルールを適切な見出しの下に追加する
- ファイルが200行を超える場合は、代わりに
.claude/rules/の使用を提案する
.claude/rules/の場合:
- ファイルが存在しなければ作成する
- スコープがある場合はYAMLフロントマターに
pathsを追加する - ルールの内容を記述する
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API開発ルール
- すべてのエンドポイントはZodスキーマで入力をバリデーションする
- エラーレスポンスには`ApiError`クラスを使用する(生のErrorは使用しない)
- ハンドラ関数にはOpenAPI JSDocコメントを含める
ステップ6: 自動記憶をクリーンアップする
昇格後、MEMORY.md内の元のエントリを削除またはマークします:
# 削除される内容を表示
grep -n "<パターン>" "$MEMORY_DIR/MEMORY.md"
ユーザーに削除の確認を求めます。その後、MEMORY.mdを編集して昇格したエントリを削除します。これにより、新しい学習のための容量が確保されます。
ステップ7: 確認
✅ {{ターゲット}}に昇格しました
ルール: "{{蒸留されたルール}}"
ソース: MEMORY.md {{n}}行目(削除済み)
MEMORY.md: {{行数}}/200行 残り
パターンは強制指示になりました。Claudeは今後すべてのセッションでこれに従います。
昇格判断ガイド
昇格すべき場合:
- 自動記憶に同じパターンが3回以上出現した
- それについてClaudeを2回以上修正した
- プロジェクトの規約であり、すべてのコントリビューターが知るべき内容
- 繰り返し発生するミスを防ぐことができる
昇格すべきでない場合:
- 1回限りのデバッグメモ(自動記憶に残す)
- セッション固有のコンテキスト(セッション記憶で処理)
- 近いうちに変更される可能性がある(例:移行中)
- 既存のルールでカバーされている
CLAUDE.md vs .claude/rules/
| CLAUDE.mdを使用する場合 | .claude/rules/を使用する場合 |
|---|---|
| プロジェクト全体のルール | ファイルタイプ固有のパターン |
| ビルドコマンド | テストの規約 |
| アーキテクチャの決定 | API設計ルール |
| チームの規約 | フレームワーク固有の注意点 |
ヒント
- CLAUDE.mdは200行未満に保つ — 溢れたらrules/を使用する
- ルールは1行ずつ記述するとメンテナンスが容易
- 概念だけでなく、具体的なコマンドを含める
- 昇格したルールは四半期ごとに見直し、不要になったものは削除する