[#475] Hermes Agent를 사용하여 프로젝트의 아키텍쳐를 명세하여 AI의 작업 효율을 개선한다#476
Merged
Conversation
DevLog 레포 전용 AI 작업 규칙 추가 아키텍처 변경 시 확인할 모듈 경계와 모호성 게이트 정의 전역 메모리보다 레포 로컬 규칙을 우선하는 기준 명시
DevLog 프로젝트에서 사용하는 Hermes Skill 위치 안내 로컬 Skill 설치 명령과 실행 방법 정리 AGENTS.md와 Hermes reference의 canonical 관계 명시
아키텍처 작업에 적용할 Hermes Skill 메타데이터 추가 작업 분류, 모호성 게이트, 검증 절차 정의 상세 플로우와 워크플로 reference 연결
AI 하네스의 요청 처리 흐름을 Mermaid로 정리 모듈 레이어 맵과 Core, Domain 판단 흐름 정의 외부 의존성, Widget 데이터, 검증 플로우 기준 추가
PR, 커밋, Xcode 프로젝트, CI 작업 규칙 정리 Data, Domain, Infra 경계와 Presentation Store 규칙 이전 Widget, localization, release 관련 DevLog 전용 규칙을 Hermes reference로 분리
Contributor
There was a problem hiding this comment.
Code Review
이번 PR은 AI 에이전트가 프로젝트의 아키텍처 원칙을 준수하며 작업할 수 있도록 'DevLog Architecture Harness'와 관련 가이드라인을 도입합니다. 주요 변경 사항으로는 Hermes 스킬 정의, 상세 아키텍처 흐름도, 워크플로우 규칙 및 에이전트 전용 지침서(AGENTS.md) 추가가 포함됩니다. 리뷰를 통해 지침서 내에 포함된 로컬 절대 경로를 상대 경로로 수정하여 환경 범용성을 높이고, 설명된 레이어 경로를 실제 디렉토리 구조와 일치시키도록 하는 개선 사항이 제안되었습니다.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🔗 연관된 이슈
🎯 의도
AI 모델이 아키텍처 경계, 모듈 의존성, 검증 절차를 일관되게 따를 수 있도록 저장소 로컬 규칙과 Hermes Skill 기준을 문서화하기 위함
📝 작업 내용
📌 요약
AGENTS.md작업 규칙 추가🔍 상세
AGENTS.md에 DevLog 모듈 레이어 맵, Store 흐름, ambiguity gate, 검증 규칙 정리.hermes/README.md에 Hermes Skill 설치 경로와 실행 방법 정리.hermes/skills/devlog-architecture-harness/SKILL.md에 아키텍처 작업 전 필수 확인 절차 정의devlog-architecture-flow.md에 레이어 의존성, Core/Domain 판단, 외부 SDK 배치, 위젯 데이터 흐름 정리devlog-workflow-rules.md에 PR, 커밋, Xcode 프로젝트 파일, CI, Widget, Store, Localization, Release 관련 작업 규칙 정리📸 영상 / 이미지 (Optional)