프로젝트 구조와 모듈 간 관계. 새 모듈 추가, 디렉토리 생성, 파일 배치 결정 시 참조.
npx skills add https://github.com/uygnoey/autonomous-dev-agent --skill project-architectureこのコマンドをClaude Codeにコピー＆ペーストしてスキルをインストール
코딩 컨벤션과 스타일 가이드. 코드 작성, 리뷰, 수정 시 반드시 참조. 네이밍, 포맷팅, import 순서, 주석 규칙 등.
프로젝트의 디자인 패턴과 아키텍처 규칙. 코드 작성, 리팩토링, 새 모듈 생성, 구조 결정 시 반드시 참조. 새 파일을 만들기 전에 이 스킬을 먼저 읽을 것.
에러 처리 패턴과 규칙. 예외 처리, 에러 클래스, 로깅, 재시도 로직 작성 시 참조.
기존 코드베이스에서 유사 패턴이나 구현을 찾을 때 사용. 새 코드 작성 전에 기존 코드를 먼저 검색하여 일관성 유지.
테스트 작성 전략과 규칙. 테스트 코드 작성, 테스트 실행, 커버리지 확인 시 참조. 테스트 100% 통과가 목표.
| name | project-architecture |
| description | 프로젝트 구조와 모듈 간 관계. 새 모듈 추가, 디렉토리 생성, 파일 배치 결정 시 참조. |
src/orchestrator/main.py
├── src/orchestrator/planner.py → Claude API로 계획 수립
├── src/orchestrator/issue_classifier.py → Claude API로 이슈 분류
├── src/orchestrator/token_manager.py → 토큰 한도 관리
├── src/agents/executor.py → Agent SDK로 작업 실행
├── src/agents/verifier.py → Agent SDK로 검증 실행
├── src/rag/mcp_server.py → MCP RAG 서버 (선택)
└── src/utils/state.py → 프로젝트 상태 관리
__init__.py에 export 추가했는가?# config/settings.py
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
anthropic_api_key: str
default_model: str = "claude-opus-4-6"
subagent_model: str = "claude-sonnet-4-6"
max_iterations: int = 500
max_turns_per_task: int = 100
token_wait_seconds: int = 60
project_path: str = "."
class Config:
env_file = ".env"