AGENTS.md: add Supported Development Platforms rule (#228 §0) - #269
Merged
Conversation
Encode the retrospective's headline cross-platform decision framework: cross-platform (Win+macOS+Linux via WSL2/devcontainer) by default; narrow a repo's platform only for a hard runtime ceiling set by its dependencies (e.g. a Home Assistant integration is Linux-only), decided per repo and recorded in the repo. The narrowing axis is where code executes for dev/testing, not where editing happens. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new governance rule to AGENTS.md documenting the repo-template decision framework for supported development platforms, tying platform support to dependency/runtime ceilings (not tooling effort) and requiring narrowed platform decisions to be recorded explicitly in-repo.
Changes:
- Introduces a new
## Supported Development Platformssection describing the cross-platform default (Windows/macOS/Linux) and the WSL2/devcontainer path to a consistent Linux toolchain. - Defines when and how a repo should narrow platform support based on hard dependency/runtime constraints (with an explicit example).
- Requires documenting any narrowed platform stance (and rationale) in README/AGENTS.
Linux dev runs natively (Linux desktop, or SSH/remote into a Linux host) as well as via WSL2 or a devcontainer; the latter two carry their own nuances but deliver the same toolchain. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…in/mac Correct wording that implied WSL2 runs on macOS. Devcontainer covers Windows and macOS; WSL2 is Windows-only. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Drop the VS Code Server parenthetical; dev/test execution is native, SSH-remote, container, or CI - not tied to VS Code Remote. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced Jul 9, 2026
Closed
ptr727
added a commit
that referenced
this pull request
Jul 9, 2026
…logging rules (#271) Promotion of `develop` -> `main`, batching the docs/governance PRs since the last promotion: - **#268** — AGENTS.md `## Communicating with the User` (clickable PR links; numbered questions). - **#269** — AGENTS.md `## Supported Development Platforms` (#228 §0: cross-platform by default, narrow only for a hard dependency/runtime ceiling). - **#270** — CODESTYLE.md: xUnit v3 + AwesomeAssertions (no native asserts); NuGet libraries log via `ILoggerFactory`, not Serilog. Diff is only `AGENTS.md` + `CODESTYLE.md`; no code. `spec/validate.py` green. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Encodes the last unincorporated piece of the #228 retrospective — §0, the cross-platform decision framework — as a new
## Supported Development Platformssection in AGENTS.md (before## Devcontainer):Additive only; CRLF preserved. Completes #228's incorporation; the section→PR mapping will be posted on #228 at close.
🤖 Generated with Claude Code