Add CLAUDE.md for project guidance and workflow documentation

This commit is contained in:
“hyeonggkim”
2026-03-20 14:14:29 +09:00
parent 2b26f76e2f
commit c3ce56f993

62
CLAUDE.md Normal file
View File

@@ -0,0 +1,62 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
- **Type**: Game service frontend agent (submodule-based monorepo)
- **Stack**: Nuxt 3/4, TypeScript (strict), pnpm
- **Language**: Korean (코드 리뷰, 커밋 메시지, 문서)
## Commands
### Development
```bash
pnpm install # Install dependencies
pnpm dev # Run dev server
pnpm build # Production build
pnpm preview # Preview build
```
### Validation
```bash
pnpm build # Verify no build errors
pnpm typecheck # Verify TypeScript (if configured)
```
### Submodules
```bash
git submodule update --init --recursive # Initialize
git submodule update --remote --recursive # Update all
```
## Git Workflow
### Branches
- `release` - Production (verified)
- `dev` - Development/testing
- Feature branches from `dev`
### MR Guidelines
- **Title**: `[Category] Description` (Feature, Fix, Refactor, Docs)
- **Target**: `dev` first, then `release` after verification
- **Review**: 1+ team member approval required
## Context Files
Additional context in `.claude/` directory:
- `contexts/` - Nuxt patterns, TypeScript conventions
- `skills/` - code-review, test-generator, refactor-component
- `agents/` - debugger, refactor, performance-optimizer
## Project-Specific Patterns
### Common Nuxt Issues
- Hydration mismatch → Use `<ClientOnly>`
- useFetch infinite loop → Check watch/immediate/key options
### Key Conventions
- Use Composition API with `<script setup lang="ts">`
- Composables for reusable logic
- Pinia for complex state management
- Always type API responses: `useFetch<Type>()`