From 46228977d6a7a6676bb437fc339ace28b0d2e086 Mon Sep 17 00:00:00 2001 From: J8k3 Date: Sat, 16 May 2026 10:39:46 -0400 Subject: [PATCH] Update repo agent guidance --- AGENTS.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 2086010b..224ee21c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,6 +12,22 @@ - Do not commit repo changes whose only purpose is to make local Windows execution work. - If a failure appears only in the local Windows shell, do not treat it as a code regression until it reproduces in Docker/Linux. +## Session Start + +- At the start of a session, sync with `origin/master` before doing substantive work. +- Preferred command: + - `git pull --rebase origin master` +- Only do this automatically when the worktree is clean. +- If there are local changes already present, do not pull/rebase blindly; inspect first and avoid overwriting user work. + +## Commit Scope + +- Keep commits small and reviewable by default. +- Prefer one commit per individual recipe change when that is practical. +- Otherwise group a commit around one coherent class of change, not multiple unrelated fixes or refactors. +- Split work before committing when a reviewer would benefit from evaluating the pieces independently. +- Only keep changes together when separating them would make the behavior harder to understand, test, or revert. + ## Current Project Preference - For this fork, validate payment-related changes through the Docker-based workflow before judging safety to commit.