Skip to content

Document Cloud Agent driver and site-simulator layout #969

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
frahlg wants to merge 1 commit into
base: master
Choose a base branch
from
+20 −0
Draft

Document Cloud Agent driver and site-simulator layout #969

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down