進捗トラッキング¶

git への類比¶

Adaptive Learner の進捗追跡は、git のコード管理に着想を得ています。

git の概念	Adaptive Learner の対応
コミット	完了したセッション（評価付き）
コミットメッセージ	`"Cycle 3 — U 85/100, S 20/100"`
ブランチ	使用中のメソッド
`git blame`	どのセッションがどのスキルに影響したか
タグ	メソッド切り替えのマイルストーン

これはメタファーです。実際に git を実行する必要はありません。ただし、データ構造は同じ規律に従っています。

ProgressCommit の構造¶

評価付きでセッションを終了するたびに、 ProgressCommit レコードが書き込まれます。

ProgressCommit(
    session_id="...",
    method="deductive",
    understanding=0.85,    # 1-5 スケールから再スケール
    stress=0.20,
    error_rate=0.00,       # 現在は常に 0.0
    duration_minutes=23,
    committed_at="2026-05-14T10:23:00Z"
)

このレコードは進捗チャートとダッシュボードに反映されます。

StepEvaluation¶

デュアルプロンプト評価器はすべての評価結果を記録します。

StepEvaluation(
    from_step=2,
    to_step=3,
    advance=False,      # AI の推奨
    confidence=0.45,    # 0.0-1.0
    applied=True,       # あなたが実際に適用したか
    fallback_used=False, # JSON 解析失敗時
    reason="...",       # AI の人間が読める説明
)

これにより、どのステップが最も時間を要したか、信頼度がどのように変化したかが追跡できます。

ゲーミフィケーション層¶

XP、バッジ、ストリークはトラッキングデータの上に構築されています。それ自体がデータではなく、データの表現です。

XP（経験値）の内訳：

アクション	XP
評価付きセッションの提出	50 XP
ステップ 7（統合）到達	+25 XP
メソッド切り替えの承認	10 XP
信頼度 > 80% の間隔反復カード	5 XP
Anki エクスポート	20 XP

レベルは平方根関数でスケールします： level = floor(sqrt(xp / 100))

初期のレベルは早く上がります（学習の初期の弾みを反映）。高いレベルはより長い時間が必要です。

プライバシーとデータ¶

すべてのトラッキングデータはローカルに保存されます。 - サーバーモード： FastAPI バックエンドの SQLite - ブラウザモード： ブラウザの IndexedDB（Dexie）

どちらのモードでも、データはあなたのデバイスを離れません。 AI 呼び出しを除いて（それはあなたが選んだプロバイダーにのみ送信されます）。

バックアップとエクスポートについては設定を参照してください。