klod68/gen-global-usings

name: gen-global-usings description: "Use when setting up or cleaning up global using directives for a project. Generates a categorized GlobalUsings.cs based on the project's NuGet dependencies and internal namespaces, with section comments. Also invoke when the user mentions: global usings, add GlobalUsings.cs, organize usings, implicit usings. Domain: Code Generation. Level: Beginner."

Generate a GlobalUsings.cs for the project: ${1:ProjectName}.

Context

• Project type: ${2|Library,Web App / API,Console,Test project|}
• Test framework (if test project): ${3|xUnit + FluentAssertions + Moq,MSTest,NUnit + FluentAssertions + Moq,N/A|}
• Referenced NuGet packages: ${4:e.g. Microsoft.Extensions.Logging, Polly, FluentValidation}
• Referenced projects: ${5:e.g. MyApp.Domain, MyApp.Application}
• Key internal namespaces used across 3+ files: ${6:e.g. MyApp.Domain.Entities, MyApp.Application.Services}

Output format

// ============================================================================
// Global Usings — ${1}
// ============================================================================

// ── System ──────────────────────────────────────────────────────────────────
// Include System.* namespaces used in 3+ files

// ── Microsoft Extensions ────────────────────────────────────────────────────
// DI, Logging, Configuration, Options — include with one-line comment

// ── Third-Party Libraries ───────────────────────────────────────────────────
// External NuGet packages — include library name and purpose

// ── Project — ${1} ─────────────────────────────────────────────────────────
// Internal namespaces used across multiple files

// ── Project References ──────────────────────────────────────────────────────
// Namespaces from referenced projects/packages

For test projects, prepend a test framework block:

xUnit + FluentAssertions + Moq:

// ── Test Frameworks ─────────────────────────────────────────────────────────
global using Xunit;
global using FluentAssertions;
global using Moq;

MSTest:

// ── Test Frameworks ─────────────────────────────────────────────────────────
global using Microsoft.VisualStudio.TestTools.UnitTesting;

NUnit + FluentAssertions + Moq:

// ── Test Frameworks ─────────────────────────────────────────────────────────
global using NUnit.Framework;
global using FluentAssertions;
global using Moq;

Rules

• Include a namespace only if it is used in 3 or more files — rare usings stay local
• Every section has a // ── Section Name ── header
• Every global using line has an inline comment explaining what it provides (e.g., // ILogger<T>, LogLevel or // ArgumentNullException.ThrowIfNull)
• Sections are separated by a blank line
• Within each section, sort alphabetically
• Do not include the project's own root namespace (it is already implicit)
• Scan GlobalUsings.cs if it already exists — extend it, don't replace valid entries

Constraints

• Follow all rules in the workspace root instruction file
• File-scoped namespace is NOT used in GlobalUsings.cs — no namespace declaration
• Do not add global using static unless the project already uses that pattern
• Do not remove any existing global using that is already present