architecture-context은(는) 무엇을 하나요?
AI 기반 개발(Claude Code, Codex)을 위한 아키텍처 컨텍스트 팩입니다. 서비스 맵, 흐름, 규칙을 제공합니다.
개요
이 팩은 AI 어시스턴트가 프로젝트의 아키텍처 맥락을 이해하는 데 필요한 핵심 정보를 담고 있습니다. 주요 구성 요소는 다음과 같습니다:
- 서비스 맵: 각 서비스의 역할과 의존성을 정의합니다.
- 데이터 흐름: 시스템 간 데이터 이동 및 변환을 설명합니다.
- 코딩 규칙: 프로젝트에서 준수해야 할 명명 규칙, 패턴, 모범 사례를 명시합니다.
사용 방법
이 팩은 다음 플랫폼에서 사용할 수 있습니다:
- Claude Code:
.claude/settings.json또는CLAUDE.md파일에 참조를 추가합니다. - Codex: 프롬프트 시작 부분에 이 내용을 포함시킵니다.
Claude Code 예시
.claude/settings.json 파일:
{
"skills": ["p-onchain/architecture-context"]
}
주요 내용
1. 서비스 맵
| 서비스 | 설명 | 의존성 |
|---|---|---|
| api-gateway | 외부 요청을 처리하고 인증을 수행합니다. | auth-service, user-service |
| auth-service | 사용자 인증 및 권한 부여를 담당합니다. | user-db |
| user-service | 사용자 프로필 및 설정을 관리합니다. | user-db, cache |
| payment-service | 결제 처리를 담당합니다. | payment-gateway, order-service |
2. 데이터 흐름
graph TD
A[사용자] -->|HTTP 요청| B[api-gateway]
B -->|인증 요청| C[auth-service]
B -->|사용자 요청| D[user-service]
D -->|데이터 조회| E[(user-db)]
D -->|캐싱| F[(cache)]
3. 코딩 규칙
- 명명 규칙: 변수와 함수는
camelCase를 사용합니다. 클래스는PascalCase를 사용합니다. - 에러 처리: 모든 함수는 에러를 명시적으로 반환하거나 예외를 던져야 합니다.
- 테스트: 모든 새로운 기능에는 단위 테스트가 포함되어야 합니다.
라이선스
MIT