> X学習(id=521・@ai_agent_dev投稿)を受け、お姉様の指示「AI駆動開発基盤に組み込んで」で恒久実装。Issue vvv-bots #316(完了) / #315(実証コメント)
## 何をしたか（4ステップ全実装・shadow実機）
### 1. rules + CLAUDE.md/AGENT.md 組み込み
- **新設**: `~/.claude/rules/ant-cli-guide.md`（サブコマンド全容・よく使うコマンド・Managed Agent作成実践・Gotcha）
- CLAUDE.md「詳細設定」に1行参照追加（100行未満維持を確認）
- AGENT.md「8.重要な期限」に ant CLI 節追加（全エージェント共通仕様書 = Codex/agy/Hermesも認識）
### 2. 委譲ルート追加
- task-router.md: ant委譲ルート表（「Managed Agent作って」「antで〜」系はCC自身がant経由）
- codex-delegation.md: 冒頭に「ant CLIを先に検討」分岐（Claude Platform操作はAnthropic公式antが最優先）
### 3. ラッパースクリプト
- **新設**: `~/workspace/tools/ant_helper.sh`（実行権限付与済・動作確認済）
- サブコマンド: status(auth+疎通サマリー) / agents / agent
### 4. 実Managed Agent 稼働実証（フルチェーン）
- create(curl直叩き) → agent_01M8jZP6hDSCBBBXUyhXVyjq 作成成功（model=claude-haiku-4-5・無料）
- retrieve(ant CLIメタ操作) → 設定/ログ取得成功・ラッパーで1件表示確認
- archive → archived_at セット・active 0件に復帰（片付け完了）
## ★Gotcha（重要・再利用価値高）
- `ant beta:agents create --model <文字列>` は v1.10.0 で動かない: string was used where mapping is expected。--model '{"model":"x"}' でも API が model.model: Extra inputs not permitted(400)
- 回避策: curl 直叩きで model を文字列として渡す。create以外（list/retrieve/update/archive/skills/models）は ant CLI が正常
- beta header = managed-agents-2026-04-01,oauth-2025-04-20（ant --debug beta:agents list で確認）
- トークン取得 = ant auth print-credentials | grep -oE 'sk-ant-[^ "]+'
- レスポンスの model は {"id":"...","speed":"standard"} に正規化される
## 課金境界（#315と整合）
- メタ操作(list/retrieve/archive/create) = 無料／実推論(messages/agent run) = APIクレジット課金
## 残アクション（任意・費用対効果を見てから）
- beta:worker で shadow を self-hosted worker 化し Managed Agent にローカルツールを持たせる
- beta:memory-stores を MEMORY.md肥大化(#292)の公式代替として AgentMemory(#300)/Memanto(id=511) と横並び比較