walkinglabs/learn-harness-engineering
Harness engineering beginner tutorial, from 0 to 1
このプロジェクトは何ですか?
Learn Harness Engineering は、AI コーディングエージェント(Claude、GPT、Codex など)が実際のソフトウェアプロジェクトで確実に動作するための支援システムを構築する方法を教える、無料のオープンソースコースです。より良いプロンプトを書くことではなく、AI が動作する環境を設計することです。
核となる考え方:最も強力な AI モデルでも、適切な構造を与えなければ、実際のエンジニアリングタスクで失敗します。このコースでは、その構造を構築する方法を示します。それを ハーネス と呼びます。
ハーネスは何をしますか?
README は、ハーネスには 5 つのサブシステムがあり、それぞれに特定の役割があると説明しています:
- 指示 – エージェントに何を、どの順序で、開始前に何を読むべきかを伝えます。1 つの巨大なファイルではなく、エージェントがオンデマンドでナビゲートする段階的開示構造です。
- 状態 – 完了したこと、進行中のこと、次に何をするかを追跡します。ディスクに保存され、次のセッションが前のセッションが終了した場所から正確に再開します。
- 検証 – 合格したテストスイートのみが証拠としてカウントされます。エージェントは実行可能な証明なしに成功を主張できません。
- スコープ – エージェントを一度に 1 つの機能に制限します。過剰な範囲、複数のことを中途半端に終わらせること、未完了の作業を隠すために機能リストを書き換えることはありません。
- セッションライフサイクル – 開始時に初期化し、終了時にクリーンアップし、次のセッションのためのクリーンな再起動パスを残します。
README には、これらがどのように組み合わさるかを示す図と、テキスト版が含まれています:「モデルは書くコードを決定します。ハーネスは、いつ、どこで、どのように書くかを管理します。」
コースには何が含まれていますか?
コースは 3 つの部分に分かれています:
- 講義 – ハーネスエンジニアリングの背後にある理論を説明する 14 の概念ユニット。
- プロジェクト – ゼロからエージェントワークスペースを構築する 8 つの実践プロジェクト。
- リソースライブラリ – 自分のリポジトリにドロップできるコピー可能なテンプレート(
AGENTS.md、feature_list.json、init.shなど)。
スキル セクションもあり、プロジェクト用に数分で本番グレードのハーネスをスキャフォールドできる harness-creator スキルが含まれています。
すぐにどう使えますか?
README はクイックスタートを提供しています:すでにコーディングエージェントを使用している場合、プロジェクトルートに 4 つのファイルを追加することで今日から改善できます:
AGENTS.md– エージェントの操作マニュアルinit.sh– インストール + 検証 + 開始を実行feature_list.json– 存在する機能、完了した機能claude-progress.md– セッション進行ログ(名前は歴史的なものですが、エージェントに依存しません。どのエージェントでも使用できます)
これらのファイルはリポジトリ内に存在するため、すべてのセッションが同じ状態から始まります。README は、これだけでエージェントセッションが「プロンプトだけで実行するよりも大幅に安定する」と述べています。
キャップストーンプロジェクトは何ですか?
すべての 6 つ(現在は 8 つ)のコースプロジェクトは、同じ製品を中心に展開しています:実際のアプリ。README は文の途中で途切れていますが、プロジェクトが単一の実際のアプリケーションを中心に構築されていることは明確です。
最近の新機能は?
README は 2 つの主要な更新を強調しています:
- 2026 年 8 月:フロンティアハーネス設計の分解 に関する新しいセクションを追加 – 実際の製品(Pi、Claude Code、Codex、DeepSeek)がハーネスを構築する方法を、コースの 5 サブシステムフレームワークを適用して深く掘り下げた 4 つの分析。また、グラフエンジニアリング に関する講義 14 と、ワークフローをグラフとして描画するプロジェクト 08 を追加。
- 2026 年 7 月:ループエンジニアリング に関する講義 13 と、最初の自動ループを構築するプロジェクト 07、およびゴールループ、タイマーループ、メーカー-チェッカループのコードテンプレートを追加。
その他の詳細
- 言語:コースは 15 言語で利用可能(英語、中国語、日本語、韓国語、スペイン語、フランス語、ロシア語、ドイツ語、アラビア語、ベトナム語、ウズベク語、トルコ語、ポルトガル語-ブラジル、ウクライナ語など)。
- PDF:PDF コースブックを生成するビルドパイプラインがあります(
npm run pdf:build)、出力はartifacts/pdfs/に。 - ライセンス:MIT。
- コミュニティ:コミュニティに参加するための Discord リンクがあります。
なぜこのコースが存在するのですか?
README は動機を説明しています:モデルはコードを書くことができますが、実際のリポジトリ内で複数のセッションにわたって、絶え間ない人間の監督なしに実際のエンジニアリングタスクを確実に完了できますか?現在、答えは「ハーネスなしではできません」です。このコースは、そのハーネスを構築する方法を教え、AI エージェントを信頼して作業を任せ、結果を検証しながら後片付けをしないようにします。
要するに:Learn Harness Engineering は、AI コーディングエージェントを時々役立つアシスタントから信頼できるチームメイトに変えるためのフレームワークとツールを提供する、実践的でプロジェクトベースのコースです。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト