@polymorphism-tech/morph-spec 2.4.0 → 3.0.1

package/content/.claude/skills/{specialists → level-2-domains/quality}/testing-specialist.md

@@ -1,126 +1,126 @@
-# Testing Specialist
-
-> **Layer:** 2 | **Load:** on-keyword | **Keywords:** test, testing, mock, fake, simulation, unit test, integration test
-
-Especialista em testes, mocking e simulação para projetos .NET.
-
-## Strategy
-
-| Level | What | Tools |
-|-------|------|-------|
-| **Unit** | Business logic, domain, handlers | xUnit + Moq + FluentAssertions |
-| **Integration** | API flows, DB operations | WebApplicationFactory + TestContainers |
-| **Component** | Blazor rendering, events | bUnit |
-| **E2E** | Critical user journeys | Playwright (if needed) |
-
-**Focus:** Critical/complex code. Don't aim for 100%, aim for value. Cover edge cases and error paths.
-
----
-
-## Core Patterns
-
-### AAA (Arrange-Act-Assert)
-
-```csharp
-[Fact]
-public async Task CreateOrder_Should_ReturnSuccess_When_ValidInput()
-{
-    // Arrange
-    var command = new CreateOrderCommand { CustomerId = 1, Items = [...] };
-    var handler = new CreateOrderHandler(_mockRepo.Object);
-    // Act
-    var result = await handler.Handle(command, CancellationToken.None);
-    // Assert
-    result.IsSuccess.Should().BeTrue();
-}
-```
-
-### Naming Convention
-```
-[Method]_Should_[ExpectedResult]_When_[Condition]
-```
-
-### Test Data Builders
-Use builder pattern for complex test entities: `new OrderBuilder().WithCustomer(123).WithStatus(Completed).Build()`
-
-### Mocking (Moq)
-```csharp
-var mockRepo = new Mock<IOrderRepository>();
-mockRepo.Setup(r => r.GetByIdAsync(It.IsAny<int>())).ReturnsAsync(new Order { Id = 1 });
-mockRepo.Verify(r => r.SaveAsync(It.IsAny<Order>()), Times.Once);
-```
-
-### Integration Tests (WebApplicationFactory)
-Replace real DB with in-memory in `ConfigureServices`, use `CreateClient()` for HTTP calls.
-
-### bUnit (Blazor)
-`RenderComponent<Counter>()` → `Find("button").Click()` → assert `TextContent`.
-
----
-
-## Libraries
-
-| Library | Purpose | NuGet |
-|---------|---------|-------|
-| xUnit | Test framework | `xunit` |
-| Moq | Mocking | `Moq` |
-| FluentAssertions | Readable assertions | `FluentAssertions` |
-| Bogus | Fake data | `Bogus` |
-| TestContainers | DB containers | `Testcontainers` |
-| Respawn | DB reset | `Respawn` |
-| WireMock | HTTP mocking | `WireMock.Net` |
-| bUnit | Blazor testing | `bunit` |
-
-## Folder Structure
-
-```
-tests/
-├── Unit/{Domain,Application,Builders}/
-├── Integration/{Api,Fixtures}/
-└── E2E/
-```
-
-## Anti-Patterns
-1. **Fragile tests** — test behavior, not implementation
-2. **Slow tests** — use mocks, not real DB for unit tests
-3. **Coupled tests** — each test independent
-4. **Vague assertions** — use specific FluentAssertions
-5. **Giant setup** — extract to builders/fixtures
-
----
-
-## Simulation of External Services
-
-> **Ref:** `.claude/skills/checklists/simulation-checklist.md` for complete checklist
-
-### Key Rules
-
-| Mock Type | Characteristic | DI Lifetime |
-|-----------|---------------|-------------|
-| **Stateful** (Dictionary, List) | Keeps data between calls | `Singleton` |
-| **Stateless** | No state | `Scoped` |
-
-```csharp
-// ❌ Stateful with Scoped = loses state between requests
-services.AddScoped<IReplicateClient, FakeReplicateClient>();
-// ✅ Stateful with Singleton
-services.AddSingleton<IReplicateClient, FakeReplicateClient>();
-```
-
-**Before implementing mocks:** Map ALL dependencies (interfaces, transitive deps, lifetimes).
-
----
-
-## Checklists
-
-### Per Test Type
-| Target | Test |
-|--------|------|
-| Entity/Domain | Creation validation, state transitions (valid + invalid), invariants |
-| Handler/Service | Happy path, invalid input, not found (404), auth error, timeout |
-| API | Status codes, response body, request validation, auth |
-| Blazor Component | Initial render, user events, states (loading/error/empty), form validation |
-
----
-
-*MORPH-SPEC by Polymorphism Tech*
+# Testing Specialist
+
+> **Layer:** 2 | **Load:** on-keyword | **Keywords:** test, testing, mock, fake, simulation, unit test, integration test
+
+Especialista em testes, mocking e simulação para projetos .NET.
+
+## Strategy
+
+| Level | What | Tools |
+|-------|------|-------|
+| **Unit** | Business logic, domain, handlers | xUnit + Moq + FluentAssertions |
+| **Integration** | API flows, DB operations | WebApplicationFactory + TestContainers |
+| **Component** | Blazor rendering, events | bUnit |
+| **E2E** | Critical user journeys | Playwright (if needed) |
+
+**Focus:** Critical/complex code. Don't aim for 100%, aim for value. Cover edge cases and error paths.
+
+---
+
+## Core Patterns
+
+### AAA (Arrange-Act-Assert)
+
+```csharp
+[Fact]
+public async Task CreateOrder_Should_ReturnSuccess_When_ValidInput()
+{
+    // Arrange
+    var command = new CreateOrderCommand { CustomerId = 1, Items = [...] };
+    var handler = new CreateOrderHandler(_mockRepo.Object);
+    // Act
+    var result = await handler.Handle(command, CancellationToken.None);
+    // Assert
+    result.IsSuccess.Should().BeTrue();
+}
+```
+
+### Naming Convention
+```
+[Method]_Should_[ExpectedResult]_When_[Condition]
+```
+
+### Test Data Builders
+Use builder pattern for complex test entities: `new OrderBuilder().WithCustomer(123).WithStatus(Completed).Build()`
+
+### Mocking (Moq)
+```csharp
+var mockRepo = new Mock<IOrderRepository>();
+mockRepo.Setup(r => r.GetByIdAsync(It.IsAny<int>())).ReturnsAsync(new Order { Id = 1 });
+mockRepo.Verify(r => r.SaveAsync(It.IsAny<Order>()), Times.Once);
+```
+
+### Integration Tests (WebApplicationFactory)
+Replace real DB with in-memory in `ConfigureServices`, use `CreateClient()` for HTTP calls.
+
+### bUnit (Blazor)
+`RenderComponent<Counter>()` → `Find("button").Click()` → assert `TextContent`.
+
+---
+
+## Libraries
+
+| Library | Purpose | NuGet |
+|---------|---------|-------|
+| xUnit | Test framework | `xunit` |
+| Moq | Mocking | `Moq` |
+| FluentAssertions | Readable assertions | `FluentAssertions` |
+| Bogus | Fake data | `Bogus` |
+| TestContainers | DB containers | `Testcontainers` |
+| Respawn | DB reset | `Respawn` |
+| WireMock | HTTP mocking | `WireMock.Net` |
+| bUnit | Blazor testing | `bunit` |
+
+## Folder Structure
+
+```
+tests/
+├── Unit/{Domain,Application,Builders}/
+├── Integration/{Api,Fixtures}/
+└── E2E/
+```
+
+## Anti-Patterns
+1. **Fragile tests** — test behavior, not implementation
+2. **Slow tests** — use mocks, not real DB for unit tests
+3. **Coupled tests** — each test independent
+4. **Vague assertions** — use specific FluentAssertions
+5. **Giant setup** — extract to builders/fixtures
+
+---
+
+## Simulation of External Services
+
+> **Ref:** `.claude/skills/checklists/simulation-checklist.md` for complete checklist
+
+### Key Rules
+
+| Mock Type | Characteristic | DI Lifetime |
+|-----------|---------------|-------------|
+| **Stateful** (Dictionary, List) | Keeps data between calls | `Singleton` |
+| **Stateless** | No state | `Scoped` |
+
+```csharp
+// ❌ Stateful with Scoped = loses state between requests
+services.AddScoped<IReplicateClient, FakeReplicateClient>();
+// ✅ Stateful with Singleton
+services.AddSingleton<IReplicateClient, FakeReplicateClient>();
+```
+
+**Before implementing mocks:** Map ALL dependencies (interfaces, transitive deps, lifetimes).
+
+---
+
+## Checklists
+
+### Per Test Type
+| Target | Test |
+|--------|------|
+| Entity/Domain | Creation validation, state transitions (valid + invalid), invariants |
+| Handler/Service | Happy path, invalid input, not found (404), auth error, timeout |
+| API | Status codes, response body, request validation, auth |
+| Blazor Component | Initial render, user events, states (loading/error/empty), form validation |
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/content/.claude/skills/level-3-technologies/README.md

@@ -0,0 +1,7 @@
+# Level 3: Technologies
+
+Technology-specific implementation patterns.
+
+**Purpose:** Skills for specific technologies (EF Core, Blazor, Hangfire, SignalR, etc.).
+
+**To be populated in Phase 8/9.**

package/content/.claude/skills/level-4-patterns/README.md

@@ -0,0 +1,7 @@
+# Level 4: Patterns
+
+Architectural and design patterns.
+
+**Purpose:** Skills for specific patterns (CQRS, Event Sourcing, DDD, Repository, etc.).
+
+**To be populated later.**