저장소 루트 CLAUDE.md을 그대로 미러링한 문서다 — Claude Code이 참고하는 설정 파일이며, 손으로 고치지 말고 루트의 CLAUDE.md 원본을 고친 뒤 빌드하면 자동으로 갱신된다(scripts/sync-ai-docs.mjs).

## 개발

개발 서버를 시작할 때는 백그라운드 모드를 사용한다:

```
astro dev --background
```

백그라운드 서버는 `astro dev stop`, `astro dev status`, `astro dev logs`로 관리한다.

## 문서

전체 문서: https://docs.astro.build

관련 작업을 하기 전에 아래 가이드를 참고한다:

- [페이지, 동적 라우트, 미들웨어 추가하기](https://docs.astro.build/en/guides/routing/)
- [Astro 컴포넌트 다루기](https://docs.astro.build/en/basics/astro-components/)
- [React, Vue, Svelte 등 다른 프레임워크 컴포넌트 사용하기](https://docs.astro.build/en/guides/framework-components/)
- [콘텐츠 추가·관리하기](https://docs.astro.build/en/guides/content-collections/)
- [스타일 추가 또는 Tailwind 사용하기](https://docs.astro.build/en/guides/styling/)
- [다국어 지원하기](https://docs.astro.build/en/guides/internationalization/)