# AGENTS.md

## 프로젝트 정체

- Music Assistant 프론트엔드 프로젝트.
- 본 파일 작성 시점(초기화) 기준 저장소는 비어 있음. 구조/매니페스트/빌드 산출물이 생기면 이 파일을 해당 사실에 맞춰 갱신할 것.

## 진실의 원천 계약

- 사용자와의 논의 내용은 이 저장소를 "유일한 진실의 원천"으로 문서화한다. 산출물은 코드·문서·설정 파일로 저장하여 대화 기록에만 의존하지 않는다.
- 논의 결과 기존 진실을 변경해야 하면, 모순이 발생하지 않도록 연관된 모든 문서·설정·코드를 함께 갱신한다. 한쪽만 고치고 다른 쪽을 방치하지 않는다.
- 이 저장소는 git 프로젝트이므로 의미 있는 단위마다 주기적으로 커밋한다.

## 커밋 컨벤션

표준 conventional commits를 유지하되 메시지는 한국어로 작성.

```
[접두어]: [요약된 내용]
```

- 본문(설명/옵션)이 필요하면 제목 다음 줄에 빈 줄 하나 두고 작성.
- 접두어 예: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `build`, `ci`, `perf`, `revert`.
- 한국어 요약은 명사구 또는 문장형으로 간결하게.

## 도구 환경

- Node 24, pnpm 11, bun 1.3, git 2.53 사용 가능.
- 패키지 매니페스트가 없는 초기 상태이므로 아직 빌드/테스트/린트 명령은 확정되지 않음. 매니페스트가 생성되면 여기에 정확한 명령을 기록할 것.
- 명령 순서가 중요해지면(예: `lint -> typecheck -> test`) 그 순서를 명시할 것.

## 작업 주의사항

- 빈 저장소에서 시작하므로, 파일을 생성하기 전에 먼저 기존 구조를 확인한다. 추측으로 파일 트리를 만들지 않는다.
- 설치 스크립트·빌드 명령·환경 변수 로딩 등 비자명한 설정이 생기면 이 파일에 즉시 기록한다.
- 일반 언어/프레임워크 관례, 자명한 사실, 검증 불가능한 추측은 여기에 적지 않는다.