AIアシスタント向け AGENTS.md テンプレート

問題はこうです：AIコーディングアシスタント（Claude Code、Cursor、Cline、Windsurf）は存在しない rdc フラグを作り出し続け、どの Rediacc リポジトリ名がどの GUID に対応するかを毎回あなたに尋ねずにはいられません。このテンプレートがそれを解決します。以下のブロックをプロジェクトの CLAUDE.md、.cursorrules、またはあなたのツールが使用するエージェント設定ファイルに貼り付けてください。

テンプレート

# Rediacc Infrastructure

Self-hosted infrastructure platform. Each machine runs Docker-based repositories with encrypted, isolated environments.

## CLI Tool: rdc

Install: `curl -fsSL https://www.rediacc.com/install.sh | bash`

### Key Flags
- `--output json` (or `-o json`), machine-readable JSON output
- `--yes` (or `-y`), skip interactive confirmations
- `--quiet` (or `-q`), suppress informational output
- `--fields name,status`, limit output fields
- Auto-JSON: when piped (non-TTY), output defaults to JSON automatically

### JSON Envelope
All JSON output uses a consistent envelope:
{"success": true, "command": "...", "data": ..., "errors": null, "warnings": [], "metrics": {"duration_ms": N}}

On error: {"success": false, "command": "...", "data": null, "errors": [{"code": "...", "message": "...", "retryable": false, "guidance": "..."}], ...}

### Common Operations

# Machine status
rdc machine status <machine> -o json

# List containers on a machine
rdc machine status <machine> --containers -o json

# Machine health check
rdc machine health <machine> -o json

# Deploy a repository
rdc repo up <repo>@<machine> --yes

# Stop a repository
rdc repo down <repo>@<machine> --yes

# SSH terminal to machine
rdc term connect <machine> 
# SSH terminal to specific repo (sets DOCKER_HOST)
rdc term connect <repo>@<machine>

# Run command on machine
rdc term connect <machine> -c "command"

# File sync
rdc repo sync upload <repo>@<machine> --local ./local-path
rdc repo sync download <repo>@<machine> --local ./local-path

# List all available commands
rdc --help-all

### Architecture
- **Repository**: Isolated application deployment with its own Docker daemon at /var/run/rediacc/docker-<networkId>.sock, loopback IP range (127.0.x.x/26), and encrypted btrfs mount at /mnt/rediacc/mounts/<guid>/
- **Config**: CLI config at ~/.config/rediacc/rediacc.json. Auto-created on first use.
- One adapter: **local** (SSH-based)

### Rules
- Say "local adapter", never "local mode"
- S3 is a resource state backend, not a separate adapter
- Default config is created automatically on first use, do not tell users to run `rdc config init`
- Always use `--output json` when parsing output programmatically
- Always use `--yes` to skip confirmations in automated workflows
- Use `--dry-run` on destructive commands (repo delete, repo up, repo down) to preview before executing

カスタマイズ

<machine> と <repo> を実際のマシン名とリポジトリ名に置き換えてください。rdc repo list を実行すると、利用可能なリポジトリの名前からGUIDへのマッピングを確認できます。

セットアップの確認

# List configured machines
rdc machine status <machine-name>

# List repositories with GUIDs
rdc repo list

# Check what commands are available
rdc --help-all

CLIリファレンス： rdc machine status · rdc repo list

エージェントごとの設定

Claude Code: プロジェクトルートに CLAUDE.md として保存
Cursor: プロジェクトルートに .cursorrules として保存
Cline: Clineのシステムプロンプトまたはプロジェクト設定に追加
Windsurf: プロジェクトルートに .windsurfrules として保存