From 4b972742fe193f64cfa80be03baae3ff6792f84c Mon Sep 17 00:00:00 2001
From: Simon Richardson <stickupkid@gmail.com>
Date: Wed, 11 Mar 2026 16:30:56 +0000
Subject: [PATCH] feat: add some domain knowledge for agents

Following juju/juju repo, add some domain knowledge so the agents have
some initial documentation to consume to start with.
---
 AGENTS.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..ceed437
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,49 @@
+# juju-controller Agent Rules Index
+
+Ensure that the following documents have been read:
+
+ - [Juju Hook Lifecycle](https://documentation.ubuntu.com/juju/3.6/reference/hook/)
+ - [Operator Framework](https://documentation.ubuntu.com/ops/latest/reference/)
+
+If guidance conflicts, Juju Hook Lifecycle rules take precedence.
+
+## Setup
+
+Create and activate a virtualenv, and install the development requirements:
+   
+```
+virtualenv -p python3 venv
+source venv/bin/activate
+uv pip install ".[dev]"
+```
+
+Install `astral-uv` using snaps:
+
+```
+sudo snap install astral-uv --classic
+```
+
+## Build
+
+Install `charmcraft` using snaps:
+
+```
+sudo snap install charmcraft --classic
+```
+
+Then run charmcraft pack:
+
+```
+charmcraft pack -v
+```
+
+## Updating libs
+
+```
+charmcraft fetch-libs
+```
+
+## Running Tests
+
+- `./run_tests`
+