Codex 멀티 에이전트 환경 구축

[SongMinQQ]

#️⃣연관된 이슈

#29

📝작업 내용

browser-debugger

• 브라우저에서 이슈를 재현하고, 화면 동작을 확인하는 디버깅용 에이전트입니다.
• 스크린샷, 콘솔 로그, 네트워크 흐름 같은 근거를 수집하는 데 적합합니다.
• UI 문제를 먼저 사실 기반으로 파악할 때 사용합니다.

ui-fixer

• 재현된 문제를 바탕으로 작은 범위의 구현 수정을 담당하는 에이전트입니다.
• 불필요한 변경을 피하고, 변경한 동작만 검증하는 방식에 적합합니다.
• 디버깅 이후 실제 코드 수정 단계에서 사용합니다.

writer

• 구현된 내용이나 작업 결과를 문서화하는 에이전트입니다.
• 변경 사항, 확인 필요 항목, 발생한 문제와 해결 과정을 문서 중심으로 정리하는 데 적합합니다.
• 현재와 같은 요약 문서, 작업 기록, 운영 메모를 작성할 때 사용합니다.

설치된 스킬

vercel-composition-patterns

• React 컴포지션 패턴과 구조 설계에 대한 가이드를 제공하는 스킬입니다.
• 컴포넌트 설계, 상태 분리, 조합 중심 UI 작성에 참고합니다.

vercel-react-best-practices

• React 구현 시 성능, 렌더링, 비동기 처리 관련 베스트 프랙티스를 제공하는 스킬입니다.
• UI 수정이나 React 코드 작성 시 기본 기준으로 활용합니다.

web-design-guidelines

• 웹 UI의 시각적 완성도와 디자인 방향을 정리한 스킬입니다.
• 레이아웃, 분위기, 인터랙션의 품질을 높이는 데 참고합니다.

현재 구조 및 운영 메모

• 커스텀 에이전트는 .codex/agents 아래에, repo 공용 스킬은 .agents/skills 아래에 분리되어 있습니다.
• ui-fixer는 repo 공용 스킬 경로를 참조하도록 정리되어 있어 재사용성이 높습니다.
• browser-debugger는 브라우저 재현 중심, ui-fixer는 최소 수정 중심, writer는 문서화 중심으로 역할이 나뉘어 있습니다.
• 새 작업을 시작할 때는 먼저 디버깅용 에이전트로 사실을 확인하고, 수정은 ui-fixer, 정리는 writer로 이어가는 흐름이 가장 자연스럽습니다.

스크린샷 (선택)

생성된 에이전트는 다음과 같이 @ 키워드로 태그하여 사용

💬리뷰 요구사항(선택)

리뷰어가 특별히 봐주었으면 하는 부분이 있다면 작성해주세요

ex) 메서드 XXX의 이름을 더 잘 짓고 싶은데 혹시 좋은 명칭이 있을까요?

[gemini-code-assist]

Code Review

This pull request updates the .gitignore file to exclude AI agent-related directories and introduces a skills-lock.json file to track external skill dependencies and their integrity hashes. I have no feedback to provide as there are no review comments.