Initial commit

cdsmcp/AGENTS.md

@@ -0,0 +1,42 @@
+# AGENTS.md
+
+This folder contains the VMware/vCenter + MigrateOps runbook for CDS MCP workflows.
+
+## Files
+- `esxvm.md`: index file only; points to guide and run-learnings docs.
+- `esxvm-guide.md`: authoritative workflow/rules/checklists/default behavior.
+- `esxvm-runs.md`: run-specific learnings, only when a run adds new information.
+- `vmw.yaml`: base template for `MIGRATEOPS_VMWARE_COMPUTE` operations.
+
+## Source Of Truth
+- Use `esxvm-guide.md` for how to execute runs.
+- Use `vmw.yaml` as the starting operation template.
+- Treat `esxvm-runs.md` as evidence/history, not baseline procedure.
+
+## Required Run Pattern
+1. Confirm source VM in vCenter and power state before IP/SSH actions.
+2. Prepare source host (CDC cleanup + CMC reinstall/registration) and verify source is connected in CDC.
+3. Validate preflight requirements from `esxvm-guide.md` (integration, access node, destination name, datastore/host/network, source NIC).
+4. Create MigrateOps from `vmw.yaml` with request-specific replacements.
+5. Monitor continuously and auto-approve cutover unless user requests manual approval.
+6. After terminal state:
+- validate destination login (poll guest IP if needed),
+- archive operation,
+- run offline-host cleanup loop until source/helper cleanup conditions are satisfied,
+- provide final read-only status listing for source/destination/access/helper across CDC and vCenter.
+7. Ask user explicitly before deleting destination VM; never delete without same-run confirmation.
+
+## VM Lookup Requirement
+- Unless user explicitly asks otherwise, scope VM lookup/list responses to cluster `QACL-ATVMCypressONLY`.
+- For vCenter VM lookup requests, always include datastore name and VM notes/annotation in the response.
+
+## Update Rules
+- Update `esxvm-guide.md` only when workflow/rules/default behavior changes.
+- Update `esxvm-runs.md` only when a run reveals a new learning/failure pattern/required check.
+- Keep `esxvm.md` as a lightweight index.
+
+## Environment Defaults
+- vCenter: `192.168.0.201`
+- Cluster scope: `QACL-ATVMCypressONLY` unless user overrides.
+- Default CDC project: `Skidamarink`
+- Default access node: `atvm-linux-h2h`