oh-my-ag 1.2.0

package/.agent/skills/backend-agent/resources/snippets.md

@@ -0,0 +1,197 @@
+# Backend Agent - Code Snippets
+
+Copy-paste ready patterns. Use these as starting points, adapt to the specific task.
+
+---
+
+## FastAPI Route with Auth
+
+```python
+from fastapi import APIRouter, Depends, HTTPException, status
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.core.deps import get_current_user, get_db
+from app.models.user import User
+from app.schemas.resource import ResourceCreate, ResourceResponse
+
+router = APIRouter(prefix="/api/resources", tags=["resources"])
+
+@router.post("/", response_model=ResourceResponse, status_code=status.HTTP_201_CREATED)
+async def create_resource(
+    data: ResourceCreate,
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    resource = Resource(**data.model_dump(), user_id=current_user.id)
+    db.add(resource)
+    await db.commit()
+    await db.refresh(resource)
+    return resource
+```
+
+---
+
+## Pydantic Schema Pair
+
+```python
+from datetime import datetime
+from uuid import UUID
+from pydantic import BaseModel, Field
+
+class ResourceCreate(BaseModel):
+    title: str = Field(..., min_length=1, max_length=200)
+    description: str | None = None
+
+class ResourceResponse(BaseModel):
+    id: UUID
+    title: str
+    description: str | None
+    user_id: UUID
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+```
+
+---
+
+## SQLAlchemy Model
+
+```python
+import uuid
+from datetime import datetime
+from sqlalchemy import ForeignKey, String, Text
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from app.core.database import Base
+
+class Resource(Base):
+    __tablename__ = "resources"
+
+    id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    title: Mapped[str] = mapped_column(String(200), nullable=False)
+    description: Mapped[str | None] = mapped_column(Text, nullable=True)
+    user_id: Mapped[uuid.UUID] = mapped_column(ForeignKey("users.id"), nullable=False, index=True)
+    created_at: Mapped[datetime] = mapped_column(default=datetime.utcnow)
+
+    user: Mapped["User"] = relationship(back_populates="resources")
+```
+
+---
+
+## JWT Auth Dependency
+
+```python
+from fastapi import Depends, HTTPException, status
+from fastapi.security import OAuth2PasswordBearer
+from jose import JWTError, jwt
+
+from app.core.config import settings
+
+oauth2_scheme = OAuth2PasswordBearer(tokenUrl="/api/auth/login")
+
+async def get_current_user(
+    token: str = Depends(oauth2_scheme),
+    db: AsyncSession = Depends(get_db),
+) -> User:
+    try:
+        payload = jwt.decode(token, settings.SECRET_KEY, algorithms=["HS256"])
+        user_id = payload.get("sub")
+        if user_id is None:
+            raise HTTPException(status_code=401, detail="Invalid token")
+    except JWTError:
+        raise HTTPException(status_code=401, detail="Invalid token")
+
+    user = await db.get(User, user_id)
+    if user is None:
+        raise HTTPException(status_code=401, detail="User not found")
+    return user
+```
+
+---
+
+## Password Hashing
+
+```python
+from passlib.context import CryptContext
+
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+def hash_password(password: str) -> str:
+    return pwd_context.hash(password)
+
+def verify_password(plain: str, hashed: str) -> bool:
+    return pwd_context.verify(plain, hashed)
+```
+
+---
+
+## Paginated Query
+
+```python
+from sqlalchemy import select, func
+
+async def paginate(
+    db: AsyncSession,
+    query,
+    page: int = 1,
+    size: int = 20,
+):
+    total = await db.scalar(select(func.count()).select_from(query.subquery()))
+    items = await db.scalars(query.offset((page - 1) * size).limit(size))
+    return {
+        "items": list(items),
+        "total": total,
+        "page": page,
+        "size": size,
+    }
+```
+
+---
+
+## Alembic Migration
+
+```python
+"""add resources table
+
+Revision ID: xxxx
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import UUID
+
+def upgrade() -> None:
+    op.create_table(
+        "resources",
+        sa.Column("id", UUID(as_uuid=True), primary_key=True),
+        sa.Column("title", sa.String(200), nullable=False),
+        sa.Column("description", sa.Text, nullable=True),
+        sa.Column("user_id", UUID(as_uuid=True), sa.ForeignKey("users.id"), nullable=False),
+        sa.Column("created_at", sa.DateTime, server_default=sa.func.now()),
+    )
+    op.create_index("ix_resources_user_id", "resources", ["user_id"])
+
+def downgrade() -> None:
+    op.drop_table("resources")
+```
+
+---
+
+## Test with httpx
+
+```python
+import pytest
+from httpx import AsyncClient
+
+@pytest.mark.asyncio
+async def test_create_resource(client: AsyncClient, auth_headers: dict):
+    response = await client.post(
+        "/api/resources/",
+        json={"title": "Test", "description": "Test desc"},
+        headers=auth_headers,
+    )
+    assert response.status_code == 201
+    data = response.json()
+    assert data["title"] == "Test"
+    assert "id" in data
+```

package/.agent/skills/backend-agent/resources/tech-stack.md

@@ -0,0 +1,39 @@
+# Backend Agent - Tech Stack Reference
+
+## Python (Preferred)
+- **Framework**: FastAPI 0.110+
+- **ORM**: SQLAlchemy 2.0 (async)
+- **Validation**: Pydantic v2
+- **Database**: PostgreSQL 16+, Redis 7+
+- **Auth**: python-jose (JWT), passlib (bcrypt)
+- **Testing**: pytest, httpx (async test client)
+- **Migrations**: Alembic
+
+## Node.js (Alternative)
+- **Framework**: Express.js, NestJS, Hono
+- **ORM**: Prisma, Drizzle
+- **Validation**: Zod
+- **Auth**: jsonwebtoken, bcrypt
+- **Testing**: Jest, Supertest
+
+## Architecture
+
+```
+backend/
+  domain/           # Business logic (pure Python, no framework deps)
+  application/      # Use cases, services
+  infrastructure/   # Database, cache, external APIs
+  presentation/     # API endpoints, middleware
+```
+
+## Security Requirements
+- Password hashing: bcrypt (cost factor 10-12)
+- JWT: 15min access tokens, 7 day refresh tokens
+- Rate limiting on auth endpoints
+- Input validation with Pydantic/Zod
+- Parameterized queries (never string interpolation)
+
+## Serena MCP Shortcuts
+- `find_symbol("create_todo")`: Locate existing function
+- `get_symbols_overview("app/api")`: List all endpoints
+- `find_referencing_symbols("User")`: Find all usages of a model

package/.agent/skills/commit/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: commit
+description: Create git commits following Conventional Commits specification with project-specific branch naming rules
+---
+
+# Commit Skill - Conventional Commits
+
+## When to use
+- 사용자가 "커밋해줘", "commit", "변경사항 저장" 요청 시
+- `/commit` 명령 시
+
+## Configuration
+프로젝트별 설정: `.agent/skills/commit/config/commit-config.yaml`
+
+## Commit Types
+| Type | Description | Branch Prefix |
+|------|-------------|---------------|
+| feat | 새 기능 추가 | feature/ |
+| fix | 버그 수정 | fix/ |
+| refactor | 코드 개선 | refactor/ |
+| docs | 문서 변경 | docs/ |
+| test | 테스트 추가/수정 | test/ |
+| chore | 빌드, 설정 등 | chore/ |
+| style | 코드 스타일 변경 | style/ |
+| perf | 성능 개선 | perf/ |
+
+## Commit Format
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+```
+
+## Workflow
+
+### Step 1: Analyze Changes
+```bash
+git status
+git diff --staged
+git log --oneline -5
+```
+
+### Step 1.5: Split by Feature (if needed)
+변경 파일이 여러 기능/도메인에 걸쳐 있으면, **기능 단위로 커밋을 분리**하라.
+
+**분리 기준:**
+- 서로 다른 scope (예: workflows vs skills vs docs)
+- 서로 다른 type (예: feat vs fix vs docs)
+- 논리적으로 독립된 변경사항
+
+**예시:**
+```
+# 변경 파일 목록:
+.agent/workflows/*.md (7개)     → fix(workflows): ...
+.agent/skills/**/*.md (4개)     → fix(skills): ...
+USAGE.md, USAGE-ko.md           → docs: ...
+
+# 3개의 커밋으로 분리
+```
+
+**분리하지 않는 경우:**
+- 모든 변경이 하나의 기능에 속함
+- 변경 파일 수가 적음 (5개 이하)
+- 사용자가 단일 커밋 요청
+
+### Step 2: Determine Commit Type
+변경 내용 분석 → 적절한 type 선택:
+- 새 파일 추가 → `feat`
+- 버그 수정 → `fix`
+- 리팩토링 → `refactor`
+- 문서만 변경 → `docs`
+- 테스트 추가 → `test`
+- 빌드/설정 변경 → `chore`
+
+### Step 3: Determine Scope
+변경된 모듈/컴포넌트를 scope로 사용:
+- `feat(auth)`: 인증 관련
+- `fix(api)`: API 관련
+- `refactor(ui)`: UI 관련
+- scope 없이도 가능: `chore: update dependencies`
+
+### Step 4: Write Description
+- 72자 이내
+- 명령형 사용 (add, fix, update, remove...)
+- 첫 글자 소문자
+- 마침표 없음
+
+### Step 5: Confirm with User
+```
+📝 커밋 메시지 미리보기:
+
+feat(orchestrator): add multi-CLI agent mapping support
+
+- Add user-preferences.yaml for CLI configuration
+- Update spawn-agent.sh to read agent-CLI mapping
+- Update memory schema with CLI field
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+이대로 커밋하시겠습니까? (Y/N/수정)
+```
+
+### Step 6: Execute Commit
+사용자 확인 후:
+```bash
+git add <specific-files>
+git commit -m "<message>"
+```
+
+## References
+- 설정: `config/commit-config.yaml`
+- 가이드: `resources/conventional-commits.md`
+
+## Important Notes
+- **NEVER** commit without user confirmation
+- **NEVER** use `git add -A` or `git add .` without explicit permission
+- **NEVER** commit files that may contain secrets (.env, credentials, etc.)
+- **ALWAYS** use specific file names when staging
+- **ALWAYS** use HEREDOC for multi-line commit messages

package/.agent/skills/commit/config/commit-config.yaml

@@ -0,0 +1,55 @@
+# Commit Configuration
+
+# Conventional Commits 활성화
+conventional_commits: true
+
+# 허용되는 커밋 타입
+types:
+  - feat
+  - fix
+  - refactor
+  - docs
+  - test
+  - chore
+  - style
+  - perf
+
+# 브랜치 접두사 규칙
+branch_prefixes:
+  feat: "feature/"
+  fix: "fix/"
+  refactor: "refactor/"
+  docs: "docs/"
+  test: "test/"
+  chore: "chore/"
+  hotfix: "hotfix/"
+  style: "style/"
+  perf: "perf/"
+
+# 커밋 메시지 규칙
+message:
+  max_subject_length: 72
+  require_body: false
+  body_wrap_length: 100
+
+# Scope 규칙
+scope:
+  required: false
+  # 허용되는 scope 목록 (비어있으면 모두 허용)
+  allowed: []
+
+# Co-Author 설정
+co_author:
+  enabled: true
+  name: "Claude Opus 4.5"
+  email: "noreply@anthropic.com"
+
+# 금지된 파일 패턴 (커밋 경고)
+forbidden_patterns:
+  - "*.env"
+  - "*.env.*"
+  - "credentials.json"
+  - "secrets.yaml"
+  - "*.pem"
+  - "*.key"
+  - ".env.local"

package/.agent/skills/commit/resources/conventional-commits.md

@@ -0,0 +1,166 @@
+# Conventional Commits Guide
+
+## Overview
+
+Conventional Commits는 커밋 메시지에 일관된 규칙을 적용하여:
+- 자동화된 CHANGELOG 생성
+- Semantic Versioning 자동화
+- 팀원 간 커밋 히스토리 이해도 향상
+
+## Commit Message Structure
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+## Types
+
+### Primary Types
+
+| Type | Description | SemVer | Example |
+|------|-------------|--------|---------|
+| `feat` | 새로운 기능 추가 | MINOR | `feat: add user authentication` |
+| `fix` | 버그 수정 | PATCH | `fix: resolve login timeout issue` |
+
+### Secondary Types
+
+| Type | Description | SemVer | Example |
+|------|-------------|--------|---------|
+| `docs` | 문서 변경 | - | `docs: update API documentation` |
+| `style` | 코드 스타일 변경 (포맷팅, 세미콜론 등) | - | `style: fix indentation` |
+| `refactor` | 기능 변경 없는 코드 개선 | - | `refactor: extract helper function` |
+| `perf` | 성능 개선 | PATCH | `perf: optimize database queries` |
+| `test` | 테스트 추가/수정 | - | `test: add unit tests for auth` |
+| `chore` | 빌드, 설정, 패키지 관련 | - | `chore: update dependencies` |
+
+## Scope
+
+Scope는 변경된 코드의 영역을 나타냅니다:
+
+```
+feat(auth): add OAuth2 support
+fix(api): handle null response
+refactor(ui): simplify button component
+```
+
+### Common Scopes
+- `auth` - 인증/인가
+- `api` - API 엔드포인트
+- `ui` - 사용자 인터페이스
+- `db` - 데이터베이스
+- `config` - 설정
+- `deps` - 의존성
+
+## Description
+
+- **명령형** 사용: "add", "fix", "update" (NOT "added", "fixed", "updates")
+- **첫 글자 소문자**
+- **마침표 없음**
+- **72자 이내**
+
+### Good Examples
+```
+feat(auth): add JWT token refresh mechanism
+fix(api): handle empty response from payment gateway
+refactor(ui): extract common button styles
+```
+
+### Bad Examples
+```
+feat(auth): Added JWT token refresh mechanism.  # 과거형, 마침표
+fix: fix bug  # 설명 부족
+Update the authentication system to support OAuth2 tokens and refresh mechanism  # 너무 김
+```
+
+## Body
+
+Body는 선택사항이지만, 복잡한 변경사항에 유용합니다:
+
+```
+feat(auth): add multi-factor authentication
+
+Implement TOTP-based two-factor authentication:
+- Add QR code generation for authenticator apps
+- Store encrypted TOTP secrets in database
+- Add backup codes for account recovery
+
+Closes #123
+```
+
+## Breaking Changes
+
+Breaking change는 `!` 또는 footer로 표시:
+
+```
+feat(api)!: change response format for user endpoint
+
+BREAKING CHANGE: The user endpoint now returns a nested object
+instead of a flat structure. Update client code accordingly.
+```
+
+## Footer
+
+### Issue References
+```
+feat(auth): add password reset flow
+
+Closes #456
+Refs #123, #789
+```
+
+### Co-Authors
+```
+feat(ui): redesign dashboard
+
+Co-Authored-By: Jane Doe <jane@example.com>
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+```
+
+## Branch Naming Convention
+
+| Type | Branch Prefix | Example |
+|------|---------------|---------|
+| feat | `feature/` | `feature/user-auth` |
+| fix | `fix/` | `fix/login-timeout` |
+| refactor | `refactor/` | `refactor/api-cleanup` |
+| docs | `docs/` | `docs/api-guide` |
+| hotfix | `hotfix/` | `hotfix/security-patch` |
+
+## Commit Workflow
+
+1. **Stage specific files** (NOT `git add .`):
+   ```bash
+   git add src/auth/login.ts
+   git add tests/auth/login.test.ts
+   ```
+
+2. **Write commit message**:
+   ```bash
+   git commit -m "$(cat <<'EOF'
+   feat(auth): add login rate limiting
+
+   - Limit failed attempts to 5 per minute
+   - Add exponential backoff for repeated failures
+   - Log suspicious activity
+
+   Closes #234
+
+   Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+   EOF
+   )"
+   ```
+
+3. **Verify**:
+   ```bash
+   git log -1 --format=full
+   ```
+
+## Resources
+
+- [Conventional Commits Specification](https://www.conventionalcommits.org/)
+- [Semantic Versioning](https://semver.org/)
+- [Angular Commit Guidelines](https://github.com/angular/angular/blob/main/CONTRIBUTING.md#commit)

package/.agent/skills/debug-agent/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: debug-agent
+description: Bug diagnosis and fixing specialist - analyzes errors, identifies root causes, provides fixes, and writes regression tests
+---
+
+# Debug Agent - Bug Fixing Specialist
+
+## When to use
+- User reports a bug with error messages
+- Something is broken and needs fixing
+- Performance issues or slowdowns
+- Intermittent failures or race conditions
+- Regression bugs
+
+## When NOT to use
+- Building new features -> use Frontend/Backend/Mobile agents
+- General code review -> use QA Agent
+
+## Core Rules
+1. Reproduce first, then diagnose - never guess at fixes
+2. Identify root cause, not just symptoms
+3. Minimal fix: change only what's necessary
+4. Every fix gets a regression test
+5. Search for similar patterns elsewhere after fixing
+6. Document in `.gemini/antigravity/brain/bugs/`
+
+## How to Execute
+Follow `resources/execution-protocol.md` step by step.
+See `resources/examples.md` for input/output examples.
+Before submitting, run `resources/checklist.md`.
+
+## Serena MCP
+- `find_symbol("functionName")`: Locate the function
+- `find_referencing_symbols("Component")`: Find all usages
+- `search_for_pattern("error pattern")`: Find similar issues
+
+## Serena Memory (CLI Mode)
+See `../_shared/serena-memory-protocol.md`.
+
+## References
+- Execution steps: `resources/execution-protocol.md`
+- Code examples: `resources/examples.md`
+- Checklist: `resources/checklist.md`
+- Error recovery: `resources/error-playbook.md`
+- Bug report template: `resources/bug-report-template.md`
+- Common patterns: `resources/common-patterns.md`
+- Debugging checklist: `resources/debugging-checklist.md`
+- Context loading: `../_shared/context-loading.md`
+- Reasoning templates: `../_shared/reasoning-templates.md`
+- Context budget: `../_shared/context-budget.md`
+- Lessons learned: `../_shared/lessons-learned.md`