hyowons
549545bde6
설정·스크립트·스킬·문서·큐레이션 메모리 추적. 시크릿(credentials/identity)·런타임 상태(state/logs/sessions/sqlite)· 백업(clobbered/bak)·dream 캐시는 .gitignore로 제외. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.0 KiB
1.0 KiB
Architecture
Goal
이 저장소는 에이전트가 이해하고 수정하기 쉬운 구조를 유지하는 것을 목표로 한다.
Principles
- 구조는 단순하게 유지한다.
- 경계는 명확하게 둔다.
- 숨은 규칙보다 문서화된 규칙을 우선한다.
- 에이전트가 읽을 수 없는 지식은 없는 지식으로 간주한다.
Recommended Layers
프로젝트 특성에 맞게 조정하되, 아래처럼 역할을 분리한다.
- Types / Schema
- Config
- Repository / Data Access
- Service / Domain Logic
- Runtime / API / App Layer
- UI (해당 시)
Constraints
- 비즈니스 로직은 경계가 분명한 계층 안에 둔다.
- 데이터 입출력은 경계에서 검증한다.
- 공통 규칙은 문서와 도구로 강제한다.
- 복잡한 예외 규칙은 최소화한다.
Agent-friendly Design
- 파일은 너무 커지지 않게 유지한다.
- 이름은 역할이 드러나게 짓는다.
- 암묵적 규칙보다 명시적 규칙을 택한다.
- 관련 문서는 코드 가까이에 둔다.