Skip to content

[#475] Hermes Agent를 사용하여 프로젝트의 아키텍쳐를 명세하여 AI의 작업 효율을 개선한다#476

Merged
opficdev merged 6 commits into
developfrom
chore/#475-Hermes
May 19, 2026
Merged

[#475] Hermes Agent를 사용하여 프로젝트의 아키텍쳐를 명세하여 AI의 작업 효율을 개선한다#476
opficdev merged 6 commits into
developfrom
chore/#475-Hermes

Conversation

@opficdev
Copy link
Copy Markdown
Owner

🔗 연관된 이슈

🎯 의도

AI 모델이 아키텍처 경계, 모듈 의존성, 검증 절차를 일관되게 따를 수 있도록 저장소 로컬 규칙과 Hermes Skill 기준을 문서화하기 위함

📝 작업 내용

📌 요약

  • DevLog 전용 AGENTS.md 작업 규칙 추가
  • Hermes Skill 설치 및 사용 안내 문서 추가
  • DevLog 아키텍처 하네스 Skill 진입점 추가
  • 아키텍처 경계 판단 흐름과 워크플로우 규칙 문서화

🔍 상세

  • 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)

opficdev added 5 commits May 18, 2026 18:30
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로 분리
@opficdev opficdev self-assigned this May 19, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

이번 PR은 AI 에이전트가 프로젝트의 아키텍처 원칙을 준수하며 작업할 수 있도록 'DevLog Architecture Harness'와 관련 가이드라인을 도입합니다. 주요 변경 사항으로는 Hermes 스킬 정의, 상세 아키텍처 흐름도, 워크플로우 규칙 및 에이전트 전용 지침서(AGENTS.md) 추가가 포함됩니다. 리뷰를 통해 지침서 내에 포함된 로컬 절대 경로를 상대 경로로 수정하여 환경 범용성을 높이고, 설명된 레이어 경로를 실제 디렉토리 구조와 일치시키도록 하는 개선 사항이 제안되었습니다.

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
Comment thread .hermes/skills/devlog-architecture-harness/SKILL.md Outdated
@opficdev opficdev merged commit 11fab68 into develop May 19, 2026
1 check passed
@opficdev opficdev deleted the chore/#475-Hermes branch May 19, 2026 05:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Hermes Agent를 사용하여 프로젝트의 아키텍쳐를 명세하여 AI의 작업 효율을 개선한다

1 participant