Repolode
walkinglabs

walkinglabs/learn-harness-engineering

AIコーディングエージェントの信頼性を高める環境、状態管理、検証、制御の仕組みを構築する方法を学ぶ、プロジェクトベースの講座です。

スター
23,454
フォーク
2,700
未解決の Issue
18
最終コミット
16 日前

これは何?

Learn Harness Engineeringは、AIコーディングエージェントを取り巻くシステムの構築方法を学べる、初心者向けの講座です。優れたモデルでも、指示、永続化された状態、検証、スコープ制限、セッションのライフサイクルルールがなければ、実際のエンジニアリングタスクで失敗するという考えに基づいています。講座では、ハーネス設計を「指示」「状態」「検証」「スコープ」「セッションのライフサイクル」の5つのサブシステムに分けて解説します。

講座は14回のレクチャーと8つの実践プロジェクトで構成されており、すべて同じElectronベースの個人用ナレッジベースデスクトップアプリを題材にしています。各プロジェクトでは、同じタスクに対する弱いハーネス構成と強いハーネス構成を比較し、測定された差を確認できます。後半のレクチャーでは、ループエンジニアリング(ゴールループ、タイマーループ、作成者と検証者の分離)と、グラフエンジニアリング(ノード、エッジ、共有状態、ルーティング)を扱います。

リポジトリには、AGENTS.md、feature_list.json、init.shなど、すぐに使えるテンプレートをまとめたリソースライブラリ、再利用可能なハーネス作成スキル、15言語に翻訳されたコンテンツも含まれています。講座の本文はVitePressのドキュメントサイトで公開されています。

主な機能

  • 01指示、状態、検証、スコープ、セッションのライフサイクルを扱う5つのサブシステムからなるフレームワーク。
  • 02エージェントの信頼性に関する中核的な問いにそれぞれ答える、全14回のレクチャー。
  • 031つのElectron製ナレッジベースアプリを発展させていく、8つの実践プロジェクト。
  • 04AGENTS.md、feature_list.json、init.shなど、すぐに使えるテンプレート。
  • 05複数ステップにわたるエージェントのワークフローに向けた、ループエンジニアリングとグラフエンジニアリングの解説。
  • 06簡体字中国語を含む15言語で利用できるコンテンツ。

ユースケース

  • Claude Code、Codexなどのエージェントを実際のリポジトリで使っており、より安定した結果を得たいエンジニア。
  • リポジトリの構成や環境設計がエージェントの出力に与える影響を評価したいテックリード。
  • 既存プロジェクト向けに、AGENTS.md、進捗ログ、検証手順を整備したい開発者。

クイックスタート

  1. 1

    リポジトリをクローンする

  2. 2

    harness-creator スキルを使って、プロジェクト用のハーネスを作成する(README のクイックスタートを参照)

使う前に知っておきたいこと

  • このプロジェクトは、インストール可能なソフトウェアツールではなく、文章形式の講義とプロジェクトで構成されたコースです。

収録されている特集

トピック

よくある質問

learn-harness-engineering とは?
AIコーディングエージェントの信頼性を高める環境、状態管理、検証、制御の仕組みを構築する方法を学ぶ、プロジェクトベースの講座です。 Learn Harness Engineeringは、AIコーディングエージェントを取り巻くシステムの構築方法を学べる、初心者向けの講座です。優れたモデルでも、指示、永続化された状態、検証、スコープ制限、セッションのライフサイクルルールがなければ、実際のエンジニアリングタスクで失敗するという考えに基づいています。講座では、ハーネス設計を「指示」「状態」「検証」「スコープ」「セッションのライフサイクル」の5つのサブシステムに分けて解説します。
learn-harness-engineering は無料で使えますか?ライセンスは?
learn-harness-engineering は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
learn-harness-engineering は今もメンテナンスされていますか?
活発にメンテナンス中。learn-harness-engineering の最終コミットは 2026年10月22日 です。
learn-harness-engineering は何に使えますか?
Claude Code、Codexなどのエージェントを実際のリポジトリで使っており、より安定した結果を得たいエンジニア。 リポジトリの構成や環境設計がエージェントの出力に与える影響を評価したいテックリード。 既存プロジェクト向けに、AGENTS.md、進捗ログ、検証手順を整備したい開発者。
learn-harness-engineering のインストール方法は?
リポジトリをクローンする harness-creator スキルを使って、プロジェクト用のハーネスを作成する(README のクイックスタートを参照)
learn-harness-engineering はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/walkinglabs/learn-harness-engineering

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト