> ## 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が理解した内容を示すために生成されるモックアップ、図、仕様です。ブループリントはコードを書く前に作成されるため、あなたの意図と一致しているかを確認できます。ブループリントの段階で誤解に気づけば、コメント1つで済みます。デリバリー後に気づけば、作り直しになります。

## ブループリントの種類

| 種類 | 示す内容 |
| - | - |
| **UXモックアップ** | 画面とレイアウト。実際のルートをクリックして操作できるライブのプロトタイプとして作られます。まだプロトタイプ化されていない画面は「計画中」として表示されます |
| **ユーザージャーニー** | 利用者がたどるステップ。シナリオに分けて示します |
| **シーケンス図** | コンポーネント同士が時間の流れに沿ってどうやり取りするか |
| **API契約** | エンドポイント、リクエスト、レスポンス（OpenAPI） |
| **データモデル** | エンティティとリレーション |
| **ドメインモデル** | ビジネス上の概念とそのルール |
| **アーキテクチャ** | コンポーネント、デプロイ、連携、データフロー |
| **ステートマシン** | 状態と状態間の遷移 |
| **品質プロファイル** | 作業が満たすべき品質特性 |
| **インテント仕様** | アウトカムの背後にある意図を正確に記述したもの |
| **技術スタック** | 作業で使う技術 |
| **探索キャンバス** | 自由形式で書く計画メモ |
| **コードグラフ** | 既存コードの構造 |
| **コード Wiki** | 既存コードの仕組みを文章でまとめたもの。エージェントが計画と構築の際に読みます |

[ブループリントの例](/ja/concepts/blueprint-examples)では、1つのアウトカムを例に、計画用の種類を表示形式とソースの両方で紹介しています。Exploration Canvas、Code Graph、Code Wiki は、自由形式の計画や既存コードの分析から作られるため、このページには含まれていません。エディターとレビューツールについては、[ブループリントエディターとツール](/ja/guides/blueprint-editor)を参照してください。

アウトカムのブループリントは変更内容を記述します。アウトカムが完了すると、そのブループリントはビジョン共通のベースラインに昇格するため、次のアウトカムは最新の全体像から始められます。

## ブループリントをレビューする

ブループリントは、ワークスペース内のアウトカムから、またはKanaがチャットに投稿したリンクから開きます。

* 意図と一致していれば**承認**します。コメントを添えることもできます。
* 一致していなければ、理由と確認したい質問を添えて**却下**します。Kanaがブループリントを修正し、再度レビューを依頼します。
* 特定の部分に**注釈**を付けてスレッドを始めたり、ブループリントを直接編集したりできます。データモデル、ステートマシン、ドメインモデル、ユーザージャーニーにはビジュアルエディターがあります。

承認されたブループリントは、アウトカムのエビデンスパッケージの一部になります。

## 理解のギャップ

**理解のギャップ**とは、Kanaの理解とあなたの意図が一致していない可能性がある箇所です。ギャップは、ワークスペースとチャットに、あなたへの質問として表示されます。

| 種類 | 意味 |
| - | - |
| 情報不足 | Kanaが持っていない情報が必要です |
| 曖昧さ | 依頼内容が複数の意味に読み取れます |
| 仮定 | Kanaが置いた仮定を、あなたに確認してほしい状態です |
| 決定 | すでに行われ、記録された選択です |
| リスク | 構築前に提起しておくべきリスクがあります |
| エスカレーション | 人の判断が必要な事項です |
| 仕様の不足 | 依頼の一部が、どのブループリントやタスクでもカバーされていません |
| 意図のずれ | 計画が、あなたの依頼内容からずれてきています |
| 理解度 | あなたとKanaが計画を同じように理解しているかの確認です |
| 前提情報 | あなたが持っていて、Kanaには知りようのなかった情報です |

ギャップを解消するには、回答する、保留する、または該当なしとしてマークします。**リスク、エスカレーション、仕様の不足、意図のずれ、理解度、前提情報のギャップはブロッキングです**。これらが解消されるまで、アウトカムはレビューから実行へ進めません。計画の開始前に挙がったギャップは、種類にかかわらず、すべて解消しないと計画を始められません。

## 仕様の差異

**仕様の差異**とは、作られたものが承認済みの仕様やブループリントと一致しなくなった箇所です。差異は次の2つから生じます。

* タスクの構築中やチェック中に、エージェントがコードと仕様の食い違いを見つけた場合。
* 承認後に、あなたまたはKanaがタスクの内容や受け入れ条件を編集した場合。このときはドキュメントを追いつかせるために**古いドキュメント**の差異が記録されます。

各差異には種類（**未実装の機能**、**誤った挙動**、**古いドキュメント**、**仕様からの逸脱**）と、「低」から「重大」までの重要度があります。差異は**仕様の差異**パネルに一覧表示されます。

差異に対処する最も簡単な方法は、Kanaに任せることです。Kanaは各差異をコードと仕様の両方と照らし合わせ、間違っている側を修正して、解消済みにします。自分で**解消済みにする**を選ぶこともできます。

差異はフェーズの変更をブロックしません。差異は振り返りのドリフトチェックとは別物で、そちらで**ドリフトによるブロック**が示された場合は、アウトカムの完了が止まります（[デリバリーを受け入れる](/ja/concepts/outcomes)を参照）。これとは別に、タスクのパイプラインでは**ブループリント適合性**チェックが実装をAPI契約のブループリントと照合します。このチェックは、合格するまでタスクをブロックします。


## Related topics

- [Kanaeruの概要](/ja/index.md)
- [Kanaeruのしくみ](/ja/concepts/how-kanaeru-works.md)
- [レベル：シップ、クラフト、オートノミー](/ja/concepts/levels.md)


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