omgkit 1.0.0

package/plugin/skills/omega/omega-sprint/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: omega-sprint
+description: Omega sprint management. Use for AI team sprint execution.
+---
+
+# Omega Sprint Skill
+
+## Sprint Lifecycle
+```
+Vision → Backlog → Sprint → Execute → Retrospect
+   ↑                                      │
+   └──────────────────────────────────────┘
+```
+
+## Vision Setting
+```yaml
+vision:
+  product: "What we're building"
+  users: "Who it's for"
+  goals: ["Goal 1", "Goal 2"]
+  success: "How we measure"
+```
+
+## Sprint Planning
+1. Review backlog
+2. Select tasks for sprint
+3. Estimate (optional)
+4. Assign to agents
+
+## AI Team Execution
+
+### Autonomy Levels
+- **Full-Auto**: No human intervention
+- **Semi-Auto**: Review at checkpoints
+- **Manual**: Approve each step
+
+### Agent Routing
+| Task Type | Agent |
+|-----------|-------|
+| feature | fullstack-developer |
+| bugfix | debugger |
+| research | oracle |
+| docs | docs-manager |
+| test | tester |
+
+## Retrospective
+```markdown
+## What Went Well
+- [Success]
+
+## What Could Improve
+- [Learning]
+
+## Action Items
+- [Improvement for next sprint]
+```
+
+## Commands
+```bash
+/vision:set
+/sprint:new --propose
+/team:run --mode semi-auto
+/sprint:end
+```

package/plugin/skills/omega/omega-testing/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: omega-testing
+description: Comprehensive Omega testing. Use for thorough test coverage.
+---
+
+# Omega Testing Skill
+
+## Testing Pyramid
+```
+        /\
+       /E2E\
+      /─────\
+     /Integ. \
+    /─────────\
+   /   Unit    \
+  /─────────────\
+```
+
+## Coverage Targets
+- Unit: 80%+
+- Integration: 60%+
+- E2E: Critical paths 100%
+
+## Test Categories
+
+### 1. Happy Path
+```typescript
+it('creates user successfully', async () => {
+  const user = await createUser({ email: 'test@example.com' });
+  expect(user.email).toBe('test@example.com');
+});
+```
+
+### 2. Edge Cases
+```typescript
+it('handles empty input', () => {
+  expect(() => createUser({ email: '' })).toThrow();
+});
+```
+
+### 3. Error Cases
+```typescript
+it('handles database failure', async () => {
+  db.fail();
+  await expect(createUser({})).rejects.toThrow(DatabaseError);
+});
+```
+
+### 4. Performance
+```typescript
+it('responds within 100ms', async () => {
+  const start = Date.now();
+  await fetchUsers();
+  expect(Date.now() - start).toBeLessThan(100);
+});
+```
+
+### 5. Security
+```typescript
+it('rejects SQL injection', () => {
+  const input = "'; DROP TABLE users; --";
+  expect(() => query(input)).not.toThrow();
+});
+```
+
+## Omega Quality
+Test for ALL dimensions:
+- Accuracy
+- Performance
+- Security
+- Accessibility

package/plugin/skills/omega/omega-thinking/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: omega-thinking
+description: 7 modes of Omega thinking. Use for deep analysis, problem solving, finding 10x improvements.
+---
+
+# Omega Thinking Skill
+
+## The 7 Modes
+
+### 🔭 TELESCOPIC
+Zoom out to see the big picture.
+- Task → Feature → Product → Market → Industry → World
+- **Ask**: "What's the ultimate impact?"
+
+### 🔬 MICROSCOPIC
+First principles analysis.
+- Why? → Why? → Why? → Why? → Why?
+- **Ask**: "What's fundamentally true?"
+
+### ↔️ LATERAL
+Different angles and approaches.
+- How would [X industry] solve this?
+- What's the opposite approach?
+- **Ask**: "What are we not seeing?"
+
+### 🔄 INVERSION
+Learn through failure.
+- How to guarantee failure?
+- Avoid those things.
+- **Ask**: "What would make this fail?"
+
+### ⏳ TEMPORAL
+Time dimension analysis.
+- Historical patterns?
+- Relevant in 10 years?
+- **Ask**: "How does time affect this?"
+
+### 🕸️ SYSTEMIC
+Interconnections and emergence.
+- Components and connections?
+- Feedback loops?
+- **Ask**: "What system dynamics are at play?"
+
+### ⚛️ QUANTUM
+Multiple possibilities.
+- All possible solutions?
+- How to test quickly?
+- **Ask**: "What are all the possibilities?"
+
+## Application
+For any problem:
+1. Apply all 7 modes
+2. Synthesize insights
+3. Find the 10x opportunity

