ホームLLMshareAI-lab/learn-claude-code
// archived 2026-04-24
66

// 概要

本リポジトリは、AI モデルが認識し行動するために不可欠な環境である agent harness を構築するための包括的な教育フレームワークを提供します。真のエージェンシーはモデルの学習過程で獲得されるものであり、開発者の役割はモデルが機能するためのツール、知識、コンテキスト管理システムを構築することにあると説いています。12 回の段階的なセッションを通じて、ユーザーは Claude Code の背後にある原則をリバースエンジニアリングし、堅牢でスケーラブルな agent アーキテクチャを構築する方法を学びます。

// 技術解説

本プロジェクトは 「harness-first」 という設計哲学を推進しており、真のエージェンシーは複雑な手続き型コードのオーケストレーションではなく、トレーニング済みのモデルから導き出されると主張しています。インテリジェントなモデルが効果的に認識、推論、行動するための環境、すなわち harness を構築するための構造化されたフレームワークを提供することで、業界でよく見られる 「prompt plumbing」 という落とし穴に対処しています。インテリジェンス (モデル) とインフラストラクチャ (harness) を分離することで、本プロジェクトはソフトウェアエンジニアリング以外の多様なドメインにも適用可能な、モジュール式でスケーラブルなエージェント構築アプローチを提供します。

// 主要ハイライト

01
エージェントモデルとそれを支える harness インフラストラクチャの明確なアーキテクチャ上の区別を提供します。
02
基本的なループから洗練されたエージェントシステムを段階的に構築する 12 のプログレッシブラーニングセッションを特徴としています。
03
エージェントの機能を容易に拡張できるモジュール式のツールディスパッチシステムを実装しています。
04
サブエージェントの分離やマルチレイヤーのコンテキスト圧縮など、高度なコンテキスト管理技術を実証しています。
05
依存関係グラフと永続的なファイルベースのストレージを備えた堅牢なタスク管理システムを含んでいます。
06
チームベースのワークフロー向けに、非同期の JSONL メールボックスを使用したマルチエージェント調整パターンを紹介しています。

// ユースケース

01
ツール、知識、コンテキスト管理を備えたモジュール式 agent harness の構築
02
複雑なワークフローのための永続的なタスクシステムと subagent 連携の実装
03
分離された実行環境と multi-agent チーム通信プロトコルの開発

// クイックスタート

開始するには、リポジトリを clone し、 'pip install -r requirements.txt' を使用して必要な依存関係をインストールしてください。サンプルファイルを '.env' にコピーし、 ANTHROPIC_API_KEY を追加して環境を設定します。その後、 'agents/' ディレクトリ内のスクリプトを 's01_agent_loop.py' から順に実行し、 's_full.py' での完全な実装に向けて進めることで、学習の進捗を確認できます。