continuous-learning-v2

継続的ラーニング v2 - インスティンクトベースのアーキテクチャ

Claude Code のセッションを、アトミックな「インスティンクト」— 信頼度スコア付きの小さな学習済み振る舞い — を通じて再利用可能な知識に変える、高度な学習システムです。

v2 の新機能

機能	v1	v2
観察	Stop フック (セッション終了時)	PreToolUse/PostToolUse (100% 確実)
分析	メインコンテキスト	バックグラウンドエージェント (Haiku)
粒度	スキル全体	アトミックな「インスティンクト」
信頼度	なし	0.3～0.9 の重み付け
進化	スキルへ直接	インスティンクト → クラスター → スキル/コマンド/エージェント
共有	なし	インスティンクトのエクスポート/インポート

インスティンクトモデル

インスティンクトとは、小さな学習済みの振る舞いです。

---
id: prefer-functional-style
trigger: "when writing new functions"
confidence: 0.7
domain: "code-style"
source: "session-observation"
---

# Prefer Functional Style

## Action
Use functional patterns over classes when appropriate.

## Evidence
- Observed 5 instances of functional pattern preference
- User corrected class-based approach to functional on 2025-01-15

プロパティ:

• アトミック — 1 つのトリガー、1 つのアクション
• 信頼度で重み付け — 0.3 = 暫定的、0.9 = ほぼ確実
• ドメインタグ付き — code-style、testing、git、debugging、workflow など
• エビデンスに基づく — どの観察がそれを生み出したかを追跡

仕組み

Session Activity
      │
      │ Hooks capture prompts + tool use (100% reliable)
      ▼
┌─────────────────────────────────────────┐
│         observations.jsonl              │
│   (prompts, tool calls, outcomes)       │
└─────────────────────────────────────────┘
      │
      │ Observer agent reads (background, Haiku)
      ▼
┌─────────────────────────────────────────┐
│          PATTERN DETECTION              │
│   • User corrections → instinct         │
│   • Error resolutions → instinct        │
│   • Repeated workflows → instinct       │
└─────────────────────────────────────────┘
      │
      │ Creates/updates
      ▼
┌─────────────────────────────────────────┐
│         instincts/personal/             │
│   • prefer-functional.md (0.7)          │
│   • always-test-first.md (0.9)          │
│   • use-zod-validation.md (0.6)         │
└─────────────────────────────────────────┘
      │
      │ /evolve clusters
      ▼
┌─────────────────────────────────────────┐
│              evolved/                   │
│   • commands/new-feature.md             │
│   • skills/testing-workflow.md          │
│   • agents/refactor-specialist.md       │
└─────────────────────────────────────────┘

クイックスタート

1. 観察フックを有効にする

~/.claude/settings.json に追加します:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh pre"
      }]
    }],
    "PostToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh post"
      }]
    }]
  }
}

2. ディレクトリ構造を初期化する

mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands}}
touch ~/.claude/homunculus/observations.jsonl

3. オブザーバーエージェントを実行する (任意)

オブザーバーはバックグラウンドで観察を分析して実行できます:

# Start background observer
~/.claude/skills/continuous-learning-v2/agents/start-observer.sh

コマンド

コマンド	説明
/instinct-status	学習したすべてのインスティンクトを信頼度とともに表示します
/evolve	関連するインスティンクトをスキル/コマンドにクラスター化します
/instinct-export	共有用にインスティンクトをエクスポートします
/instinct-import <file>	他の人からインスティンクトをインポートします

設定

config.json を編集します:

{
  "version": "2.0",
  "observation": {
    "enabled": true,
    "store_path": "~/.claude/homunculus/observations.jsonl",
    "max_file_size_mb": 10,
    "archive_after_days": 7
  },
  "instincts": {
    "personal_path": "~/.claude/homunculus/instincts/personal/",
    "inherited_path": "~/.claude/homunculus/instincts/inherited/",
    "min_confidence": 0.3,
    "auto_approve_threshold": 0.7,
    "confidence_decay_rate": 0.05
  },
  "observer": {
    "enabled": true,
    "model": "haiku",
    "run_interval_minutes": 5,
    "patterns_to_detect": [
      "user_corrections",
      "error_resolutions",
      "repeated_workflows",
      "tool_preferences"
    ]
  },
  "evolution": {
    "cluster_threshold": 3,
    "evolved_path": "~/.claude/homunculus/evolved/"
  }
}

ファイル構造

~/.claude/homunculus/
├── identity.json           # Your profile, technical level
├── observations.jsonl      # Current session observations
├── observations.archive/   # Processed observations
├── instincts/
│   ├── personal/           # Auto-learned instincts
│   └── inherited/          # Imported from others
└── evolved/
    ├── agents/             # Generated specialist agents
    ├── skills/             # Generated skills
    └── commands/           # Generated commands

Skill Creator との統合

Skill Creator GitHub App を使用すると、今では両方を生成します:

• 従来の SKILL.md ファイル (後方互換性のため)
• インスティンクトコレクション (v2 学習システム用)

リポジトリ分析から得られたインスティンクトには source: "repo-analysis" が付与され、ソースリポジトリの URL が含まれます。

信頼度スコアリング

信頼度は時間とともに進化します:

スコア	意味	動作
0.3	暫定的	提案されるが強制はされない
0.5	中程度	関連する場合に適用される
0.7	強い	適用が自動承認される
0.9	ほぼ確実	中核となる振る舞い

信頼度が上がるのは:

• パターンが繰り返し観察されたとき
• ユーザーが提案された振る舞いを修正しないとき
• 他のソースからの類似したインスティンクトが一致するとき

信頼度が下がるのは:

• ユーザーが振る舞いを明示的に修正したとき
• パターンが長期間観察されないとき
• 矛盾するエビデンスが現れたとき

観察にフックとスキルのどちらを使うか?

「v1 は観察にスキルを頼っていました。スキルは確率的で、Claude の判断に基づいて約 50～80% の確率で発火します。」

フックは100% の確率で、決定的に発火します。つまり:

• すべてのツール呼び出しが観察される
• どのパターンも見逃されない
• 学習が包括的になる

後方互換性

v2 は v1 と完全に互換性があります:

• 既存の ~/.claude/skills/learned/ スキルは引き続き動作します
• Stop フックは引き続き実行されます (ただし、今は v2 にも取り込まれます)
• 段階的な移行パス: 両方を並行して実行する

プライバシー

• 観察はあなたのマシン上にローカルにとどまります
• エクスポートできるのはインスティンクト (パターン) のみです
• 実際のコードや会話の内容は共有されません
• 何をエクスポートするかはあなたが制御します

関連

• Skill Creator - リポジトリの履歴からインスティンクトを生成します
• Homunculus - v2 アーキテクチャの着想元
• The Longform Guide - 継続的ラーニングのセクション

---

インスティンクトベースの学習: 一度に 1 つの観察で、Claude にあなたのパターンを教えます。