peterruiter/claude-build-framework

에이전트 브리프 작성

템플릿: ${CLAUDE_PLUGIN_ROOT}/templates/agent-brief.md. 배경: ${CLAUDE_PLUGIN_ROOT}/docs/waves-and-agents.md.

단계

1. 사실 수집(추측 금지):
   • 저장소 경로, 브랜치, 스택 요약(CLAUDE.md), 게이트 명령어(CLAUDE.md 또는 프로파일);
   • 언어: build/contracts/locales.json 읽기: 개수, 소스 언어, 가장 긴 언어(보통 독일어 또는 핀란드어) 및 복수형이 많은 언어(Intl.PluralRules에서 few/many가 필요한 경우, 설정되어 있다면)를 스크린샷용으로 파악;
   • 데이터 상주(CLAUDE.md);
   • 문자열 폴더, 용어집, 변경 로그(가장 높은 ID: "작성하는 시점에서 다음 빈 번호" 명시);
   • 예약된 마이그레이션 슬롯, 스크래치 DB, 포트, 스크래치 폴더(웨이브 계획에서 가져오거나, 비어 있는 것을 골라 기록);
   • 먼저 연구할 파일과 에이전트가 소유하는 파일.
2. 사용자 관점에서 목표 작성, 이후 구체적인 범위 항목과 범위 밖은 무엇인지 작성.
3. 템플릿의 모든 플레이스홀더 채우기. 실제로 해당하지 않는 섹션(예: 백엔드 전용 항목의 스크린샷)은 제거하고 한 줄로 이유 설명.
4. 상시 규칙을 템플릿에서 그대로 유지: 모든 설정 언어와 복수형, WCAG 2.2 AA, 라이트 및 다크 모드, 프라이버시 바이 디자인, 데이터 상주, 하나의 What's new 항목, STATE.md 섹션, 작고 집중된 수정, 커밋/푸시/배포/클라우드 금지, 비밀 정보 금지, 에이전트가 작성하는 모든 것에 AI 귀속 금지.
5. 숫자가 포함된 체크리스트와 보고서 형식을 마지막에 추가.
6. 항목이 보안에 민감한 표면(로그인, 토큰, 링크, 웹훅, 내보내기, 테넌트 경계)을 다루는 경우, ${CLAUDE_PLUGIN_ROOT}/docs/security-review.md의 관련 내용을 테스트와 함께 명시적 수락 기준으로 추가.
7. 브리프를 하나의 블록으로 출력하여 에이전트 프롬프트로 바로 전달할 수 있도록 함.