Skip to content

AGENTS.md

Latest commit

 

History

History
45 lines (33 loc) · 1.7 KB

AGENTS.md

File metadata and controls

45 lines (33 loc) · 1.7 KB

AGENTS.md

Project

pnpm monorepo (Turbo) — apps/web (TanStack Start), apps/api (Nitro), packages/ui (shadcn), packages/db (Drizzle + PostgreSQL).

Commands

  • pnpm dev — 전체 dev server
  • pnpm build — 전체 빌드
  • pnpm ui:add <name> — shadcn 컴포넌트 추가 (packages/ui)
  • make dev-up — Docker로 db + api 실행
  • pnpm --filter <package> check-types — 타입 체크

Conventions

  • 한국어 커밋 메시지, 코드/변수명은 영어
  • Tailwind CSS v4, CSS variables 기반 테마
  • UI 컴포넌트는 packages/ui, 앱별 컴포넌트는 각 apps 내부
  • UI 관련 작업 시 반드시 DESIGN.md 참조

Memories Workflow (Required)

장기/다단계 작업에서는 memories/ 문서를 필수 컨텍스트로 사용한다.

작업 시작 전

  • memories/plan.md와 memories/task.md를 먼저 확인한다.
  • 현재 우선순위, 의존성, 진행 상태(대기/진행중/완료)를 기준으로 작업 범위를 정한다.

작업 완료 후

  • memories/task.md에 진행 상태를 반영한다.
  • 필요 시 memories/plan.md의 단계/설명을 현재 구현 상태와 동기화한다.
  • 변경 사항은 간결하게 기록해 다음 세션/다른 에이전트가 즉시 이어받을 수 있게 한다.

Structure

apps/web/src/styles.css        — Tailwind 진입점 + @source
apps/web/src/routes/           — 라우트/페이지 (TanStack Start)
apps/api/src/                  — 서버 엔트리/모듈/컨트롤러 (NestJS)
packages/db/src/               — Drizzle schema/DB 로직
packages/ui/src/styles/        — 테마 변수 (globals.css)
packages/ui/src/components/ui/ — shadcn 컴포넌트
packages/ui/src/lib/           — 유틸 (cn 등)