説明を最新に保つ — Noea Code ドキュメント

意図やコードを変えたら、説明がまだ適用できるか確認します。サイドバーの説明でプロジェクト全体の確認が必要な説明を扱い、段落の調査で一つの内容を確認できます。

何が変わったかを知る

古い可能性があることは、結論が間違いだとは限りません。無関係な変更かもしれません。変更がないことも、テストの合格や全機能の完成の証明ではありません。

保存して段落にポインターを重ね、左側の調査を選びます。既存の余白ノートにもう一度調査がある場合もあります。

選択した内容の説明だけを更新します。未保存の変更がある内容では利用できず、先に保存するよう案内します。

例えば重複報酬を防ぐコードを変えた後、対応するルールを調査し、説明が現在の実装を記述しているか確かめます。

サイドバーの説明で、調査待ちの内容と、裏付けファイルが変わった説明を確認します。プロジェクト未選択、読み取り専用、実装フォルダ未リンクの場合は利用できません。

手動開始すると、段階、進行状況、個別の結果を示すチャットが開きます。実行中はそのチャットに通常のメッセージを送れませんが、ほかのチャットは使えます。

終了後、結果を展開し、更新された説明、今も正しい説明、失敗または未完了の確認を見ます。タスクの終了はすべての確認の成功を意味しません。

説明は意図とコードを比較し、段落レベルと局所的な説明の両方を確認します。正しい内容は維持し、修正が必要な部分を更新するため、毎回すべてを書き直すとは限りません。

説明更新はテストの再実行ではありません。動作検証は通常のチャットで依頼し、その後で関連内容を調査します。範囲の読み取り方は説明と根拠を読むをご覧ください。

設定 → 現在のプロジェクト → 自動化 → 実装後に自動的に説明は既定でオンです。主な条件は次のとおりです。

操作	自動説明
意図を変更し、実装も必要な提案を承認する。	実装タスクが正常終了した後。
意図を変更し、既存実装が既に満たす提案を承認する。	承認後。
サイドバーの実装から開始する。	最初のターンが正常終了した後。
意図の文章を変更する整理案を承認する。	上の設定とは独立して、承認後に実行。
ファイル名やフォルダ構成だけを整理する。	起動しない。
通常のチャットでコードだけを変更、直接実装を選択、または実装が失敗・停止する。	起動しない。手動で説明を実行。

自動説明は通常のチャットを作らずバックグラウンドで動きます。元のチャットを続け、実行で進行状況を確認できます。

サイドバーの実行に説明タスクが残ります。展開すると各実行の読み取り専用記録を見られ、チャットを切り替えたりアプリを再起動したりしても閲覧できます。

失敗・中断後はもう一度実行を選びます。既存の説明は保持します。新しい実行後に、以前失敗・未完了だった項目が処理されたか確認します。

説明に使う Agent は開始方法で変わります。プロジェクト操作の設定と適用範囲はAgent、モデル、使用量をご覧ください。