Skip to content

中文版本 →

関連講義: 講義 07. エージェントのタスク境界を明確に引く · 講義 08. 機能リストでエージェントの作業を制約する テンプレートファイル: templates/

プロジェクト 04. ランタイムフィードバックでエージェントの挙動を修正する

やること

起動ログ、インポート/インデックスログ、エラー状態などのランタイム観測性と、レイヤー越境を防ぐアーキテクチャ制約を追加します。さらに、エージェントに修正させるランタイムバグを仕込みます。

同じ作業を 2 回実行します。1 回目はログや制約なし。2 回目は適切なツールとルールを使います。

リポジトリ内のプロジェクトを使う

リポジトリ内のパス: projects/project-04/

ディレクトリ含まれるもの比較すること
starter/Project 03 のコードで診断シグナルが弱い状態です。仕込まれた indexing 欠陥により大きなファイルの chunking が壊れる可能性があり、architecture check script もありません。runtime シグナルなしで根本原因にたどり着く時間。
solution/structured logger、architecture boundary docs/script、修正済み chunking logic、clean-state-checklist.md があります。logs と boundary checks が修正を速く、影響範囲を小さくするか。

確認するファイル: projects/project-04/solution/src/services/logger.ts, projects/project-04/solution/scripts/check-architecture.sh, projects/project-04/solution/docs/ARCHITECTURE.md, projects/project-04/solution/src/services/indexing-service.ts.

ツール

  • Claude Code または Codex
  • Git
  • Node.js + Electron

Harness メカニズム

ランタイムフィードバック + スコープ制御 + 増分インデックス