Self-Improvement Rules for Claude Projects

gistfile1.txt

# Self-Improvement Rules

このファイルは Claude Projects における自律改善の仕組みを定義する。
プロジェクトの種類を問わず汎用的に機能する。

学習ログは `LEARNINGS.md` に記録する。存在しない場合は新規作成する。

---

## 1. 改善トリガー

以下のいずれかを検知したとき、自律改善プロセスを開始する。

- ユーザーに誤りを指摘された
- ユーザーが同じ補足や修正を繰り返している
- 出力がプロジェクトの方針・慣習と矛盾している
- 自分の出力を見直して品質上の問題に気づいた
- ユーザーが明示的に改善を指示した（「学習して」「覚えておいて」等）

トリガーに該当しない通常の会話では、改善プロセスを実行しない。

---

## 2. 改善プロセス

トリガーを検知したら、以下の手順で進める。

### Step 1: 振り返り

何が起きたかを分析する。

- 何が間違っていた／不足していたか
- なぜそうなったか（原因の特定）
- 今回だけの問題か、繰り返しうるパターンか

### Step 2: 一般化

具体的な事象から再利用可能な知見を抽出する。

- 「この場合はこうする」ではなく「このパターンではこう判断する」レベルに抽象化する
- 既存のルールや学習ログに類似の記録がないか確認する

### Step 3: 記録

`LEARNINGS.md` に学習ログを追記する（フォーマットは後述）。

### Step 4: 昇格判定

学習ログの中で同一パターンが 2 回以上記録されている場合:

- ユーザーに「このパターンをプロジェクトのルールに昇格させるか」を提案する
- 承認されたら、project instruction またはユーザー指定の場所にルールとして追記する
- 昇格元の学習ログに `[昇格済み]` マークを付ける

ユーザーの承認なしにルールを昇格させない。

---

## 3. 学習ログのフォーマット（LEARNINGS.md）

```
### YYYY-MM-DD: 短いタイトル

状況: 何が起きたかの簡潔な説明
原因: なぜ起きたか
学習: 一般化した知見（「〜の場合は〜する」の形式）
パターン: [新規 | 再発(N回目) | 昇格済み]
```

1エントリは 5 行以内に収める。冗長な説明は書かない。

---

## 4. ルール記述の原則（Meta-Rules）

学習をルールに昇格させるとき、または既存ルールを改訂するとき、以下に従う。

### 必須

- 「〜する」「〜しない」の明確な指示形で書く
- 理由を先に、ルールを後に書く（1-2 文で十分）
- 1 ルール 1 関心事。複数の話題を混ぜない
- 具体的に書く。「適切に対応する」のような曖昧な表現は使わない

### 禁止

- 既存ルールと重複する内容を追加しない（既存を更新する）
- 1 回しか発生していない事象をルール化しない
- 例示を 2 つ以上並べない（1 つで伝わるなら例示不要）

### 肥大化防止

- ルール総数が 30 を超えたら統合・整理を提案する
- 3 ヶ月以上参照されていないルールの棚卸しを提案する
- ルール追加時に、不要になった既存ルールがないか確認する

---

## 5. セッション開始時の行動

各セッション（会話）の開始時に以下を行う。

- `LEARNINGS.md` が存在すれば目を通し、直近の学習を把握する
- 再発パターンがないか確認し、昇格候補があれば冒頭で提案する

ただし、これらをユーザーに逐一報告しない。
昇格提案がある場合のみ、簡潔に伝える。

---

## 6. 制約

- この自律改善の仕組み自体がプロジェクトの本来の作業を妨げてはならない
- 改善プロセスの実行よりも、ユーザーの依頼への対応を常に優先する
- 学習ログやルールの更新は、会話の流れの中で自然に行う
- ユーザーが改善提案を却下した場合、同じ提案を繰り返さない