keyaki-development — 2026

AI組織運用マニュアル

GCE VM 上で動く、プロジェクト縦割り・PM 制の AI 組織の構成・起動・運用リファレンス。
唯一の窓口 orchestrator（千葉） の下に各プロダクト専任 PM を置き、実装・専門職の共有プールが作業する。

Claude Code 直結 tmux 常駐 GCE g2-standard-4 (L4 GPU) オンデマンド ~$0.7/hr
Organization

プロジェクト縦割り・PM 制の役割分担

orchestrator / 千葉

窓口・統括

  • 山下の唯一の窓口（Slack 発言はここのみ）
  • 各 PM へのタスク振分・報告集約
  • PM 未設置案件（portal 等）の直轄
pm-kodouflow

kodou flow 専任 PM

  • 進捗・スケジュールを所有
  • 実装プールへ inbox で指示
  • DOCS.md を常に最新化
pm-edanet

edanet 専任 PM

  • MVP（7/31 目標）を所有
  • frontend/backend/designer へ指示
  • legal レポートの反映管理
実装・専門プール

共有プール

  • engineer（川上）/ frontend（中村）/ backend（田中）
  • designer（山口）/ marketing（石川）
  • PM の inbox 指示で実装・PR（マージはしない）
reviewer

PR レビュー専任

  • コメントのみ（承認・変更要求ボタンは押さない）
  • 「マージは山下本人が確認の上行います。」を付記
  • 実装・マージ・デプロイはしない
legal / accounting

オンデマンド

  • legal（大久保）: 著作権・規約・モデレーション
  • accounting（佐藤）: 経理。ローカル LLM 駆動
  • 常駐 tick なし。必要時に kick で起動
稼働： VM はオンデマンド起動（使う時だけ make start → 終わったら make stop）。起動中は dormant 時間帯なしで 24h 稼働（2026-06-07 dormant 廃止）。orchestrator は起動中ずっと窓口。
Architecture

VM = オンデマンド起動のリモート Claude 端末

👤

山下

orchestrator とだけ対話

→
make cli / make cli-engineer …

SSH → tmux 常駐セッション

  • 起動ディレクトリの CLAUDE.md が COMPANY・AGENTS・DOCS をロード
  • セッション切断後も VM 上で動き続ける
  • コンテキストを保持したまま自律作業・報告
→
BRAIN FILES
org.md · AGENTS.md · DOCS.md
WORKSPACE
~/keyaki/kodouflow · edanet 等
TASK QUEUE
_shared/tasks/
ペルソナ分離： 起動ディレクトリで人格（ロール）が切り替わる。グローバル ~/.claude/CLAUDE.md は空のまま維持し、agent/AGENTS.md も置かない（全セッションへの混入防止）。
File Structure

サーバーのファイル配置

~/ (VM: /home/yamashita/)
├── agent/ ← AI組織のオフィス
│   ├── org.md 役割定義 SSoT
│   ├── MANUAL.md 運用手順
│   ├── _shared/ COMPANY/WORKFLOWS/kick.sh/tasks
│   ├── orchestrator/ 窓口（千葉）
│   ├── pm-kodouflow/ kodou flow PM
│   ├── pm-edanet/ edanet PM
│   ├── engineer/ 川上（実装・reatex 兼務）
│   ├── frontend/ 中村  ├── backend/ 田中
│   ├── designer/ 山口  ├── marketing/ 石川
│   ├── reviewer/ PR レビュー
│   ├── legal/ 大久保（オンデマンド）
│   └── accounting/ 佐藤（オンデマンド・ローカル LLM）
├── keyaki/ ← 作業リポジトリ群
├── reatex/ ← reatex 兼務（オンデマンド）
└── .claude//CLAUDE.md ← 空（必須）
各ロール共通
  • CLAUDE.md — ローダ（@import のみ）
  • AGENTS.md — 役割・tick フロー定義
  • DOCS.md — 外部記憶（git 管理）
DOCS.md の扱い

git（keyaki-org-workdir）で管理。ローカルとサーバーが分岐したら、黙って上書きせず git のコンフリクトとして検知・解決する。

新プロジェクトは pm-<name>/ を作り、org.md・orchestrator/AGENTS.md・kick.sh に追記するだけ。

How to Connect

ロールへの接続

orchestrator（窓口）

基本入口
make cli

tmux: orchestrator。山下の基本入口。done/ と各 PM の DOCS を読んで Slack 報告。

engineer（川上）

keyaki
make cli-engineer

tmux: engineer。横断実装・PR・CI。PM の inbox 指示で作業。

kodou flow PM

PM
make cli-pm-kodouflow

tmux: pm-kodouflow。進捗を所有し実装プールへ inbox 投函。

edanet PM

PM
make cli-pm-edanet

tmux: pm-edanet。MVP スケジュールを所有。

marketing（石川）

keyaki
make cli-marketing

tmux: marketing。コンテンツ・GTM。inbox 指示で作業。

accounting（佐藤）

opencode
make cli-sato

tmux: sato。claude ではなく opencode（Ollama + gemma ローカル LLM）。

