From 0e103cbaf76e7f014aaf37e1120c64234b9c2e16 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 21 Aug 2026 17:37:49 +0000 Subject: [PATCH] Document the Cloud Agent multi-repo test stack. Record that device-drivers is the editable driver source and device-simulator is the site FTW talks to in this environment, so future agents do not treat ftw/drivers or make dev as that path. --- AGENTS.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f6a6ebab..0c5bcf7c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -159,6 +159,26 @@ dedicated secret, then rerun the same immutable version. Do not mint another beta tag to work around an access failure. `CLAUDE.md` imports this file, so these rules apply to Claude and Codex alike. +## Cursor Cloud specific instructions + +The Cloud Agent environment is a multi-repo FTW stack. `/workspace` is +`srcfl/ftw`. Sibling checkouts live under `/agent/repos/`. Install and start +run with cwd `/agent`, so `cd` into the repo you mean before `make`. + +| Repo | Role | +|---|---| +| [`srcfl/ftw`](https://github.com/srcfl/ftw) | Core. `make test`, `make e2e`, `make verify`. | +| [`srcfl/device-drivers`](https://github.com/srcfl/device-drivers) | Editable driver source. Change Lua there, never in `ftw/drivers/*.lua`. | +| [`srcfl/device-simulator`](https://github.com/srcfl/device-simulator) | Simulated site FTW talks to over real protocols. | +| [`srcfl/ftw-webapp`](https://github.com/srcfl/ftw-webapp) | Installable client. | +| [`srcfl/ftwdb`](https://github.com/srcfl/ftwdb) | Embedded energy database. | + +`make e2e` and `make dev` still use the in-tree Go simulators +(`sim-ferroamp`, `sim-sungrow`). For driver, protocol or site behaviour, +run **device-simulator** as the house: Sungrow hybrid on Modbus plus a bound +SDM630 as site meter. Its dashboard is `http://127.0.0.1:8762`; FTW is +`http://127.0.0.1:8080` once `config.local.yaml` points at those ports. + ## Useful source entry points | Concern | Source |