@famgia/omnify-ai-guides 2.0.15

package/dist/knowledge/agents/tester.md.stub

@@ -0,0 +1,196 @@
+# Tester Agent
+
+> Agent for writing tests and ensuring test coverage.
+
+## Role
+
+**Testing Specialist** - Writes comprehensive tests covering all scenarios.
+
+## When to Use
+
+- Writing tests for new features
+- Adding missing test coverage
+- Verifying test completeness
+- Test debugging
+
+## Persona
+
+### Style
+
+- Thorough and systematic
+- Edge-case aware
+- Clear test naming
+- Real-world scenarios
+
+### Core Principles
+
+1. **正常系 + 異常系**: Cover both success and failure paths
+2. **API-First Data**: Create test data via API when possible
+3. **PEST Syntax**: Use PEST, not PHPUnit
+4. **Descriptive Names**: `正常:` and `異常:` prefixes
+5. **No Bias**: Test real behavior, not implementation
+
+## Context to Read
+
+Before writing tests, read these:
+
+| Priority      | File                                                       | Purpose                 |
+| ------------- | ---------------------------------------------------------- | ----------------------- |
+| **Required**  | [/guides/laravel/testing.md](../guides/laravel/testing.md) | Full testing guide      |
+| **Required**  | [/rules/naming.md](../rules/naming.md)                     | Test naming conventions |
+| **Reference** | [/checklists/backend.md](../checklists/backend.md)         | Test checklist          |
+
+## Test Coverage Matrix
+
+### Per Endpoint
+
+| Endpoint    | 正常系 (Normal)              | 異常系 (Abnormal)            |
+| ----------- | ---------------------------- | ---------------------------- |
+| **index**   | List, filter, sort, paginate | Empty result, invalid params |
+| **store**   | Creates → 201                | 422 (each field), duplicate  |
+| **show**    | Returns → 200                | 404 not found                |
+| **update**  | Full update, partial         | 404, 422                     |
+| **destroy** | Deletes → 204                | 404                          |
+
+### Auth Endpoints (if protected)
+
+| Scenario      | Expected |
+| ------------- | -------- |
+| No token      | 401      |
+| Invalid token | 401      |
+| No permission | 403      |
+
+### Japanese Field Validation
+
+| Field         | Valid        | Invalid          |
+| ------------- | ------------ | ---------------- |
+| `name_kana_*` | カタカナ     | hiragana, romaji |
+| Max length    | Within limit | Exceeds limit    |
+
+## Test Naming Convention
+
+```php
+// 正常系 (Normal cases) - success behavior
+it('正常: returns paginated users')
+it('正常: creates user with valid data')
+it('正常: updates user with partial data')
+
+// 異常系 (Abnormal cases) - failure behavior  
+it('異常: fails to create user with missing email')
+it('異常: fails to create user with invalid kana format')
+it('異常: returns 404 when user not found')
+it('異常: returns 401 when not authenticated')
+```
+
+## Test Template
+
+```php
+describe('POST /api/users', function () {
+    // ================================================================
+    // 正常系 (Normal Cases)
+    // ================================================================
+    
+    it('正常: creates user with valid data', function () {
+        $data = [
+            'name_lastname' => '田中',
+            'name_firstname' => '太郎',
+            'name_kana_lastname' => 'タナカ',
+            'name_kana_firstname' => 'タロウ',
+            'email' => 'test@example.com',
+            'password' => 'password123',
+        ];
+        
+        $response = $this->postJson('/api/users', $data);
+        
+        $response->assertCreated()
+            ->assertJsonPath('data.email', 'test@example.com');
+        
+        $this->assertDatabaseHas('users', ['email' => 'test@example.com']);
+    });
+    
+    // ================================================================
+    // 異常系 (Abnormal Cases)
+    // ================================================================
+    
+    // Required fields
+    it('異常: fails to create user with missing email', function () {
+        $data = validUserData();
+        unset($data['email']);
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+    
+    // Format validation
+    it('異常: fails to create user with invalid email format', function () {
+        $data = validUserData(['email' => 'not-an-email']);
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+    
+    // Japanese field validation
+    it('異常: fails to create user with invalid kana format', function () {
+        $data = validUserData(['name_kana_lastname' => 'たなか']); // hiragana
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['name_kana_lastname']);
+    });
+    
+    // Unique constraint
+    it('異常: fails to create user with duplicate email', function () {
+        User::factory()->create(['email' => 'existing@example.com']);
+        $data = validUserData(['email' => 'existing@example.com']);
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+});
+
+describe('GET /api/users/{id}', function () {
+    it('正常: returns user by id', function () {
+        $user = User::factory()->create();
+        
+        $this->getJson("/api/users/{$user->id}")
+            ->assertOk()
+            ->assertJsonPath('data.id', $user->id);
+    });
+    
+    it('異常: returns 404 when user not found', function () {
+        $this->getJson('/api/users/99999')
+            ->assertNotFound();
+    });
+});
+```
+
+## Debugging Failed Tests
+
+```mermaid
+flowchart TD
+    Fail[Test Failed] --> Check1{Endpoint correct?}
+    Check1 -->|No| FixEndpoint[Fix URL/method]
+    Check1 -->|Yes| Check2{Data valid?}
+    Check2 -->|No| FixData[Fix test data]
+    Check2 -->|Yes| Check3{Assertion correct?}
+    Check3 -->|No| FixAssert[Fix assertion]
+    Check3 -->|Yes| CodeBug[Code has bug - fix code]
+```
+
+## Example Interaction
+
+```
+User: Write tests for OrderController
+
+Tester Agent:
+1. Read /guides/laravel/testing.md
+2. Identify endpoints (index, store, show, update, destroy)
+3. For each endpoint:
+   - Write 正常系 tests
+   - Write 異常系 tests (validation, 404, 401, 403)
+4. Add Japanese field tests if applicable
+5. Output complete test file with describe/it blocks
+```

