4.6 KiB
4.6 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| 프로젝트 컨텍스트 관리 | AI 에이전트를 안내하는 project-context.md를 만들고 유지합니다 |
|
project-context.md 파일을 사용해 모든 워크플로에서 AI 에이전트가 프로젝트의 기술 선호도와 구현 규칙을 따르게 하세요. 이 파일을 항상 참고하게 하려면 도구 컨텍스트나 항상 적용되는 규칙 파일(예: AGENTS.md)에 중요한 프로젝트 컨텍스트와 관례는 [프로젝트 컨텍스트 경로]/project-context.md에 있습니다라는 줄을 추가할 수도 있습니다.
:::note[필수 조건]
- BMad Method 설치
- 프로젝트의 기술 스택과 규칙에 대한 이해 :::
사용 시점
- 아키텍처를 시작하기 전에 강한 기술 선호도가 있습니다
- 아키텍처를 완료했고 구현 결정을 포착하고 싶습니다
- 이미 확립된 패턴이 있는 기존 코드베이스에서 작업합니다
- 스토리마다 에이전트가 일관되지 않은 결정을 내리는 문제가 보입니다
1단계: 접근 방식 선택
수동 작성 - 문서화할 규칙을 정확히 알고 있을 때 가장 좋습니다
아키텍처 후 생성 - 솔루션 설계 중 내려진 결정을 포착할 때 가장 좋습니다
기존 프로젝트용 생성 - 기존 코드베이스의 패턴을 발견할 때 가장 좋습니다
2단계: 파일 만들기
옵션 A: 수동 작성
_bmad-output/project-context.md에 파일을 만듭니다.
mkdir -p _bmad-output
touch _bmad-output/project-context.md
기술 스택과 구현 규칙을 추가합니다.
---
project_name: '내프로젝트'
user_name: '사용자이름'
date: '2026-02-15'
sections_completed: ['technology_stack', 'critical_rules']
---
# AI 에이전트용 프로젝트 컨텍스트
## 기술 스택과 버전
- Node.js 20.x, TypeScript 5.3, React 18.2
- 상태 관리: Zustand
- 테스트: Vitest, Playwright
- 스타일링: Tailwind CSS
## 중요한 구현 규칙
**TypeScript:**
- 엄격 모드 사용, `any` 타입 금지
- 공개 API에는 `interface`, 유니언에는 `type` 사용
**코드 구성:**
- 컴포넌트는 `/src/components/`에 두고 테스트를 함께 배치
- API 호출은 `apiClient` 싱글턴 사용 - 직접 fetch 금지
**테스트:**
- 단위 테스트는 비즈니스 로직에 집중
- 통합 테스트는 MSW로 API를 모킹
옵션 B: 아키텍처 후 생성
새 채팅에서 워크플로를 실행합니다.
bmad-generate-project-context
워크플로는 아키텍처 문서와 프로젝트 파일을 스캔해 내려진 결정을 담은 컨텍스트 파일을 생성합니다.
옵션 C: 기존 프로젝트용 생성
기존 프로젝트에서는 다음을 실행합니다.
bmad-generate-project-context
워크플로가 코드베이스를 분석해 규칙을 식별한 뒤 검토하고 다듬을 수 있는 컨텍스트 파일을 생성합니다.
3단계: 내용 확인
생성된 파일을 검토하고 다음이 담겨 있는지 확인하세요.
- 올바른 기술 버전
- 실제 관례(일반적인 모범 사례가 아님)
- 흔한 실수를 예방하는 규칙
- 프레임워크별 패턴
누락된 내용은 수동으로 추가하고 부정확한 내용은 제거하세요.
얻는 결과
project-context.md 파일은 다음을 제공합니다.
- 모든 에이전트가 같은 규칙을 따르게 합니다
- 스토리 간 일관되지 않은 결정을 방지합니다
- 구현을 위한 아키텍처 결정을 포착합니다
- 프로젝트 패턴과 규칙의 참조 자료가 됩니다
팁
:::tip[모범 사례]
- 겉으로 잘 드러나지 않는 것에 집중하세요 - "의미 있는 변수명을 사용하라" 같은 보편 규칙보다 "모든 공개 클래스에는 JSDoc을 사용하라"처럼 에이전트가 놓칠 수 있는 패턴을 문서화합니다.
- 간결하게 유지하세요 - 이 파일은 모든 구현 워크플로에서 로드됩니다. 긴 파일은 컨텍스트를 낭비합니다. 좁은 범위나 특정 스토리에만 적용되는 내용은 제외하세요.
- 필요할 때 업데이트하세요 - 패턴이 바뀌면 수동으로 수정하거나 큰 아키텍처 변경 후 다시 생성하세요.
- 빠른 흐름과 전체 BMad Method 프로젝트 모두에 사용할 수 있습니다. :::
다음 단계
- 프로젝트 컨텍스트 설명 - 작동 방식을 더 알아보기
- 워크플로 맵 - 어떤 워크플로가 프로젝트 컨텍스트를 로드하는지 보기