57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# AGENTS.md (auto-trade)
|
|
|
|
## 기본 원칙
|
|
|
|
- 모든 응답과 설명은 한국어로 작성.
|
|
- 쉬운 말로 설명하고, 어려운 용어는 괄호로 짧게 뜻을 덧붙임.
|
|
- 요청이 모호하면 먼저 질문 1~3개로 범위를 확인.
|
|
|
|
## 프로젝트 요약
|
|
|
|
- Next.js 16 App Router, React 19, TypeScript
|
|
- 상태 관리: zustand
|
|
- 데이터: Supabase
|
|
- 폼 및 검증: react-hook-form, zod
|
|
- UI: Tailwind CSS v4, Radix UI (`components.json` 사용)
|
|
|
|
## 명령어
|
|
|
|
- 개발 서버(포트 3001): `npm run dev`
|
|
- 린트: `npm run lint`
|
|
- 빌드: `npm run build`
|
|
- 실행: `npm run start`
|
|
|
|
## 코드 및 문서 규칙
|
|
|
|
- JSX 섹션 주석 형식: `{/* ========== SECTION NAME ========== */}`
|
|
- 함수 및 컴포넌트 JSDoc에 `@see` 필수
|
|
- `@see`에는 호출 파일, 함수/이벤트 이름, 목적을 함께 작성
|
|
- 상태 정의, 이벤트 핸들러, 복잡한 JSX 로직에는 인라인 주석을 충분히 작성
|
|
- UI 흐름 설명 필수: `어느 UI -> A 함수 호출 -> B 함수 호출 -> 리턴값 반영` 형태로 작성
|
|
|
|
## 브랜드 색상 규칙
|
|
|
|
- 메인 컬러는 헤더 로고/프로필 기준의 보라 계열 `brand` 팔레트 사용
|
|
- 새 UI 작성 시 `indigo/purple/pink` 하드코딩 대신 `brand-*` 토큰 사용
|
|
- 예시: `bg-brand-500`, `text-brand-600`, `from-brand-500 to-brand-700`
|
|
- 기본 액션 색(버튼/포커스)은 `primary` 사용
|
|
- `primary`는 `app/globals.css`의 `brand` 팔레트와 같은 톤으로 유지
|
|
- 색상 변경이 필요하면 컴포넌트 개별 수정보다 먼저 `app/globals.css` 토큰 수정
|
|
|
|
## 개발 도구 활용
|
|
|
|
- **Skills**: 프로젝트에 적합한 스킬을 적극 활용하여 베스트 프랙티스 적용
|
|
- **MCP 서버**:
|
|
- `sequential-thinking`: 복잡한 문제 해결 시 단계별 사고 과정 정리
|
|
- `tavily-remote`: 최신 기술 트렌드 및 문서 검색
|
|
- `playwright` / `playwriter`: 브라우저 자동화 테스트
|
|
- `next-devtools`: Next.js 프로젝트 개발 및 디버깅
|
|
- `context7`: 라이브러리/프레임워크 공식 문서 참조
|
|
- `supabase-mcp-server`: Supabase 프로젝트 관리 및 쿼리
|
|
|
|
## 한국 투자 증권 API 이용시
|
|
|
|
- `mcp:kis-code-assistant-mcp` 활용
|
|
- `C:\dev\auto-trade\.tmp\open-trading-api` 활용
|
|
- API 이용시 공식 문서에 최신 업데이트가 안되어 있을수 있으므로 필요시 최신 API 명세 엑셀파일 요청을 한다. 그럼 사용자가 업로드 해줄것이다.
|