133 lines
4.6 KiB
Markdown
133 lines
4.6 KiB
Markdown
---
|
|
title: '프로젝트 컨텍스트 관리'
|
|
description: AI 에이전트를 안내하는 project-context.md를 만들고 유지합니다
|
|
sidebar:
|
|
order: 9
|
|
---
|
|
|
|
`project-context.md` 파일을 사용해 모든 워크플로에서 AI 에이전트가 프로젝트의 기술 선호도와 구현 규칙을 따르게 하세요. 이 파일을 항상 참고하게 하려면 도구 컨텍스트나 항상 적용되는 규칙 파일(예: `AGENTS.md`)에 `중요한 프로젝트 컨텍스트와 관례는 [프로젝트 컨텍스트 경로]/project-context.md에 있습니다`라는 줄을 추가할 수도 있습니다.
|
|
|
|
:::note[필수 조건]
|
|
|
|
- BMad Method 설치
|
|
- 프로젝트의 기술 스택과 규칙에 대한 이해
|
|
:::
|
|
|
|
## 사용 시점
|
|
|
|
- 아키텍처를 시작하기 전에 강한 기술 선호도가 있습니다
|
|
- 아키텍처를 완료했고 구현 결정을 포착하고 싶습니다
|
|
- 이미 확립된 패턴이 있는 기존 코드베이스에서 작업합니다
|
|
- 스토리마다 에이전트가 일관되지 않은 결정을 내리는 문제가 보입니다
|
|
|
|
## 1단계: 접근 방식 선택
|
|
|
|
**수동 작성** - 문서화할 규칙을 정확히 알고 있을 때 가장 좋습니다
|
|
|
|
**아키텍처 후 생성** - 솔루션 설계 중 내려진 결정을 포착할 때 가장 좋습니다
|
|
|
|
**기존 프로젝트용 생성** - 기존 코드베이스의 패턴을 발견할 때 가장 좋습니다
|
|
|
|
## 2단계: 파일 만들기
|
|
|
|
### 옵션 A: 수동 작성
|
|
|
|
`_bmad-output/project-context.md`에 파일을 만듭니다.
|
|
|
|
```bash
|
|
mkdir -p _bmad-output
|
|
touch _bmad-output/project-context.md
|
|
```
|
|
|
|
기술 스택과 구현 규칙을 추가합니다.
|
|
|
|
```markdown
|
|
---
|
|
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: 아키텍처 후 생성
|
|
|
|
새 채팅에서 워크플로를 실행합니다.
|
|
|
|
```bash
|
|
bmad-generate-project-context
|
|
```
|
|
|
|
워크플로는 아키텍처 문서와 프로젝트 파일을 스캔해 내려진 결정을 담은 컨텍스트 파일을 생성합니다.
|
|
|
|
### 옵션 C: 기존 프로젝트용 생성
|
|
|
|
기존 프로젝트에서는 다음을 실행합니다.
|
|
|
|
```bash
|
|
bmad-generate-project-context
|
|
```
|
|
|
|
워크플로가 코드베이스를 분석해 규칙을 식별한 뒤 검토하고 다듬을 수 있는 컨텍스트 파일을 생성합니다.
|
|
|
|
## 3단계: 내용 확인
|
|
|
|
생성된 파일을 검토하고 다음이 담겨 있는지 확인하세요.
|
|
|
|
- 올바른 기술 버전
|
|
- 실제 관례(일반적인 모범 사례가 아님)
|
|
- 흔한 실수를 예방하는 규칙
|
|
- 프레임워크별 패턴
|
|
|
|
누락된 내용은 수동으로 추가하고 부정확한 내용은 제거하세요.
|
|
|
|
## 얻는 결과
|
|
|
|
`project-context.md` 파일은 다음을 제공합니다.
|
|
|
|
- 모든 에이전트가 같은 규칙을 따르게 합니다
|
|
- 스토리 간 일관되지 않은 결정을 방지합니다
|
|
- 구현을 위한 아키텍처 결정을 포착합니다
|
|
- 프로젝트 패턴과 규칙의 참조 자료가 됩니다
|
|
|
|
## 팁
|
|
|
|
:::tip[모범 사례]
|
|
|
|
- **겉으로 잘 드러나지 않는 것에 집중하세요** - "의미 있는 변수명을 사용하라" 같은 보편 규칙보다 "모든 공개 클래스에는 JSDoc을 사용하라"처럼 에이전트가 놓칠 수 있는 패턴을 문서화합니다.
|
|
- **간결하게 유지하세요** - 이 파일은 모든 구현 워크플로에서 로드됩니다. 긴 파일은 컨텍스트를 낭비합니다. 좁은 범위나 특정 스토리에만 적용되는 내용은 제외하세요.
|
|
- **필요할 때 업데이트하세요** - 패턴이 바뀌면 수동으로 수정하거나 큰 아키텍처 변경 후 다시 생성하세요.
|
|
- 빠른 흐름과 전체 BMad Method 프로젝트 모두에 사용할 수 있습니다.
|
|
:::
|
|
|
|
## 다음 단계
|
|
|
|
- [**프로젝트 컨텍스트 설명**](../explanation/project-context.md) - 작동 방식을 더 알아보기
|
|
- [**워크플로 맵**](../reference/workflow-map.md) - 어떤 워크플로가 프로젝트 컨텍스트를 로드하는지 보기
|