chore: document fork workflow and ignore local artifacts

2026-08-04 16:25:32 -04:00
parent 9627453e23
commit a2e4f1d576
3 changed files with 189 additions and 219 deletions
@@ -1,5 +1,16 @@
 # Agent Notes

+## Fork initialization and upstream sync
+
+This repository is a personal fork maintained under the `snowspeeder` Gitea account.
+
+- `origin` is the writable Gitea repository: `snowspeeder/pi-web`.
+- `upstream` is the canonical project: `https://github.com/jmfederico/pi-web.git`.
+- Keep fork-specific work in focused commits and branches. Do not force-push shared branches.
+- To bring in project updates, run `git fetch upstream`, merge or rebase `upstream/main` into the relevant local branch, resolve conflicts, test, then push to `origin`.
+- Do not push changes to `upstream`.
+
+
 This project is expected to run locally using split systemd user services:

 - `pi-web-sessiond.service` runs `npm run start:sessiond` in non-autoreload, non-auto-restart mode.