⚙️ Vault運用
README
最終更新 2026年05月09日 ／ 90_Meta/AI作業ロック/README.md
AI作業ロック
Claude Code と Codex が同じ Obsidian / Google Drive / システムを同時更新すると、後勝ち保存・競合コピー・changelog食い違いが起きる。
共有領域を触る前に、必ず共通ロックを取る。
30秒で全体像
| 観点 | 一言 |
|---|---|
| 核心 | Claude Code / Codex / 社内AIが同じDriveを触る前に、対象単位でロックする |
| コマンド | ~/Obsidian/scripts/ai_session_lock.sh |
| 共有コピー | AI/SCALE-Brain/scripts/ai_session_lock.sh |
| ロック実体 | /Users/oogushiyuuki/Library/CloudStorage/GoogleDrive-y-ogushi@scale-group.co.jp/マイドライブ/AI/_ai_work_locks/ |
| 現在状態 | _ai_work_locks/ACTIVE_LOCKS.md |
絶対ルール
| タイミング | 動き |
|---|---|
| 作業開始前 | list で他セッションのロック確認 |
| Vault / Drive / システム更新前 | acquire で対象ロック取得 |
| ロック取得失敗 | 編集しない。対象を分けるか、作業者にhandoffする |
| 作業完了後 | Drive同期・Vault反映・handoff作成まで終えた後に release |
| セッションが落ちた時 | TTL期限切れ後に自動cleanup。必要なら cleanup |
コマンド
# 現在のロック一覧
~/Obsidian/scripts/ai_session_lock.sh list
# Vault全体をロック
~/Obsidian/scripts/ai_session_lock.sh acquire vault codex 180 "AI運用ルール更新"
# SCALE Baseをロック
~/Obsidian/scripts/ai_session_lock.sh acquire scale-base claude-code 120 "KPI画面修正"
# 対象の状態確認
~/Obsidian/scripts/ai_session_lock.sh status vault
# 作業終了時に解除
~/Obsidian/scripts/ai_session_lock.sh release vault
# 期限切れロックを整理
~/Obsidian/scripts/ai_session_lock.sh cleanup
ロック対象名
| 対象名 | 使う場面 |
|---|---|
vault |
AGENTS / AI運用ルール / Daily / MOC / 複数Vaultファイルを触る時 |
vault-ai-rules |
22_AI運用ルール や AI運用関連だけを触る時 |
scale-base |
SCALE Base のコード・changelog・最新基準点 |
scale-lead |
SCALE CRM / Lead 系 |
scale-finance |
Finance Dashboard |
scale-pm |
PM Dashboard |
scale-fs |
FS Dashboard |
terasu |
TERASU関連 |
google-drive-ai |
Google Drive AI/ 直下の共有構造を触る時 |
対象が迷う時は、広い方のロックを取る。例: AGENTSと複数ノートを触るなら vault。
衝突時の判断
| 状況 | 判断 |
|---|---|
| 同じ対象がロック中 | 待つ / 別タスクに切り替える / handoffを依頼 |
| 別対象がロック中 | 作業範囲が重ならなければ並列OK |
vault がロック中 |
Vault全体更新は止める。読むだけならOK |
scale-base がロック中 |
コード・changelog・最新基準点は触らない |
| staleに見える | TTL切れまで待つ。急ぎなら大串確認後に cleanup |
標準フロー
# 1. まず全体確認
~/Obsidian/scripts/ai_session_lock.sh list
# 2. 対象をロック
~/Obsidian/scripts/ai_session_lock.sh acquire <target> <tool> <ttl_minutes> "<note>"
# 3. 作業する
# - Read -> Edit
# - Vault反映
# - Drive同期
# - handoff必要なら生成
# 4. 最後に解除
~/Obsidian/scripts/ai_session_lock.sh release <target>
補足
- 同じMac上の Claude Code / Codex では即時に効く。
- 別PCの場合はGoogle Drive同期ラグがあるため、
ACTIVE_LOCKS.mdの更新時刻も確認する。 - 別PCで
~/Obsidian/scripts/ai_session_lock.shがない場合は、Drive共有コピーAI/SCALE-Brain/scripts/ai_session_lock.shを使う。 - ロックは「共有編集の信号」。Gitのマージやバックアップの代替ではない。
- システム改修時の退化禁止フロー、バックアップ、changelog、本番確認は従来通り必須。