最初のワークフロー — Noea Code ドキュメント

チェックイン報酬を例に、最初の意図の作成、確認または実装、新しい判断の記録までを体験します。実際のコードと検証結果から、要件を満たしているか判断する方法を学びます。

準備完了の Agent がある Noea と、作業対象のローカルプロジェクトが必要です。チェックイン機能がなければ、同じ程度に具体的な別のルールに置き換えてください。

コードのプロジェクトを開く

ワークベンチのフォルダを開く…、またはファイル → 実装フォルダを開く…を選び、コードを含むフォルダを指定します。

初回はリンクされたプロジェクトを作成します。既存のプロジェクトが一つなら直接開き、複数なら選択を求めます。ほかの方法はプロジェクトを開いて管理するをご覧ください。

サイドバーの新規意図をクリックし、「毎日のチェックイン」と名付けます。Noea が .noea.md を付けてドキュメントを開きます。次のように入力します。

# 毎日のチェックイン

ユーザーは一日一回チェックインできる。7 日連続でチェックインしたユーザーに報酬を付与する。

macOS は ⌘S、Windows / Linux は Ctrl+S で保存します。決まっていることから始め、すべての例外を今列挙する必要はありません。

説明はプロジェクト全体で説明の確認が必要な内容を調べます。段落の調査はその内容だけを調べます。どちらも実装を確認して説明を作成・更新し、コードは変更しません。

チェックインが既にある場合は、サイドバーの説明をクリックします。この段落だけなら、段落にポインターを重ね、左側の調査を選びます。

まだ実装が必要な場合は、新規チャットを開き、入力欄で @ を入力して意図ドキュメントを選び、次を送信します。

参照した意図に従い、このプロジェクトにチェックイン報酬を実装してください。まず既存コードを調べ、プロジェクトの構成に従い、7 日連続の場合とチェックインを逃した場合の両方を検証してください。

利用可能ならサイドバーの実装も使えます。Agent と実装を進めるをご覧ください。作業中は返信、ツール呼び出し、ファイル変更がチャットに表示されます。

実装後、自動で始まらなければ説明をクリックします。通常のチャットでのコード変更がすべて説明更新を起動するわけではありません。

意図に戻り、段落内の文字以外の空白をクリックして余白ノートを開きます。次の項目を読みます。

例えば、実装が端末のタイムゾーンで暦日を決めていると分かるかもしれません。実際の動作と要件の一致を確かめ、引用を開いて根拠が説明をどこまで支えているか確認します。

説明の完了はテストの再実行を意味しません。テストコード、過去の結果、今回実行した検証を区別してください。説明と根拠を読むで詳しく説明します。元の要件を満たさなければ、コードに合わせてルールを書き換えるのではなく実装を直します。

段落にポインターを重ね、左側のこれについて質問を選びます。入力欄に参照が挿入されます。質問を加えて送信します。

現在の実装では、タイムゾーンをまたぐ移動をどう扱いますか。二つの場所でチェックインすると連続日数に影響しますか。コードに基づいて説明してください。

動作を理解したら、計算に制約を設けるか決めます。設けるなら、次を送ります。

「一日はユーザーの現在地の暦日に従う」をこの意図に加えてください。まずレビューできるよう意図の変更を提案してください。

提案が届いたら変更を表示で挿入・置換された文章を読みます。必要なら新しい文章を編集し、自分の編集を承認を選びます。編集不要なら承認します。

実装が必要な提案は、承認後に同じチャットで続行します。既存の実装が満たしていれば新たな実装実行は不要です。その後、説明タスクの結果を確認し、必要に応じて手動で調査します。

終了前に保存し、説明が現在の文章を対象としているか確認します。次の四つを自分の言葉で答えてみましょう。

例えば、一日の定義を説明でき、根拠を見つけ、「7 日連続」が報酬条件だと示せることが目安です。答えが曖昧なら該当段落について質問します。

最初から全ルールを記録する必要はありません。残す価値のある次の判断に出会ったときに追加します。