TimeWarpEngineering · StevenTCramer · Jul 29, 2026 · Jul 29, 2026 · Jul 29, 2026 · Jul 29, 2026
diff --git a/Directory.Build.props b/Directory.Build.props
@@ -17,9 +17,6 @@
     <!-- Output packages to our local feed directory -->
     <PackageOutputPath>$(PackagesDirectory)</PackageOutputPath>
 
-    <!-- Use local NuGet cache instead of global -->
-    <RestorePackagesPath>$(RepositoryRoot).nuget-cache/</RestorePackagesPath>
-
     <!-- Suppress .NET preview SDK message -->
     <SuppressNETCoreSdkPreviewMessage>true</SuppressNETCoreSdkPreviewMessage>
   </PropertyGroup>

diff --git a/_ai/Index.md b/_ai/Index.md
diff --git a/_ai/ai-instructions.md b/_ai/ai-instructions.md
diff --git a/_ai/csharp-coding-standards.md b/_ai/csharp-coding-standards.md
diff --git a/_ai/dotnet-conventions.md b/_ai/dotnet-conventions.md
diff --git a/_ai/environment.md b/_ai/environment.md
diff --git a/_ai/nugets.md b/_ai/nugets.md
diff --git a/_ai/project-structure.md b/_ai/project-structure.md
diff --git a/_ai/references.md b/_ai/references.md
diff --git a/_ai/shell-commands.md b/_ai/shell-commands.md
diff --git a/_ai/tools.md b/_ai/tools.md
diff --git a/documentation/developer/how-to-guides/configure-file-name-analyzer.md b/documentation/developer/how-to-guides/configure-file-name-analyzer.md
@@ -58,6 +58,20 @@ Rename files to kebab-case:
 - `UserService.cs` → `user-service.cs`
 - `IDataProcessor.cs` → `i-data-processor.cs`
 
+**Multi-dot partials** (e.g. state/action files) are valid when **every** segment is kebab-case.
+Only rename non-kebab segments; do not collapse multi-dot names into a single stem:
+
+| Invalid | Valid |
+|---------|--------|
+| `ApplicationState.CloseModal.cs` | `application-state.close-modal.cs` |
+| `application-state.CloseModal.cs` | `application-state.close-modal.cs` |
+| `application_state.close_modal.cs` | `application-state.close-modal.cs` |
+
+Valid multi-dot examples (no rename needed):
+- `application-state.close-modal.cs`
+- `counter-state.increment-counter.cs`
+- `weather-forecasts-state.fetch-weather-forecasts.cs`
+
 ## Troubleshooting
 
 ### Too Many Violations

diff --git a/documentation/developer/reference/analyzers/file-name-rule-analyzer.md b/documentation/developer/reference/analyzers/file-name-rule-analyzer.md
@@ -9,7 +9,7 @@ The FileNameRuleAnalyzer enforces kebab-case naming conventions for C# source fi
 - **Rule ID**: TW0001
 - **Category**: Naming
 - **Default Severity**: Info (disabled by default)
-- **Message**: File '{0}' should use kebab-case naming convention (e.g., 'my-file.cs')
+- **Message**: File '{0}' should use kebab-case naming convention (e.g., 'my-file.cs' or 'my-type.my-partial.cs')
 
 > **Diagnostic ID (SSOT):** This rule is **TW0001** from TimeWarp.SourceGenerators. It is **not** a TimeWarp Architecture analyzer (`TWA*`). Do **not** enable or suppress it with `TWA001` / `dotnet_diagnostic.TWA001.*` — use `dotnet_diagnostic.TW0001.*` and `#pragma warning disable TW0001`.
 
@@ -21,19 +21,33 @@ Valid kebab-case file names must:
 - Separate words with hyphens (-)
 - Not contain consecutive hyphens
 - End with `.cs` extension
+- **Multi-dot basenames** are allowed when **every** segment between dots is itself kebab-case
+  (common for partials such as state/action files)
+
+Pattern (conceptual):
+
+```text
+^[a-z][a-z0-9]*(?:-[a-z0-9]+)*(?:\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*)*\.cs$
+```
 
 ### Valid Examples
 - `user-service.cs`
 - `data-processor.cs`
 - `my-component.cs`
 - `api-client-v2.cs`
+- `application-state.close-modal.cs` (multi-dot partial)
+- `counter-state.increment-counter.cs` (multi-dot partial)
+- `weather-forecasts-state.fetch-weather-forecasts.cs` (multi-dot partial)
 
 ### Invalid Examples
 - `UserService.cs` (PascalCase)
 - `userService.cs` (camelCase)
 - `user_service.cs` (snake_case)
 - `user--service.cs` (consecutive hyphens)
 - `-user-service.cs` (starts with hyphen)
+- `ApplicationState.CloseModal.cs` (Pascal multi-dot)
+- `application-state.CloseModal.cs` (mixed multi-dot; one Pascal segment)
+- `application_state.close_modal.cs` (snake_case segments)
 
 ## Configuration
 

diff --git a/documentation/developer/reference/analyzers/overview.md b/documentation/developer/reference/analyzers/overview.md
@@ -6,7 +6,7 @@ All analyzer diagnostic IDs from this package use the **TW** prefix (e.g. **TW00
 
 ### TW0001 - File Name Rule Analyzer
 
-Enforces kebab-case naming convention for C# source files.
+Enforces kebab-case naming convention for C# source files (including multi-segment kebab basenames such as `application-state.close-modal.cs`).
 
 - **Rule ID**: TW0001
 - **Category**: Naming