Skip to main content
Kanaeruは作業をループとして組み立てます。各段階は前の段階をさらに絞り込み、誤解があると高くつく場面ではあなたがレビューします。そして各アウトカムの振り返りで得た学びを、Kanaは次のアウトカムに持ち込みます。その間ずっと、リファインメントがロードマップを整えています。

ビジョン

ビジョンは、目指している長期的な成果です。1つのビジョンに到達するには、通常いくつものアウトカムが必要です。学びに応じてビジョンを見直すこともできます。各ビジョンはそれぞれ専用のワークスペースに置かれます。ワークスペースを作成することは、ビジョンを記述することです。

ロードマップとバックログ

ロードマップには、ビジョンに到達するために必要なすべての項目が含まれます。項目は、あなた自身、Kanaの提案、接続済みのツールから追加されます。提案された項目は、あなたが受け入れるまで提案のままです。 まだアウトカムに入っていない項目はバックログに置かれ、アウトカムに組み込まれるまでそこで待機します。KanaがAI提案した項目も、あなたのレビューを待つ間はバックログに置かれます。 リファインメントセッションでは、Kanaと一緒にロードマップを整えます。新しいリファインメントで開始します。リファインメントでは、Kanaは次のことができます。
  • 項目の並べ替え、統合、分割、明確化
  • 新しい項目を追加する前に、同じ項目がすでにないかの確認
  • 接続済みツールやコードからの詳細の取り込み
  • バックログの項目を、新規または既存のアウトカムにまとめる
リファインメントセッションは、ほかの作業の前でも並行してでも、いつでも開けます。

アウトカム

アウトカムとは、ビジョンに向けた一区切りの作業で、実際に使えるものが出来上がるまでを1単位とします。ロードマップの項目を1つの成果物にまとめ、計画、レビュー、実行、デリバリー、振り返りという決まったライフサイクルを進みます。アウトカムを参照してください。

タスク、ジャーニー、ブループリント

アウトカムの計画セッションで、Kanaはアウトカムをタスクに分割します。各タスクは1つ以上のユーザージャーニー、つまり利用者があなたの作るものの中でたどる道筋をカバーします。各ジャーニーには次のものが含まれます。
  • 受け入れ条件:Given / When / Then形式で書かれたシナリオです。受け入れテストに合格するまで、タスクは完了になりません。
  • ブループリント:そのジャーニーに必要な設計です。コードを書く前に生成されるので、Kanaが何を理解したかを確認できます。
ブループリントには多くの種類があり、各ジャーニーは対象となる画面や機能に必要なものを使います。 すべての種類とレビュー方法については、ブループリントを参照してください。 依存関係が宣言されていないタスクは並行して実行されます。

理解のギャップ

理解のギャップとは、Kanaの理解とあなたの意図が一致していない可能性がある箇所です。Kanaは、影響が及ぶ最も狭い範囲(1つのジャーニー、1つのタスク、タスク一覧、またはアウトカム全体)でギャップを提起します。 通常のギャップもあります。情報不足、曖昧さ、確認すべき仮定、記録された決定です。一方でブロッキングのギャップもあります。リスク、エスカレーション、仕様の不足、意図のずれ、理解度の確認、あなただけが持つ前提情報です。ブロッキングのギャップは、実行を開始する前に解消する必要があります。理解のギャップを参照してください。

レビュー

計画のレビューは、アウトカムの計画とレビューセクションで、作られたときと同じ順序で行います。まずタスク分解、次に各タスクのジャーニー、最後に受け入れ条件とブループリントを含む各ジャーニーです。 アウトカムを開始は、必要な条件がすべてそろうまでロックされたままです。
  • 構築したいすべてのタスクが承認され、その要件がレビュー済みである
  • すべてのブループリントが承認され、未解決のブロッキング注釈がない
  • ブロッキングの理解のギャップが残っていない
  • Kanaの理解度クイズに合格している
理解度クイズは、あなたが承認しようとしている内容を理解しているかをKanaが確かめる方法です。レビューチャットでKanaが計画を説明したあと、3〜5問の質問をします。すべてに正解する必要があります。1問でも間違えると、Kanaが改めて説明し、新しい質問を出します。アウトカムを開始を選んだら、合格したことを確認し、確認して開始を選びます。

