senior-architect

senior-architect skill 개요

senior-architect의 용도

senior-architect는 모호한 시스템 설계 질문을 구조화된 아키텍처 의사결정, 다이어그램, 의존성 검토, 구현 트레이드오프로 정리해 주는 Software Architecture skill입니다. 일반적인 브레인스토밍 답변보다 아키텍처 계획, ADR 스타일의 판단 근거, 기술 스택 비교, 확장성 검토, 코드베이스 수준의 아키텍처 평가가 필요한 사용자에게 특히 적합합니다.

잘 맞는 사용자와 작업

monolith, modular monolith, microservices, event-driven, CQRS, hexagonal, clean architecture 패턴 중 무엇을 선택할지 결정해야 할 때 senior-architect skill을 사용하면 좋습니다. 기존 repository를 검토하는 팀에도 유용합니다. 포함된 Python scripts가 프로젝트 구조를 스캔하고, 아키텍처 계층을 추론하며, 결합도를 감지하고, Mermaid, PlantUML, ASCII 다이어그램을 생성할 수 있기 때문입니다.

차별점

이 skill은 프롬프트 가이드와 실제 repository 분석 도구를 함께 제공합니다. 참조 문서는 아키텍처 패턴, 시스템 설계 워크플로, 기술 의사결정 매트릭스를 다루고, scripts는 프로젝트 다이어그램 생성, 의존성 분석, 아키텍처 평가를 지원합니다. 그래서 코드베이스의 근거를 바탕으로 판단해야 할 때 단순한 “act as a senior architect” 프롬프트보다 훨씬 실용적입니다.

도입 시 중요한 제약

scripts는 휴리스틱 기반 스캐너이지 정식 아키텍처 검증 도구가 아닙니다. 일반적인 프로젝트 구조와 Node, Python, Go, Rust, Java, Docker, Kubernetes 같은 흔한 생태계에서 가장 잘 작동합니다. 매우 커스텀된 monorepo에서는 생성된 결과를 최종 결론이 아니라 검토를 시작하기 위한 자료로 봐야 합니다.

senior-architect skill 사용 방법

senior-architect 설치와 먼저 읽을 파일

GitHub skill directory에서 다음 명령으로 설치합니다.

npx skills add alirezarezvani/claude-skills --skill senior-architect

설치 후에는 먼저 SKILL.md를 읽어 트리거 범위와 명령 예시를 확인하세요. 그다음 아래 파일을 살펴보는 것이 좋습니다.

• references/architecture_patterns.md: 패턴별 트레이드오프와 “when not to use” 가이드
• references/system_design_workflows.md: 용량 계획, API 설계, 마이그레이션, 확장성 워크플로
• references/tech_decision_guide.md: 데이터베이스, 캐싱, 큐, 인증, 프론트엔드, 클라우드, API 스타일 선택 기준
• scripts/architecture_diagram_generator.py
• scripts/dependency_analyzer.py
• scripts/project_architect.py

이 순서로 읽으면 결과물에 의존하기 전에 판단 프레임워크와 실행 가능한 분석 도구를 함께 이해할 수 있습니다.

더 나은 아키텍처 결과를 만드는 입력

senior-architect skill은 비즈니스 맥락과 기술적 제약을 함께 제공할 때 가장 잘 작동합니다. 약한 프롬프트는 “Design a scalable backend.”입니다. 더 좋은 프롬프트는 다음과 같습니다.

Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.

유용한 입력에는 예상 사용자 수, 요청량, 읽기/쓰기 비율, 지연 시간 목표, 가용성 목표, 데이터 보존 기간, 컴플라이언스 요구사항, 팀 규모, 배포 환경, 현재 기술 스택, 마이그레이션 제약, 이미 제외한 선택지가 포함됩니다.

실무에서의 senior-architect 사용 워크플로

새 시스템이라면 참조 워크플로부터 시작하세요. 기능 요구사항을 명확히 하고, 규모를 추정하고, 비기능 요구사항을 식별한 뒤, 트레이드오프가 포함된 후보 아키텍처를 요청합니다. 기존 코드베이스라면 추천을 요청하기 전에 scripts를 먼저 실행하세요.

python scripts/architecture_diagram_generator.py ./my-project --format mermaid

python scripts/dependency_analyzer.py ./my-project --output json

python scripts/project_architect.py ./my-project --verbose

프롬프트에는 가장 관련 있는 결과를 붙여 넣으세요. 예를 들어 감지된 패턴, 결합도 점수, 순환 의존성, 누락된 계층, package manager, 추천 사항을 포함할 수 있습니다. 이렇게 하면 모델이 모호한 설명만으로 아키텍처를 추론하지 않고, 실제 근거를 바탕으로 답변할 수 있습니다.

