@etus/bhono-app 0.1.1

package/templates/base/.claude/skills/playwright-e2e-testing/templates/test-template.spec.js

@@ -0,0 +1,163 @@
+import { test, expect } from '@playwright/test';
+// Import your page objects
+// import { LoginPage } from '../tests-config/pages/LoginPage';
+// import { DashboardPage } from '../tests-config/pages/DashboardPage';
+
+/**
+ * Test Suite: [Feature Name]
+ * 
+ * Description: [Brief description of what this test suite covers]
+ * 
+ * Test Priority: [Critical/High/Medium/Low]
+ * Tags: @feature @priority
+ */
+
+test.describe('[Feature Name]', () => {
+  // Setup before each test
+  test.beforeEach(async ({ page }) => {
+    // Navigate to starting page
+    await page.goto('/');
+    
+    // Wait for page to be ready
+    await page.waitForLoadState('domcontentloaded');
+    
+    // Additional setup if needed
+  });
+
+  // Cleanup after each test (if needed)
+  test.afterEach(async ({ page }) => {
+    // Cleanup actions
+  });
+
+  /**
+   * Test Case: [Test Name]
+   * 
+   * Steps:
+   * 1. [Step 1]
+   * 2. [Step 2]
+   * 3. [Step 3]
+   * 
+   * Expected: [Expected result]
+   */
+  test('should [do something] when [condition] @tag', async ({ page }) => {
+    // Arrange - Setup test conditions
+    await page.goto('/feature');
+    
+    // Act - Perform the action
+    await page.getByRole('button', { name: 'Submit' }).click();
+    
+    // Assert - Verify the result
+    await expect(page.getByText('Success')).toBeVisible();
+    await expect(page).toHaveURL(/success/);
+  });
+
+  /**
+   * Test Case: Error handling
+   * 
+   * Expected: Should display error message for invalid input
+   */
+  test('should display error for invalid input @error-handling', async ({ page }) => {
+    await page.goto('/form');
+    
+    // Enter invalid data
+    await page.getByLabel('Email').fill('invalid-email');
+    await page.getByRole('button', { name: 'Submit' }).click();
+    
+    // Verify error message
+    await expect(page.getByText('Invalid email format')).toBeVisible();
+  });
+
+  /**
+   * Test Case: Edge case
+   * 
+   * Expected: Should handle edge case appropriately
+   */
+  test('should handle [edge case] @edge-case', async ({ page }) => {
+    // Test edge case scenario
+  });
+});
+
+/**
+ * Authenticated Tests
+ * Use storageState for tests requiring authentication
+ */
+test.describe('Authenticated Features', () => {
+  // Use saved authentication state
+  test.use({ storageState: 'auth.json' });
+
+  test('should access protected page @authenticated', async ({ page }) => {
+    await page.goto('/dashboard');
+    await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible();
+  });
+});
+
+/**
+ * API Tests
+ * Test API endpoints directly
+ */
+test.describe('API Endpoints', () => {
+  test('should fetch user data @api', async ({ request }) => {
+    const response = await request.get('/api/users/1');
+    
+    expect(response.ok()).toBeTruthy();
+    expect(response.status()).toBe(200);
+    
+    const user = await response.json();
+    expect(user).toMatchObject({
+      id: 1,
+      email: expect.stringMatching(/@/)
+    });
+  });
+});
+
+/**
+ * Mobile Tests
+ * Test mobile-specific features
+ */
+test.describe('Mobile Features', () => {
+  test.use({ 
+    viewport: { width: 375, height: 667 } 
+  });
+
+  test('should display mobile menu @mobile', async ({ page }) => {
+    await page.goto('/');
+    await page.getByLabel('Open menu').click();
+    await expect(page.getByRole('navigation')).toBeVisible();
+  });
+});
+
+/**
+ * Slow Tests
+ * Mark slow tests explicitly
+ */
+test.describe('Slow Operations', () => {
+  test('should complete slow operation @slow', async ({ page }) => {
+    test.slow(); // Triples the default timeout
+    
+    // Perform slow operation
+    await page.goto('/slow-page');
+    await page.waitForLoadState('networkidle');
+  });
+});
+
+/**
+ * Flaky Tests (use test.fixme or test.skip)
+ * Only use if absolutely necessary and add a TODO
+ */
+test.describe.skip('Flaky Tests', () => {
+  // TODO: Fix flakiness before enabling
+  test.fixme('flaky test to be fixed @flaky', async ({ page }) => {
+    // Test code
+  });
+});
+
+/**
+ * Cross-browser Tests
+ * Tag tests that should run on all browsers
+ */
+test.describe('Cross-browser Compatibility', () => {
+  test('should work on all browsers @critical @cross-browser', async ({ page }) => {
+    await page.goto('/');
+    await expect(page.getByRole('heading', { level: 1 })).toBeVisible();
+  });
+});

