> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kanaeru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 学習ループ

> 振り返りがどのように学びになり、誰がそれを承認し、どのようにKanaの以降のセッションに届くか。

すべてのアウトカムは振り返りで終わります。振り返りでわかったことは**学び**として保存され、有効な学びはKanaの以降のセッションに渡されます。そのため、次のアウトカムは前のアウトカムから得た教訓を踏まえて始まります。

```mermaid theme={null}
%%{init: {"theme":"base","themeVariables":{"fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif","fontSize":"16px","primaryColor":"#FFF1E0","primaryBorderColor":"#A94604","primaryTextColor":"#3B1A02","secondaryColor":"#FFE4C2","tertiaryColor":"#FFF8F0","lineColor":"#A94604","clusterBkg":"#FFF8F0","clusterBorder":"#E8B98A","edgeLabelBackground":"#FFFFFF","git0":"#A94604","git1":"#FF9F0A","git2":"#D97706","git3":"#B45309","gitBranchLabel0":"#FFFFFF","gitBranchLabel1":"#3B1A02","gitBranchLabel2":"#FFFFFF","commitLabelColor":"#3B1A02","commitLabelBackground":"#FFF1E0"}}}%%
flowchart TD
  D[デリバリーPRがマージ済み] -->|あなた：振り返りを開始| R[振り返りセッション<br/>指標、コスト、ドリフト、Kanaの評価]
  R --> F[あなたのフィードバック]
  F -->|あなた：デリバリーを承認| L[アウトカムの学び]
  L -->|Kanaが昇格| W[ワークスペースの学び]
  W -->|Kanaが昇格| C{全社向け？}
  C -->|レビュー待ち| A[オーナーまたは管理者が<br/>承認または却下]
  C -->|有効| S[以降のセッション]
  A -->|承認| S
```

## 振り返り

デリバリープルリクエストがマージされ、すべてのタスクが完了、キャンセル、または延期されたら、**振り返りを開始**を選びます。振り返りを開始できるのは人だけで、KanaやKoaは開始できません。Kanaeruが振り返りセッションを開き、Kanaが自分でサイクル全体を振り返ります。

Kanaがわかったことは、**実行**タブの**振り返り**パネルに表示されます。

| 項目 | 表示内容 |
| - | - |
| 指標 | **期間**、**タスク**、**パイプラインステップ**、**コミット**、**メッセージ**、**推定コスト**、**理解ギャップ**、**エビデンス** |
| **Kanaの評価** | Kanaの所見。**うまくいったこと**、**課題**、**学び**、**アクション項目**に分類されます |
| **ユーザーのフィードバック** | 同じ4つの分類で追加する、あなた自身の項目。分類を選び、項目を入力して送信します |

Kanaは**仕様の差異**、つまり実際に作られたものが、あなたが承認したブループリントからどれだけ離れたかも評価します。ドリフトの判定がブロッキングの場合、アウトカムを完了するには人がそれを確認する必要があります。

## 振り返りを終える

Kanaの作業中は、**エビデンスと信頼性**のボタンに**振り返りを実行中**と表示されます。作業が終わったら、**デリバリーを承認し、アウトカムを完了**を選びます。

アウトカムが完了するのは、振り返りにフィードバックが1件以上ある場合だけです。Kanaはセッション中に自分のフィードバックを記録するため、通常はこの条件をすでに満たしています。あなた自身がフィードバックを追加すると、[レベル](/ja/concepts/levels)の**レトロスペクティブを完了する**を達成できます。

アウトカムを完了すると、その振り返りも学びとして保存されます。保存に失敗した場合、アウトカムは振り返りのフェーズにとどまり、**振り返りの知見をエクスペリエンスバンクに保存できませんでした**と表示されます。完了後に追加したフィードバックも、1分ほどで学びとして保存されます。

<span id="applying-a-finding" />

## 所見を反映する

振り返りパネルの **課題**、**学び**、**アクション項目** の各所見（Kanaのものもあなたのものも）には、**ロードマップに反映** ボタンがあります。所見を反映すると、その所見から **振り返りから** というラベルの付いたロードマップ項目が下書きされ、所見には **反映済み** と **ロードマップで見る** が表示されます。項目は、**ロードマップ** タブの **AI提案をレビュー** であなたが承認または却下するまで、提案の状態のままです。同じ所見をもう一度反映すると、同じ項目が開きます。

振り返りを完了した後に所見を反映すると、オートノミーに到達するための目標の1つである **振り返りの所見を反映する** を達成します。振り返りの後にビジョンのタイトルや説明を編集した場合も、引き続き達成として数えられます。どちらの場合も、加算はビジョンごとに1回です。

## 学び

学びとは、繰り返し起きる失敗とその回避方法など、1つの教訓のことです。学びにはそれぞれスコープがあります。

| スコープ | 出どころ | 適用範囲 |
| - | - | - |
| **アウトカム** | 振り返りと、アウトカムの実行ログ | そのアウトカム |
| **ワークスペース** | ワークスペースの複数のアウトカムに共通する教訓を、Kanaが昇格させたもの | ワークスペース内のすべてのアウトカム |
| **会社** | 複数のワークスペースに共通する教訓を、Kanaが昇格させたもの | 組織内のすべてのワークスペース |

また、ステータスもあります。