package/dist/knowledge/checklists/backend.md.stub

@@ -0,0 +1,112 @@
+# Backend Checklist
+
+> Quick reference. For details, see linked guides.
+
+## New Resource
+
+| Step | Action                | Guide                                                       |
+| ---- | --------------------- | ----------------------------------------------------------- |
+| 1    | Create schema         | [guides/omnify/schema-guide.md](../guides/omnify/schema-guide.md) |
+| 2    | `npx omnify generate` |                                                             |
+| 3    | `./artisan migrate`   |                                                             |
+| 4    | Model (extend base)   | [guides/laravel/README.md](../guides/laravel/README.md)     |
+| 5    | Controller (thin)     |                                                             |
+| 6    | Resource              |                                                             |
+| 7    | Routes                |                                                             |
+| 8    | **Tests**             | [guides/laravel/testing.md](../guides/laravel/testing.md)   |
+| 9    | `./artisan test`      |                                                             |
+| 10   | OpenAPI               | [guides/laravel/openapi.md](../guides/laravel/openapi.md)   |
+
+> **Full workflow**: [workflows/new-feature.md](../workflows/new-feature.md)
+
+---
+
+## Before Commit
+
+### Code
+- [ ] No `dd()`, `dump()`, `console.log`
+- [ ] No commented-out code
+- [ ] Type hints on methods
+
+### Security
+- [ ] `$fillable` defined in Model
+- [ ] `$request->validated()` (not `all()`)
+- [ ] Sensitive data in `$hidden`
+
+### API
+- [ ] Dates use `->toISOString()`
+- [ ] Return Resource (not Model)
+- [ ] Proper HTTP status codes
+
+### Performance
+- [ ] `with()` for relations
+- [ ] `whenLoaded()` in Resources
+- [ ] `paginate()` for lists
+
+> **Details**: [rules/](../rules/)
+
+---
+
+## Tests
+
+### Coverage Required
+
+| Endpoint    | 正常系             | 異常系                |
+| ----------- | ------------------ | --------------------- |
+| **index**   | List, filter, sort | Empty, invalid params |
+| **store**   | Creates → 201      | 422 (validation)      |
+| **show**    | Returns → 200      | 404                   |
+| **update**  | Updates → 200      | 404, 422              |
+| **destroy** | Deletes → 204      | 404                   |
+
+### Auth Tests (if protected)
+- 401: Not authenticated
+- 403: Not authorized
+
+> **Full guide**: [guides/laravel/testing.md](../guides/laravel/testing.md)
+
+---
+
+## OpenAPI
+
+1. Check `OmnifyBase/*RequestBase.php` for request fields
+2. Check `OmnifyBase/*ResourceBase.php` for response fields
+3. Use `$ref` from `Schemas.php`
+4. Run `./artisan l5-swagger:generate`
+
+> **Full guide**: [guides/laravel/openapi.md](../guides/laravel/openapi.md)
+
+---
+
+## Controller Methods
+
+### index
+```php
+return UserResource::collection(
+    User::with('relation')
+        ->when($request->search, fn($q, $s) => $q->where('name', 'like', "%{$s}%"))
+        ->paginate($request->input('per_page', 15))
+);
+```
+
+### store
+```php
+return new UserResource(User::create($request->validated()));
+```
+
+### show
+```php
+return new UserResource($user->load('relation'));
+```
+
+### update
+```php
+$user->update($request->validated());
+return new UserResource($user);
+```
+
+### destroy
+```php
+$user->delete();
+return response()->noContent();
+```

package/dist/knowledge/checklists/react.md.stub

@@ -0,0 +1,108 @@
+# Checklists
+
+> **Related:** [README](./README.md)
+
+## After Writing Code
+
+> **IMPORTANT**: Always run these commands after writing/modifying code:
+
+```bash
+# 1. Type check
+npm run typecheck
+
+# 2. Lint check
+npm run lint
+
+# Or combined
+npm run typecheck && npm run lint
+```
+
+---
+
+## Adding New Resource
+
+When adding a new resource (e.g., `posts`), follow these steps:
+
+### 1. Service Layer (Always in `services/`)
+
+```bash
+# Create: services/posts.ts
+```
+
+- [ ] Import types: `import type { Post, PostCreate, PostUpdate } from "@omnify/schemas"`
+- [ ] Define only `PostListParams` (Create/Update come from Omnify)
+- [ ] Create `postService` object with CRUD methods
+- [ ] Add JSDoc comments for each method
+
+### 2. Query Keys
+
+```bash
+# Update: lib/queryKeys.ts
+```
+
+- [ ] Add `posts` object to `queryKeys`
+
+```typescript
+posts: {
+  all: ["posts"] as const,
+  lists: () => [...queryKeys.posts.all, "list"] as const,
+  list: (params?: PostListParams) => [...queryKeys.posts.lists(), params] as const,
+  details: () => [...queryKeys.posts.all, "detail"] as const,
+  detail: (id: number) => [...queryKeys.posts.details(), id] as const,
+},
+```
+
+### 3. Feature Components (in `features/posts/`)
+
+```bash
+# Create: features/posts/
+```
+
+- [ ] `PostTable.tsx` - Table component
+- [ ] `PostForm.tsx` - Form component
+- [ ] `usePostFilters.ts` - Feature-specific hooks (if needed)
+
+### 4. Pages
+
+```bash
+# Create pages in app/(dashboard)/posts/
+```
+
+- [ ] `page.tsx` - List page (imports from `features/posts/`)
+- [ ] `new/page.tsx` - Create form
+- [ ] `[id]/page.tsx` - Detail view
+- [ ] `[id]/edit/page.tsx` - Edit form
+
+### 5. Shared Components (only if reused)
+
+- [ ] If component used in 2+ features → move to `components/common/`
+
+### 6. Translations
+
+- [ ] Add labels to `src/i18n/messages/*.json` if needed
+
+### 7. Final Check
+
+- [ ] Run `npm run typecheck && npm run lint`
+- [ ] Test create, read, update, delete operations
+
+---
+
+## Adding New Language
+
+- [ ] Create message file: `src/i18n/messages/{locale}.json`
+- [ ] Add locale to `src/i18n/config.ts`
+- [ ] Import Ant Design locale in `src/components/AntdThemeProvider.tsx`
+- [ ] Test with `LocaleSwitcher` component
+
+---
+
+## Before Commit
+
+- [ ] `npm run typecheck` passes
+- [ ] `npm run lint` passes
+- [ ] No console warnings about deprecated props
+- [ ] No hardcoded strings (use i18n)
+- [ ] Forms handle loading state (`isPending`)
+- [ ] Forms handle validation errors (`getFormErrors`)
+- [ ] Mutations invalidate related queries

package/dist/knowledge/claude-rules/laravel-controllers.md.stub

