Update CLAUDE.md with project guidance#2358
Conversation
Replace minimal MCP server note with full developer guidance including build/test commands, architecture overview, code conventions, and multi-targeting notes. Uses .slnx solution format with a note about net8.0 incompatibility requiring project-level test runs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Review Summary by QodoAdd comprehensive developer guidance to CLAUDE.md
WalkthroughsDescription• Replace minimal MCP note with comprehensive developer guidance • Document build, test, and pack commands using .slnx format • Add detailed architecture overview and core class descriptions • Include multi-targeting strategy, code conventions, and testing stack Diagramflowchart LR
A["Minimal CLAUDE.md<br/>MCP note only"] -->|Replace with| B["Comprehensive CLAUDE.md"]
B --> C["Build & Test<br/>Commands"]
B --> D["Project Overview<br/>& Architecture"]
B --> E["Code Conventions<br/>& Testing Stack"]
C --> F["dotnet build/test<br/>with .slnx"]
D --> G["Core classes &<br/>Request pipeline"]
E --> H["Multi-targeting &<br/>Code style"]
File Changes1. CLAUDE.md
|
Code Review by Qodo
1.
|
Deploying restsharp with
|
| Latest commit: |
a57c1ec
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://4c3e0e17.restsharp.pages.dev |
| Branch Preview URL: | https://update-claude-md.restsharp.pages.dev |
| # Run all tests | ||
| dotnet test RestSharp.slnx -c Debug | ||
|
|
||
| # Run tests for a specific TFM | ||
| dotnet test RestSharp.slnx -f net9.0 | ||
|
|
||
| # Run a single test by fully-qualified name | ||
| dotnet test test/RestSharp.Tests/RestSharp.Tests.csproj --filter "FullyQualifiedName=RestSharp.Tests.ObjectParserTests.ShouldUseRequestProperty" -f net8.0 | ||
|
|
||
| # Pack | ||
| dotnet pack src/RestSharp/RestSharp.csproj -c Release -o nuget -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg | ||
| ``` | ||
|
|
||
| **Note:** `dotnet test` with `.slnx` does not work with `net8.0`. To run tests targeting `net8.0`, use individual project files: `dotnet test test/RestSharp.Tests/RestSharp.Tests.csproj -f net8.0` |
There was a problem hiding this comment.
2. Slnx/net8 test guidance conflict 🐞 Bug ⛯ Reliability
CLAUDE.md recommends dotnet test RestSharp.slnx -c Debug (“Run all tests”), but also states dotnet test with .slnx does not work with net8.0. Since the .slnx includes test projects that multi-target net8.0, the guidance is internally inconsistent/ambiguous and likely to confuse or send users into a failing workflow.
Agent Prompt
### Issue description
`CLAUDE.md` currently recommends running all tests via `dotnet test RestSharp.slnx -c Debug` while also stating `.slnx` tests don’t work with `net8.0`. Because test projects in the `.slnx` multi-target `net8.0`, this is contradictory/ambiguous guidance.
### Issue Context
The `.slnx` includes test projects and the shared test props multi-target `net8.0`, so the doc should clearly communicate a working set of commands (and precisely what combination is known to fail).
### Fix Focus Areas
- CLAUDE.md[7-25]
ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools
Test Results 42 files 42 suites 17m 48s ⏱️ Results for commit d7820fc. |
RestResponse types have public setters on all properties. Remove the incorrect "immutable" label and clarify what [GenerateClone] actually does. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|



Summary
.slnxsolution formatdotnet testwith.slnxdoes not work withnet8.0(use project files instead)Fixes #2359
🤖 Generated with Claude Code