Skip to content
This repository was archived by the owner on Mar 17, 2026. It is now read-only.

README.md

Latest commit

 

History

History
138 lines (107 loc) · 8.58 KB

README.md

File metadata and controls

138 lines (107 loc) · 8.58 KB

AgentMine

TypeScript Node.js Next.js React Hono SQLite Tailwind CSS pnpm Turborepo

English

AI非依存の開発タスクオーケストレーション基盤。複数のAI Runner（Claude, Codex, Gemini等）を統合管理し、スコープ制御・完了定義・監査証跡で安全性と観測可能性を提供する。

ポジショニング

AgentMineは「AIプログラマーを管理するプロジェクトマネージャー」として機能する。

観点 Claude Code等のAI開発ツール AgentMine
AI対応 特定AI専用 AI非依存（RunnerAdapter）
安全制御 ツール単位の権限 ファイル単位のスコープ+違反検出+承認
実行隔離 同一ディレクトリ worktreeで物理隔離
完了判定 AI自己報告 Observable Facts + DoD
監査 なし Proof-Carrying Run（証跡パック自動生成）
利用形態 個人ターミナル Web UIで可視化・共有

主要機能

機能 説明
AI非依存オーケストレーション RunnerAdapterで複数AI Runnerを統合管理する
スコープ制御 タスクごとにwrite/excludeを適用し、事前制約+事後検出で担保する
Conflict-Aware Scheduler 並列起動前にwrite_scopeの重なりを検出し、衝突を回避する
Proof-Carrying Run Run完了時に証跡パック（prompt hash、scope、変更ファイル、DoD結果）を自動生成する
Memory Governance 記憶の信頼度・有効期限・承認で長期運用の品質を維持する
観測可能な事実 exit code、差分、検証結果等で状態を自動判定する（AIの自己申告に依存しない）
worktree隔離 タスクごとにブランチ+worktreeを作り、並列実行の衝突を物理的に防ぐ
監視と介入（Web UI） ブラウザで実行ログを監視し、stop/retry/continue/approve等で介入する

アーキテクチャ概要

flowchart LR
  H[Human / Team] --> UI[Web UI<br/>監視・介入・共有]
  UI <--> D[Local Daemon<br/>HTTP API + Events]

  D --> DB[(DB Master<br/>SSoT)]
  D --> G[Git Repos]
  D --> WT[Worktrees<br/>物理隔離]

  D --> RA[RunnerAdapter<br/>AI非依存]
  RA --> R1[Claude CLI]
  RA --> R2[Codex CLI]
  RA --> R3[Gemini CLI]
Loading

注:

  • Phase 1-2はlocalhost一人運用。Phase 3でチーム対応を予定。
  • ログの正はDBではなくファイルである。DBは参照（log_ref/output_ref）を保持する。
  • DBをSSoT（Single Source of Truth）とし、状態はObservable Factsから導出する。

技術スタック

層 技術
フロントエンド Next.js 15 / React 19, Tailwind CSS 4, TanStack Query + Zustand
バックエンド Hono, Drizzle ORM, SSE
データ SQLite
開発ツール pnpm, Turborepo, tsup, Vitest

モノレポ構成

パッケージ 責務
packages/daemon Local Daemon（Hono API + RunnerManager）
packages/web Web UI（Next.js）
packages/shared 共通型定義（API schema等）
packages/db Drizzle schema + migrations

想定ワークフロー

  1. Projectを登録する（repo_pathとbase_branchを指定する）
  2. Settingsで scope.defaultExclude と dod.requiredChecks を設定する
  3. Agent Profileを作成する（runner/model/prompt_template等。Runnerを選択可能）
  4. タスクを作成する（title/description/write_scope必須）
  5. Runを開始する → Conflict-Aware Schedulerがwrite_scope衝突を事前チェック
  6. worktreeで物理隔離された環境で、選択されたRunnerがタスクを実行する
  7. scope violationが発生した場合、Web UIでapprove/rejectする
  8. Run完了時にDoDチェック実行 → **Proof Bundle（証跡パック）**を自動生成
  9. base branchへマージされたことを根拠にdoneを確定する

設計の特徴

  • AI非依存: RunnerAdapterで差異を吸収。特定AI Runnerにロックインしない
  • 安全性: write_scope + 違反検出 + 承認ワークフロー + worktree物理隔離
  • 監査性: Proof-Carrying Runで変更の証跡を自動集約。レビュー・監査コストを削減
  • 衝突回避: Conflict-Aware Schedulerが並列実行前にwrite_scope重複を検出
  • 記憶の品質管理: Memory Governanceで信頼度・有効期限・承認を管理
  • 観測可能性: 状態はObservable Facts（exit code, diff, check結果等）から導出。AIの自己申告に依存しない

フェーズ計画

Phase テーマ 主な内容
1 MVP完成 + 差別化確立 スコープ制御完成、Proof-Carrying Run、Conflict-Aware Scheduler、Memory Governance、RunnerAdapter追加
2 運用知能化 Cost/SLA Router、Compliance Templates、監査ログエクスポート
3 チーム対応 認証・認可、リモートアクセス、チームダッシュボード

ドキュメント

カテゴリ パス
設計の入口 docs/00-index.md
全体像 docs/01-overview/summary.md
スコープ・フェーズ docs/01-overview/scope.md
構成 docs/02-architecture/structure.md
役割モデル docs/02-architecture/role-model.md
Proof-Carrying Run docs/03-details/proof-carrying-run.md
Conflict-Aware Scheduler docs/03-details/conflict-aware-scheduler.md
Memory Layer + Governance docs/03-details/memory-layer.md
UI仕様（MVP） docs/03-details/ui-mvp.md
リポジショニング決定 docs/04-decisions/0013-repositioning.md
用語 docs/99-appendix/glossary.md
English docs docs_en/

コントリビューション / Contributing

コントリビューションを歓迎します。詳細は CONTRIBUTING.md を参照してください。

Contributions are welcome. See CONTRIBUTING.md for details.

ステータス

Phase 1（MVP完成 + 差別化確立）の実装を進行中。