パイプライン

各タスクの準備が整うと、タスク計画セッションがそのタスクのパイプライン、つまりタスクを構築・チェックする具体的なステップを設計します。どのステップも実行される前に、独立したレビュアーが計画をチェックします。 パイプラインは3つの階層で構成されます。
  • フェーズ:必ずビジネスロジック、API、UI、QA、デプロイの順です。該当しないフェーズは、理由を記録したうえでスキップされます。
  • レイヤー:各フェーズの中にあり、コードベースの各部分に対応します。ビジネスロジックにはドメインとユースケースのレイヤーがあります。APIにはコントローラー、アダプター、APIクライアントがあります。UIにはコンポーネント、ページ、状態管理、フロントエンドのユースケースがあります。
  • ステップ:各レイヤーの中にあり、1つずつ実行されます。
各レイヤーは2つのサイクルを実行します。
  1. 構築:ほとんどのレイヤーは、先にコードを書き、次にそのテストを書きます。ユースケースのレイヤーはテストファーストで、テストとそれが定めるインターフェースが実装より先に作られます。生成されたコードはすべて、すぐにlintの修正が行われます。
  2. レビューと修正:レビューステップが、書かれたばかりのコードやテストをチェックします。作業が却下されると、パイプラインはそれを書いたステップに差し戻し、再度レビューします。何度か却下が続くと、エスカレーション判定が、受け入れるか、もう一度差し戻すか、ブロックしてあなたの判断を待つかを決めます。
ビジネスロジックのレイヤーは、最後にミューテーションテストを行い、テストが実際にバグを検出できるかを確かめます。 すべてのステップがエージェントというわけではありません。ステップには、エージェント、コミットやPR作成などの組み込みスキル、手動の操作があります。また、各ステップには生成、テスト、lint、レビュー、品質などのカテゴリーがあります。 QAでは、タスクがエンドツーエンドで動くことを検証します。すべてのタスクに、受け入れ条件のエンドツーエンドテストと、セキュリティ、コードレビュー、品質のゲートがあります。デプロイでは作業をコミットし、変更全体を改めてレビューし、プルリクエストを作成して、結果を検証します。どのパイプラインも、短いタスクの振り返りとコンテキスト同期で終わるため、次のタスクはこのタスクの学びを引き継いで始まります。 その後もエージェントがプルリクエストを担当し、マージされるまでレビューコメントに対応し、CIを修正します。各タスクは専用のGitワークツリーとブランチで作業するため、並行するタスクがチェックアウトを共有することはありません。1つのアウトカムで同時に実行されるタスクは最大3つです。別のタスクに依存するタスクは、依存先のプルリクエストがレビュー中でも開始できます。

デリバリーと振り返り

タスクのプルリクエストは、アウトカム専用のブランチ(outcome/<id>)にマージされます。最後のプルリクエストがマージされると、Kanaeruはリポジトリごとに1つのデリバリープルリクエストを、アウトカムブランチからデフォルトブランチに向けて作成します。これをマージすると、アウトカム全体が一度に出荷されます。別の方法でレビューしたい場合はKanaに相談してください。たとえば、タスクのプルリクエストをスタックにしたり、1つずつベースブランチに直接マージしたりできます。 デリバリープルリクエストがマージされたら、振り返りを開始を選びます。振り返りでは、うまくいったこと、うまくいかなかったこと、かかったコストを確認します。フィードバック(あなたまたはKanaのもの)が1つ以上記録され、エビデンスパッケージ(テスト結果、差分、承認、ゲートの結果)を確認したら、デリバリーを承認し、アウトカムを完了を選びます。振り返りの指摘は学びとして保存され、以降のKanaのセッションで使われるため、次のアウトカムは今回の続きから始まります。学習ループを参照してください。

セッション

このループの各段階は、特定の種類のKanaセッションとして実行されます。種類は、ビジョン&ロードマップ、リファインメント、計画、レビュー、タスク計画、タスク実行、振り返りです。セッションは、あなたが選んだランタイムを使ってエージェントマシン上で動きます。セッションとは、Webアプリ、CLI、またはCodexやClaudeの中のKanaeruアプリからやり取りできます。

役割分担