commit a06fa5ed6f99542db72dd71f4bb492f4b20714a5
Author: Adam Mandel <adam@atom.ca>
Date:   Wed Oct 21 15:53:24 2026 +0000

    Initialize portable AtomHMI project knowledge and handoff

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..e63fab2
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,14 @@
+# Project instructions
+
+## Start of each session
+Read PROJECT.md and HANDOFF.md from this repository before continuing. Treat these files as the shared project knowledge across computers and conversations. Verify the latest repository version before editing.
+
+## Working approach
+Use AtomHMI's graphical web interface to create and edit pages when requested. Do not assume that this repository contains the AtomHMI application source. Ask for the target site, page, and desired change when they are missing.
+
+Record confirmed facts separately from assumptions. Do not invent page structures, addresses, credentials, or completed work. Never commit passwords, tokens, cookies, or other credentials.
+
+## Continuity
+At the end of a substantial work session, update HANDOFF.md with completed work, validation results, unfinished items, and concrete next steps. Update PROJECT.md when durable project facts or decisions change. Commit these updates to this repository and report the commit. Do not claim knowledge was saved until the remote write succeeds.
+
+Repository notes provide continuity, not automatic synchronization of chat history, browser sessions, running tools, or local files. A new chat must explicitly read them.
diff --git a/HANDOFF.md b/HANDOFF.md
new file mode 100644
index 0000000..c73ca36
--- /dev/null
+++ b/HANDOFF.md
@@ -0,0 +1,23 @@
+# Current handoff
+
+Last updated: 2026-10-21
+
+## Completed
+- Established this repository as the remote home for AtomHMI UI project knowledge.
+- Added session instructions, project overview, and handoff notes.
+
+## Current state
+No AtomHMI page edits have been performed as part of this setup. The target site URL, page, and requested changes have not yet been supplied in this conversation.
+
+## Next steps
+1. Read AGENTS.md and PROJECT.md.
+2. Obtain the target AtomHMI URL, page, and requested changes.
+3. Inspect the page editor using the available browser tools; authenticate through the normal login flow if needed.
+4. Perform the requested work and verify the result.
+5. Commit updated project knowledge and handoff notes here.
+
+## Resume prompt
+Use Atom Git to open Auto/atom-hmi-ui-chatgpt. Read AGENTS.md, PROJECT.md, and HANDOFF.md, then continue from the recorded next steps.
+
+## Continuity limits
+These notes do not automatically transfer browser login state, uncommitted local files, running processes, or complete chat history between computers.
diff --git a/PROJECT.md b/PROJECT.md
new file mode 100644
index 0000000..6cf6e37
--- /dev/null
+++ b/PROJECT.md
@@ -0,0 +1,23 @@
+# AtomHMI UI project
+
+## Purpose
+Use AtomHMI's graphical web interface to create and modify pages. Keep durable project knowledge in this repository so work can continue from another computer.
+
+## Knowledge location
+This repository is the shared home for project instructions, confirmed facts, and current handoff notes. It is not currently an application source checkout.
+
+## Files
+- AGENTS.md: instructions for assistants working on the project.
+- PROJECT.md: durable project facts and decisions.
+- HANDOFF.md: current progress and next actions.
+
+## Established preferences
+- Prefer graphical editing within AtomHMI for page work.
+- Preserve project knowledge remotely rather than depending on one computer.
+- Use the connected Atom Git plugin to read and update this repository.
+
+## Details still needed
+- Target AtomHMI URL and environment.
+- Target page and desired changes.
+- Page editor workflow and available backup/export features.
+- Validation and publication requirements for the target environment.