auto-trade/AGENTS.md

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 서버:
  • next-devtools: Next.js 프로젝트 개발/디버깅, 공식 문서 인덱스 조회
  • playwright: 브라우저 자동화 테스트 (페이지 상호작용/검증)
  • playwriter: Chrome 확장 기반 브라우저 자동화/디버깅
  • context7: 라이브러리/프레임워크 공식 문서 참조
  • supabase-mcp-server: Supabase 프로젝트 관리 및 SQL/함수 작업
  • tavily-remote: 최신 기술 트렌드/웹 검색
  • sequential-thinking: 복잡한 문제를 단계적으로 정리
  • figma: Figma 파일 레이아웃/스타일/에셋 조회
  • mcp:kis-code-assistant-mcp: 한국투자증권 API 검색/소스 조회

한국 투자 증권 API 이용시

• mcp:kis-code-assistant-mcp 활용
• C:\dev\auto-trade\.tmp\open-trading-api 활용
• 업로드된 전체 API 엑셀을 우선 참고: C:\dev\auto-trade\common-docs\api-reference\openapi_all.xlsx
• API 스펙 확인 순서: openapi_all.xlsx -> mcp:kis-code-assistant-mcp -> .tmp\open-trading-api 샘플 코드
• 공식 문서와 엑셀/실코드가 다르면 엑셀과 실코드를 우선 기준으로 판단하고, 차이가 크면 사용자에게 최신 파일 재확인 요청

소개문구

• 불안감을 해소하고 확신을 주는 문구
• 친근하고 확신에 찬 문구를 사용하여 심리적 장벽을 낮추는 전략