.claude

Imported from cdion/spx (.claude/AGENTS.md). Install upstream with npx skills add cdion/spx --skill .claude. Copyright stays with the author.

Spx Agent Rules

Architecture & Ownership

Dependency Flow

Spx.Nexus.Domain  (pure, no deps)
  └── Spx.Nexus.Simulation
  └── Spx.Contracts (references Nexus.Domain for grain signatures)
        └── Spx.Grains (implements grain interfaces)
Spx.Account.Application (account outcomes + handlers)
Spx.Game.Application (game outcomes + handlers, persistence abstractions)
  └── Spx.Data (EF Core adapters implementing IGamePersistence etc.)
  └── Spx.Grains  (game grains like GamePresenceGrain, LobbyInvalidationGrain)
        └── Spx.Silo (hosts grains)
  └── Spx.Web.Components (shared UI, references Game.Application + Nexus.Domain)
        └── Spx.Web (pages, endpoints, adapters references everything)

Namespace Quirks

• Spx.Web.Components has <RootNamespace>Spx.Web</RootNamespace> — components use using Spx.Web;.
• Spx.Contracts csproj is Spx.Game.Contract.csproj but namespace is Spx.Contracts.
• Spx.Grains csproj is Spx.Game.Grain.csproj but namespace is Spx.Grains.
• All other projects use their directory name as the namespace.

Quick Search Anchors

Orleans Grains (Contracts → Grains)

Application Handlers (Spx.Game.Application)

Account Handlers (Spx.Account.Application)

Persistence Abstractions (Spx.Game.Application → Spx.Data)

EF Core Entities (Spx.Data)

Nexus Domain Types (Spx.Nexus.Domain)

Blazor Pages (Spx.Web/Components/Pages)

Shared Components (Spx.Web.Components/Components)

Web Adapters (Spx.Web/Adapters)

Web Endpoints (Spx.Web/Endpoints)

Handler Patterns

Common Values

Enums (Spx.Game.Application.GameEnums)

Testing

Common Commands

Key Files

• Directory.Build.props — shared MSBuild (AnalysisMode, EnforceCodeStyleInBuild)
• Spx.slnx — solution file
• justfile — imports ci/deploy/infra/dev recipes
• dev.just — development recipes (build, test, run, watch, migrate, coverage)
• NEXUS-PROTOCOL-SPEC.md — protocol spec (read only if asked)
• TESTING.md — testing strategy (refer when adding tests)
• .config/dotnet-tools.json — local tool manifest (csharpier, reportgenerator, dotnet-ef)

Framework Versions

• .NET 10.0 (net10.0)
• Orleans 10.1.0 (Microsoft.Orleans.Core.Abstractions)
• Tailwind CSS v4 (standalone CLI in tools/tailwind/bin/)
• NSubstitute 5.3.0
• bUnit for component tests
• xUnit for all tests
• Testcontainers for integration tests

Available Skills

Use /skill:name for detailed guidance on specific topics: