From 8c522b3880e196d56b0b8a9165119c50b2bc71e3 Mon Sep 17 00:00:00 2001 From: Mike Swanson Date: Fri, 15 May 2026 15:52:15 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20harden=20agent=20parity=20rule=20?= =?UTF-8?q?=E2=80=94=20all=20platforms=20in=20same=20change,=20no=20except?= =?UTF-8?q?ions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CODING_GUIDELINES.md: tighten parity rule wording to match Mike's intent: "add feature X" means Windows + Linux + macOS in the same commit - memory: add feedback_gururmm_agent_parity for future session enforcement Co-Authored-By: Claude Sonnet 4.6 --- .claude/CODING_GUIDELINES.md | 8 ++++---- .claude/memory/MEMORY.md | 1 + .claude/memory/feedback_gururmm_agent_parity.md | 16 ++++++++++++++++ 3 files changed, 21 insertions(+), 4 deletions(-) create mode 100644 .claude/memory/feedback_gururmm_agent_parity.md diff --git a/.claude/CODING_GUIDELINES.md b/.claude/CODING_GUIDELINES.md index f7a178a..8ea1e4c 100644 --- a/.claude/CODING_GUIDELINES.md +++ b/.claude/CODING_GUIDELINES.md @@ -128,10 +128,10 @@ A feature that silently no-ops on one platform is a gap, not a cross-platform im ### The rule -> If you add or change a feature in the agent and the change is not blocked by OS-level APIs, -> you must implement or stub it on all three platforms in the same PR. -> If a real implementation is not feasible, add a `// TODO(platform): — ` comment -> and open a tracking item. +> "Add feature X to the agent" means Windows + Linux + macOS. All three, in the same change. +> No exceptions for convenience. If a real implementation is not feasible on a given platform, +> add a working stub and a `// TODO(platform): — ` comment in the same commit. +> A feature that silently no-ops on one platform without a stub and TODO is a bug, not a gap. ### cfg gating — choose the right target diff --git a/.claude/memory/MEMORY.md b/.claude/memory/MEMORY.md index 25d8cd9..9c587f5 100644 --- a/.claude/memory/MEMORY.md +++ b/.claude/memory/MEMORY.md @@ -22,6 +22,7 @@ - [Howard Enos](user_howard.md) — Mike's brother, technician, full trust/access. Known machine: ACG-TECH03L. ## Feedback +- [GuruRMM agent parity rule](feedback_gururmm_agent_parity.md) — "Add feature X to the agent" = Windows + Linux + macOS in the same change, no exceptions. Stub + TODO if real impl not feasible. - [D2TESTNAS SSH Access](feedback_d2testnas_ssh.md) - Use root@192.168.0.9 with Paper123!@#, not sysadmin - [Bypass Permissions Setting](feedback_bypass_permissions_setting.md) - Set permissions.defaultMode to bypassPermissions in settings.json on all machines - [365 Remediation Tool](feedback_365_remediation_tool.md) - Always means Graph API app fabb3421, not CIPP diff --git a/.claude/memory/feedback_gururmm_agent_parity.md b/.claude/memory/feedback_gururmm_agent_parity.md new file mode 100644 index 0000000..a52040c --- /dev/null +++ b/.claude/memory/feedback_gururmm_agent_parity.md @@ -0,0 +1,16 @@ +--- +name: feedback_gururmm_agent_parity +description: "Add feature X to the agent" means all three platforms (Windows + Linux + macOS) in the same change — no exceptions +metadata: + type: feedback +--- + +"Add feature X to the agent" means Windows + Linux + macOS. All three in the same change. + +**Why:** Mike stated this explicitly 2026-05-15. Delivering Windows-only and leaving Linux/macOS for later is not acceptable — it's the same as not finishing the task. + +**How to apply:** When implementing any agent feature: +- If the implementation differs by platform, write all three variants. +- If a real implementation is not feasible on a platform yet, add a working stub + `// TODO(platform): — ` in the same commit. +- A silent no-op without a stub and TODO is treated as a bug. +- See `.claude/CODING_GUIDELINES.md` "GuruRMM Agent — Platform Parity" for the full matrix and known gaps.