package/plugin/skills/security/better-auth/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: better-auth
+description: Better Auth library. Use for authentication in TypeScript projects.
+---
+
+# Better Auth Skill
+
+## Setup
+```typescript
+import { betterAuth } from 'better-auth';
+
+export const auth = betterAuth({
+  database: {
+    provider: 'postgresql',
+    url: process.env.DATABASE_URL,
+  },
+  emailAndPassword: {
+    enabled: true,
+  },
+  socialProviders: {
+    google: {
+      clientId: process.env.GOOGLE_CLIENT_ID,
+      clientSecret: process.env.GOOGLE_CLIENT_SECRET,
+    },
+  },
+});
+```
+
+## Client Usage
+```typescript
+import { createAuthClient } from 'better-auth/client';
+
+const authClient = createAuthClient();
+
+// Sign up
+await authClient.signUp.email({
+  email: 'user@example.com',
+  password: 'password',
+  name: 'User',
+});
+
+// Sign in
+await authClient.signIn.email({
+  email: 'user@example.com',
+  password: 'password',
+});
+```
+
+## Best Practices
+- Enable rate limiting
+- Use secure cookies
+- Implement email verification
+- Add MFA option

package/plugin/skills/security/oauth/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: oauth
+description: OAuth 2.0 / OIDC. Use for third-party authentication, social login.
+---
+
+# OAuth Skill
+
+## Authorization Code Flow
+```
+1. Redirect to provider
+   /authorize?client_id=X&redirect_uri=Y&scope=Z&response_type=code
+
+2. User authorizes
+
+3. Callback with code
+   /callback?code=ABC
+
+4. Exchange code for token
+   POST /token
+   { code, client_id, client_secret, redirect_uri }
+
+5. Use access token
+   Authorization: Bearer <token>
+```
+
+## Implementation
+```typescript
+// Redirect to OAuth provider
+app.get('/auth/google', (req, res) => {
+  const url = new URL('https://accounts.google.com/o/oauth2/v2/auth');
+  url.searchParams.set('client_id', CLIENT_ID);
+  url.searchParams.set('redirect_uri', REDIRECT_URI);
+  url.searchParams.set('response_type', 'code');
+  url.searchParams.set('scope', 'openid email profile');
+  res.redirect(url.toString());
+});
+
+// Handle callback
+app.get('/auth/callback', async (req, res) => {
+  const { code } = req.query;
+  const tokens = await exchangeCodeForTokens(code);
+  // Create session
+});
+```
+
+## Best Practices
+- Use PKCE for public clients
+- Validate state parameter
+- Use short-lived tokens
+- Store tokens securely

package/plugin/skills/security/owasp/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: owasp
+description: OWASP security. Use for security best practices, vulnerability prevention.
+---
+
+# OWASP Skill
+
+## Top 10 Prevention
+
+### 1. Injection
+```typescript
+// Bad
+db.query(`SELECT * FROM users WHERE id = ${id}`);
+
+// Good
+db.query('SELECT * FROM users WHERE id = $1', [id]);
+```
+
+### 2. Broken Authentication
+```typescript
+// Use secure session management
+// Implement MFA
+// Rate limit login attempts
+```
+
+### 3. XSS Prevention
+```typescript
+// Bad
+element.innerHTML = userInput;
+
+// Good
+element.textContent = userInput;
+// Or use DOMPurify
+```
+
+### 4. CSRF Prevention
+```typescript
+// Use CSRF tokens
+// SameSite cookies
+// Verify Origin header
+```
+
+### 5. Security Headers
+```typescript
+app.use(helmet({
+  contentSecurityPolicy: true,
+  hsts: true,
+  noSniff: true,
+}));
+```
+
+## Checklist
+- [ ] Input validation
+- [ ] Output encoding
+- [ ] Parameterized queries
+- [ ] Secure headers
+- [ ] HTTPS only

package/plugin/skills/testing/playwright/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: playwright
+description: Playwright E2E testing. Use for browser automation, E2E tests.
+---
+
+# Playwright Skill
+
+## Basic Test
+```typescript
+import { test, expect } from '@playwright/test';
+
+test('homepage has title', async ({ page }) => {
+  await page.goto('/');
+  await expect(page).toHaveTitle(/My App/);
+});
+
+test('login flow', async ({ page }) => {
+  await page.goto('/login');
+  await page.fill('[name="email"]', 'test@example.com');
+  await page.fill('[name="password"]', 'password');
+  await page.click('button[type="submit"]');
+  await expect(page).toHaveURL('/dashboard');
+});
+```
+
+## Page Object Model
+```typescript
+class LoginPage {
+  constructor(private page: Page) {}
+
+  async login(email: string, password: string) {
+    await this.page.fill('[name="email"]', email);
+    await this.page.fill('[name="password"]', password);
+    await this.page.click('button[type="submit"]');
+  }
+}
+```
+
+## Config
+```typescript
+// playwright.config.ts
+export default defineConfig({
+  testDir: './tests',
+  use: {
+    baseURL: 'http://localhost:3000',
+    screenshot: 'only-on-failure',
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+    { name: 'mobile', use: { ...devices['iPhone 12'] } },
+  ],
+});
+```
+
+## Run
+```bash
+npx playwright test
+npx playwright test --ui
+npx playwright codegen
+```

package/plugin/skills/testing/pytest/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: pytest
+description: Python testing with pytest. Use for unit tests, fixtures, mocking.
+---
+
+# Pytest Skill
+
+## Basic Tests
+```python
+def test_add():
+    assert add(1, 2) == 3
+
+def test_raises():
+    with pytest.raises(ValueError):
+        validate("")
+```
+
+## Fixtures
+```python
+@pytest.fixture
+def user():
+    return User(email="test@example.com")
+
+@pytest.fixture
+async def db():
+    conn = await create_connection()
+    yield conn
+    await conn.close()
+
+def test_user_email(user):
+    assert user.email == "test@example.com"
+```
+
+## Parametrize
+```python
+@pytest.mark.parametrize("input,expected", [
+    (1, 2),
+    (2, 4),
+    (3, 6),
+])
+def test_double(input, expected):
+    assert double(input) == expected
+```
+
+## Mocking
+```python
+def test_api_call(mocker):
+    mocker.patch('module.fetch', return_value={'data': 'test'})
+    result = get_data()
+    assert result == {'data': 'test'}
+```
+
+## Run
+```bash
+pytest -v
+pytest --cov=src
+pytest -k "test_user"
+```

package/plugin/skills/testing/vitest/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: vitest
+description: Vitest testing. Use for JavaScript/TypeScript unit tests.
+---
+
+# Vitest Skill
+
+## Basic Tests
+```typescript
+import { describe, it, expect } from 'vitest';
+
+describe('add', () => {
+  it('adds two numbers', () => {
+    expect(add(1, 2)).toBe(3);
+  });
+
+  it('handles negative numbers', () => {
+    expect(add(-1, 1)).toBe(0);
+  });
+});
+```
+
+## Async Tests
+```typescript
+it('fetches user', async () => {
+  const user = await fetchUser('123');
+  expect(user.email).toBe('test@example.com');
+});
+```
+
+## Mocking
+```typescript
+import { vi } from 'vitest';
+
+vi.mock('./api', () => ({
+  fetchData: vi.fn().mockResolvedValue({ data: 'test' }),
+}));
+
+it('calls API', async () => {
+  const result = await getData();
+  expect(fetchData).toHaveBeenCalled();
+});
+```
+
+## Setup
+```typescript
+// vitest.config.ts
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    coverage: {
+      provider: 'v8',
+    },
+  },
+});
+```
+
+## Run
+```bash
+vitest
+vitest --coverage
+vitest --ui
+```

package/templates/OMEGA.md

@@ -0,0 +1,80 @@
+# 🔮 OMEGA.md - Project Context
+
+> This file provides context for OMGKIT AI Team.
+> Customize for your project.
+
+## Project Overview
+
+**Name**: [Your Project Name]
+**Description**: [Brief description]
+**Tech Stack**: [e.g., Next.js, PostgreSQL, TypeScript]
+
+## Team Structure
+
+OMGKIT provides 23 specialized agents organized into teams:
+
+### Core Development
+- **planner** - Task decomposition and planning
+- **fullstack-developer** - Full implementation
+- **debugger** - Error analysis and fixing
+- **tester** - Test generation
+- **code-reviewer** - Code review with security focus
+- **scout** - Codebase exploration
+
+### Operations
+- **git-manager** - Git operations and PRs
+- **docs-manager** - Documentation
+- **project-manager** - Progress tracking
+- **database-admin** - Schema and migrations
+- **ui-ux-designer** - UI components
+
+### Omega Team ⭐
+- **oracle** - Deep analysis, 7 thinking modes
+- **architect** - System design, leverage multiplication
+- **sprint-master** - Sprint and team management
+
+## Conventions
+
+### Code Style
+- TypeScript strict mode
+- ESLint + Prettier
+- Conventional commits
+
+### Testing
+- Minimum 80% coverage
+- TDD for critical paths
+- E2E for user flows
+
+### Documentation
+- Update docs with code
+- API documentation required
+- Architecture decisions in ADRs
+
+## Current Sprint
+
+See `.omgkit/sprints/current.yaml`
+
+## Commands Quick Reference
+
+```bash
+# Core
+/feature [desc]    # Build feature
+/fix [issue]       # Fix bug
+/plan [task]       # Create plan
+/test [scope]      # Generate tests
+
+# Sprint
+/vision:set        # Set vision
+/sprint:new        # New sprint
+/team:run          # Run AI team
+/backlog:add       # Add task
+
+# Omega
+/10x [topic]       # 10x path
+/100x [topic]      # 100x paradigm
+/1000x [topic]     # 1000x moonshot
+```
+
+---
+
+*Think Omega. Build Omega. Be Omega.* 🔮

package/templates/backlog.yaml

@@ -0,0 +1,25 @@
+# Product Backlog
+# Managed by /backlog:* commands
+
+backlog: []
+
+# Task template:
+# - id: "TASK-001"
+#   title: ""
+#   description: ""
+#   type: feature | bugfix | docs | test | refactor | infra
+#   priority: 1-5 (1 = highest)
+#   status: pending | in_progress | review | done | blocked
+#   assigned_to: null | agent_name
+#   sprint_id: null | sprint_id
+#   estimate: "2h" | "1d" | "3d"
+#   tags: []
+#   dependencies: []
+#   created_at: ""
+#   completed_at: null
+
+stats:
+  total: 0
+  pending: 0
+  in_progress: 0
+  done: 0

package/templates/config.yaml

@@ -0,0 +1,44 @@
+# OMGKIT Project Configuration
+version: "1.0.0"
+
+# Project info
+project:
+  name: ""
+  description: ""
+
+# AI settings
+ai:
+  model: inherit
+  temperature: 0.7
+
+# Agent settings
+agents:
+  mode: auto  # auto | sequential | parallel
+  timeout: 300
+
+# Sprint settings
+sprint:
+  default_duration: 14
+  max_tasks: 20
+  auto_propose: true
+
+# Team settings
+team:
+  autonomy: semi-auto  # full-auto | semi-auto | manual
+  review_gates: true
+  auto_commit: false
+
+# Output settings
+output:
+  plans_dir: .omgkit/plans
+  docs_dir: .omgkit/docs
+  logs_dir: .omgkit/logs
+  verbose: false
+
+# MCP settings
+mcp:
+  context7: true
+  sequential: true
+  playwright: false
+  memory: true
+  filesystem: true