diff --git a/AGENTS.md b/AGENTS.md index 0b6a5c9..112c9ee 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,3 +14,38 @@ Run before handing off changes: ``` The validator is non-destructive and does not require a Kodi runtime. + +## Global DevOps GitHub–Kanban Contract + +For DevOps, infrastructure, deployment, security, GitOps, and service work: + +1. GitHub is authoritative for Issues, PRs, CI, reviews, merges, releases, and delivery state. Hermes Kanban is the execution queue only. +2. One GitHub Issue plus one active Hermes Kanban card should normally produce one PR directly to `main`. +3. Before branch work or a PR, fetch `origin/main` and reconcile against the current remote default branch. Do not build branch-on-branch PR stacks unless an explicit integration owner and final target are stated. +4. Do not merge, deploy, close issues, rotate secrets, or claim production success unless the task explicitly authorizes it and verification evidence exists. +5. If branches diverge, stop merging the stack. Create one integration branch from current `origin/main`, resolve semantic conflicts deliberately, run tests, and open one replacement PR to `main`. +6. For security or infrastructure work, provide exact build, test, and diff evidence and require fresh independent review before merge. Never put secrets in code, logs, PRs, or comments. +7. A task is not complete because a local test passes or a Kanban card says done. Completion requires the requested GitHub state and, when applicable, verified live behavior. +8. When creating a PR, state its target branch, linked issue, validation output, and whether it supersedes prior PRs. Do not leave divergent worker PRs ambiguous. + + +## Low-Interruption Execution + +- Treat explicit outcome requests such as "fix," "build," "complete," and + "finish" as continuing authorization for bounded work toward that outcome. +- Continue through diagnosis, implementation, tests, commits, pushes, review + feedback, and CI repair without renewed confirmation. +- New defects discovered within the same task or pull request remain in scope + when the repair is reversible, clearly supported, and consistent with the + existing architecture. +- Progress updates are informational and do not pause execution. +- Do not request confirmation when the only realistic alternatives are the + clearly supported action and inaction. +- Use a blocking checkpoint only at a genuine impasse. Present two or three + materially different choices as **A**, **B**, and optionally **C**; recommend + one and ask for a one-letter reply. +- Do not use "Done — continue" as a generic permission gate. +- Preserve explicit approval boundaries for merge, deploy, destructive work, + secret or access changes, material cost, external communication, and credible + downtime or data-loss risk. +