@wipal/agent-team 1.0.0

package/.claude/skills/domain/product/user-stories/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: user-stories
+description: |
+  User story writing and refinement following agile best practices. Use when:
+  writing user stories, breaking down features, defining acceptance criteria,
+  or when user mentions "user story", "story", "acceptance criteria", "INVEST".
+version: 1.0.0
+category: product
+tags:
+  - user-stories
+  - agile
+  - acceptance-criteria
+  - backlog
+depends_on:
+  - requirements-gathering
+recommends: []
+used_by:
+  - sprint-planning
+---
+
+# Skill: User Stories
+
+## Core Principle
+**User stories describe value, not tasks.** Focus on who needs what and why, not how.
+
+## User Story Format
+
+```
+As a [type of user],
+I want [goal/desire],
+So that [benefit/value].
+```
+
+## INVEST Criteria
+
+| Letter | Meaning | Check |
+|--------|---------|-------|
+| **I** | Independent | Can be developed alone |
+| **N** | Negotiable | Details can be discussed |
+| **V** | Valuable | Provides user value |
+| **E** | Estimable | Team can estimate effort |
+| **S** | Small | Fits in one sprint |
+| **T** | Testable | Has clear acceptance criteria |
+
+## Hard Rules
+
+1. **NEVER write tasks as stories** - Stories deliver value
+2. **NEVER skip acceptance criteria** - How do we know it's done?
+3. **ALWAYS include the "why"** - So that...
+4. **ALWAYS keep stories small** - Split large stories
+
+## Good vs Bad Stories
+
+```markdown
+❌ Bad: As a user, I want a login page
+✅ Good: As a returning user, I want to log in quickly so I can access my account
+
+❌ Bad: Implement password reset
+✅ Good: As a forgetful user, I want to reset my password so I can regain access to my account
+
+❌ Bad: As an admin, I want to manage users
+✅ Good: As an admin, I want to deactivate user accounts so I can revoke access for terminated employees
+```
+
+## Acceptance Criteria
+
+```markdown
+## Story: User can reset password
+
+### Acceptance Criteria
+- [ ] Given I'm on the login page, when I click "Forgot password", then I see the reset form
+- [ ] Given I enter a valid email, when I submit, then I receive a reset link within 5 minutes
+- [ ] Given I click the reset link, when I enter a new password, then my password is updated
+- [ ] Given I use an expired link, when I try to reset, then I see an error message
+- [ ] Given I enter an unregistered email, when I submit, then I see a generic success message (security)
+```
+
+## Story Breakdown
+
+```
+Large Story:
+"As a user, I want to manage my profile"
+
+Break down into:
+1. "As a user, I want to view my profile information"
+2. "As a user, I want to update my name and email"
+3. "As a user, I want to change my password"
+4. "As a user, I want to upload a profile picture"
+5. "As a user, I want to delete my account"
+```
+
+## Story Template
+
+```markdown
+# [Story ID] [Title]
+
+## User Story
+As a [role],
+I want [feature],
+So that [benefit].
+
+## Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Technical Notes
+- API endpoint: POST /api/users/reset-password
+- Email template: password-reset.html
+
+## Dependencies
+- Email service must be configured
+
+## Estimate
+Story Points: 5
+
+## Definition of Done
+- [ ] Code complete
+- [ ] Unit tests passing
+- [ ] Code review approved
+- [ ] QA tested
+- [ ] Documentation updated
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Missing "so that" | Add the why |
+| Too technical | Focus on user value |
+| Too large | Break into smaller stories |
+| Vague acceptance criteria | Use Given/When/Then |
+| No estimate | Add story points |
+
+## Checklist
+
+- [ ] Follows INVEST criteria
+- [ ] Has clear acceptance criteria
+- [ ] Includes user benefit
+- [ ] Estimated by team
+- [ ] Dependencies identified

package/.claude/skills/domain/quality/bug-reporting/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: bug-reporting
+description: |
+  Bug report templates and best practices for effective issue tracking. Use when:
+  reporting bugs, creating issue tickets, documenting defects, or when user
+  mentions "bug", "issue", "defect", "bug report", "ticket".
+version: 1.0.0
+category: quality
+tags:
+  - bug
+  - issue
+  - defect
+  - ticket
+depends_on: []
+recommends: []
+used_by: []
+---
+
+# Skill: Bug Reporting
+
+## Core Principle
+**A bug report should enable reproduction.** If developers can't reproduce it, they can't fix it.
+
+## Severity Levels
+
+| Level | Definition | Example |
+|-------|------------|---------|
+| **Critical** | System down, data loss | Database corruption |
+| **High** | Major feature broken | Can't complete checkout |
+| **Medium** | Feature partially broken | Filter not working |
+| **Low** | Minor issue, workaround exists | Typo, UI glitch |
+
+## Hard Rules
+
+1. **NEVER report without reproduction steps** - One step, one action
+2. **NEVER assume developer context** - Include all details
+3. **ALWAYS include expected vs actual** - Clear comparison
+4. **ALWAYS search for duplicates first** - Don't create duplicates
+
+## Bug Report Template
+
+```markdown
+# 🐛 [Short Description]
+
+## Summary
+[One sentence describing the bug]
+
+## Severity
+- [ ] Critical
+- [ ] High
+- [x] Medium
+- [ ] Low
+
+## Environment
+- **OS:** macOS 14.0
+- **Browser:** Chrome 120
+- **Version:** v2.1.0
+- **Device:** Desktop
+
+## Steps to Reproduce
+1. Log in as standard user
+2. Navigate to Settings > Profile
+3. Click "Change Password"
+4. Enter current password
+5. Enter new password (8 characters)
+6. Click "Save"
+
+## Expected Behavior
+Password should be updated successfully with confirmation message.
+
+## Actual Behavior
+Error message appears: "Invalid current password" even though password is correct.
+
+## Evidence
+
+### Screenshot
+[Attach screenshot]
+
+### Logs
+```
+[2024-01-15 10:30:45] ERROR: Password validation failed
+[2024-01-15 10:30:45] Stack trace: ...
+```
+
+### Network Request
+```
+POST /api/user/password
+Request: { "currentPassword": "***", "newPassword": "***" }
+Response: { "error": "Invalid current password" }
+```
+
+## Impact
+- Users cannot change passwords
+- Affects ~15% of users based on support tickets
+- Workaround: Reset password via email
+
+## Additional Context
+- First reported: 2024-01-15
+- Related tickets: #123, #456
+- Only affects users with special characters in password
+
+## Possible Root Cause
+Password encoding issue - special characters not properly escaped
+```
+
+## Quick Bug Report
+
+```markdown
+**What:** [Bug description in one line]
+**Where:** [Page/URL/Feature]
+**When:** [What action triggers it]
+**Severity:** [Critical/High/Medium/Low]
+
+**Steps:**
+1. [First step]
+2. [Second step]
+3. [Third step]
+
+**Expected:** [What should happen]
+**Actual:** [What actually happened]
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Vague description | Specific, detailed |
+| No reproduction steps | Number each step |
+| Missing environment | OS, browser, version |
+| No evidence | Screenshots, logs |
+| Duplicate tickets | Search first |
+
+## Bug Lifecycle
+
+```
+New → Triaged → In Progress → Fixed → Verified → Closed
+                    ↓
+                Won't Fix
+                    ↓
+               Cannot Reproduce
+```
+
+## Checklist
+
+- [ ] Searched for duplicates
+- [ ] Reproduction steps included
+- [ ] Expected vs actual stated
+- [ ] Evidence attached
+- [ ] Environment specified
+- [ ] Severity assigned

package/.claude/skills/domain/quality/regression-testing/SKILL.md

@@ -0,0 +1,178 @@
+---
+name: regression-testing
+description: |
+  Regression test strategies and execution. Use when: running regression tests,
+  ensuring existing functionality works, or when user mentions "regression",
+  "regression test", "smoke test", "sanity test".
+version: 1.0.0
+category: quality
+tags:
+  - regression
+  - smoke-test
+  - sanity-test
+  - qa
+depends_on:
+  - test-automation
+recommends: []
+used_by: []
+---
+
+# Skill: Regression Testing
+
+## Core Principle
+**Protect what works.** New features shouldn't break existing functionality.
+
+## Test Types
+
+| Type | Scope | When | Duration |
+|------|-------|------|----------|
+| **Smoke** | Critical paths | Every build | 5-15 min |
+| **Sanity** | Specific feature | After fix | 15-30 min |
+| **Regression** | Full suite | Before release | 1-4 hours |
+
+## Hard Rules
+
+1. **NEVER skip smoke tests** - They catch major issues early
+2. **NEVER release without regression** - Protect existing users
+3. **ALWAYS run automated tests first** - Fast feedback
+4. **ALWAYS investigate failures** - Flaky tests hide real bugs
+
+## Smoke Test Suite
+
+```markdown
+# Smoke Test Checklist
+
+## Critical Paths (Must Pass)
+- [ ] User can log in
+- [ ] User can view dashboard
+- [ ] User can create new item
+- [ ] User can edit item
+- [ ] User can delete item
+- [ ] User can log out
+
+## API Health
+- [ ] GET /health returns 200
+- [ ] Database connection works
+- [ ] Cache connection works
+- [ ] External APIs reachable
+
+## Performance
+- [ ] Page load < 3 seconds
+- [ ] API response < 500ms
+```
+
+## Automated Smoke Test
+
+```typescript
+// tests/smoke.spec.ts
+import { test, expect } from '@playwright/test';
+
+test.describe('Smoke Tests', () => {
+  test('health check', async ({ request }) => {
+    const response = await request.get('/health');
+    expect(response.ok()).toBeTruthy();
+  });
+
+  test('user can login', async ({ page }) => {
+    await page.goto('/login');
+    await page.fill('[name="email"]', process.env.TEST_USER_EMAIL!);
+    await page.fill('[name="password"]', process.env.TEST_USER_PASSWORD!);
+    await page.click('button[type="submit"]');
+
+    await expect(page).toHaveURL('/dashboard');
+  });
+
+  test('dashboard loads', async ({ page }) => {
+    await page.goto('/dashboard');
+    await expect(page.locator('h1')).toContainText('Dashboard');
+  });
+});
+```
+
+## Regression Test Matrix
+
+```markdown
+| Area | Smoke | Sanity | Full Regression |
+|------|-------|--------|-----------------|
+| Authentication | ✅ | ✅ | ✅ |
+| User Management | ✅ | - | ✅ |
+| Orders | - | ✅ | ✅ |
+| Payments | - | - | ✅ |
+| Reports | - | - | ✅ |
+| Settings | - | - | ✅ |
+```
+
+## Regression Checklist
+
+```markdown
+# Pre-Release Regression
+
+## Automation Status
+- [ ] All smoke tests passing
+- [ ] Feature tests passing
+- [ ] No flaky test failures
+- [ ] Coverage report generated
+
+## Manual Testing
+- [ ] Critical paths verified
+- [ ] New features tested
+- [ ] Edge cases checked
+- [ ] Cross-browser tested
+- [ ] Mobile tested
+
+## Performance
+- [ ] Load tests passed
+- [ ] No memory leaks
+- [ ] Response times acceptable
+
+## Compatibility
+- [ ] Chrome latest
+- [ ] Firefox latest
+- [ ] Safari latest
+- [ ] Mobile Safari
+- [ ] Mobile Chrome
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Running all tests always | Risk-based selection |
+| Ignoring flaky tests | Fix or quarantine |
+| No test prioritization | Run critical first |
+| Manual-only regression | Automate what makes sense |
+
+## CI Integration
+
+```yaml
+# .github/workflows/regression.yml
+name: Regression Tests
+
+on:
+  push:
+    branches: [main]
+  schedule:
+    - cron: '0 2 * * *'  # Nightly
+
+jobs:
+  smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: npx playwright test --grep "@smoke"
+
+  regression:
+    needs: smoke
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: npx playwright test
+```
+
+## Checklist
+
+- [ ] Smoke suite defined
+- [ ] Automation running in CI
+- [ ] Test matrix created
+- [ ] Failure process defined
+- [ ] Regular suite maintenance

package/.claude/skills/domain/quality/test-automation/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: test-automation
+description: |
+  Test automation frameworks and strategies. Use when: setting up automation,
+  writing automated tests, choosing frameworks, or when user mentions "automation",
+  "automated tests", "Playwright", "Cypress", "Selenium".
+version: 1.0.0
+category: quality
+tags:
+  - automation
+  - playwright
+  - cypress
+  - e2e
+depends_on:
+  - test-planning
+recommends: []
+used_by:
+  - regression-testing
+---
+
+# Skill: Test Automation
+
+## Core Principle
+**Automate what matters.** Tests should be fast, reliable, and maintainable.
+
+## What to Automate
+
+| Automate | Don't Automate |
+|----------|----------------|
+| Regression tests | One-time tests |
+| Repetitive tasks | Exploratory testing |
+| Critical paths | UI polish testing |
+| Data-driven tests | Subjective testing |
+
+## Hard Rules
+
+1. **NEVER automate flaky tests** - Fix the root cause first
+2. **NEVER use fixed delays** - Wait for conditions
+3. **ALWAYS use Page Object Model** - Maintainable tests
+4. **ALWAYS run in CI** - Automation without CI is manual
+
+## Framework Comparison
+
+| Feature | Playwright | Cypress | Selenium |
+|---------|------------|---------|----------|
+| Speed | Fast | Fast | Slow |
+| Reliability | High | High | Medium |
+| Multi-browser | Yes | Limited | Yes |
+| Parallel | Built-in | Paid | Yes |
+| Learning curve | Medium | Easy | Hard |
+
+## Playwright Setup
+
+```typescript
+// playwright.config.ts
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: 'html',
+  use: {
+    baseURL: 'http://localhost:3000',
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+  },
+  projects: [
+    { name: 'chromium', use: { browserName: 'chromium' } },
+    { name: 'firefox', use: { browserName: 'firefox' } },
+    { name: 'webkit', use: { browserName: 'webkit' } },
+  ],
+});
+```
+
+## Page Object Model
+
+```typescript
+// pages/LoginPage.ts
+import { Page, Locator } from '@playwright/test';
+
+export class LoginPage {
+  readonly page: Page;
+  readonly emailInput: Locator;
+  readonly passwordInput: Locator;
+  readonly loginButton: Locator;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.emailInput = page.locator('[name="email"]');
+    this.passwordInput = page.locator('[name="password"]');
+    this.loginButton = page.locator('button[type="submit"]');
+  }
+
+  async goto() {
+    await this.page.goto('/login');
+  }
+
+  async login(email: string, password: string) {
+    await this.emailInput.fill(email);
+    await this.passwordInput.fill(password);
+    await this.loginButton.click();
+  }
+}
+```
+
+## Test Example
+
+```typescript
+// tests/login.spec.ts
+import { test, expect } from '@playwright/test';
+import { LoginPage } from '../pages/LoginPage';
+
+test.describe('Login', () => {
+  let loginPage: LoginPage;
+
+  test.beforeEach(async ({ page }) => {
+    loginPage = new LoginPage(page);
+    await loginPage.goto();
+  });
+
+  test('should login successfully', async ({ page }) => {
+    await loginPage.login('test@example.com', 'password123');
+
+    // Wait for navigation
+    await expect(page).toHaveURL('/dashboard');
+
+    // Verify user is logged in
+    await expect(page.locator('[data-testid="user-name"]')).toBeVisible();
+  });
+
+  test('should show error for invalid credentials', async ({ page }) => {
+    await loginPage.login('test@example.com', 'wrongpassword');
+
+    // Verify error message
+    await expect(page.locator('.error-message')).toContainText('Invalid credentials');
+  });
+});
+```
+
+## Best Practices
+
+### Wait Strategies
+```typescript
+// ❌ Bad: Fixed wait
+await page.waitForTimeout(1000);
+
+// ✅ Good: Wait for condition
+await page.waitForSelector('.loaded');
+await expect(page.locator('.status')).toBeVisible();
+await page.waitForResponse('**/api/data');
+```
+
+### Test Data
+```typescript
+// Use test fixtures for data
+test('should create order', async ({ page, request }) => {
+  // Setup: Create test user via API
+  const user = await request.post('/api/test/users', {
+    data: { email: 'test@example.com' }
+  });
+
+  // Test...
+});
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Fixed waits | Wait for conditions |
+| No Page Objects | Use POM pattern |
+| Flaky tests | Fix or delete |
+| No parallelization | Configure workers |
+| Not in CI | Add to pipeline |
+
+## Checklist
+
+- [ ] Framework selected
+- [ ] Page Objects implemented
+- [ ] Tests run in CI
+- [ ] Parallel execution configured
+- [ ] Proper wait strategies
+- [ ] Test data management