Human-AI Loop — 人間とAIの協働フレームワーク

Tool
Human-AI Loop — 人間とAIの協働フレームワーク

Human-AI Loop — 人間とAIの協働フレームワーク

Human-AI Loop は、人間とAIが交互に役割を果たす最小限のフレームワークです。目標や制約をファイルに定義し、AIは次に行うべきアクションを提案、ユーザーが実行して進捗を追記することで学習と適応を繰り返します。セッション自体はステートレスに設計され、継続性は prompt.md、plan.md、progress.txt によって保たれます。シンプルなファイル駆動のプロトコルと PowerShell スクリプトで、監査性や手動介入の柔軟性を重視したワークフローを実現します。

https://github.com/franciscohermida/human-ai-loop

概要

Human-AI Loop は「人間とAIの共生」を目指した非常にシンプルなフレームワークです。利用者は自身の目標、状態、制約を plan.md に記述し、prompt.md にループのプロトコル（サイクルの進め方）を定義します。進捗は progress.txt に追記され、セッションはステートレスに保たれるため、各呼び出しはファイルの現在状態を読み取って次の推奨アクションを返します。run.ps1（PowerShell スクリプト）がループの呼び出しやファイルの入出力を担う想定で、シンプルさ、追跡可能性、手動での実行と介入を重視した設計が特徴です。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 2
  • ファイル数: 6
  • メインの言語: PowerShell

主な特徴

  • ファイル駆動のステートレス設計（prompt.md／plan.md／progress.txt に継続性を保持）
  • 人間が実行するループ（AI は提案、ユーザーが実行してログを残す）
  • シンプルな PowerShell スクリプト run.ps1 によるオーケストレーション
  • 監査可能な追記ログ（append-only）の採用で履歴の追跡が容易

技術的なポイント

このプロジェクトの技術的要点は「最小限の設計」で継続性と可搬性を確保している点です。セッション自体をステートレスにすることでサーバー側の永続化やセッション管理を不要にし、必要な文脈は全てファイルに置くという非常に明快なアーキテクチャを採用しています。具体的には、prompt.md にプロトコル（AI がどう働き、どのような出力を返すか）を明示し、plan.md に目標や制約、利用者のコンテキストを記載、progress.txt に逐次的なログを追記することで「いつ」「なにを」「どのように」行ったかが残ります。

技術実装面では PowerShell を採用しているため、Windows 環境ではそのまま動作させやすく、PowerShell Core（pwsh）を用いれば macOS/Linux でも利用可能です。run.ps1 はファイルの読み込み・書き込み、AI への問い合わせ（外部 API を利用する場合のラッパー）や出力の整形を担う想定で、スクリプトベースのためカスタマイズや組み込みが容易です。設計上の利点は、可搬性・透明性・手動介入の容易さにあり、欠点としては並列実行や大規模データ処理、複雑な状態遷移を必要とするワークフローには向かない点、また機密情報の取り扱いやロールバック、検証の仕組みが初期実装では限定的である点が挙げられます。拡張案としては暗号化されたストレージ、バージョン管理の強化（progress の差分管理）、自動化トリガーやスケジューラーとの連携、API キーの安全管理や差分学習の導入などが考えられます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • README.md: file
  • plan.md: file
  • progress.txt: file
  • prompt.md: file
  • run.ps1: file

…他 1 ファイル

まとめ

シンプルで監査可能な人間主導のAIループを試すための軽量プロトタイプ。

リポジトリ情報：

READMEの抜粋：

Human-AI Loop

A minimal framework for human-AI symbiosis. You define your goals and constraints, AI directs your next action, you execute, AI learns and adapts.

Concept

Each session is stateless. All continuity lives in files:

  • prompt.md - The protocol (how cycles work)
  • plan.md - Your life context (goals, state, constraints)
  • progress.txt - Append-only log for continuity

You call the loop multiple times per day. Each time:

  1. AI reads your current state
  2. AI suggests O…