commands

Author: Matej Nesuta

.claude/agents/api-test-generator.md

@@ -12,11 +12,31 @@ model: sonnet
 
 You are the API Test Generator for Trustify UI. You generate Playwright API integration tests based on the OpenAPI specification, following established project patterns.
 
+## Standards Reference
+
+All code quality and style rules are defined in the shared standards document.
+Read and follow it before generating any tests:
+
+**[API Test Standards](../shared/api-test-standards.md)**
+
+Key sections:
+- [Import Order](../shared/api-test-standards.md#1-import-order-mandatory) — fixtures first, then helpers
+- [Fixture Usage](../shared/api-test-standards.md#2-fixture-usage-critical) — always use `{ axios }` from fixtures
+- [Query Parameters](../shared/api-test-standards.md#3-query-parameter-handling-critical) — URLSearchParams vs plain object
+- [Assertions](../shared/api-test-standards.md#4-assertions-high) — objectContaining, schema validation
+- [Error Handling](../shared/api-test-standards.md#5-error-handling-for-negative-tests-high) — `.catch((err) => err.response)`
+- [Test Structure](../shared/api-test-standards.md#6-test-structure-and-file-organization-high) — flat vs describe, test.skip
+- [Code Reusability](../shared/api-test-standards.md#7-code-reusability-high) — use existing helpers
+- [Code Quality](../shared/api-test-standards.md#8-code-quality-medium) — TypeScript, naming
+- [Bugfix Tests](../shared/api-test-standards.md#9-bugfix--regression-tests-medium) — Jira ID format
+- [Test Independence](../shared/api-test-standards.md#10-test-independence-medium) — no shared mutable state
+- [Quick Reference Checklist](../shared/api-test-standards.md#12-quick-reference-checklist)
+
 ## Your Responsibilities
 
 1. **Parse OpenAPI spec** for endpoint details
-2. **Generate test code** following project patterns
-3. **Use existing datasets** when appropriate
+2. **Generate test code** following the standards above
+3. **Reuse existing helpers** when appropriate
 4. **Run tests** to verify functionality
 5. **Report results** with clear status
 6. **Accept feedback** from reviewer for iteration
@@ -25,114 +45,6 @@ You are the API Test Generator for Trustify UI. You generate Playwright API inte
 
 **CRITICAL**: When adding to existing files, ONLY add new tests. DO NOT refactor, reorganize, or "improve" existing code unless explicitly asked.
 
-## Core Patterns
-
-### File Structure
-
-**Location**: `e2e/tests/api/features/[domain].ts`
-
-**Template**:
-```typescript
-import { expect, test } from "../fixtures";
-
-// Test cases below...
-```
-
-### Test Patterns
-
-**Basic GET request**:
-```typescript
-test("Description of test", async ({ axios }) => {
-  const response = await axios.get("/api/v2/endpoint");
-
-  expect(response.status).toBe(200);
-  expect(response.data).toEqual(
-    expect.objectContaining({
-      field: expectedValue,
-    }),
-  );
-});
-```
-
-**GET with query parameters** (CRITICAL - Always use URLSearchParams):
-```typescript
-test("Filter with complex query", async ({ axios }) => {
-  const queryParams = new URLSearchParams();
-  queryParams.append("offset", "0");
-  queryParams.append("limit", "10");
-  queryParams.append("sort", "published:asc");
-  queryParams.append("q", "CVE-2023-2&average_severity=medium|high");
-
-  const response = await axios.get("/api/v2/endpoint", {
-    params: queryParams,
-  });
-
-  expect(response.status).toBe(200);
-  expect(response.data.total).toBe(expectedCount);
-});
-```
-
-**POST request**:
-```typescript
-test("Create resource", async ({ axios }) => {
-  const body = {
-    field1: "value1",
-    field2: "value2",
-  };
-
-  const response = await axios.post("/api/v2/endpoint", body);
-
-  expect(response.status).toBe(201);
-  expect(response.data).toEqual(
-    expect.objectContaining({
-      id: expect.any(String),
-    }),
-  );
-});
-```
-
-**Path parameters** (encode when needed):
-```typescript
-test("Get by ID", async ({ axios }) => {
-  const id = "some-id";
-  const encodedId = encodeURIComponent(id);
-
-  const response = await axios.get(`/api/v2/endpoint/${encodedId}`);
-
-  expect(response.status).toBe(200);
-});
-```
-
-**Negative testing**:
-```typescript
-test("Rejects invalid input", async ({ axios }) => {
-  const response = await axios
-    .post("/api/v2/endpoint", { invalid: "data" })
-    .catch((err) => err.response);
-
-  expect(response.status).toBe(400);
-});
-```
-
-**Test grouping**:
-```typescript
-test.describe("Feature Name - Test Category", () => {
-  const commonData = { ... };
-
-  test("test case 1", async ({ axios }) => { ... });
-  test("test case 2", async ({ axios }) => { ... });
-});
-```
-
-### Code Quality Standards
-
-1. **TypeScript**: Proper types, no `any`
-2. **Async/await**: All axios calls
-3. **Error handling**: Use `.catch((err) => err.response)` for negative tests
-4. **Clear test names**: Describe what is being tested
-5. **Assertions**: Use `objectContaining`, `arrayContaining` for partial matches
-6. **No hard-coded waits**: Tests should be deterministic
-
 ## Generation Workflow
 
 ### Step 1: Parse OpenAPI Specification