Skip to content

Add CLAUDE.md with repository conventions - #40

Merged
anon5r merged 1 commit into
mainfrom
docs/claude-md
Sep 23, 2026
Merged

anon5r merged 1 commit into
mainfrom
docs/claude-md

Conversation

@anon5r

@anon5r anon5r commented Sep 23, 2026

Copy link
Copy Markdown
Owner

Summary

Adds CLAUDE.md so the conventions and constraints that kept getting re-derived during the .NET 10 migration are written down once.

Contents:

  • Which project is live — the solution still contains both src/KsGameLauncher2 and the deprecated KsGameLauncher, and the deprecated one no longer builds under the current SDK. Worth stating explicitly since the layout alone doesn't make it obvious.
  • Build / test / publish commands — including the detail that publishing needs -r win-x64 on the command line while the rest of the single-file options live in the csproj, and that there is no nuget restore step any more.
  • Testing constraints — why tests stop short of the real Konaste service, plus the two rules that follow from testing a WinForms tray app: [StaFact] rather than [Fact], and never calling the MessageBox-bearing launch paths from a test.
  • Three specific traps that already caused bugs in this repo: appinfo.json path resolution (Save appinfo.json next to the executable instead of the working directory #39), the Microsoft.Web.WebView2 reference that looks unused but is needed for Login issue #29, and the regenerated Settings.Designer.cs that must not be hand-edited.
  • Commit/PR conventions — branch-and-PR rather than direct pushes to main, and no attribution lines on commits or PR descriptions.

Reviewer notes

This file only affects Claude Code sessions; it changes nothing about the build. Note that this PR and its commit already follow the new no-attribution rule.

Records the things that were repeatedly re-derived while working on the
.NET 10 migration, so they do not have to be rediscovered each session:

- which project is live and which is deprecated, since the solution
  still contains both and the deprecated one no longer builds
- the build, test and publish commands, including that publishing needs
  -r win-x64 on the command line while the rest of the options are in
  the csproj
- why tests stop short of the real Konaste service, and the STA/MessageBox
  constraints that follow from testing a WinForms tray app
- three specific traps: appinfo.json path resolution, the WebView2
  reference that looks unused but is needed for #29, and the regenerated
  Settings.Designer.cs

Also sets the commit and PR conventions: branch-and-PR rather than direct
pushes to main, and no attribution lines.
@anon5r anon5r self-assigned this Sep 23, 2026
@anon5r
anon5r merged commit 09bb1e8 into main Sep 23, 2026
2 checks passed
@anon5r
anon5r deleted the docs/claude-md branch September 23, 2026 13:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant