К основному содержанию
правило CX Codex

solution-management — правило для Cursor и Claude Code

Правило solution-management задаёт стандарты организации решений .NET: фиксирует версии SDK, общие свойства сборки и централизованное управление NuGet-пакетами.

Apache-2.0 ★ 138 обновлён 2025-03-29

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/solution-management.mdc
Открыть на GitHub

Что делает solution-management

Правило настраивает поведение ассистента в контексте решений на C# и F#. Инструкции активируются при работе с файлами .sln, .csproj, .fsproj, global.json или конфигурациями Directory.Build.props и Directory.Package.props.

Внутри заложены шаблоны для global.json с политикой rollForward: patch, централизованный контроль зависимостей через Directory.Packages.props с параметром ManagePackageVersionsCentrally, а также безопасная настройка nuget.config с маппингом источников. При сборке через CLI агент будет использовать детерминированные флаги (/p:ContinuousIntegrationBuild=true) и строгий режим TreatWarningsAsErrors.

Правило требует дисциплины в версионировании: если проект не готов к трактовке предупреждений как ошибок, сборка упадёт сразу.

Какие задачи решает

  • настроить централизованное управление зависимостями в .NET
  • зафиксировать версию .NET SDK через global.json с rollForward
  • вынести метаданные и общие параметры сборки в Directory.Build.props
  • включить маппинг источников в nuget.config

Примеры запросов агенту

  • Переведи солюшен на централизованное управление пакетами через Directory.Packages.props
  • Создай global.json для .NET 8 с политикой обновления патчей
  • Настрой Directory.Build.props со строгой обработкой предупреждений как ошибок

Как установить solution-management

Вручную: положить файлы

.cursor/rules/solution-management.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о solution-management

Как установить solution-management в Cursor?

Сохраните файл правила по пути .cursor/rules/solution-management.mdc в корне вашего проекта.

Как установить solution-management в Claude Code?

Поместите файл с текстом правила в директорию проекта по пути .claude/rules/solution-management.md.

Для каких файлов срабатывает это правило?

В Cursor оно активируется при открытии файлов по маске: *.sln, global.json, Directory.Build.props, Directory.Package.props, *.csproj и *.fsproj.

Исходный текст

solution-management.mdc · Apache-2.0
---
description: This file provides guidelines for maintaining .NET solutions with consistent SDK versions, shared metadata, and centralized package management.
globs: *.sln, global.json, Directory.Build.props, Directory.Package.props, *.csproj, *.fsproj
alwaysApply: false
---

# Cursor Rules File: Best Practices for .NET Solution Management

Role Definition:
 - .NET Solution Architect
 - Build System Expert
 - Package Management Specialist

General:
  Description: >
    .NET solutions must be configured with explicit SDK versioning, shared build properties,
    and centralized package management to ensure consistency, maintainability, and security
    across all projects within the solution.
  Requirements:
    - Maintain a global.json for SDK version control
    - Use Directory.Build.props for shared metadata
    - Implement centralized package management
    - Configure secure and reliable package sources

SDK Version Management:
  - Maintain a global.json file in the solution root:
      - Specify exact SDK version to ensure consistent builds
      - Include rollForward policy for patch version flexibility
      - Example:
        ```json
        {
          "sdk": {
            "version": "8.0.100",
            "rollForward": "patch"
          }
        }
        ```
  - Update SDK versions through controlled processes:
      - Test new SDK versions in development/CI before updating
      - Document SDK version changes in source control
      - Consider implications for CI/CD pipelines

Shared Build Properties:
  - Implement Directory.Build.props in solution root:
      - Define common metadata:
          - Company/Author information
          - Copyright details
          - Project URL
          - License information
          - Version prefix/suffix strategy
      - Example structure:
        ```xml
        <Project>
          <PropertyGroup>
            <Authors>Your Company</Authors>
            <Company>Your Company</Company>
            <Copyright>© $([System.DateTime]::Now.Year) Your Company</Copyright>
            <PackageLicenseExpression>MIT</PackageLicenseExpression>
            <PackageProjectUrl>https://github.com/your/project</PackageProjectUrl>
            <VersionPrefix>1.0.0</VersionPrefix>
          </PropertyGroup>
        </Project>
        ```
  - Consider environment-specific overrides:
      - Use Directory.Build.targets for overrides
      - Support CI/CD pipeline customization

Package Management:
  - Enable centralized package management:
      - Create Directory.Packages.props:
          - Define package versions once
          - Enforce consistent versions across projects
          - Example:
            ```xml
            <Project>
              <PropertyGroup>
                <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
              </PropertyGroup>
              <ItemGroup>
                <PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
              </ItemGroup>
            </Project>
            ```
  - Configure nuget.config:
      - Enable package source mapping
      - Define trusted package sources
      - Example:
        ```xml
        <?xml version="1.0" encoding="utf-8"?>
        <configuration>
          <packageSourceMapping>
            <packageSource key="nuget.org">
              <package pattern="*" />
            </packageSource>
          </packageSourceMapping>
          <packageSources>
            <clear />
            <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
          </packageSources>
        </configuration>
        ```

Maintenance:
  - Regular auditing:
      - Review SDK versions for security updates
      - Validate package versions for vulnerabilities
      - Update shared metadata as needed
  - Version control:
      - Commit all configuration files
      - Document changes in commit messages
      - Consider using git hooks for validation