package/templates/base/.claude/skills/playwright-e2e-testing/templates/tests/email-deeplink.ads.spec.ts

@@ -0,0 +1,44 @@
+import { test, expect } from '../fixtures';
+
+/**
+ * Example: email deep link -> page load -> first GPT ad slot renders + becomes viewable.
+ *
+ * Customize:
+ * - URL path and query params
+ * - What "success" means (e.g., content visible, correct offer, etc.)
+ * - Timeouts (mobile networks can be slow)
+ *
+ * Tags:
+ * - @critical: key revenue path
+ * - @ads: ad assertions
+ * - @mobile: tuned for mobile projects
+ */
+test('email deep link renders first ad slot @critical @ads @mobile', async ({ authedPage: page, ads }, testInfo) => {
+  // This test is most reliable on Chromium because it can also use CDP realism helpers if needed.
+  // Keep it runnable elsewhere by not hard-requiring CDP, but allow project-based tuning.
+  const projectName = testInfo.project.name;
+
+  await ads.install();
+
+  // Optional: mid-tier mobile realism (Chromium-only). Uncomment if you import enableMobileRealism in fixtures.
+  // if (projectName === 'mobile-chrome') {
+  //   await enableMobileRealism(testInfo.workerInfo.workerIndex, page); // example only
+  // }
+
+  // Simulate the URL a user would open from an email click (include UTM/campaign params).
+  await page.goto('/quiz/result?utm_source=email&utm_medium=click&utm_campaign=deep_link');
+
+  // Assert primary content is visible first (avoid a test that only checks ads).
+  await expect(page.getByRole('main')).toBeVisible();
+
+  // Wait for first ad render.
+  const render = await ads.waitForFirstRender(20_000);
+  testInfo.attach('gpt-slot-render-ended', { body: JSON.stringify(render, null, 2), contentType: 'application/json' });
+
+  // Wait for first viewable impression.
+  const viewable = await ads.waitForFirstViewable(30_000);
+  testInfo.attach('gpt-impression-viewable', { body: JSON.stringify(viewable, null, 2), contentType: 'application/json' });
+
+  // Optional: screenshot for debugging (avoid strict visual assertions on dynamic ads).
+  await page.screenshot({ path: testInfo.outputPath('after-load.png'), fullPage: false });
+});

package/templates/base/.claude/skills/skill-rules.json

@@ -0,0 +1,184 @@
+{
+    "version": "1.1",
+    "description": "Skill activation rules for project and user skills",
+    "skills": {
+        "architecture-analyzer": {
+            "type": "domain",
+            "enforcement": "suggest",
+            "priority": "high",
+            "description": "Architectural analysis and documentation - C4 diagrams, ERD, dependency maps, tech debt assessment, API documentation",
+            "promptTriggers": {
+                "keywords": [
+                    "analyze architecture",
+                    "architecture analysis",
+                    "document codebase",
+                    "codebase documentation",
+                    "C4 diagram",
+                    "ERD",
+                    "entity relationship",
+                    "dependency map",
+                    "tech debt",
+                    "technical debt",
+                    "architecture report",
+                    "architecture review",
+                    "map dependencies",
+                    "generate diagram",
+                    "system diagram",
+                    "component diagram",
+                    "architecture documentation"
+                ],
+                "intentPatterns": [
+                    "(analyze|review|assess).*?architecture",
+                    "(generate|create|build).*?(C4|ERD|diagram|documentation)",
+                    "(map|visualize).*?dependenc",
+                    "(document|analyze).*?codebase",
+                    "tech.*?debt.*(analysis|assessment|report)",
+                    "architecture.*(report|review|assessment)"
+                ]
+            }
+        },
+
+        "dev-browser": {
+            "type": "domain",
+            "enforcement": "suggest",
+            "priority": "high",
+            "description": "Browser automation with persistent page state - navigate websites, fill forms, take screenshots, scrape data, test web apps",
+            "promptTriggers": {
+                "keywords": [
+                    "browser automation",
+                    "take screenshot",
+                    "fill form",
+                    "click button",
+                    "scrape website",
+                    "scrape page",
+                    "web scraping",
+                    "automate browser",
+                    "test website",
+                    "log into",
+                    "login to website",
+                    "navigate to",
+                    "go to url",
+                    "extract data",
+                    "web automation",
+                    "playwright automation"
+                ],
+                "intentPatterns": [
+                    "(go|navigate).*?(to|url|website|page)",
+                    "(click|press).*?(button|link|element)",
+                    "(fill|complete|submit).*?(form|input|field)",
+                    "(take|capture).*?screenshot",
+                    "(scrape|extract).*?(data|content|text|page)",
+                    "(automate|test).*?(browser|website|web)",
+                    "(log|sign).*?in.*?(to|website|page)",
+                    "browser.*(interact|automat)"
+                ]
+            }
+        },
+
+        "linear": {
+            "type": "domain",
+            "enforcement": "suggest",
+            "priority": "high",
+            "description": "Linear issue tracking - teams, projects, issues, status, labels, comments via CLI scripts",
+            "promptTriggers": {
+                "keywords": [
+                    "linear",
+                    "linear issue",
+                    "linear team",
+                    "linear project",
+                    "issue status",
+                    "issue label",
+                    "create issue",
+                    "list issues",
+                    "linear workflow"
+                ],
+                "intentPatterns": [
+                    "(list|filter|get).*?linear.*?(issue|team|project)",
+                    "(create|update|archive).*?issue",
+                    "(manage|change).*?(status|priority|label|assignment)",
+                    "(add|view).*?comment"
+                ]
+            }
+        },
+
+        "playwright-e2e-testing": {
+            "type": "domain",
+            "enforcement": "suggest",
+            "priority": "high",
+            "description": "Playwright-specific E2E testing - Page Objects, fixtures, OAuth, API testing, visual regression, debugging",
+            "promptTriggers": {
+                "keywords": [
+                    "playwright",
+                    "playwright test",
+                    "page object",
+                    "playwright fixture",
+                    "playwright oauth",
+                    "playwright api",
+                    "visual regression",
+                    "playwright debug",
+                    "playwright selector",
+                    "getByRole",
+                    "getByText",
+                    "toBeVisible"
+                ],
+                "intentPatterns": [
+                    "(write|create|add).*?playwright.*?test",
+                    "(debug|fix).*?playwright",
+                    "playwright.*(oauth|authentication|login)",
+                    "playwright.*(api|visual|snapshot)",
+                    "(optimize|improve).*?playwright"
+                ]
+            }
+        },
+
+        "wrangler": {
+            "type": "domain",
+            "enforcement": "suggest",
+            "priority": "high",
+            "description": "Cloudflare Wrangler CLI - Workers deployment, D1, KV, R2, Queues, Workflows, secrets, and local development",
+            "promptTriggers": {
+                "keywords": [
+                    "wrangler",
+                    "cloudflare worker",
+                    "cloudflare workers",
+                    "wrangler deploy",
+                    "wrangler dev",
+                    "wrangler d1",
+                    "wrangler kv",
+                    "wrangler r2",
+                    "wrangler secret",
+                    "wrangler queues",
+                    "wrangler workflows",
+                    "wrangler pages",
+                    "wrangler init",
+                    "cloudflare deploy",
+                    "worker deploy",
+                    "worker development"
+                ],
+                "intentPatterns": [
+                    "(deploy|publish).*?(worker|cloudflare)",
+                    "(run|start).*?wrangler",
+                    "wrangler.*(command|cli|help)",
+                    "(create|manage|configure).*?(d1|kv|r2|queue|workflow|secret)",
+                    "(local|dev).*?worker",
+                    "cloudflare.*(storage|database|queue)"
+                ]
+            }
+        }
+    },
+    "notes": {
+        "current_implementation": "Only promptTriggers are currently functional via UserPromptSubmit hook",
+        "enforcement_types": {
+            "suggest": "Skill suggestion appears but doesn't block execution (WORKING)",
+            "block": "Requires skill to be used before proceeding (NOT IMPLEMENTED)",
+            "warn": "Shows warning but allows proceeding (NOT IMPLEMENTED)"
+        },
+        "priority_levels": {
+            "critical": "Highest - Always trigger when matched",
+            "high": "Important - Trigger for most matches",
+            "medium": "Moderate - Trigger for clear matches",
+            "low": "Optional - Trigger only for explicit matches"
+        },
+        "trigger_detection": "Only prompt-based detection works: keywords (exact match) and intentPatterns (regex)"
+    }
+}

package/templates/base/.claude/skills/wrangler/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: wrangler
+description: Get the context of the Wrangler CLI tool. Use this skill whenever users will run any wrangler commands to any related Cloudflare services.
+---
+
+# Purpose
+
+Provide the context and all the information about the Wrangler CLI tool to the agent never miss or run an outdated command.
+
+## Variables
+
+SOME_VAR: "some-value"
+
+## Instructions
+
+Run `wrangler --help` to get the context of the Wrangler CLI tool and information about the commands and options.
+
+## Workflow
+
+1. Run the "Instructions" section
+2. Identify if the wrangler is outdated or not and if it is, run the `npm i -G wrangler@latest` command to update it.
+3. Return the options and commands of the wrangler CLI tool to the agent related to task he is working on.
+
+## Context
+
+Wrangler, the Cloudflare Developer Platform command-line interface (CLI), allows you to manage Worker projects.
+
+## Resources
+
+### Core Documentation
+
+| Resource                                                        | Description                                              |
+| --------------------------------------------------------------- | -------------------------------------------------------- |
+| [API](./resources/api.md)                                       | Programmatic APIs for local Cloudflare Workers workflows |
+| [Bundling](./resources/bundling.md)                             | Wrangler's default bundling behavior                     |
+| [Configuration](./resources/configuration.md)                   | Configuration file customization for Workers             |
+| [Custom Builds](./resources/custom-builds.md)                   | Customize code compilation before Wrangler processing    |
+| [Deprecations](./resources/deprecations.md)                     | Wrangler version differences and breaking changes        |
+| [Environments](./resources/enviroments.md)                      | Create different configurations for the same Worker      |
+| [System Variables](./resources/system-enviroments-variables.md) | Environment variables that change Wrangler behavior      |
+
+### Commands Reference
+
+| Resource                                  | Description                             |
+| ----------------------------------------- | --------------------------------------- |
+| [Commands Index](./resources/commands.md) | Complete index of all Wrangler commands |
+
+#### Getting Started Commands
+
+| Command                                          | Description                   |
+| ------------------------------------------------ | ----------------------------- |
+| [how-to-run](./resources/commands/how-to-run.md) | How to run Wrangler commands  |
+| [docs](./resources/commands/docs.md)             | Open documentation in browser |
+| [init](./resources/commands/init.md)             | Initialize a Worker project   |
+| [login](./resources/commands/login.md)           | Authorize with Cloudflare     |
+| [logout](./resources/commands/logout.md)         | Remove authorization          |
+| [whoami](./resources/commands/whoami.md)         | Show user information         |
+
+#### Development & Deployment Commands
+
+| Command                                  | Description              |
+| ---------------------------------------- | ------------------------ |
+| [dev](./resources/commands/dev.md)       | Local development server |
+| [deploy](./resources/commands/deploy.md) | Deploy to Cloudflare     |
+| [delete](./resources/commands/delete.md) | Delete Worker            |
+| [tail](./resources/commands/tail.md)     | Log tailing session      |
+| [check](./resources/commands/check.md)   | Validate Worker          |
+
+#### Versioning & Deployments Commands
+
+| Command                                            | Description                     |
+| -------------------------------------------------- | ------------------------------- |
+| [versions](./resources/commands/versions.md)       | Manage Worker Versions          |
+| [deployments](./resources/commands/deployments.md) | Manage Deployments              |
+| [rollback](./resources/commands/rollback.md)       | Rollback to previous Deployment |
+| [triggers](./resources/commands/triggers.md)       | Update cron/routes              |
+
+#### Storage Commands
+
+| Command                                              | Description        |
+| ---------------------------------------------------- | ------------------ |
+| [d1](./resources/commands/d1.md)                     | D1 SQL databases   |
+| [kv-namespace](./resources/commands/kv-namespace.md) | KV namespaces      |
+| [kv-key](./resources/commands/kv-key.md)             | KV keys and values |
+| [kv-bulk](./resources/commands/kv-bulk.md)           | KV bulk operations |
+| [r2-bucket](./resources/commands/r2-bucket.md)       | R2 buckets         |
+| [r2-object](./resources/commands/r2-object.md)       | R2 objects         |
+| [r2-sql](./resources/commands/r2-sql.md)             | R2 SQL queries     |
+
+#### AI & Database Commands
+
+| Command                                          | Description               |
+| ------------------------------------------------ | ------------------------- |
+| [vectorize](./resources/commands/vectorize.md)   | Vectorize indexes         |
+| [hyperdrive](./resources/commands/hyperdrive.md) | Hyperdrive configurations |
+
+#### Secrets & Configuration Commands
+
+| Command                                                              | Description               |
+| -------------------------------------------------------------------- | ------------------------- |
+| [secret](./resources/commands/secret.md)                             | Worker secrets            |
+| [secrets-store-secret](./resources/commands/secrets-store-secret.md) | Secrets Store secrets     |
+| [secrets-store-store](./resources/commands/secrets-store-store.md)   | Secrets Store stores      |
+| [setup](./resources/commands/setup.md)                               | Interactive setup         |
+| [types](./resources/commands/types.md)                               | Generate TypeScript types |
+| [telemetry](./resources/commands/telemetry.md)                       | Telemetry settings        |
+
+#### Platform Commands
+
+| Command                                                          | Description           |
+| ---------------------------------------------------------------- | --------------------- |
+| [pages](./resources/commands/pages.md)                           | Cloudflare Pages      |
+| [containers](./resources/commands/containers.md)                 | Containerized Workers |
+| [queues](./resources/commands/queues.md)                         | Cloudflare Queues     |
+| [workflows](./resources/commands/workflows.md)                   | Workflows             |
+| [pipelines](./resources/commands/pipelines.md)                   | Worker Pipelines      |
+| [dispatch-namespace](./resources/commands/dispatch-namespace.md) | Dispatch namespaces   |
+
+#### Certificate Commands
+
+| Command                                                      | Description       |
+| ------------------------------------------------------------ | ----------------- |
+| [mtls-certificate](./resources/commands/mtls-certificate.md) | mTLS certificates |
+| [cert](./resources/commands/cert.md)                         | TLS certificates  |
+
+## Cookbook
+
+<If: User needs to create a new Worker>
+
+<Then: Use `wrangler init` to initialize the project, then `wrangler dev` for local development, and `wrangler deploy` to publish>
+
+<Examples:>
+
+```bash
+# Create new Worker
+npx wrangler init my-worker
+cd my-worker
+
+# Local development
+npx wrangler dev
+
+# Deploy to production
+npx wrangler deploy
+```
+
+<If: User needs to manage secrets>
+
+<Then: Use `wrangler secret put` for single secrets or `wrangler secret bulk` for multiple>
+
+<Examples:>
+
+```bash
+# Add a single secret
+npx wrangler secret put API_KEY
+
+# Bulk upload secrets
+echo '{"API_KEY":"value","DB_URL":"postgres://..."}' | npx wrangler secret bulk
+```
+
+<If: User needs to work with D1 database>
+
+<Then: Create database with `wrangler d1 create`, execute SQL with `wrangler d1 execute`>
+
+<Examples:>
+
+```bash
+# Create D1 database
+npx wrangler d1 create my-database
+
+# Execute SQL
+npx wrangler d1 execute my-database --command "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)"
+
+# Execute from file
+npx wrangler d1 execute my-database --file ./schema.sql
+```
+
+<If: User needs to work with KV storage>
+
+<Then: Create namespace with `wrangler kv namespace create`, manage keys with `kv key` commands>
+
+<Examples:>
+
+```bash
+# Create KV namespace
+npx wrangler kv namespace create MY_KV
+
+# Put a value
+npx wrangler kv key put --namespace-id <ID> "my-key" "my-value"
+
+# Get a value
+npx wrangler kv key get --namespace-id <ID> "my-key"
+```
+
+<If: User needs to work with R2 storage>
+
+<Then: Create bucket with `wrangler r2 bucket create`, manage objects with `r2 object` commands>
+
+<Examples:>
+
+```bash
+# Create R2 bucket
+npx wrangler r2 bucket create my-bucket
+
+# Upload file
+npx wrangler r2 object put my-bucket/path/to/file.txt --file ./local-file.txt
+
+# Download file
+npx wrangler r2 object get my-bucket/path/to/file.txt --file ./downloaded.txt
+```