| ステータス | 意味 |
| - | - |
| **レビュー待ち** | 提案された全社向けの学び。オーナーまたは管理者の判断を待っています |
| **有効** | 使用中。Kanaのセッションに届くのは有効な学びだけです |
| **解決済み** | 学びが示す問題は修正済みです。問題が再発すると、再び有効になります |
| **却下** | 廃止済み。Kanaはもう使いません |
| **取り下げ** | レビュー待ちの間に却下されたもの |

アウトカムとワークスペースの学びは、Kanaが保存した時点で有効になります。全社向けの学びはすべてのワークスペースに届くため、**レビュー待ち**として待機します。ただし、実行ログで観察されたエビデンスだけに基づく学びは、Kanaが自分で有効にします。

## 全社向けの学びを承認する

オーナーと管理者は、**エージェントのメモリ**（[後述](#seeing-what-kana-has-learned)）の **レビュー待ち** で確認します。学びを開いて根拠を読み、理由を添えて **承認** または **却下** します。開いている間に学びが更新された場合は、最新の内容がもう一度表示されます。ターミナルからも同じ操作ができます。

```bash theme={null}
kana memory learnings list
kana memory learnings get <id>
kana memory learnings approve <id> --revision <hash> --reason "Matches our API style guide" --yes
kana memory learnings dismiss <id> --revision <hash> --reason "Only true for the legacy importer" --yes
```

`--revision`は`learnings get`で表示されるハッシュです。これにより、自分が読んだバージョンについて判断できます。学びを承認すると有効になり、**人による指針**として記録されます。学びを却下すると、同じキーを持つすべての学びが、すべてのスコープでまとめて廃止されます。[`kana memory`](/ja/cli/reference#kana-memory)を参照してください。

## 学びがKanaに届く仕組み

Kanaは、すべてのセッションですべての学びを読むわけではありません。セッションの種類ごとに、その作業に合った有効な学びが渡されます。

| セッション | 渡される学び |
| - | - |
| タスク実行 | アウトカムの学びと、全社向けの学び |
| 計画 | ワークスペースの学びと、全社向けの学び |
| レビュー | アウトカムの学び、ワークスペースの学び、そして失敗しやすい点についての全社向けの教訓 |
| ビジョン＆ロードマップ、リファインメント | ワークスペースの学びと、全社向けの学び |
| 振り返り | なし。振り返りセッション自体が学びを読み書きします |
| Koa | なし |

1つのセッションに渡される学びは最大10件で、コストの大きいものから順に選ばれます。学びはそのセッションのKanaへの指示に追加されます。Claude Codeでは、セッションの開始時、再開時、コンテキストの圧縮時にも復元されます。全社向けの学びを受け取るセッションには、この上限とは別に[会社のメモ](#seeing-what-kana-has-learned)も渡されます。

<span id="seeing-what-kana-has-learned" />

## Kanaが学んだことを確認する

ワークスペースの **…** メニュー → **設定** → **エージェントのメモリ** を開きます。

* **レビュー待ち**（オーナーと管理者のみ）には、承認または却下を待つ全社向けの学びの提案が一覧表示されます。
* **保存された学び**には、ワークスペースの学びと、そのワークスペースが引き継ぐ全社向けの学びが、それぞれのスコープ、ステータス、出どころ（**観察からの学び**、**エージェントの提案**、**人による指針**）とともに一覧表示されます。オーナーと管理者は、ここでワークスペースやアウトカムの学びを変更できます（後述）。
* **会社のメモ**は、APIのスタイルや命名規則など、組織のためのキーと値のメモです。Kanaの計画、タスク実行、レビュー、ビジョン＆ロードマップ、リファインメントの各セッションは、学びとあわせて最大20件を会社の指針として読み込みます。追加、編集、削除できるのはオーナーと管理者だけです。エージェントが書いたメモは、オーナーまたは管理者が保存し直すまで読み込まれません。

ターミナルからは次のようにします。

```bash theme={null}
kana memory patterns --workspace <id>
kana memory get
```

学びを削除することはできませんが、オーナーと管理者は理由を添えて使用を止められます。

* **保存された学び** のワークスペースまたはアウトカムの学びでは、問題が解決したら **解決済みにする**（再発すると再び有効になります）、助言が誤っていれば **却下**、解決済みの学びは **再び有効にする** ことができます。変わるのはその学びだけです。
* 全社向けの学びを **却下** すると、同じキーを持つすべての学びが、すべてのスコープでまとめて廃止されます。

```bash theme={null}
kana memory patterns resolve <id> --reason "Fixed by the new retry wrapper" --yes
kana memory patterns dismiss <id> --reason "Doesn't apply to this repository" --yes
kana memory patterns reactivate <id> --reason "The flaky test is back" --yes
```

## 振り返りからロードマップへ

振り返りの間、Kanaは**課題**と**アクション項目**の各所見を、ワークスペースのリファインメントシグナルとしても登録します。シグナルだけではロードマップは変わりません。シグナルをロードマップの提案にするには、**シグナル改善パス**セッションを使う[オートメーション](/ja/guides/automations)を作成します。ワークスペースに未対応のシグナルが3件以上あると、実行のたびに**自動リファインメント**というラベルの付いたロードマップ項目が下書きされます。それらは**ロードマップ**タブの**AI提案をレビュー**で確認できます。あなたが承認するまで、提案の状態のままです。


## Related topics

- [Kanaeruの概要](/ja/index.md)
- [Kanaeruのしくみ](/ja/concepts/how-kanaeru-works.md)
- [設定とプロフィール](/ja/guides/settings.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.