AIエージェント階層PMシステムのGit基盤選択のバックアップ(No.1)

項目	GitLab	Gitea	Forgejo	GitBucket?
容量	5GB	200MB	150MB	150MB
起動時間	5-10分	30秒	20秒	45秒
メモリ使用量	2-4GB	50-200MB	40-150MB	50-200MB
言語	Ruby	Go	Go	Java/Scala
アーキテクチャ	モノリシック	軽量	軽量	軽量

↑

MCP対応状況 †

サーバー	MCP対応	対応状況
GitLab	×	未対応
Gitea	○	公式gitea-mcp
Forgejo	○	公式forgejo-mcp
GitBucket?	△	非公式実装のみ

↑

AIエージェント機能比較 †

↑

*WebHook?・通知機能 †

機能	GitLab	Gitea	Forgejo	GitBucket?
WebHook?イベント数	30+	20+	20+	12
リアルタイム通知	○	○	○	×
WebSocket?対応	○	○	○	×
高度フィルタリング	○	○	○	×

↑

*Web UI・コメント機能 †

機能	GitLab	Gitea	Forgejo	GitBucket?
Word-level Diff	○	○	○	×
範囲選択コメント	○	○	○	×
下書きコメント	○	○	○	×
API完全性	○	○	○	△

↑

*図表・Markdown対応 †

機能	GitLab	Gitea	Forgejo	GitBucket?
Mermaid図表	○	○	○	△
LaTeX数式	○	○	○	△
GitHub? Flavored Markdown	○	○	○	○

↑

GitLabが重い理由 †

↑

アーキテクチャの根本的違い †

GitLab: モノリシック・全部入りシステム

GitLab = Git + CI/CD + Registry + Security + Analytics + 
         Project Management + Issue + Wiki + Container Registry + 
         Kubernetes + Monitoring + ...

Gitea/Forgejo: 軽量・特化システム

Gitea/Forgejo = Git + Issue + PR + CI/CD(軽量) + Wiki

↑

技術スタック比較 †

技術要素	GitLab	Gitea/Forgejo
言語	Ruby on Rails	Go
DB必須	PostgreSQL	SQLite可
Redis必須	○ 必要	× 不要
Sidekiq	○ 必要	× 不要
Elasticsearch	○ 高機能用	× 内蔵検索
デプロイ	複数コンテナ	単一バイナリ

↑

Gitea vs Forgejo の違い †

↑

運営体制の違い †

項目	Gitea	Forgejo
運営主体	Gitea Limited (営利企業)	Codeberg e.V. (非営利団体)
設立	2016年	2022年10月 (フォーク)
商業化	企業向けサービス展開	完全非営利
意思決定	企業主導	コミュニティ主導

↑

技術的差異 †

項目	Gitea	Forgejo
容量	200MB	150MB (25%軽量化)
起動時間	30秒	20秒
テレメトリ	オプトアウト可	完全なし
プライバシー	基本的	強化済み
Federation	計画中	ActivityPub?実装中

↑

フォーク理由 †

Giteaへの懸念:

商業化への不安（Gitea Limited設立）
透明性の低下（企業内意思決定）
プライバシー懸念（テレメトリ追加）

Forgejoの解決策:

完全非営利保証（ドイツ非営利法人格）
プライバシーファースト（テレメトリ完全削除）
革新的機能（Federation・AI統合実験）

↑

最終選択: Forgejo安定版 †

↑

採用理由 †

↑

*1. 軽量性 †

150MB: GitLabの1/30、Giteaより25%軽量化
20秒起動: GitLabの1/15〜1/30
低メモリ: 40-150MB使用

↑

*2. セキュリティ・プライバシー †

テレメトリ完全なし: データ漏洩リスクゼロ
外部通信最小限: 完全プライベート運用可能
迅速セキュリティ修正: コミュニティ主導の透明対応

↑

*3. AIエージェント最適化 †

MCP完全対応: 階層AI PMシステム必須機能
豊富WebHook?: 20+イベント + 高度フィルタリング
リアルタイム通知: WebSocket?内蔵
API完全性: AI統合向け詳細API

↑

*4. 将来性・持続可能性 †

非営利保証: 商業化リスクなし
コミュニティ主導: 透明性・持続性
革新的機能: Federation・AI統合実験
オープンソース: ベンダーロックインなし

↑

技術スタック構成 †

階層AI PMシステム技術スタック:
├── Git基盤: Forgejo安定版
├── AI統合: MCP + Claude + forgejo-mcp  
├── 階層構造: C4モデル（Context→Container→Component→Code）
├── 記憶システム: Qdrant(ベクトル検索) + Neo4j(グラフDB)
├── コンテキスト圧縮: Atlas手法
└── 図表対応: Mermaid + LaTeX数式

↑

セキュリティ考慮事項 †

↑

AI開発環境のセキュリティ要件 †

データ機密性: AI開発データ = 企業機密・知的財産
通信秘匿性: 階層PM間通信 = 戦略・技術情報
監査可能性: AI意思決定プロセスのトレーサビリティ

↑

Forgejoの安全設計 †

# 完全プライベート設定例
DISABLE_TELEMETRY=true
OFFLINE_MODE=true  
DISABLE_GRAVATAR=true
DISABLE_FEDERATED_AVATAR=true
LOCAL_NETWORK_ALLOWLIST=192.168.0.0/16,10.0.0.0/8

↑

実装準備 †

↑

Docker起動コマンド †

# セキュア設定でのForgejo起動
docker run -d \
  --name=forgejo-secure \
  -p 3000:3000 \
  -v /path/to/data:/data \
  -e DISABLE_TELEMETRY=true \
  -e OFFLINE_MODE=true \
  codeberg.org/forgejo/forgejo:stable

↑

MCP設定 †

{
  "mcpServers": {
    "forgejo": {
      "command": "forgejo-mcp",
      "args": ["-t", "stdio", "--host", "http://localhost:3000"],
      "env": {
        "GITEA_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

↑

参考情報 †

↑

発音 †

Forgejo: フォルゲヨ (for-GEH-yo)
語源: エスペラント語で「鍛冶屋」の意味

↑

まとめ †

AIエージェント階層PMシステム構築において、Git基盤としてFORGEJO安定版を選択した。軽量性・セキュリティ・AI統合機能・持続可能性のバランスが最適であり、C4モデルベースの階層構造システムに理想的な基盤となる。

当初検討していたGitLabと比較して、容量1/30・起動時間1/15という圧倒的な軽量性を実現しながら、AIエージェントに必要な機能をすべて備えている。

今後は、Forgejoをベースとした階層AI PMシステムの詳細実装を進めていく予定である。

C4モデルによる階層AI PMシステム設計?
MCPを活用したAIエージェント統合?
コンテキスト圧縮とAtlas手法の実装?

更新履歴:

2025-06-16: 初版作成

AIエージェント階層PMシステムのGit基盤選択 のバックアップ(No.1)

AIエージェント階層PMシステムのGit基盤選択 †

概要 †

プロジェクト背景 †

階層AI PMシステムとは †

Git基盤の重要性 †

Git基盤候補の比較 †

検討対象 †

基本性能比較 †