[frequency403]

Summary

Adds an AGENTS.md at the repo root with guidance for AI coding agents (and a compact reference for human contributors). The content comes from an analysis of the development branch, and its claims were checked against the source.

Changes Made

• Bug fix (non-breaking change)
• New feature (non-breaking change)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update
• Refactoring (no functional change)

Contents of AGENTS.md:

• Solution layout and tech stack (Avalonia 12, ReactiveUI + source generators, MS.Extensions.Hosting, Serilog, SSH.NET, xUnit v3)
• Exact build, test, run and publish commands (always via OpenSSH_GUI.slnx or an explicit .csproj)
• Architecture: startup, keyed View/ViewModel DI (RegisterViewWithViewModel naming rules), ResolveViewAsync, InitializeAsync(TParam), configuration, logging
• Coding conventions: nullable, primary constructors, Central Package Management, compiled bindings, resx in both languages, DotSettings style
• Security invariants: TOFU host key verification, key file permissions, in-process passphrase handling, backup/restore, SFTP modes
• Testing guidelines, branch/versioning/commit/PR conventions, CI/release contract (asset names, pinned actions, secrets)
• A "Known quirks" section and a Do/Don't checklist

Testing Performed

• Tested on Windows (Version: _______)
• Tested on macOS (Version: _______)
• Tested on Linux (Version: _______)
• Added unit tests (if applicable)
• Verified no regression in existing functionality (documentation only)

Test Evidence

• Documentation only, no code changes. Claims were cross-checked against the source by independent reviewers, with spot checks (e.g. the duplicate LoggingLevelSwitch registration, the SFTP 700/600 constants, resx key counts).

Questions for Reviewers

• The Known quirks section points out possible issues instead of fixing them: the duplicate LoggingLevelSwitch registration, the stray OpenSSH_GUI.Testss.csproj, the missing de.resx key, outdated CONTRIBUTING.md instructions, and the unpermissioned file creation in FileSystemAnalyzer. Should any of these become their own issues?

---

Notes for Reviewers:

• Priority: low
• Breaking change: no

🤖 Generated with Claude Code