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行1ルール
- 命令形(「Xを使用」、「常にY」、「決してZしない」)
- 概念だけでなく、コマンドや例を含める
- 背景説明は不要 — 指示のみ
ステップ5: ターゲットに書き込む
CLAUDE.mdの場合:
- 既存のCLAUDE.mdを読み込む
- 適切なセクションを見つける(または作成する)
- 該当する見出しの下に新しいルールを追加する
- ファイルが200行を超える場合は、代わりに
.claude/rules/を使用することを提案する
.claude/rules/ の場合:
- ファイルが存在しなければ作成する
- スコープがある場合はYAMLフロントマターに
pathsを追加する - ルールの内容を書き込む
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API開発ルール
- すべてのエンドポイントはZodスキーマで入力をバリデーションする
- エラーレスポンスには(生のErrorではなく)`ApiError` クラスを使用する
- ハンドラー関数にはOpenAPI JSDocコメントを含める
ステップ6: 自動メモリをクリーンアップする
昇格後、MEMORY.md内の元のエントリを削除またはマークします:
# 削除されるものを表示
grep -n "<パターン>" "$MEMORY_DIR/MEMORY.md"
ユーザーに削除の確認を求めます。その後、MEMORY.mdを編集して昇格したエントリを削除します。これにより、新しい学習内容のためのスペースが確保されます。
ステップ7: 確認
✅ {{ターゲット}} に昇格しました
ルール: "{{抽出されたルール}}"
ソース: MEMORY.md {{n}}行目(削除済み)
MEMORY.md: {{lines}}/200行 残り
このパターンは強制される指示になりました。Claudeは今後のすべてのセッションでこれに従います。
昇格判断ガイド
昇格すべき場合:
- パターンが自動メモリに3回以上出現した
- Claudeを同じことについて複数回訂正した
- すべてのコントリビューターが知るべきプロジェクト規約である
- 繰り返し発生するミスを防止する
昇格すべきでない場合:
- 一度きりのデバッグメモである(自動メモリに残す)
- セッション固有のコンテキストである(セッションメモリで対応)
- 近いうちに変更される可能性がある(移行期間中など)
- 既存のルールで既にカバーされている
CLAUDE.md vs .claude/rules/
| CLAUDE.mdを使用する場合 | .claude/rules/を使用する場合 |
|---|---|
| プロジェクト全体のルール | ファイルタイプ固有のパターン |
| ビルドコマンド | テスト規約 |
| アーキテクチャ上の決定 | API設計ルール |
| チーム規約 | フレームワーク固有の落とし穴 |
ヒント
- CLAUDE.mdは200行未満に保つ — あふれた分はrules/を使用する
- 1行1ルールの方が段落よりも管理が容易
- 概念だけでなく、具体的なコマンドを含める
- 昇格したルールは四半期ごとに見直す — 不要になったものは削除する