의사결정과 리뷰를 위한 프롬프트 패턴

설계 의사결정이 필요하다면 명시적인 결정 형식을 요청하세요. context, options, decision criteria, recommended option, rejected alternatives, risks, migration plan, open questions를 포함하도록 요구하는 방식입니다. 리뷰의 경우 skill이 “observed facts”, “interpretation”, “recommended changes”를 구분하게 하세요. 이렇게 하면 과도하게 확신에 찬 아키텍처 조언을 줄이고, 결과를 ADR, 로드맵 항목, 엔지니어링 제안서로 전환하기 쉬워집니다.

senior-architect skill FAQ

senior-architect는 대규모 시스템에만 필요한가요?

아닙니다. 작은 팀이 단순한 아키텍처를 선택하고 성급한 microservices 도입을 피하는 데도 도움이 됩니다. 포함된 아키텍처 패턴 참조는 monolith와 modular monolith의 트레이드오프를 명시적으로 다루므로, 최선의 답이 “더 단순하게 유지하자”일 때도 유용합니다.

일반 아키텍처 프롬프트보다 무엇이 더 좋은가요?

일반 프롬프트는 사용자가 무엇을 포함했는지에 크게 좌우됩니다. senior-architect skill은 재사용 가능한 의사결정 워크플로, 패턴 참조, 기술 비교 매트릭스, 코드베이스 스캔 scripts를 더해 줍니다. 이 조합은 일회성 조언보다 반복 가능한 아키텍처 리뷰가 필요할 때 특히 가치가 있습니다.

초보자도 이 senior-architect skill을 사용할 수 있나요?

네. 다만 초보자는 이를 권위 있는 정답이 아니라 안내형 의사결정 보조 도구로 사용해야 합니다. 트레이드오프 설명, 용어 정의, 가정 표시를 요청하세요. 규모, 가용성 목표, 운영 제약을 아직 모른다면 설계를 추천하기 전에 빠진 질문 목록부터 제시해 달라고 요청하는 것이 좋습니다.

언제 사용하지 않는 편이 좋나요?

보안이 중요하거나 컴플라이언스 부담이 크거나 production 마이그레이션이 걸린 의사결정에서 유일한 근거로 사용해서는 안 됩니다. 또한 profiling, load testing, cloud cost modeling, 고유한 도메인에 대한 전문가 리뷰를 대체하지도 않습니다. 저수준 구현 버그라면 언어별 debugging skill이 더 적합할 수 있습니다.

senior-architect skill 개선 방법

측정 가능한 제약으로 senior-architect 입력 개선하기

가장 흔한 실패 양상은 그럴듯하지만 실행하기 어려운 아키텍처 조언입니다. 결과를 개선하려면 사용자 수, 초당 요청 수, 스토리지 증가량, 피크 배수, 지연 시간 예산, uptime 목표, 팀 규모, 릴리스 빈도, 비용 상한처럼 숫자로 표현된 정보를 추가하세요. “high scale”이나 “enterprise grade” 같은 형용사보다 대략적인 추정치라도 훨씬 낫습니다.

변경을 요청하기 전에 repository 근거 사용하기

기존 프로젝트라면 script output과 간단한 file-tree 요약을 함께 포함하세요. 코드가 controllers/services/repositories 구조를 쓰는지, domain/application/infrastructure 폴더를 쓰는지, Docker, Kubernetes, message queues, 여러 deployable services를 사용하는지도 언급하세요. 이렇게 하면 senior-architect가 의도된 아키텍처와 우연한 폴더 명명 방식을 구분하는 데 도움이 됩니다.

넓은 설계에서 구체적인 산출물로 반복하기

첫 아키텍처 제안에서 멈추지 마세요. 후속 질문으로 ADR, Mermaid diagram, migration sequence, risk register, database choice, API boundary, service ownership model을 요청하세요. 좋은 반복 경로는 high-level design → trade-off comparison → chosen architecture → diagram → ADR → phased implementation plan입니다.

과도한 설계와 누락된 가정 점검하기

결과가 microservices, event sourcing, CQRS, distributed messaging을 권장한다면 추가 운영 복잡도를 감수할 근거가 무엇인지 물어보세요. 가정이 빠져 있다면 미확정 사항을 명시하고 더 단순한 기본안을 제시하는 수정 답변을 요청하세요. senior-architect를 가장 잘 활용하는 방식은 이론적 확장성만이 아니라 팀의 실제 역량에 맞춰 설계를 유지하는 것입니다.