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

ブループリントの種類

ブループリントの例では、1つのアウトカムを例に、計画用の種類を表示形式とソースの両方で紹介しています。Exploration Canvas、Code Graph、Code Wiki は、自由形式の計画や既存コードの分析から作られるため、このページには含まれていません。エディターとレビューツールについては、ブループリントエディターとツールを参照してください。 アウトカムのブループリントは変更内容を記述します。アウトカムが完了すると、そのブループリントはビジョン共通のベースラインに昇格するため、次のアウトカムは最新の全体像から始められます。

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

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

理解のギャップ

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

仕様の差異

仕様の差異とは、作られたものが承認済みの仕様やブループリントと一致しなくなった箇所です。差異は次の2つから生じます。
  • タスクの構築中やチェック中に、エージェントがコードと仕様の食い違いを見つけた場合。
  • 承認後に、あなたまたはKanaがタスクの内容や受け入れ条件を編集した場合。このときはドキュメントを追いつかせるために古いドキュメントの差異が記録されます。
各差異には種類(未実装の機能、誤った挙動、古いドキュメント、仕様からの逸脱)と、「低」から「重大」までの重要度があります。差異は仕様の差異パネルに一覧表示されます。 差異に対処する最も簡単な方法は、Kanaに任せることです。Kanaは各差異をコードと仕様の両方と照らし合わせ、間違っている側を修正して、解消済みにします。自分で解消済みにするを選ぶこともできます。 差異はフェーズの変更をブロックしません。差異は振り返りのドリフトチェックとは別物で、そちらでドリフトによるブロックが示された場合は、アウトカムの完了が止まります(デリバリーを受け入れるを参照)。これとは別に、タスクのパイプラインではブループリント適合性チェックが実装をAPI契約のブループリントと照合します。このチェックは、合格するまでタスクをブロックします。