From adf4cace9c6fbb1660e11e5452814451bd5fc884 Mon Sep 17 00:00:00 2001 From: Joey Smith Date: Sat, 26 Sep 2026 17:48:00 -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 f6f3a7a..db86184 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,5 +1,18 @@ # Webware Navigation — 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`).