evolve

Evolve (coach)

Hard rules

• 1回の自動適用で最大1件
• 高リスク変更は人間の承認なしに適用しない
• improvements.md の過去エントリを編集・削除しない（append-only）
• soul.md, CLAUDE.md, settings.local.json は自動適用しない
• 秘密情報をログに書かない
• Step 4 (Verified 検証) skip 禁止。proposed が 0 件でも applied entry の再発スキャン必須。時間圧迫 / context 圧迫を理由に省略しない。skip した場合は reflection に明示記録

実行手順

1. 提案スキャン

docs/memory/heartbeat/improvements.md を読み、Status: proposed の項目を抽出する。

• proposed が0件 → ステップ4（検証）へスキップ

2. リスク分類と適用判定

リスク分類基準 に基づき、各提案の Risk-level を確認する。

Risk-level が未記入（旧フォーマット）の場合は、Fix の内容から判定する。

3a. 低リスク自動適用

Risk-level: low の proposed が存在する場合、最も古い1件 を自動適用する:

1. Fix の内容に基づき、対象ファイルを変更する
2. improvements.md の該当項目の Status を proposed → applied に更新
3. docs/memory/heartbeat/decisions.md に追記:

   ## YYYY-MM-DD -- 自動適用: {proposal title}
   - 対象: {改修対象ファイル / 行 / セクション}
   - 内容: {変更内容の要約}
   - Expected impact: {improvements.md から転記}
   - Why: {failure-patterns.md の該当パターン ID + reflection リンク、50-65 字以内}
   - Rollback: {improvements.md から転記}
   

   Why セクションは reflection リンクのみで短縮、長文 Why は禁止。台帳の重複記述を避けるため、本 entry ではファイルパス参照のみとする。
4. 出力: EVOLVE: auto-applied "{title}" (low-risk)

3b. 中・高リスク人間キュー

Risk-level: medium または high の proposed が存在する場合、一覧を表示してユーザーに判断を求める:

• medium: 既存ファイル変更を含む追記、SKILL.md 等の動作変更、Hard rules 文言の調整等。人間承認後に applied 化、変更内容次第で部分適用可
• high: コード変更、settings.json、soul.md/CLAUDE.md/identity.md、Hard rules 削除・新規鉄則追加、新ファイル作成等。人間承認必須

Risk-level 単一値ルール: 1 entry 内に複数の Fix (改修 1 / 改修 2 / 改修 3) が異なる severity を持つ場合 (例: 改修 1 LOW + 改修 2 MEDIUM)、entry 単位の Risk-level フィールドは 最高 severity (= 最も保守的) を採用する。これにより mixed severity entry は人間キュー (本セクション 3b) に入り、ユーザーが改修ごとに個別承認できる。entry 全体の自動適用回避で安全側に倒す設計。

• 採用: diff 案を提示 → ユーザー承認後に適用 → improvements.md を applied に → decisions.md に記録
• 却下: improvements.md の Status を rejected -- {理由} に更新
• 保留: 変更なし

出力フォーマット (視認性確保)

ANSI 色エスケープは Claude のテキスト応答 (CommonMark レンダリング) では無効化されるため、絵文字 + 罫線 + markdown 強調 で視覚分離する。判断要求セクションは必ず以下フォーマットで出力する。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🟡 **ユーザー判断要求** ({MEDIUM | HIGH} proposal × N 件)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

### {改修 N} ({severity 絵文字 + ラベル})

- **対象**: {改修対象ファイル / 行 / セクション}
- **変更内容**: {具体的な diff 概要}
- **想定影響**: {Rubric / 機能影響}
- 💡 **私の推奨**: ✅ 採用 / ❌ 却下 / ⏸ 保留 — {理由 1 文}

→ 採用 / 却下 / 保留 を指示してください。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

絵文字凡例:

用途	絵文字	意味
Severity	🔴 HIGH	コード変更 / soul.md / CLAUDE.md / settings.json / 新規鉄則
Severity	🟡 MEDIUM	SKILL.md 動作変更 / 既存ファイル追記 / Hard rules 調整
Severity	🟢 LOW	本セクション該当なし (自動適用済、参考表示のみ)
推奨	✅ 採用推奨	改修案を採用すべき
推奨	❌ 却下推奨	改修案は不要 / 不適切
推奨	⏸ 保留推奨	追加情報待ち / 後日再検討
Field	💡 私の推奨	推奨併記必須、判断丸投げ禁止

Why: ANSI 色は CommonMark でリテラル化するため絵文字に倒す。罫線 (━) はヘッダ階層を超えた視覚分離として機能。

4. Verified 検証

Status: applied のエントリを確認する。

各エントリについて:

1. docs/memory/reflection/ の直近3セッション分の振り返りを読む
2. そのエントリの Symptom と同種の摩擦が再発していなければ: → Status: applied を Status: verified -- YYYY-MM-DD に更新 → decisions.md に verified: {title} を記録
3. 再発している場合: → failure-patterns.md に記録し、新しい改善提案を生成
4. 意味ないルール削除提案権限: applied / verified entry が 3 サイクル以上「効いている証拠なし」(再発も予防効果も観察されない、Status 更新後の reflection で言及ゼロ) の場合、削除提案を improvements.md に新規 entry として起票推奨。Hard rule (過去 entry 編集禁止) は触らず、新 entry で「該当 failure pattern 削除 / SKILL.md 該当行削除」を MEDIUM proposed として人間キュー化。意味ないルールは積極削除でリポ肥大化予防

5. サイクル健全性チェック

docs/memory/heartbeat/rubric-log.md の直近5セッションのスコア推移を確認する。

下降トレンド検出: 直近3回のスコアが連続で前回以下の場合 → docs/memory/heartbeat/cycle-health.md にアラート記録 → 出力に EVOLVE_ALERT を含める

適用後の悪化検出: 改善を applied にした直後のセッションでスコアが2点以上低下した場合 → ロールバックプロトコル に従い対処を提案 → cycle-health.md にロールバック候補を記録

6. 出力

• 自動適用した場合:

  EVOLVE: auto-applied "{title}" (low-risk)
  

• 手動レビュー実施:

  EVOLVE: reviewed N proposals (adopted: N, rejected: N, deferred: N)
  

• 検証のみ:

  EVOLVE: verified N improvements
  

• サイクル異常検出:

  EVOLVE_ALERT: rubric trend declining (N/10 → N/10 → N/10). Review recent changes.
  

• 何もなし:

  EVOLVE_OK
  

archive 運用 (任意)

docs/memory/heartbeat/ 配下のログファイルが肥大化した場合の archive 切り出しは 手動運用 を推奨。evolve skill は archive ディレクトリ (docs/memory/_archive/ 等) を参照しない設計。旧履歴を確認する場合は手動で archive を grep する。

improvements.md から applied entry を削除する自動化は本 SKILL に 追加しない。Hard rule (上記「improvements.md の過去エントリを編集・削除しない」) との衝突を避けるため。

禁止事項

• 1回の実行で2件以上の自動適用
• 高リスク改善の無断適用
• improvements.md / decisions.md の過去エントリ削除
• soul.md, CLAUDE.md, identity.md, settings.local.json の自動変更
• archive ディレクトリへの自動書き込み (手動運用のみ)