From ccd003a611badc9e76418c8d978e17fc5c831fe3 Mon Sep 17 00:00:00 2001 From: Joey Smith Date: Sat, 26 Sep 2026 17:47:55 -0500 Subject: [PATCH] docs: adopt the fleet agent working agreements Working discipline lived only in machine-local agent memory: unversioned, unreviewable, invisible, and gone when the session ends. webware-tools now carries it as versioned source -- agent-working-agreements.md at that package root, mandated from the preset's copilot-instructions artifact. This adopts the block, which is what makes it live: this file is loaded automatically in every session and is reviewed like any other file. --- .github/copilot-instructions.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index eb2210a..44c4048 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,5 +1,18 @@ # Webware Message — Copilot Agent Instructions +## Read this before acting — fleet working agreements + +`vendor/webware/webware-tools/agent-working-agreements.md` is authoritative for how work is done +in this fleet, and it overrides anything else in this file or in any local note. Read it before +acting, and again before reporting. The non-negotiables: + +- Do exactly the scope asked — only the files, branches and repositories named. No adjacent edits, + no cleanup, no onboarding, no surveys. +- Anything else you notice gets one line at most, with no proposed fix. +- Never close a reply with a condensed restatement of it, and never present an inference as a + measurement. +- Every change lands through a pull request. Releases and tags belong to the repository owner. + ## PHPUnit Mock vs Stub Rules PHPUnit 13 enforces a strict separation between mocks and stubs. Violating these rules produces `PHPUnit Notices` that cause test suite failures under `failOnNotice="true"` (configured in `phpunit.xml.dist`).