Skip to content

[CHORE] 멀티 에이전트 개발 환경 설정 및 프로젝트 컨벤션 문서화#7

Merged
kimminna merged 3 commits into
developfrom
chore/6-setup-agent-workflow-and-conventions
May 19, 2026
Merged

[CHORE] 멀티 에이전트 개발 환경 설정 및 프로젝트 컨벤션 문서화#7
kimminna merged 3 commits into
developfrom
chore/6-setup-agent-workflow-and-conventions

Conversation

@kimminna

Copy link
Copy Markdown
Member

ISSUE 🔗

close #6



What is this PR? 🔍

1. docs: AGENTS.md 프로젝트 컨텍스트 및 컨벤션 문서화

  • 💡 배경: 에이전트가 대화를 시작할 때마다 앱 개요, 기술 스택, 데이터 타입 등 프로젝트 컨텍스트를 파악해야 하는 문제가 있었습니다.
  • ✨ 주요 변경사항: AGENTS.md에 앱 개요, 기술 스택, 디렉토리 구조 목표, 핵심 데이터 타입(Experience·JobPosting·CoverLetter), 개발 워크플로우를 추가했습니다. 컴포넌트 규칙·네이밍·타입·Mock 패턴·테스트·Storybook 등 9개 섹션의 컨벤션을 CONVENTIONS.md로 분리하여 작성하고 CLAUDE.md에서 함께 로드하도록 했습니다.

2. chore: Prettier 자동 포맷 PostToolUse Hook 추가

  • 💡 배경: Claude Code가 파일을 생성하거나 수정할 때 Prettier 포맷이 자동으로 적용되지 않아 커밋 전 수동으로 포맷을 실행해야 했습니다.
  • ✨ 주요 변경사항: .claude/settings.json에 PostToolUse Hook을 추가하여 Write/Edit 도구 실행 후 Prettier가 자동으로 실행되도록 했습니다.

3. chore: /feature 멀티 에이전트 커맨드 및 에이전트 정의 추가

  • 💡 배경: 기능 구현 시 스펙 문서 작성, 컴포넌트·테스트·Storybook 구현, 코드 검증을 일관된 방식으로 자동화할 수 있는 구조가 필요했습니다.
  • ✨ 주요 변경사항: feature-planner·feature-implementer·feature-verifier 에이전트와 /feature 오케스트레이터 커맨드를 추가하여 Plan → Implement → Verify 3단계 워크플로우를 구성했습니다. docs/specs/에 스펙 문서가 저장되는 구조도 함께 문서화했습니다.



Screenshot 📷



Test Checklist ✔

  • AGENTS.mdCONVENTIONS.md가 Claude Code 대화 시작 시 자동으로 로드되는지 확인
  • 파일 저장(Write/Edit) 후 Prettier가 자동 실행되는지 확인
  • /feature 커맨드가 Plan → Implement → Verify 3단계로 올바르게 진행하는지 확인
  • 기존 /issue, /commit, /pr 커맨드가 정상 동작하는지 확인

kimminna added 3 commits May 19, 2026 16:12
- 앱 개요, 기술 스택, 디렉토리 구조, 핵심 데이터 타입을 AGENTS.md에 추가했습니다
- CLAUDE.md에 CONVENTIONS.md include를 추가했습니다
- 컴포넌트·네이밍·타입·Mock·스타일·테스트·Storybook 등 9개 섹션의 컨벤션을 CONVENTIONS.md에 작성했습니다
- 파일 저장(Write/Edit) 시 Prettier가 자동 실행되도록 .claude/settings.json에 PostToolUse Hook을 추가했습니다
- feature-planner 에이전트를 추가하여 기능 스펙 문서를 docs/specs/에 자동 생성하도록 했습니다
- feature-implementer 에이전트를 추가하여 스펙 기반으로 컴포넌트·테스트·Storybook 스토리를 구현하도록 했습니다
- feature-verifier 에이전트를 추가하여 TypeScript·ESLint·테스트 검증 리포트를 반환하도록 했습니다
- /feature 오케스트레이터 커맨드를 추가하여 Plan → Implement → Verify 3단계 워크플로우를 자동화했습니다
- docs/specs/README.md에 워크플로우와 스펙 파일 네이밍 규칙을 문서화했습니다
@github-actions github-actions Bot added the 🔧 Chore 빌드 및 기타 설정 변경 label May 19, 2026
@kimminna kimminna changed the title [CHORE]: 멀티 에이전트 개발 환경 설정 및 프로젝트 컨벤션 문서화 [CHORE] 멀티 에이전트 개발 환경 설정 및 프로젝트 컨벤션 문서화 May 19, 2026
@kimminna kimminna merged commit 5bfcd74 into develop May 19, 2026
5 checks passed
@kimminna kimminna deleted the chore/6-setup-agent-workflow-and-conventions branch May 19, 2026 07:19
@kimminna kimminna mentioned this pull request May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🔧 Chore 빌드 및 기타 설정 변경

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[CHORE] 멀티 에이전트 개발 환경 설정 및 프로젝트 컨벤션 문서화

1 participant