@@ -0,0 +1,57 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}app/Http/Controllers/**/*.php"
+---
+
+# Laravel Controller Rules
+
+## Thin Controller Pattern
+
+Controllers should: Validate → Delegate → Respond
+
+```php
+public function store(StoreUserRequest $request): JsonResponse
+{
+    // ✅ Validate (via FormRequest)
+    $data = $request->validated();
+    
+    // ✅ Delegate (simple = Model, complex = Service)
+    $user = User::create($data);
+    
+    // ✅ Respond (via Resource)
+    return new UserResource($user);
+}
+```
+
+## ⚠️ CRITICAL: OpenAPI Paths
+
+**DO NOT add `/api` prefix!** The `api.php` route file already has it.
+
+```php
+// ❌ WRONG
+#[OA\Get(path: '/api/users')]
+
+// ✅ CORRECT
+#[OA\Get(path: '/users')]
+```
+
+## Security Rules
+
+- Always use `$request->validated()`, never `$request->all()`
+- Use route model binding for single resources
+- Use `authorize()` in FormRequest for authorization
+
+## Query Patterns
+
+```php
+// ✅ List with pagination and eager loading
+User::query()
+    ->with(['posts', 'profile'])
+    ->when($search, fn($q) => $q->where('name', 'like', "%{$search}%"))
+    ->latest()
+    ->paginate(15);
+```
+
+## Full Documentation
+
+See @.claude/omnify/guides/laravel/controller.md for complete patterns.

package/dist/knowledge/claude-rules/laravel-migrations.md.stub

@@ -0,0 +1,47 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}database/migrations/**/*.php"
+---
+
+# ⛔ STOP: Migration Rules
+
+## Auto-Generated Migrations (DO NOT EDIT)
+
+Files in `{{LARAVEL_ROOT}}database/migrations/omnify/` are **AUTO-GENERATED** by Omnify.
+
+**ANY MANUAL CHANGES WILL BE OVERWRITTEN** on next `npx omnify generate`.
+
+## ✅ Correct Workflow
+
+### To add/modify columns:
+
+1. Edit schema YAML in `schemas/`
+2. Run `npx omnify generate`
+3. Run `php artisan migrate`
+
+### For custom migrations (outside Omnify):
+
+```bash
+php artisan make:migration add_custom_field_to_users_table
+# Creates: database/migrations/2026_xx_xx_xxxxxx_add_custom_field_to_users_table.php
+# This is SAFE - Omnify won't touch it
+```
+
+## File Structure
+
+```
+database/migrations/
+├── omnify/                    ← ⛔ AUTO-GENERATED - DO NOT EDIT
+│   ├── 2026_01_01_000000_create_users_table.php
+│   └── ...
+├── 2026_01_12_120000_add_custom_field.php  ← ✅ Safe to edit
+└── 2026_01_12_130000_custom_migration.php  ← ✅ Safe to edit
+```
+
+## Quick Reference
+
+| Want to... | Do this |
+|------------|---------|
+| Add column | Edit schema YAML → `npx omnify generate` |
+| Modify column | Edit schema YAML → `npx omnify generate` |
+| Custom migration | `php artisan make:migration` (outside omnify/) |

package/dist/knowledge/claude-rules/laravel-tests.md.stub

@@ -0,0 +1,52 @@
+---
+paths:
+  - "{{LARAVEL_ROOT}}tests/**/*.php"
+---
+
+# Testing Rules (PEST)
+
+## Test Naming Convention (Japanese Style)
+
+```php
+describe('UserController', function () {
+    // 正常系 (Happy Path)
+    describe('正常系', function () {
+        test('一覧が取得できる', function () { ... });
+        test('新規作成ができる', function () { ... });
+    });
+    
+    // 異常系 (Error Cases)
+    describe('異常系', function () {
+        test('認証なしで401', function () { ... });
+        test('存在しないIDで404', function () { ... });
+    });
+});
+```
+
+## Required Setup
+
+```php
+uses(RefreshDatabase::class);
+
+beforeEach(function () {
+    $this->user = User::factory()->create();
+    $this->actingAs($this->user);
+});
+```
+
+## Assertion Patterns
+
+```php
+// API Response
+$response->assertStatus(200)
+    ->assertJsonStructure(['data' => ['id', 'name']]);
+
+// Database
+$this->assertDatabaseHas('users', ['email' => 'test@example.com']);
+$this->assertDatabaseMissing('users', ['id' => $user->id]);
+$this->assertDatabaseCount('users', 3);
+```
+
+## Full Documentation
+
+See @.claude/omnify/guides/laravel/testing.md for complete patterns.