Compilation:
  - Use dotnet CLI for builds:
      - Prefer `dotnet build` over IDE builds for consistency
      - Use `dotnet build -c Release` for release builds
      - Enable deterministic builds with `/p:ContinuousIntegrationBuild=true`
  - Enforce code quality:
      - Enable `TreatWarningsAsErrors` in Directory.Build.props:
        ```xml
        <PropertyGroup>
          <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
          <!-- Optionally allow specific warnings -->
          <WarningsNotAsErrors>CS1591</WarningsNotAsErrors>
        </PropertyGroup>
        ```
      - Address warnings properly:
          - Fix the underlying issue rather than suppressing
          - Document any necessary warning suppressions
          - Use `#pragma warning disable` sparingly and only with comments
  - Build configuration:
      - Use conditional compilation symbols purposefully
      - Define debug/release-specific behavior clearly
      - Example:
        ```xml
        <PropertyGroup>
          <DefineConstants>TRACE</DefineConstants>
          <DefineConstants Condition="'$(Configuration)'=='Debug'">$(DefineConstants);DEBUG</DefineConstants>
        </PropertyGroup>
        ```
  - Performance:
      - Enable incremental builds by default
      - Use `dotnet build --no-incremental` only when needed
      - Consider using Fast Up-to-Date Check:
        ```xml
        <PropertyGroup>
          <DisableFastUpToDateCheck>false</DisableFastUpToDateCheck>
        </PropertyGroup>
        ```
  - Build output:
      - Set consistent output paths
      - Configure deterministic output:
        ```xml
        <PropertyGroup>
          <Deterministic>true</Deterministic>
          <ContinuousIntegrationBuild Condition="'$(GITHUB_ACTIONS)' == 'true'">true</ContinuousIntegrationBuild>
        </PropertyGroup>
        ```
  - Error handling:
      - Log build errors comprehensively
      - Use MSBuild binary log for detailed diagnostics:
        ```bash
        dotnet build -bl:build.binlog
        ```
      - Configure error reporting in CI/CD:
        ```yaml
        - name: Build
          run: dotnet build --configuration Release /p:ContinuousIntegrationBuild=true
          env:
            DOTNET_CLI_TELEMETRY_OPTOUT: 1
            DOTNET_NOLOGO: 1
        ```

# End of Cursor Rules File 

© Aaronontheweb · Apache-2.0 · Aaronontheweb/dotnet-cursor-rules

Похожие правила IDE

Все правила IDE по теме «Бэкенд и API» →
check-bin-obj-clash dotnet Скилл check-bin-obj-clash для Claude Code и ещё пяти платформ находит конфликты путей OutputPath и IntermediateOutputPath в проектах MSBuild. Разбирает гонки записи файлов и сбои параллельной сборки .NET. CX Codex +1 4 500установок msbuild-antipatterns dotnet Скилл msbuild-antipatterns для Claude Code находит антипаттерны в проектах MSBuild и проверяет таргеты на ошибки. Он анализирует файлы .csproj и .fsproj без автоматической правки кода. CX Codex +1 5 000установок project-structure codewithmukesh Скилл project-structure задаёт агенту правила раскладки .NET-решения: центральные версии пакетов, общие свойства сборки, формат .slnx и именование проектов. CX Codex +1 4 000установок dotnet-project-structure Aaronontheweb Скилл dotnet-project-structure подсказывает агенту, как разложить .NET-решение: .slnx, Directory.Build.props, центральные версии пакетов и SourceLink. CX Codex +1 706установок dotnet-framework официальный github Правило dotnet-framework для GitHub Copilot задаёт рамки работы с проектами .NET Framework: сборка через msbuild, структура legacy .csproj, ограничение языка C# 7.3. CX Codex +1 ★ 41 430звёзд репо package-management Aaronontheweb Скилл package-management для Claude Code управляет пакетами NuGet через команды dotnet. Он включается при добавлении, удалении и обновлении пакетов или настройке CPM. CX Codex +1 623установок

Из того же набора11

Весь набор →
publishing-dotnettool Правило publishing-dotnettool для Claude Code и Cursor направляет ИИ-агента при создании и публикации dotnet-инструментов в NuGet. Гарантирует семантическое версионирование, правильную упаковку и совместимость с разными версиями .NET. CX Codex +1 ★ 138звёзд репо code-signing Правило code-signing задаёт стандарты подписи сборок и пакетов NuGet через SignClient в проектах на .NET. Применяется при настройке CI/CD. CX Codex +1 ★ 138звёзд репо consuming-dotnettool Правило consuming-dotnettool для Claude Code организует локальные .NET-инструменты через manifest-файл, фиксирует версии и добавляет их восстановление в CI/CD. CX Codex +1 ★ 138звёзд репо dependency-management Правило dependency-management для безопасного управления NuGet-зависимостями: проверка уязвимостей, совместимость лицензий, версионирование через dotnet CLI. Применяется к файлам проекта автоматически. CX Codex +1 ★ 138звёзд репо benchmarking Правило benchmarking для Claude Code учит агента писать корректные тесты производительности .NET через BenchmarkDotNet. Тесты измеряют скорость кода и отслеживают регрессии. CX Codex +1 ★ 138звёзд репо nuget-package-publishing Правило nuget-package-publishing, которое учит агента упаковывать .NET-библиотеки в NuGet по стандартам: с SPDX-лицензией, README и символами для отладки. CX Codex +1 ★ 138звёзд репо testing Правило testing задаёт стандарты написания тестов на C# с xUnit: настройку .NET 8 проектов, фикстуры, проверку покрытия кода и запуск интеграционных тестов. CX Codex +1 ★ 138звёзд репо coding-style Правило coding-style задаёт рекомендации по структуре и стилю C#-кода: от типов данных до обработки ошибок. Оно пригодится, если вы хотите, чтобы агент придерживался функциональных паттернов и простых абстракций. CX Codex +1 ★ 138звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой