ureca-corp

Git Worktree patterns for parallel domain development with isolated workspaces. Use when implementing multiple domains in parallel using Topological Sort, team-based execution, and worktree-based code isolation to prevent conflicts.

Use when implementing a non-trivial coding task end-to-end with built-in quality gates — plan the work into slices AND rate each slice's difficulty (tier), implement slice by slice, run difficulty-adaptive review (light=1 lens, medium=2 lenses, heavy=4 lenses + Codex) after each slice, auto-escalate a slice to full review when it turns out risky, refactor until zero critical/major issues, then guarantee the full test+build passes. Trigger for requests like "구현 계획부터 검증까지", "슬라이스별로 구현하고 적대적 리뷰", multi-step feature builds, migrations/refactors that need a verify-and-refactor loop, or whenever the user asks to build something with adversarial review + zero-issue refactoring before finishing.

세션에서 변경된 파일들을 업무 단위별로 자동 분류하고, 각 단위마다 브랜치 생성 → 한글 커밋 메시지로 커밋 → 푸시 → main 브랜치 대상 PR 생성 → PR 리뷰 모니터링까지 완전한 Git 워크플로우를 자동화하는 스킬. 다음 상황에서 반드시 사용: "diff 확인하고 PR 나눠줘", "변경사항 브랜치로 분리", "한글 커밋으로 PR 올려줘", "세션 변경사항 PR 등록", "업무 단위별 브랜치 만들어", "커밋하고 PR 올려", "PR 리뷰 모니터링", "작업 단위로 나눠서 커밋". 사용자가 "PR", "브랜치", "커밋", "diff", "push" 중 하나라도 언급하며 작업 분리나 자동화를 원하면 이 스킬을 사용할 것.

Vertical Slice 패턴 강제 적용 및 Layer-based 코드 자동 리팩토링. 코드 작성 시 항상 적용되는 아키텍처 규칙. 1 파일 = 1 기능 (DTO + Service + Controller), 공유 로직은 언더스코어 prefix. 기존 layer-based 구조 발견 시 `/guard {domain}` 명령으로 변환.

모노레포 기반 새 프로젝트 생성. Template repo에서 Flutter/FastAPI/Admin 코드를 하나의 GitHub repo에 구성합니다.

프로젝트 문서화 체계를 설정하고 유지합니다. README.md(사람용), AGENTS.md(AI 에이전트용), CLAUDE.md(Claude 진입점), ai-context/(에이전트 상세 문서 폴더)의 4-파일 체계를 생성/갱신합니다. 다음 상황에서 반드시 이 스킬을 사용하세요: - "문서화 체계", "docs setup", "문서 세팅", "문서 구조 잡아줘" - "README 만들어", "AGENTS.md 작성해줘", "CLAUDE.md 설정" - "ai-context 폴더 만들어", "TOC.md 갱신" - 프로젝트에 AGENTS.md 또는 ai-context/가 없거나 오래된 경우 - 신규 프로젝트 시작 시 문서 인프라가 필요한 경우

domain-model.md를 기반으로 API 명세를 작성한다. 각 API마다 Request/Response 필드 테이블과 오류 응답을 정의하고, 복잡한 로직(Cascade·상태전이·다단계 검증)에만 수도코드를 추가한다. 기술 용어(HTTP, REST, JWT 등) 금지.

domain-model.md와 api-spec.md를 바탕으로 도메인 README·features·business-rules를 작성하여 Domain Book을 완성한다. 도메인 의존성을 Topological Sort로 해결하고 독립 도메인부터 병렬 작성한다.

This skill should be used when creating "Freezed models", "Riverpod services", "API clients", "domain models", "AsyncNotifier", or working with Flutter DDD architecture. Provides patterns for Freezed 3.x, Riverpod 3.x, and API client integration following project conventions.

PostGIS location storage patterns for FastAPI with SQLModel. Use when implementing location features requiring latitude/longitude storage, spatial indexing, or distance calculations. Stores both latlng (client response) and PostGIS POINT geometry (spatial queries).

SESSION.md의 도메인 정의를 바탕으로 유비쿼터스 언어(서술형 도메인 모델)를 작성한다. ERD 대신 "A는 B를 할 수 있다" 형식의 자연어 명세로 domain-model.md를 생성한다.

FastAPI security patterns including JWT Bearer Token authentication, SQLModel ORM (prevent SQL injection), environment variables (prevent hardcoded secrets), and password hashing (bcrypt). Use when implementing authentication, database operations, or security-sensitive features.

This skill should be used when working with "git worktree", "parallel git branches", "worktree merge", "isolated development", or managing multiple branches simultaneously for team-based code generation.

DDD Class Diagram 생성. Domain Book의 domain-model.md를 읽고 Mermaid erDiagram으로 DDD_CLASS_DIAGRAM.md를 생성. PK/FK, Enum, Cascade, Index 전략 포함. Phase 4에서 _models.py 생성 전에 사용.

특정 도메인에 대해 엔티티 속성·관계·생명주기·권한·제약·비즈니스 룰 6가지 카테고리로 상세 인터뷰하여 모든 모호함을 제거한다. 배치(최대 4개)씩 질문하고 답변마다 SESSION.md를 즉시 업데이트한다.

Vertical Slice + Clean Architecture patterns for FastAPI projects. Use when implementing FastAPI domain modules with proper layering (Entities, Use Cases, Interface Adapters), DTO naming conventions (Request/Response prefix), file structure, and OpenAPI metadata for frontend agents.

This skill should be used when working with "agent teams", "TaskList", "SendMessage", "teammate coordination", "blocking tasks", or managing multi-agent workflows with Claude Code's Teammate tool.