From 92c5e11bbcce122c62fb6be929c35b0bd6e18d3c Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 7 Aug 2026 20:09:14 +0000 Subject: [PATCH] docs: require milestone push and web UI validation --- AGENTS.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index e41a93d..2e0dc74 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -43,7 +43,10 @@ Stop and report any request that would weaken these boundaries. - Work only on a non-`main` feature branch. If the task starts on `main`, create or request a working branch before editing. - Never modify, commit on, merge into, rebase, reset, delete or push `main`. -- Commit or push a working branch only when the task requests delivery. Never approve or merge a Gitea pull request. +- Develop each milestone on its own dedicated working branch. +- After a milestone's validations and commits, always push its working branch to Gitea using the `codex` account. The milestone is not complete until the remote branch exists. +- After pushing, create a pull request from the working branch to `main` when the available tools permit it. If automatic creation is unavailable, provide the URL or exact information needed to open it immediately. +- Never approve or merge a Gitea pull request. - Do not alter remotes, credentials or repository-wide Git configuration unless explicitly requested. - Never use destructive recovery commands such as `git reset --hard`, `git clean`, or checkout-based restoration without explicit approval and a verified target list. - Before committing, review `git status`, `git diff --stat`, the complete relevant diff and `git diff --check`. @@ -58,7 +61,8 @@ Stop and report any request that would weaken these boundaries. 6. Run targeted tests first. 7. Run the applicable global validations. 8. Update `docs/PROJECT-STATE.md` with the new baseline, delivered behavior, durable decisions, limitations and next work. -9. Review and report the final diff and validation status. +9. Review the final diff and validation status, then commit the completed milestone. +10. Push the working branch to Gitea with the `codex` account and create, or provide the exact link to create, a pull request to `main`. ## Validation @@ -86,6 +90,8 @@ git diff --check Use installed tools and pinned dependencies. Do not silently install missing tools; report the exact blocker. Keep caches under `.cache/codex/` or an OS temporary directory and remove only artifacts created by the current task. +For changes that affect the web interface, exercise the relevant screens and states in a real browser when the environment permits it. Capture screenshots and use them to check at least the overall rendering, alignment, overflow, labels, primary states, relevant responsive behavior and obvious visual regressions. Screenshots are local validation artifacts and must not be committed unless explicitly requested or another project rule requires it. If browser validation or screenshots are technically unavailable, state that explicitly in the completion report. + ## Completion report - Summarize behavior and contract changes.