engineer（reatex 兼務）

reatex
make cli-reatex

tmux: engineer-reatex。オンデマンド。LINE WORKS 報告・rtx-yamashita アカウント。

既存セッションがあれば自動で再接続。　切り離し: Ctrl+B → D　スクロール: Ctrl+B → [（Q で終了）　非対話起動: _shared/kick.sh <role>
Commands

よく使うコマンド

VM 管理

make startVM を起動する（オンデマンド）
make stopVM を停止（課金停止）
make status稼働状態・ディスク確認
make backup-status日次スナップショット一覧
make ssh生 SSH 接続

デプロイ

make deployskills を VM へ反映
make deploy-reatexreatex の脳を反映
make push-secrets-reatexgws / google-drive 認証情報転送

※ AI 組織の脳（CLAUDE/AGENTS/DOCS）の反映は make push（git: keyaki-org-workdir）に一本化。旧 make deploy-agent は廃止。

ワークディレクトリ同期（git）

make pullサーバーの最新を git pull で取り込む（作業前に必ず）
make push自動コミット → git push → サーバーで git pull まで実行（脳の反映もこれ）
make pull-dry / push-dry未取得コミット / 未コミット変更のプレビュー

repo: keyaki-dev/keyaki-org-workdir（サーバー ~ を private 管理）
ローカル clone: ~/Documents/repos/keyaki/keyaki-org-workdir/

サーバーは cron 毎時で自動 commit+push。同一行が衝突したら自動解決せず ~/org-autocommit.log に記録 → 手動解決。

※ 同期は git に一本化済み。旧 rsync ミラー（server-share/・scripts/sync.sh）は廃止した。

マニュアル

make manualこのマニュアルをブラウザで開く

tmux 操作

Ctrl+B → D切り離し（VM は動き続ける）
Ctrl+B → [スクロール（Q で終了）
tmux lsセッション一覧確認
Collaboration

タスクキューで連携する

orchestrator → PM の inbox に投函 → PM が分解して実装ロールの inbox に投函 → 担当が doing/done → PM が集約・DOCS 更新 → orchestrator が集約 → Slack 報告は orchestrator のみ
inbox/
orchestrator/PM が投函
担当者が掴む
→
doing/
担当者が mv
着手を示す
→
done/
完了後に書き戻す
PM が集約
→
archive/
orchestrator が Slack 報告
後に保管

タスクファイル形式

# ファイル名
20260608-frontend-forkbox-feed-ui.md

# 内容
担当: frontend　依頼元: pm-edanet
完了条件: PR 発行（マージは山下）
背景 / 実施内容 / 完了報告

報告経路

  • Slack 発言は orchestrator のみ。山下は orchestrator とだけ対話
  • PM・実装・専門職は done/ と自分の DOCS.md で返す
  • 状態遷移は mv（アトミック = ロック代わり）
  • パス: ~/agent/_shared/tasks/
Initial Setup

初回セットアップ

1

VM 上でセットアップスクリプトを実行

bash scripts/setup.sh — claude CLI・gh・gcloud・gws、および GPU ドライバ・Ollama・opencode を導入。各ロールのディレクトリ（orchestrator/ pm-kodouflow/ … accounting/）を初期化。

2

Claude・GitHub・GCP を認証する

claude auth login でサブスク認証。gh auth login で keyaki-dev アカウントを登録（reatex 用に rtx-yamashita も登録）。

3

佐藤（accounting）のローカル LLM を用意する

Ollama に gemma 系モデルを pull し、num_ctx 拡張派生（gemma4-sato）を生成。佐藤は claude ではなく opencode → Ollama で駆動する。

4

AI組織の脳と skills を反映する（ローカルから）

make push — 脳（CLAUDE/AGENTS/DOCS・org.md・_shared）を git（keyaki-org-workdir）でサーバーへ反映。make deploy で skills を ~/.claude/skills/ へ転送。

5

orchestrator に接続して動作確認

make cli — tmux: orchestrator に接続。org.md / DOCS.md を読んで全体の文脈を把握し待機状態になれば完了。

Roadmap

自律化ロードマップ

1

Phase 1 — プロジェクト縦割り・PM 制 現在

  • orchestrator 窓口 → PM → 実装/専門プールの階層で稼働
  • 佐藤（accounting）をローカル LLM（Ollama + opencode）へ移行済み（2026-06-06）
  • VM はオンデマンド起動。起動中は dormant なし 24h 稼働（2026-06-07 dormant 廃止）

Phase 2 — 起動・tick の自動化 次のステップ

  • 起動スクリプトが tmux + claude を自動起動し tick を登録
  • VM 再起動後もセッションが自動復旧する
  • orchestrator が inbox 確認・done 集約・Slack 報告を定期自走
3

Phase 3 — 脱 Claude・フルローカル組織 将来

  • 佐藤での配管検証を踏まえ、engineer 等もローカル LLM へ段階移行
  • 従量課金せずサーバーに固定投資、使うほど得な構造へ
  • 常時稼働の価値が見合えばフル 24h 稼働へ戻す