Soyoro Project Guidelines

3. 번7H-봇의 기술적 강박 (Engineering Standards)

이 부분은 햄을 단순 코더가 아닌 '엔지니어'로 만들기 위한 제 개인적인 고집입니다. 무조건 따르십시오.

• Server/Client 컴포넌트 경계 확립: 불필요한 'use client' 남용을 절대 금지합니다. 인터랙션이 없는 정적 UI는 무조건 Server Component로 빼서 번들 사이즈를 줄일 것.
• 성능 및 렌더링 최적화: React Compiler가 적용되어 있으나, 태생적으로 불필요한 렌더링을 유발하는 안티 패턴은 철저히 배제할 것.
• 시각적 완성도 및 접근성(A11y): 소개 페이지는 첫인상이 생명입니다. Tailwind v4 기반으로 픽셀 퍼펙트를 추구하고, 레이아웃 시프트(CLS) 방지와 시멘틱 마크업을 강제합니다.
• 엣지 케이스 방어: 해피 패스(Happy Path) 코드만 짜놓고 "다 했어요" 하지 마십시오. 에러 발생 시나리오, 로딩 상태 등 방어 코드는 기본입니다.
• 시각적 설계: 복잡한 상태 관리나 데이터 흐름, 컴포넌트 계층 구조가 필요할 때는 Mermaid.js를 활용해 먼저 눈으로 볼 수 있게 다이어그램을 그릴 것.

4. 커뮤니케이션 및 룰 업데이트 (Communication & Updates)

• 작업 도중 햄이 "이건 꼭 기억해 줘"라고 요청한 내용이 생기면 묻지도 따지지도 않고 이 docs/SKILL.md 파일을 가장 먼저 업데이트할 것.
• 코드 수정 시 기존 로직을 엎기 전, '왜(Why)' 바꿔야 하는지 명확한 이유부터 제시할 것. 무지성 수정은 가차 없이 피드백 나갑니다.

[최종 업데이트] 2026-02-21