AIエージェント統合の概要

AIコーディングアシスタントは、rdc CLIを通じてRediaccインフラストラクチャを自律的に管理できます。このガイドでは、統合アプローチと開始方法について説明します。

なぜセルフホスト + AIエージェントなのか

Rediaccのアーキテクチャは本質的にエージェントフレンドリーです:

CLIファースト: すべての操作が rdc コマンド — GUIは不要
SSHベース: トレーニングデータからエージェントが最もよく知っているプロトコル
JSON出力: すべてのコマンドが一貫したエンベロープ付きの --output json をサポート
Docker分離: 各リポジトリが独自のデーモンとネットワーク名前空間を持つ
スクリプト化可能: --yes で確認をスキップ、--dry-run で破壊的操作をプレビュー

統合アプローチ

1. AGENTS.md / CLAUDE.md テンプレート

最も手軽な開始方法です。AGENTS.md テンプレートをプロジェクトルートにコピーしてください:

Claude Code用に CLAUDE.md
Cursor用に .cursorrules
Windsurf用に .windsurfrules

これにより、利用可能なコマンド、アーキテクチャ、規約の完全なコンテキストがエージェントに提供されます。

2. JSON出力パイプライン

エージェントがサブシェルで rdc を呼び出すと、出力は自動的にJSONに切り替わります（非TTY検出）。すべてのJSONレスポンスは一貫したエンベロープを使用します:

{
  "success": true,
  "command": "machine query",
  "data": { ... },
  "errors": null,
  "warnings": [],
  "metrics": { "duration_ms": 42 }
}

エラーレスポンスには retryable と guidance フィールドが含まれます:

{
  "success": false,
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Machine \"prod-2\" not found",
    "retryable": false,
    "guidance": "Verify the resource name with \"rdc machine query\" or \"rdc config repository list\""
  }]
}

3. エージェント機能の検出

rdc agent サブコマンドは構造化されたイントロスペクションを提供します:

# List all commands with arguments and options
rdc agent capabilities

# Show detailed schema for a specific command
rdc agent schema "machine query"

# Execute a command with JSON stdin
echo '{"name": "prod-1"}' | rdc agent exec "machine query"

CLIリファレンス： rdc agent capabilities · rdc agent schema

エージェント向けの主要フラグ

フラグ	用途
`--output json` / `-o json`	機械可読なJSON出力
`--yes` / `-y`	インタラクティブな確認をスキップ
`--quiet` / `-q`	情報的なstderr出力を抑制
`--fields name,status`	出力を特定のフィールドに限定
`--dry-run`	破壊的操作を実行せずにプレビュー

次のステップ

Claude Code セットアップガイド — Claude Codeのステップバイステップ設定
Cursor セットアップガイド — Cursor IDE統合
JSON出力リファレンス — JSON出力の完全なドキュメント
AGENTS.md テンプレート — コピー＆ペースト用エージェント設定テンプレート