Skip to content

docs: add Cursor Cloud specific instructions to AGENTS.md#73

Draft
kploch wants to merge 1 commit intomainfrom
cursor/development-environment-setup-5cec
Draft

docs: add Cursor Cloud specific instructions to AGENTS.md#73
kploch wants to merge 1 commit intomainfrom
cursor/development-environment-setup-5cec

Conversation

@kploch
Copy link
Copy Markdown
Contributor

@kploch kploch commented Mar 31, 2026

Describe your changes

Adds a ## Cursor Cloud specific instructions section to AGENTS.md with development environment setup guidance for cloud agents, including:

  • Overview of the Ploch.Data library suite
  • Required sibling repository documentation (mrploch-development, ploch-common)
  • Build, test, and run commands using Debug mode with UsePlochProjectReferences=true
  • Known gotchas (NBGV shallow clone errors, duplicate MSBuild import warnings, skipped SQL Server test, no global.json, GitHub Packages NuGet auth)

Issue ticket number and link

N/A — development environment setup

Checklist before requesting a review

  • I have performed a self-review of my code
  • If it is a core feature, I have added thorough tests.
  • Do we need to implement analytics?
  • Will this be part of a product update? If yes, please write one phrase about this update.
Open in Web Open in Cursor 

Co-authored-by: Krzysztof Ploch <kploch@users.noreply.github.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 31, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f3c97459-ca35-41b9-9723-a55e84960242

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor/development-environment-setup-5cec

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a 'Cursor Cloud specific instructions' section to AGENTS.md, providing an overview of the Ploch.Data library, required sibling repositories, and standardized build, test, and run commands. The review feedback suggests including the -p:UsePlochProjectReferences=true property in the dotnet run command for consistency and updating the 'No global.json' heading to accurately reflect that the file exists but is not used for SDK pinning.

Comment thread AGENTS.md
dotnet restore ./Ploch.Data.slnx -p:UsePlochProjectReferences=true
dotnet build ./Ploch.Data.slnx --no-restore -p:UsePlochProjectReferences=true
dotnet test ./Ploch.Data.slnx --no-build -p:UsePlochProjectReferences=true
dotnet run --project samples/SampleApp/src/ConsoleApp/Ploch.Data.SampleApp.ConsoleApp.csproj --no-build
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

To maintain consistency with the previous commands and the statement that all commands use UsePlochProjectReferences=true, it is recommended to include this property in the dotnet run command as well. This ensures that if the --no-build flag is removed, the command still functions as intended with project references.

Suggested change
dotnet run --project samples/SampleApp/src/ConsoleApp/Ploch.Data.SampleApp.ConsoleApp.csproj --no-build
dotnet run --project samples/SampleApp/src/ConsoleApp/Ploch.Data.SampleApp.ConsoleApp.csproj --no-build -p:UsePlochProjectReferences=true

Comment thread AGENTS.md
- **NBGV shallow clone error**: If the build fails with `Shallow clone lacks the objects required to calculate version height`, the `ploch-common` repo needs `git fetch --unshallow`.
- **Duplicate import warning (MSB4011)**: `Ploch.Packages.props` is imported twice in `Directory.Packages.props`. This is a known non-blocking warning in the repo.
- **SQL Server test skipped**: `Data.EFCore.SqlServer.Tests` has one test explicitly skipped (`[Fact(Skip = ...)]`). No Docker/SQL Server setup is needed.
- **No `global.json`**: The repo does not pin SDK versions via `global.json`. The update script installs both .NET 8.0 and 10.0 SDKs.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The heading No global.json is misleading because a global.json file is present in the repository (as seen in Ploch.Data.slnx, line 102). It would be more accurate to state that the file exists but is not used for SDK pinning.

Suggested change
- **No `global.json`**: The repo does not pin SDK versions via `global.json`. The update script installs both .NET 8.0 and 10.0 SDKs.
- **global.json usage**: The repository contains a global.json file, but it does not pin specific SDK versions. The update script installs both .NET 8.0 and 10.0 SDKs.

@sonarqubecloud
Copy link
Copy Markdown

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.

2 participants