From 588e59db26156f5bf3bcdaf98c2df3b63e337bd5 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Fri, 24 Apr 2026 20:45:51 +0100 Subject: [PATCH] docs: clarify post-land ci waiting --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index 7d3565f537a..1047f0e06ff 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -96,6 +96,7 @@ Scoped guides: - PR links: `gh pr list --state open --search '' --json number,title,updatedAt,headRefName --limit 20`; use `gh pr view --json number,title,body,closingIssuesReferences,files,statusCheckRollup,reviewDecision` only after shortlist. - CI polling: keep full `gh` capability, but request only needed fields. Known run status: `gh api repos///actions/runs/ --jq '{status,conclusion,head_sha,updated_at,name,path}'`. - Non-blocking background workflows: `Auto response`, `Docs Sync Publish Repo`, `Docs Agent`, and `Test Performance Agent` are service/agent work. Do not wait on, rerun, or fix them during normal push/PR verification unless the user explicitly asks or the task is about those workflows. Report them as background if mentioned. +- Post-land waiting: keep it minimal. After push/merge, check only required workflows for the exact landed SHA. If the landed SHA is already superseded on `main`, treat same-branch `cancel-in-progress` CI cancellations as expected and stop waiting once local touched-surface proof is recorded. Do not wait for newer unrelated `main` commits unless asked. - `/landpr` CI wait scope: do not idle on pending `auto-response`/`Auto response` or `check-docs`. Treat docs as local proof unless `check-docs` already failed with a relevant, actionable error. If required product/code gates and touched-surface local gates are green, proceed without waiting for docs-only or auto-response automation. - Waiting: poll lightly, usually 30-60s backoff. Fetch jobs/logs/artifacts only after completion/failure or when job detail is needed; avoid repeated workflow + run + jobs loops.