From 6a1aa5ad9f0d3954f16ad3e370dc6a4a816dc69b Mon Sep 17 00:00:00 2001
From: Guy Godfroy <guy.godfroy@gugod.fr>
Date: Sun, 15 Mar 2026 15:31:25 +0100
Subject: [PATCH] Add AI agent config

---
 incus/AGENT.md  | 51 +++++++++++++++++++++++++++++++++++++++++++++++++
 incus/CLAUDE.md |  1 +
 2 files changed, 52 insertions(+)
 create mode 100644 incus/AGENT.md
 create mode 100644 incus/CLAUDE.md

diff --git a/incus/AGENT.md b/incus/AGENT.md
new file mode 100644
index 0000000..8462d02
--- /dev/null
+++ b/incus/AGENT.md
@@ -0,0 +1,51 @@
+# Agent Guide
+
+## Project Summary
+
+Incus cluster managed with OpenTofu. The cluster has 2 hypervisors and 1 witness for quorum.
+
+## CLI
+
+Always use `tofu`, never `terraform`.
+
+## Architecture
+
+Two-role cluster: hypervisors run workloads, witnesses maintain database quorum.
+
+Every cluster-wide resource (network, storage pool) follows a three-layer pattern:
+
+1. Per-hypervisor target resources
+2. Per-witness target resources
+3. Cluster-wide resource that `depends_on` both
+
+## Module Conventions
+
+Modules live in `modules/<resource>/`. Each module accepts:
+
+- `name` — resource name
+- A resource-specific type/driver string
+- `hypervisors` / `witnesses` — sets of node names
+- `hypervisor_config` / `witness_config` — free-form `map(string)` for per-role provider config
+
+The root module iterates with `for_each` over a variable map and fans values into the module.
+
+## File Layout
+
+One root `.tf` file per concern:
+
+- `provider.tf` — provider configuration
+- `groups.tf` — cluster groups
+- `network.tf` — network resources
+- `storage.tf` — storage pool resources
+- `variables.tf` — variable declarations
+
+Variable values live in `.auto.tfvars` files, one per concern.
+
+## Validation
+
+After any change:
+
+1. `tofu validate`
+2. `tofu plan`
+
+Plan output should show no unexpected replacements or destroys for existing resources.
diff --git a/incus/CLAUDE.md b/incus/CLAUDE.md
new file mode 100644
index 0000000..34e6164
--- /dev/null
+++ b/incus/CLAUDE.md
@@ -0,0 +1 @@
+See [AGENT.md](AGENT.md) for project instructions.