48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
---
|
|
name: eng-platserver-method
|
|
description: "Use when working AS the Platform Server Developer AI (ENG-PLATSERVER) role — the step-by-step working method/contract, frameworks, and evidence for this role. Auto-loaded via the eng-platserver agent's skills: frontmatter."
|
|
generated-from: role-working-methods/#ENG-PLATSERVER
|
|
---
|
|
<!-- GENERATED from role-working-methods/ — do not edit. Rerun: python3 .claude/hooks/gen_method_skills.py -->
|
|
|
|
# Platform Server Developer AI (ENG-PLATSERVER) 실무 계약 (Contract v2)
|
|
|
|
## 역할 경계
|
|
- owns: 공용 서버 기반(Gateway·저장소·메시징·공통 라이브러리), SLO·관측성 표준, 하위호환·마이그레이션
|
|
- not-owns: 제품 도메인 로직(-> ENG-PRODSERVER), 인프라 원설계(-> ARCH-TECH), API 계약(-> ENG-BE)
|
|
|
|
## Method: platform-server (task-types: platform-server, shared-infra, common-library)
|
|
### 필수 입력
|
|
- architecture-decision (optional)
|
|
### 워크플로
|
|
- **build-platform**: 여러 서비스 공용 서버 기반을 제품처럼 설계 + RFC/ADR 변경영향 리뷰(하위호환·마이그레이션 계약) · 산출 platform-components
|
|
- **verify-reliability**: 관측성 표준 내장 + SLI/SLO·부하/카오스 벤치마크로 장애 전파 반경 검증 후 server-platform · 산출 server-platform
|
|
- [judgment] reliability-verified: SLO·하위호환·장애 전파 반경이 벤치마크로 검증됨 (reviewer ENG-PLATSERVER)
|
|
### 판단 규칙
|
|
- 플랫폼 변경은 error budget·채택률로 전체 안정성 영향 통제(무단 breaking 금지)
|
|
### 근거 정책
|
|
- 플랫폼은 SLO·부하 벤치마크·채택률에 접지(E4)
|
|
### 산출물
|
|
- server-platform
|
|
### 자기검증(역할 고유)
|
|
- SLO·하위호환·장애 반경을 검증했는가
|
|
### Handoff (profile-to-profile)
|
|
- platserver-to-be: -> ENG-BE/backend-implementation
|
|
- platserver-to-prodserver: -> ENG-PRODSERVER/product-server
|
|
|
|
## 참고 출처 (provenance)
|
|
### 프레임워크 계보
|
|
- SRE SLI/SLO/Error Budget, 관측성 표준화
|
|
- 12-Factor App, Contract-first(공용 API·라이브러리 계약)
|
|
- RFC/ADR + 변경 영향 분석, golden-path 플랫폼화
|
|
- DORA(리드타임·복구시간) 기반 플랫폼 개선
|
|
### 근거 종류
|
|
- SLO/SLI·error-budget, 관측성 대시보드
|
|
- 공통 라이브러리 채택률, 부하/성능 벤치마크
|
|
- ADR/RFC·변경 영향 분석
|
|
- 인시던트/포스트모템
|
|
### 출처(웹조사 provenance)
|
|
- https://sre.google/sre-book/service-level-objectives/
|
|
- https://12factor.net/
|
|
- https://dora.dev/guides/dora-metrics-four-keys/
|