Files

1848 lines
144 KiB
YAML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
version: 1
provenance: 웹 기반 리서치(WebSearch/WebFetch)로 조사한 62직무의 실제 일하는 방식(실무 절차·프레임워크·근거·출처). gen_agents.py가 에이전트에 embed.
field-schema:
working-method: 실무 절차(실무 동사)
key-frameworks: 널리 쓰는 방법론/프레임워크
evidence-they-use: 판단 근거로 삼는 자료 유형
sources: 웹 출처 URL
role-working-methods:
EXEC-CEO:
working-method:
- 비전·전략을 확정하고 전사 전략 피라미드(미션→전략→OKR)로 하위 실행에 정렬한다.
- 포트폴리오 우선순위와 자원 배분(자본·인력)을 ROI·전략적합성·시장상황 기준으로 결정한다.
- OKR로 전략을 실행 속도로 번역하고, CEO 스스로 OKR을 설정·타운홀에서 참조해 배분 결정을 견인한다.
- 구조화된 의사결정 프레임(SPADE 등)으로 옵션을 평가하고 편향을 줄이며 결정권/책임을 명확히 한다.
- CTO(기술 안정성)·CPO(제품 속도)·CFO(재무) 간 충돌을 장기 지속가능성·고객가치 기준으로 최종 정렬한다.
- 이사회·투자자·조직 이해관계자와 방향을 커뮤니케이션하고 buy-in을 확보한다.
key-frameworks:
- OKR (전략→실행 정렬)
- 'Capital Allocation (자본배분: 재투자/M&A/자사주/배당 트레이드오프)'
- Corporate Strategy Pyramid (전사 전략 계층)
- SPADE 등 구조화 의사결정 프레임
- Amazon Working Backwards / PR-FAQ (고객 관점 역산 의사결정)
evidence-they-use:
- 전사 포트폴리오·전략/비전 문서, 시장·경쟁 분석
- OKR 진척·전사 KPI 대시보드
- CFO 재무 시나리오(3~scenario 계획), 자본배분 모델
- 이해관계자·이사회 피드백, 자문위원회 입력
sources:
- https://weekdone.com/resources/articles/okrs-and-strategy
- https://ceohangout.com/top-7-decision-making-frameworks-for-ceos/
- https://www.morganstanley.com/im/publication/insights/articles/article_capitalallocation.pdf
- https://workingbackwards.com/concepts/working-backwards-pr-faq-process/
OPS-ORCH:
working-method:
- '작업분해: 상위 목표를 WBS/작업 DAG로 분해해 노드=subtask, 엣지=출력→입력 의존으로 실행 단위를 만든다.'
- '역할·에이전트 라우팅: capability registry로 능력·상태를 보고 구조적(누가)·조건적(어느 분기) 라우팅으로 적합 역할/패밀리에 배정한다.'
- '상태·큐 관리: work-queue·workflow 상태를 shared state로 유지하고 WIP 제한(Kanban)으로 과부하·병목을 통제한다.'
- 'wave 단위 병렬 실행·핸드오프 추적: 같은 의존 레벨은 한 wave에서 병렬 실행하고, 핸드오프마다 schema 검증 게이트로 오류 전파를 막는다.'
- '리스크·에스컬레이션: turn cap·타임아웃·무한루프 방지 게이트를 두고 정해진 핸드오프 초과 시 human review로 에스컬레이션한다.'
- '라우팅·리드타임 모니터링: 라우팅 정확도·딜리버리 리드타임을 추적하고 결정은 생성하지 않고 결정권 역할로 라우팅한다(제안만).'
key-frameworks:
- Work Breakdown Structure(WBS) / Task DAG
- RACI(책임·승인·자문·통보 명확화)
- Kanban / WIP limits(흐름 시각화·과부하 방지)
- Multi-agent Orchestration(decompose→route→state→recover)
- Wave-based execution(동일 의존 레벨 병렬, 이전 wave 완료 후 다음)
- Handoff guardrails(schema gate·turn cap·human escalation)
evidence-they-use:
- work-queue.yaml / workflow-state-registry 상태, WIP·큐 깊이
- 라우팅 정확도, 딜리버리 리드타임(agent-operating-kpi)
- 작업 DAG 의존성·핸드오프 트레이스
- role-selection-scorecard 점수, tier/mode 선언
sources:
- https://www.augmentcode.com/guides/multi-agent-orchestration-architecture-guide
- https://project-management.com/work-breakdown-structure-wbs/
- https://www.atlassian.com/work-management/project-management/work-breakdown-structure
EXEC-CTO:
working-method:
- 사업 목표를 실현할 전사 기술 전략·아키텍처 방향을 정의하고 기술을 비즈니스 방향과 연결한다.
- Technology Radar(Adopt/Trial/Assess/Hold 링)로 기술 채택을 경량 거버넌스하며, 결정을 실무 팀 가까이로 위임한다.
- ADR/RFC·golden-path 표준·보안/복원력 원칙을 수립해 기술 선택의 일관성을 확보한다.
- DORA 지표(리드타임·배포빈도·변경실패율·복구시간)를 딜리버리 흐름·안정성의 선행지표로 삼아 개선 우선순위를 정한다.
- 기술 부채와 신규 기능 사이 균형을 조율하고, 기술 리스크를 CEO에게 사업 언어로 설명한다.
- CPO의 제품 비전을 구현 가능한 기술 계획으로 번역한다.
key-frameworks:
- Technology Radar (ThoughtWorks, 링 기반 기술 거버넌스)
- DORA / Engineering metrics (4~5개 딜리버리 성과지표)
- ADR/RFC (아키텍처 결정 기록)
- SLO / Error Budget (신뢰성 목표)
- Golden Path / Paved Road (표준 경로)
evidence-they-use:
- ADR/RFC, system-context, 아키텍처 리뷰
- DORA/딜리버리 지표, SLO·error-budget, 기술부채 지표
- security-architecture, 위협 모델
- 실무 팀 프로젝트 경험(Technology Radar의 근거 = 실전 경험)
sources:
- https://www.thoughtworks.com/radar
- https://www.thoughtworks.com/radar/techniques/dora-metrics
- https://cto.academy/technology-leadership/
- https://www.metridev.com/metrics/cto-vs-vp-engineering-unraveling-the-roles-and-responsibilities/
EXEC-CPO:
working-method:
- 5~10년 고객 삶을 개선하는 제품 비전을 세우고, 이를 실현하는 제품 전략으로 팀 전반을 홀리스틱하게 정렬한다.
- 제품 발견(Product Discovery)으로 불확실성을 줄이며 가치성·사용성·실현가능성·사업성 4대 리스크를 검증한다.
- 듀얼트랙 애자일(발견=PM·디자이너 주도 / 딜리버리=엔지니어 주도)로 발견과 실행을 동시에 돌린다.
- 결과 기반(outcome) 로드맵을 유지한다 — 비전은 고수(stubborn), 세부는 유연(flexible).
- Amazon PR-FAQ로 고객 관점에서 역산해 무엇을 만들지·조직 misalignment를 코드 이전에 드러낸다.
- 제품 성공 지표를 사업 성과(P&L)와 연결하고 CTO와 속도·안정성 균형을 맞춘다.
key-frameworks:
- Product Discovery / Dual-Track Agile (Marty Cagan / SVPG)
- Empowered Product Teams · Product Operating Model
- Amazon PR-FAQ / Working Backwards
- Outcome-based Roadmap (objectives 우선)
- Value/Usability/Feasibility/Viability 4대 리스크
evidence-they-use:
- PR-FAQ, 제품 비전/전략 문서, outcome 로드맵
- 제품 metrics(전환/잔존/이탈), A/B·실험 결과
- UX 리서치·사용자 인터뷰(discovery 근거)
- 제품 P&L, PRD/discovery 산출물
sources:
- https://www.mindtheproduct.com/product-vision-and-strategy-marty-cagan-on-the-product-experience-part-1-of-2/
- https://www.svpg.com/product-roadmaps/
- https://www.svpg.com/a-vision-for-product-teams/
- https://workingbackwards.com/concepts/working-backwards-pr-faq-process/
EXEC-CFO:
working-method:
- 3-statement 모델(손익·재무상태·현금흐름 연동)로 전략 결정이 현금·수익성·유동성에 미치는 영향을 실시간 평가한다.
- 드라이버 기반 예측 — 유닛이코노믹스·헤드카운트·운전자본 등 운영 드라이버를 재무제표에 직접 연결한다.
- 매출 모델은 '단위→금액' 방향으로 구성(고객획득/단위판매에서 시작해 이코노믹스 적용)한다.
- 시나리오 분석(통상 3개 시나리오)으로 획득율·이탈율 변화의 재무 영향을 테스트하고 리스크를 정량화한다.
- 예산·자본배분을 전략우선순위에 맞춰 결정하고 투자 의사결정의 재무 타당성(ROI·회수)을 검토한다.
- CEO와 지속가능한 성장 구조(현금소진·런웨이·유동성)를 점검한다.
key-frameworks:
- 3-Statement Financial Model (통합 재무모델)
- Unit Economics (LTV:CAC, 단위 수익성)
- Driver-based Forecasting (드라이버 기반 예측)
- Scenario / Sensitivity Analysis (3-시나리오 계획)
- Capital Allocation (자본배분 우선순위)
evidence-they-use:
- 3-statement 재무모델, 예산·현금흐름·P&L
- 유닛이코노믹스·LTV:CAC, 코호트 데이터
- 시나리오/민감도 분석 결과
- 자본배분 모델, 투자 회수(ROI) 평가
sources:
- https://cfoproanalytics.com/cfo-wiki/fractional-cfo/building-a-3-statement-financial-model-cfos-guide-to-driver-based-forecasting/
- https://www.keeneadvisors.com/news-and-insights/budgeting-primer-three-statement-model
- https://www.morganstanley.com/im/publication/insights/articles/article_capitalallocation.pdf
- https://the-cfo.io/2019/11/06/what-are-the-different-financial-models/
EXEC-COO:
working-method:
- CEO 비전을 실행 가능한 사업 계획·측정 가능한 성과로 번역한다(전략과 실행의 다리).
- 운영 시스템(오퍼레이팅 케이던스)을 설계 — 주간 리더 스탠드업·월간 KPI 리뷰·분기 OKR·연간 오프사이트.
- 엔드투엔드 가치 흐름(주문-현금, 기획-출시, 티켓-해결)을 매핑하고 병목을 찾아 린/자동화 우선순위를 정한다.
- 전사 KPI/성과 대시보드를 정의·추적해 조직 건강도를 측정하고 책임(accountability)을 부여한다.
- 부서 간 의사결정권·에스컬레이션 경로·SLA를 세워 Sales·Product·Finance·CS가 lockstep으로 움직이게 한다.
- 프로세스 오너와 만나 에스컬레이션을 해소하고 반복 작업 자동화로 효율·비용을 개선한다.
key-frameworks:
- 'Value Stream Mapping (가치 흐름 매핑: order-to-cash 등)'
- Operating Cadence / Operating System (운영 리듬)
- Process KPIs / Operational Dashboards
- Lean / Continuous Improvement (프로세스 개선)
- RACI / Decision Rights (의사결정권·SLA)
evidence-they-use:
- 운영 KPI(처리시간·정시납기율·매출성장률), 성과 대시보드
- value-stream-map·프로세스 아키텍처, 병목 분석
- 재무 리포트, 인시던트/에스컬레이션 리포트
- AS-IS/TO-BE 프로세스 모델, 현장 신호
sources:
- https://www.techcxo.com/chief-operating-officer-responsibilities-leadership-strategic-impact/
- https://umbrex.com/resources/fractional-executive-playbook/fractional-chief-operating-officer-playbook/
- https://digitaldefynd.com/IQ/operational-kpis-every-chief-operating-officer-needs-to-know/
- https://www.signavio.com/wiki/bpm/chief-operating-officer-coo/
EXEC-CPTO:
working-method:
- 제품 로드맵과 기술 로드맵(로드맵+아키텍처+딜리버리)을 하나의 우선순위 체계·단일 책임으로 통합한다.
- 분리 모델과 달리 CPTO가 트레이드오프를 직접 결정한다 — 속도(빠른 의사결정) vs 안정성(장기 품질)을 한 사람이 조정.
- 고객가치·개발속도·시스템 안정성·장기 기술부채를 동시에 저울질하고, 상충하는 우선순위를 정렬한다.
- 제품 조직과 엔지니어링 조직 사이 의사결정 충돌을 단일 책임점으로 흡수해 줄인다.
- 속도가 핵심 동인이면 통합을, 미래 확장을 위한 품질이 필요하면 분리를 권고하는 판단 기준을 유지한다.
- CEO 관점에서 제품/기술 통합 리스크·기회를 트레이드오프로 노출해 설명한다.
key-frameworks:
- Product Operating Model (통합 제품-기술 운영)
- Roadmap-Architecture Alignment (로드맵·ADR 정합)
- Speed vs Stability Trade-off framing
- Single Point of Accountability (단일 책임 모델)
- OKR (통합 우선순위 정렬)
evidence-they-use:
- 통합 로드맵과 ADR/RFC의 정합성, PR-FAQ
- 제품 metrics와 SLO/기술부채 지표의 트레이드오프
- 속도(리드타임/배포빈도) vs 안정성(변경실패율) 지표 대비
- 조직 충돌·misalignment 신호
sources:
- https://www.egonzehnder.com/functions/technology-officers/chief-product-officers/insights/does-your-company-need-a-chief-product-and-technology-officer
- https://cto.academy/cpto-role-and-responsibilities/
- https://medium.com/@rico.surridge/cpo-cto-or-cpto-3ae202c021cf
- https://www.pipaltreeservices.com/insights/cto-vs-cpo-vs-cpto-leadership-structure-guide/
EXEC-VPENG:
working-method:
- CTO가 정한 기술 방향을 팀 구조·개발 프로세스·실행 리듬으로 번역하고 엔지니어링 조직의 데이일리 운영을 총괄한다.
- DORA·flow·신뢰성 지표를 정의·운영하되, 개선을 위해 쓰고 처벌 도구로 쓰지 않는다.
- 안전하고 반복 가능한 릴리스를 보장 — 변경 리스크 분류·롤백 관행을 표준화하고 변경실패율을 관리한다.
- 아키텍처 리뷰 메커니즘·가드레일(원칙·표준·레퍼런스 아키텍처)을 관료적 마찰 없이 세운다.
- 팀 토폴로지(제품팀=서비스 소유 / 플랫폼=paved road·신뢰성)와 온콜 책임 경계를 설계한다.
- completion-record 수용/반려·리소스·예산을 판단해 프로젝트를 정시·예산 내 인도한다(기술 리더-실무자 병목 제거).
key-frameworks:
- DORA Metrics (배포빈도·리드타임·변경실패율·복구시간)
- Team Topologies (스트림정렬·플랫폼·복잡서브시스템·인에이블링)
- Flow Metrics / Delivery Lead Time
- Change Risk Classification & Rollback (릴리스 안정성)
- Empowered Teams (자율성=성과 상관)
evidence-they-use:
- DORA/flow 지표, 딜리버리 리드타임·리뷰 처리율
- 변경실패율·복구시간·릴리스 안정성(SLO)
- completion-record·release-acceptance, QA verification-record
- 팀 토폴로지·조직 구조 신호(자율성/의존성)
sources:
- https://dora.dev/guides/dora-metrics/
- https://www.metridev.com/metrics/cto-vs-vp-engineering-unraveling-the-roles-and-responsibilities/
- https://www.devopsschool.com/blog/vp-of-engineering-role-blueprint-responsibilities-skills-kpis-and-career-path/
- https://www.atlassian.com/devops/frameworks/dora-metrics
STR-ANALYST:
working-method:
- '문제 구조화: 모호한 사업 문제를 이슈 트리/MECE로 분해해 검증할 가설과 질문으로 정리한다.'
- '외부 환경·산업 분석: PESTLE로 거시환경을, Porter''s Five Forces로 산업 매력도·경쟁 강도를 평가한다.'
- '내부 역량·종합: SWOT로 내부 강·약점을 외부 기회·위협과 결합해 인사이트를 합성한다.'
- '시나리오·전략 옵션 도출: scenario planning으로 복수의 미래 상태를 그리고 실행 가능한 옵션 세트를 만든다.'
- '재무 모델링·근거 접지: 각 옵션을 재무 모델(NPV·시나리오)로 정량화하고 시장·경쟁 근거에 접지한다.'
- '실행 옵션 권고: C-Level·PM/PO·아키텍처가 실행 가능한 선택지로 번역해 추천한다(결정권은 C-Level).'
key-frameworks:
- Porter's Five Forces(신규진입·대체재·구매자/공급자 교섭력·경쟁강도)
- SWOT(내부 강약 × 외부 기회위협)
- PESTLE(정치·경제·사회·기술·법·환경)
- Scenario Planning(가정 기반 미래 시나리오)
- MECE / Issue Tree(문제 구조화)
- 재무 모델링(NPV·민감도·시나리오 분석)
evidence-they-use:
- 시장·경쟁 데이터, 산업 구조 지표(집중도·전환비용·자본집약도·진입장벽)
- 재무 모델·수익성 추정, LTV:CAC 등 단위경제
- evidence-ledger reliability-grade(E0~E5) 근거 등급
- org-os/01-company strategy 정합성, Decision Brief 옵션 세트
sources:
- https://en.wikipedia.org/wiki/Porter's_five_forces_analysis
- https://www.consultant-docs.com/blogs/consulting-fundamentals/strategic-planning-frameworks-swot-pestle-porter-s-five-forces
- https://flevy.com/topic/porters-five-forces-analysis/question/integrating-porters-five-forces-swot-strategy
UX-RESEARCHER:
working-method:
- 리서치 질문을 제품개발 단계(generative→formative→summative)에 매핑해 방법을 먼저 고른다.
- attitudinal↔behavioral × qualitative↔quantitative × 사용 맥락 3축으로 방법을 매칭한다(인터뷰·현장조사/contextual inquiry·카드소팅·트리테스트·다이어리 스터디·설문·사용성 테스트·A/B·애널리틱스).
- 스토리 기반(과거 실제 경험) 인터뷰로 니즈·맥락을 수집하고, 태스크 기반 사용성 테스트로 '말'이 아닌 '행동'에서 문제를 관찰한다.
- 휴리스틱 평가(Nielsen 10원칙) 등 전문가 인스펙션으로 사용자 없이도 저비용으로 문제를 조기 발굴한다.
- 정성 발견을 저니맵·페르소나로 종합하고, 정량(설문·애널리틱스)으로 보완해 삼각검증(triangulation)한다.
key-frameworks:
- NN/g 방법 선택 프레임(3축)
- 사용성 테스트(moderated/unmoderated)
- 휴리스틱 평가(Nielsen 10 Heuristics)
- Contextual Inquiry / 현장조사
- 카드소팅 · 트리테스트
- 다이어리 스터디
- Continuous Interviewing
evidence-they-use:
- 사용자 인터뷰·관찰 로그
- 사용성 테스트 결과(태스크 성공률·에러)
- 설문·제품 애널리틱스
- 저니맵·페르소나
sources:
- https://www.nngroup.com/articles/which-ux-research-methods/
- https://www.nngroup.com/articles/ten-usability-heuristics/
- https://www.nngroup.com/videos/15-user-research-methods-beyond-usability-testing/
PROD-PM:
working-method:
- JTBD/원하는 성과(outcome)로 문제를 정의하고, 그 outcome을 기회-솔루션 트리(OST) 루트에 놓는다.
- product trio(PM·디자이너·엔지니어)로 스토리 기반 고객 인터뷰를 주간으로 돌리고(continuous discovery), 인터뷰 3~4건마다 기회 공간(opportunity space)을 갱신한다.
- 타깃 기회 하나를 골라 솔루션을 3개 이상 발산한 뒤, 각 솔루션이 의존하는 가정을 도출하고 리스크 높은 가정부터 assumption test로 검증한다.
- RICE((Reach×Impact×Confidence)/Effort) 또는 ICE로 백로그·로드맵을 점수화해 우선순위를 정한다(단, 의존성·전략은 예외 허용).
- 'PRD를 작성한다: 문제/맥락·목표와 비목표(non-goals)·유저스토리+수용기준(Given/When/Then)·성공지표. 구현 방식은 과다 지정하지 않고 outcome으로 쓴다.'
- 성공지표를 North Star에 연결해 A/B 실험을 설계·해석하고, 학습을 다시 discovery로 회수한다.
key-frameworks:
- JTBD / Outcome-Driven Innovation
- Continuous Discovery
- Opportunity Solution Tree
- RICE / ICE
- PR-FAQ(Working Backwards)
- North Star Metric
- PRD + 수용기준(Given/When/Then)
evidence-they-use:
- 스토리 기반 사용자 인터뷰
- 퍼널·전환·리텐션 지표
- A/B 실험 결과
- 중요도-만족도(underserved outcome) 서베이
- 사용성 테스트
sources:
- https://www.producttalk.org/opportunity-solution-trees/
- https://www.intercom.com/blog/rice-simple-prioritization-for-product-managers/
- https://strategyn.com/jobs-to-be-done/
- https://www.nngroup.com/articles/which-ux-research-methods/
PROD-PO:
working-method:
- Product Goal을 수립·명시적으로 커뮤니케이션하고, 그로부터 Product Backlog 아이템을 도출한다(위임 가능하나 accountability는 PO).
- 백로그를 지속적으로 refinement 한다 — 아이템에 설명·순서·크기(size)를 더해 작고 명확한 단위로 쪼개고, 개발자와 협업한다.
- 가치·리스크·의존성 기준으로 백로그 순서(ordering)를 결정한다 — 스쿼드 스코프의 결정권을 행사한다.
- 유저스토리+수용기준을 작성하고, Sprint Planning에서 '제품 가치를 어떻게 높일지'를 제안하며 스프린트 목표를 합의한다.
- Sprint Review에서 이해관계자와 증분(Increment)을 점검하고, 변경 요청은 PO를 설득하는 경로로만 반영해 백로그 투명성을 유지한다.
- 출시 후 스쿼드 KPI·제품 성과를 회수해 백로그와 다음 방향에 반영한다.
key-frameworks:
- Scrum(Product Owner accountability)
- Product Backlog Management
- Backlog Refinement(ongoing)
- INVEST 유저스토리
- 수용기준(Given/When/Then)
- Sprint 이벤트(Planning/Review)
evidence-they-use:
- 백로그·수용기준(acceptance criteria)
- 스쿼드 KPI·제품 지표
- release-acceptance / completion-record
- Sprint Review 이해관계자 피드백
sources:
- https://scrumguides.org/scrum-guide.html
- https://www.scrum.org/resources/blog/product-backlog-refinement-how-succeed-scrum-team
- https://www.atlassian.com/agile/scrum/backlog-refinement
PROD-TPO:
working-method:
- 기술 복잡도 높은 요구를 API·서비스 계약 단위로 분해하고, PRD를 ADR/RFC와 연계해 기술 맥락을 보존한다.
- 개발자를 (내부/외부) 1차 고객으로 보고 developer experience 기준(문서·에러 메시지·rate limit·인증/버저닝)으로 요구를 정의한다.
- '불확실성이 큰 부분은 기술 스파이크(technical spike)로 먼저 해소하고, 성능·안정성(SLO) 조건을 story 수용기준에 수치로 명시(예: p95 < 500ms)한다.'
- 기술부채 vs 기능 트레이드오프를 person-month·리스크 언어로 설명해 우선순위에 반영한다.
- REST/GraphQL/JSON 등 소비 방식을 이해한 상태로 API 로드맵(보안·usability·호환성)을 관리하고 개발자 피드백을 회수한다.
key-frameworks:
- API-as-a-Product
- Developer Experience(DX)
- ADR/RFC 연계
- PRD + 수용기준(Given/When/Then)
- Technical Spike
- SLO/error-budget
- RICE
evidence-they-use:
- ADR/RFC·기술 스파이크 결과
- SLO·성능 벤치마크
- API 문서/사용성에 대한 개발자 피드백
- 기술부채 지표
sources:
- https://producthq.org/career/api-product-manager/
- https://www.productledalliance.com/the-rise-of-the-api-product-manager/
- https://www.perforce.com/blog/alm/how-write-product-requirements-document-prd
PROD-PPO:
working-method:
- 내부 플랫폼을 하나의 '제품'으로, 개발자·디자이너·운영자를 내부 고객으로 정의하고 그들의 니즈로 로드맵을 세운다.
- Thinnest Viable Platform(TVP)로 핵심 워크플로우 하나를 end-to-end로 최소 제공한 뒤 점진 확장한다(technically interesting 아닌 needed 중심).
- hands-on 지원(migration 단계)에서 self-service(as-a-service) 모델로 의도적으로 전환한다 — 인터페이스·문서·에러 메시지·골든패스(paved road)를 정비해 소비팀의 인지부하를 낮춘다.
- 여러 제품팀 요구를 조율해 재사용 가능한 공통 역량으로 수렴시키고, migration→consumption→evolution 단계별로 협업 방식을 바꾼다.
- 성공지표를 도입률(adoption)·재사용률·개발 리드타임·DX로 관리한다 — '아무도 안 쓰는 기능' 방지가 핵심 규율이다.
key-frameworks:
- Platform as a Product
- Team Topologies(TVP · cognitive load)
- Golden Path / Paved Road
- Self-service / Internal Developer Platform(IDP)
- Developer Experience
- Jobs-to-be-Done(내부 고객)
evidence-they-use:
- 플랫폼 도입률·재사용률
- 개발 리드타임 / DX 지표
- 내부 고객(개발자) 인터뷰
- SLO / golden-path 채택률
sources:
- https://martinfowler.com/articles/platform-teams-stuff-done.html
- https://teamtopologies.com/videos-slides/what-is-platform-as-a-product-clues-from-team-topologies
- https://platformengineering.org/talks-library/platform-as-a-product
DES-PROD:
working-method:
- '먼저 design-brief를 세운다(design-brief-spec): 무엇을/누구에게/무엇을 달성 — 미학보다 문제·독자·성공조건을 먼저 언어화한다.'
- '레퍼런스로 방향을 앵커한다 — "modern/clean/minimal" 형용사(=인터넷 평균, generic 유발)를 금지하고, 구체 제품 3–6개와 각자가 나르는 신호(밀도·간격·색 규율·인터랙션)를 명명한다.'
- 'Double Diamond로 진행한다: Discover·Define(문제공간 발산→수렴), Develop·Deliver(해법공간 발산→수렴). 정성/정량 근거·저니맵으로 설계 근거를 만든다.'
- product trio(PM·엔지니어)로 가설을 와이어프레임→프로토타입→사용성 테스트로 반복 검증한다.
- '디자인 결정을 값이 아니라 제약으로 남긴다 — 토큰은 값+의도+경계, 컴포넌트는 판단로직(언제 card vs list row), 그리고 명시적 금지규칙(anti-pattern). 추론층을 비우면 모델이 generic으로 채운다.'
- Nielsen 10 휴리스틱·디자인 시스템으로 일관성·오류 예방을 확보하고, 출시 후 전환·행동지표·A/B(CTR 등)로 반복 개선한다.
key-frameworks:
- 'design-brief (제약>묘사): brief→references→tokens(값+의도+경계)→decisions→donts'
- 레퍼런스 구동 디자인 (형용사가 아니라 구체 신호 3–6)
- Double Diamond
- Design Thinking
- Continuous Discovery / product trio
- 사용성 테스트
- 휴리스틱 평가
- 저니맵 · 페르소나
- 디자인 시스템
evidence-they-use:
- user research · 행동 데이터
- 사용성 테스트 결과
- A/B 결과(CTR 등)
- 저니맵
- 제품 전환 지표
- 명명된 레퍼런스와 그 신호(밀도·간격·색 규율)
sources:
- https://www.uxpin.com/studio/blog/double-diamond-design-process/
- https://www.nngroup.com/articles/ten-usability-heuristics/
- https://www.producttalk.org/opportunity-solution-trees/
- https://processtopixels.substack.com/p/writing-a-designmd-file-claude-can
- https://www.nngroup.com/articles/vague-prototyping/
DES-PLATFORM:
working-method:
- Atomic Design(atoms→molecules→organisms→templates→pages)으로 UI를 계층화·추상화해 최소 단위부터 조립 가능한 컴포넌트로 만든다.
- '디자인 토큰을 값이 아니라 계약으로 정의한다 — 각 토큰에 값+의도+경계(언제 쓰고 무엇에 절대 안 쓰는지). 예: primary는 CTA 전용·배경 금지·화면당 1회. 경계 없는 토큰은 일관성을 무너뜨린다.'
- 단일 책임 원칙으로 반복 UI 패턴을 표준 컴포넌트로 승격하고, 각 컴포넌트에 판단로직(언제 이 컴포넌트 vs 대안)과 금지규칙(anti-pattern)을 함께 문서화한다.
- '레퍼런스 시스템(Linear·Stripe·Material 등)에서 형용사가 아니라 구체 신호(간격 스케일·타이포 램프·elevation 규율)를 빌리고 그 이유를 남긴다("modern/clean" 금지).'
- 디자인과 코드가 함께 진화하도록 정합성(Code Connect)을 확보해 중복 작업·오해를 제거한다.
- 컴포넌트 문서·사용 가이드라인을 제공하고 채택률·커버리지·토큰 사용률·유지보수 대상 수를 지표로 관리한다.
key-frameworks:
- Atomic Design
- 'Design Tokens (값+의도+경계 — 경계가 일관성을 만든다)'
- 디자인 시스템 / 컴포넌트 라이브러리
- 단일 책임 원칙(SRP)
- 디자인-코드 매핑(Code Connect)
- 레퍼런스 구동(구체 신호) + 컴포넌트별 판단로직·금지규칙
evidence-they-use:
- 컴포넌트 커버리지·채택률
- 디자인-코드 정합성 지표
- 토큰 사용률
- 유지보수 대상 수
sources:
- https://atomicdesign.bradfrost.com/chapter-2/
- https://bradfrost.com/blog/post/design-tokens-atomic-design-%E2%9D%A4%EF%B8%8F/
- https://bradfrost.com/blog/post/extending-atomic-design/
- https://processtopixels.substack.com/p/writing-a-designmd-file-claude-can
DES-INTERNAL:
working-method:
- '먼저 design-brief를 세운다 — 어떤 운영자가 어떤 반복 업무에서 무엇을 달성해야 하는지(미학이 아니라 워크플로우·처리시간·오류율이 성공조건).'
- '복잡 애플리케이션 8원칙을 적용한다: learning by doing(작업 손실 없는 실험), 비선형·유연 경로 허용, 실수해도 복구 가능한 설계.'
- 반복 수작업/운영 병목을 워크플로우로 분석해 태스크 순서를 설계하고, staged/progressive disclosure로 정보 과부하 없이 전문가 효율을 유지한다.
- '결정을 제약으로 남긴다 — 정보 밀도·단축키·기본값의 판단로직과 금지규칙(예: 파괴적 액션은 확인 없이 실행 금지)을 명시한다. 추론층을 비우지 않는다.'
- 운영자가 오가는 다중 도구/워크스페이스 전환을 지원한다(export·서드파티 연동), 오류 예방·권한/보안 요건을 반영한다.
- TCO·처리시간·자동화율 관점에서 개선하고, 운영자(내부 고객) 관찰로 설계 근거를 확보한다.
key-frameworks:
- 'design-brief (제약>묘사) — 운영자·워크플로우 우선'
- 복잡 애플리케이션 8 가이드라인(NN/g)
- 엔터프라이즈 유저빌리티(TCO 중심)
- 워크플로우 디자인
- Progressive / Staged Disclosure
- 휴리스틱 평가
- 판단로직 · 금지규칙(파괴적 액션 가드)
evidence-they-use:
- 운영자 관찰·현장 병목 신호
- 처리시간 / 자동화율 KPI
- 사용성 테스트
- value-stream 내부 흐름
sources:
- https://www.nngroup.com/articles/complex-application-design/
- https://www.nngroup.com/articles/enterprise-usability/
- https://www.nngroup.com/videos/complex-apps-workflows/
DES-DIRECTOR:
working-method:
- '발산을 프레이밍한다 — 브리프(문제·독자·성공조건)를 세우고 몇 개 방향을 발산할지, 각 방향이 갈라져야 할 축(신호·톤·인터랙션)을 미리 정한다.'
- 'SCQA(Situation-Complication-Question-Answer)로 방향 간 차이를 명확한 질문으로 구조화해, 각 워커가 답해야 할 질문을 다르게 프레임한다.'
- '각 분과 워커(DES-PROD·DES-PLATFORM·DES-INTERNAL·DES-VISUAL)의 .report.yaml 원본을 전부 읽는다(rehydration) — 요약이 아니라 원본으로 비교해야 dissent가 보존된다.'
- 'critique를 종합하되 단독 평가자로 군림하지 않는다 — 각 안의 트레이드오프를 드러내고 근거(레퍼런스 신호·사용성·구현비용)로 하나의 방향에 수렴시킨다(평균내기 금지).'
- 'Pyramid Principle로 수렴된 방향을 지배 메시지(governing thought) 아래 정리해 다음 단계(spec·build)에 단일 설계 의도로 전달한다.'
- conflicts(소수의견)를 삭제하지 않고 보존해 종합 보고서에 함께 남긴다.
key-frameworks:
- SCQA (Situation-Complication-Question-Answer)
- Pyramid Principle (Barbara Minto)
- synthesis-rehydration (원본 재적재, 요약 금지)
- design-brief (제약>묘사) 프레이밍
- 발산-수렴(Divergent/Convergent) 퍼실리테이션
evidence-they-use:
- 분과 워커 .report.yaml 원본 전부(요약 아님)
- design-brief·레퍼런스 신호 비교표
- 발산-수렴 세션 dissent/conflicts 기록
- collaboration-modes(fan-out), report-templates(BLUF)
sources:
- https://managementconsulted.com/pyramid-principle/
- https://umbrex.com/resources/mckinsey-problem-solving/
- https://www.nngroup.com/articles/design-critiques/
- https://processtopixels.substack.com/p/writing-a-designmd-file-claude-can
DES-VISUAL:
working-method:
- '방향별로 reference cluster를 6개 내외로 좁힌다 — "modern/clean/minimal" 형용사(인터넷 평균) 대신 구체 제품과 각자가 나르는 신호(밀도·간격·색 규율·모션)를 명명한다.'
- '그 신호들로 visual thesis 한 문장을 세운다 — 이 방향이 시각적으로 무엇을 주장하는지.'
- 'signature interaction 하나를 정의한다 — 방향을 체감하게 하는 대표 모션/인터랙션 하나로 좁힌다(다다익선 아님).'
- '대표 화면을 coded slice(실제 코드 조각)로 구현해 방향을 정적 목업이 아니라 검증 가능한 실물로 만든다.'
- '토큰/결정을 값이 아니라 제약(값+의도+경계)과 금지규칙(anti-pattern)으로 남긴다 — 추론층을 비우면 모델이 generic으로 채운다.'
- anti-generic self-check로 산출물이 레퍼런스 신호에서 유도됐는지, 형용사로 되돌아가지 않았는지 스스로 점검한다.
key-frameworks:
- 'design-brief (제약>묘사): brief→references(6집중)→tokens(값+의도+경계)→decisions→donts'
- 레퍼런스 구동 디자인(형용사 금지, 구체 신호)
- visual thesis / signature interaction
- coded slice(대표 화면 실물 구현)
- anti-generic self-check
evidence-they-use:
- 명명된 레퍼런스와 그 신호(밀도·간격·색 규율·모션)
- coded slice 실물 아티팩트
- design-brief tokens/decisions/donts
- design-craft skill(anti-generic 체크리스트)
sources:
- https://processtopixels.substack.com/p/writing-a-designmd-file-claude-can
- https://github.com/VoltAgent/awesome-design-md
- https://stensyl.ai/blog/reference-images-ai-style-consistency
- https://www.nngroup.com/articles/vague-prototyping/
ENG-FE:
role-name: 프론트엔드 개발자 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 디자인 시안(Figma)·요구사항을 컴포넌트 단위로 분해하고, 상태·데이터 흐름·인터랙션 계약을 먼저 정의한다.
- 백엔드와 API 계약(OpenAPI/타입)을 합의한 뒤 모킹으로 UI를 병렬 개발한다.
- 컴포넌트 테스트·E2E(Testing Library/Playwright)로 사용자 시나리오를 검증하고 회귀를 막는다.
- Lighthouse(랩)로 개발 중 회귀를 잡고, CrUX/RUM(필드 web-vitals)으로 실사용자 75퍼센타일 성능을 상시 관측한다.
- WCAG POUR 기준(키보드 이동·대비·ARIA·스크린리더)으로 접근성을 구현·점검하고 코드리뷰에서 최종 품질선을 지킨다.
- 반복되는 화면 문제를 임시 패치가 아니라 공용 컴포넌트/패턴으로 흡수해 조직 품질 기준화한다.
key-frameworks:
- Core Web Vitals (LCP<=2.5s, INP<=200ms, CLS<=0.1, 75퍼센타일 기준)
- 필드 데이터 우선(RUM) + 랩 데이터 보조(Lighthouse) 성능 계측 원칙
- WCAG 2.2 POUR 4원칙 · 준수레벨 A/AA/AAA · 테스트 가능한 success criteria
- Contract-first / 컴포넌트 주도 개발, 컴포넌트·E2E 테스트
evidence-they-use:
- CrUX·PageSpeed Insights·RUM의 Core Web Vitals 실측값(필드 75퍼센타일)
- Lighthouse 랩 점수·성능 예산(performance budget) 회귀 여부
- WCAG success criteria 통과/실패, axe 등 접근성 스캔 결과
- API 계약(OpenAPI)·QA verification-record·코드리뷰 코멘트
sources:
- https://web.dev/articles/vitals
- https://www.w3.org/WAI/standards-guidelines/wcag/
- https://developers.google.com/search/docs/appearance/core-web-vitals
ENG-FEPLAT:
role-name: 프론트엔드 플랫폼 개발자 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 여러 제품팀의 반복 UI 패턴을 수집해 디자인 토큰(색·타이포·간격)과 공용 컴포넌트로 추상화한다.
- 컴포넌트 API를 계약처럼 설계하고 시맨틱 버저닝·마이그레이션 가이드로 파괴적 변경을 관리한다.
- 프레임워크·빌드·WebView/React Native 기반과 성능 최적화 모듈을 golden-path로 제공한다.
- Storybook·시각회귀·번들 사이즈 예산으로 컴포넌트 품질과 성능을 자동 검증한다.
- 프론트엔드 챕터의 코드리뷰·RFC·지식공유로 표준을 확산하고 채택률을 관리한다.
key-frameworks:
- 디자인 시스템(토큰·컴포넌트·문서·거버넌스), 곱셈적 컴포넌트 추상화
- Contract-first 컴포넌트 API + 시맨틱 버저닝, 성능/번들 예산(performance budget)
- Trunk-Based Development + CI(공용 라이브러리 자동 검증·배포)
- DX/DORA 리드타임 관점의 셀프서비스 플랫폼화
evidence-they-use:
- 공용 컴포넌트 채택률·재사용률, Core Web Vitals 벤치마크
- 번들 사이즈·성능 예산 회귀, 시각회귀 스냅샷 diff
- golden-path/ADR·RFC, DX·리드타임 KPI
- 챕터 코드리뷰 기준·SLO
sources:
- https://web.dev/articles/vitals
- https://trunkbaseddevelopment.com/
- https://www.atlassian.com/continuous-delivery/continuous-integration/trunk-based-development
ENG-BE:
role-name: 백엔드 개발자 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 요구사항을 도메인 모델·트랜잭션 경계로 분석하고 design doc/ADR로 대안·트레이드오프를 먼저 문서화한다.
- API를 contract-first(OpenAPI)로 설계·리뷰한 뒤 계약에 맞춰 구현하고, 소비자는 모킹으로 병렬 진행한다.
- TDD/자동화 테스트로 비즈니스 로직·동시성·정합성을 검증하고 CI로 매 커밋 회귀를 막는다.
- 12-Factor 원칙(무상태 프로세스·환경설정 분리·백킹서비스·로그 스트림)으로 확장·이식 가능하게 구성한다.
- SLI/SLO·error budget과 관측성(메트릭·트레이스·로그)으로 성능 병목·장애를 데이터로 진단한다.
- 장애 후 무비난 포스트모템으로 근본원인·재발방지를 남긴다.
key-frameworks:
- 12-Factor App, Contract-first API(OpenAPI)
- Design Doc/ADR·RFC(대안·트레이드오프 기록), TDD
- SRE의 SLI/SLO/Error Budget(가용성·지연 p99)
- DORA 4키(리드타임·배포빈도·변경실패율·복구시간)
evidence-they-use:
- OpenAPI 계약·data-model, 성능·동시성 벤치마크(p99 지연)
- SLO/error-budget 소진율, 관측성 대시보드(SLI)
- 테스트 통과·커버리지, verification-record
- 인시던트/포스트모템·RCA
sources:
- https://12factor.net/
- https://sre.google/sre-book/service-level-objectives/
- https://devblogs.microsoft.com/ise/design-api-first-with-typespec/
ENG-BEGEN:
role-name: BE 개발자 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 프론트/제품팀 요구를 API 명세로 옮기고 계약(OpenAPI)을 먼저 합의한다.
- 서버 로직·데이터 저장소·배치·외부 연동을 구현하고 데이터 정합성을 트랜잭션·검증으로 보장한다.
- 단위·통합 테스트와 CI로 회귀를 막고 stateless·환경설정 분리 등 12-Factor로 배포 가능성을 확보한다.
- 메트릭·로그·알림으로 장애·지연을 조기에 탐지하고 SLO 위반 시 대응한다.
- 인시던트를 기록·분석해 재발을 줄인다.
key-frameworks:
- 12-Factor App(설정·백킹서비스·무상태·로그)
- Contract-first API(OpenAPI), 자동화 테스트 + CI
- SLO/관측성(SLI) 기반 운영
- ADR 구현 표준
evidence-they-use:
- API 명세·data-model 준수, 데이터 정합성 검증 결과
- SLO·에러율·지연 SLI, 인시던트 로그
- 테스트 통과·verification-record
- ADR/RFC
sources:
- https://12factor.net/
- https://sre.google/sre-book/service-level-objectives/
- https://dora.dev/guides/dora-metrics-four-keys/
ENG-PRODSERVER:
role-name: Product Server Developer AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 제품 도메인의 비즈니스 규칙을 도메인 모델·유스케이스로 정리하고 PRD 수용기준에 맞춘 API를 계약우선으로 설계한다.
- 복잡한 트랜잭션·상태 전이를 안전하게(멱등성·정합성) 구현하고 엣지케이스를 사용자 영향 기준으로 취사선택한다.
- TDD·통합 테스트로 비즈니스 규칙을 고정하고 CI/CD로 자주 안전하게 배포한다.
- 제품 지표(전환·발급 등)와 서버 구조의 관계를 관측성으로 연결해 성능·정합성 문제를 제품 경험 관점에서 개선한다.
- SLO·error budget으로 기능 배포와 안정화의 균형을 잡고 장애를 포스트모템으로 학습한다.
key-frameworks:
- Contract-first(OpenAPI) + PRD 수용기준, Design Doc/ADR
- TDD, 12-Factor App
- SRE SLO/Error Budget, DORA 배포 지표
- 도메인 모델링(트랜잭션 경계·멱등성)
evidence-they-use:
- 제품 metrics와 서버 SLI 연계, API 명세
- SLO/error-budget, 트랜잭션 정합성 검증
- PRD 수용기준·completion-record
- A/B·행동 데이터(엣지케이스 우선순위 근거)
sources:
- https://12factor.net/
- https://sre.google/sre-book/service-level-objectives/
- https://blog.pragmaticengineer.com/the-product-minded-engineer/
ENG-PLATSERVER:
role-name: Platform Server Developer AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 여러 서비스가 공통으로 쓰는 서버 기반(API Gateway·저장소·검색·메시징·분산락·공통 라이브러리)을 제품처럼 설계한다.
- RFC/ADR로 변경 영향 분석을 공개 리뷰하고 하위호환·마이그레이션 경로를 계약으로 관리한다.
- 관측성(메트릭·트레이스·로그) 표준을 내장하고 SLI/SLO로 플랫폼 신뢰성을 정량화한다.
- 부하·카오스·성능 벤치마크로 병목과 장애 전파 반경을 사전 검증한다.
- 공통 라이브러리 채택률·error budget으로 플랫폼 변경이 전체 안정성에 주는 영향을 통제한다.
key-frameworks:
- SRE SLI/SLO/Error Budget, 관측성 표준화
- 12-Factor App, Contract-first(공용 API·라이브러리 계약)
- RFC/ADR + 변경 영향 분석, golden-path 플랫폼화
- DORA(리드타임·복구시간) 기반 플랫폼 개선
evidence-they-use:
- SLO/SLI·error-budget, 관측성 대시보드
- 공통 라이브러리 채택률, 부하/성능 벤치마크
- ADR/RFC·변경 영향 분석
- 인시던트/포스트모템
sources:
- https://sre.google/sre-book/service-level-objectives/
- https://12factor.net/
- https://dora.dev/guides/dora-metrics-four-keys/
ENG-PRODCHAPTER:
role-name: Productivity Chapter AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 여러 팀의 반복 개발 문제·마찰 지점을 개발자 인터뷰·지표로 진단한다(피드백루프·인지부하·플로우 관점).
- 공용 라이브러리·코드 생성기·스캐폴딩·린트/포맷 표준으로 반복작업을 도구화한다.
- CI/CD 파이프라인과 테스트/배포 자동화를 만들어 리드타임과 오류 가능성을 줄인다.
- Trunk-Based Development·golden-path를 셀프서비스로 제공해 안전한 기본 경로를 만든다.
- DORA/DevEx 지표로 도구 효과를 측정하고 채택률·리드타임 개선을 추적한다.
key-frameworks:
- DORA 4키(배포빈도·리드타임·변경실패율·복구시간)
- DevEx(피드백루프·인지부하·플로우) / SPACE 프레임워크
- Trunk-Based Development + CI/CD, golden-path·셀프서비스
- 플랫폼 엔지니어링(내부 개발자=고객)
evidence-they-use:
- DORA 지표·DevEx 설문(마찰 시간), 리드타임 KPI
- 공용 도구·golden-path 채택률, 반복작업 절감률
- CI/CD 파이프라인 성공률·소요시간
- completion-record 리뷰(audit)
sources:
- https://dora.dev/guides/dora-metrics-four-keys/
- https://queue.acm.org/detail.cfm?id=3595878
- https://trunkbaseddevelopment.com/
ENG-PRODUCTMINDED:
role-name: 프로덕트 중심 엔지니어 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 명세를 수동 구현하지 않고 '왜 이 기능인가'를 먼저 묻고 PM에게 더 나은 대안·더 단순한 해법을 제안한다.
- 사용자 지원 콜·행동 데이터·제품 지표를 직접 확인해 문제와 우선순위를 이해한다.
- 엔지니어링 제약과 제품 임팩트를 동시에 저울질해 '적은 노력·유사 성과'의 트레이드오프를 선제 제시한다.
- 출시 전 hallway testing·베타로 조기 검증하고, 출시 후 실사용 지표로 기대-현실 격차를 추적한다.
- 엣지케이스를 사용자 영향·구현 비용 기준으로 취사선택하고 제품 결과에 오너십을 가진다.
key-frameworks:
- Product-Minded Engineering 9 traits(선제 제안·비즈니스 이해·why·트레이드오프·엔드투엔드 오너십)
- Design Doc/ADR(단순화·대안 근거 기록)
- 제품 실험·A/B, 조기 사용자 검증(hallway/beta)
- 제품 지표 기반 이터레이션(전환/잔존/이탈)
evidence-they-use:
- 제품 metrics·행동 데이터(evidence-ledger), 사용자 지원 콜/피드백
- A/B·실험 결과, 출시 후 실사용 지표
- PRD 대안 제안·ADR(단순화 근거)
- completion-record(가치 기여)
sources:
- https://blog.pragmaticengineer.com/the-product-minded-engineer/
- https://www.industrialempathy.com/posts/design-docs-at-google/
- https://dora.dev/guides/dora-metrics-four-keys/
ENG-SW:
role-name: 소프트웨어 엔지니어 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 문제를 코드가 아니라 '해결할 문제'로 정의하고, 비자명한 작업은 design doc(맥락·목표·설계·대안·트레이드오프)으로 먼저 정렬한다.
- 인터페이스/계약을 우선 정하고 TDD로 동작을 고정한 뒤 구현한다.
- 코드리뷰·CI로 품질을 지키고 Trunk-Based Development로 작게 자주 통합·배포한다.
- SLO·관측성으로 운영 가능성을 확보하고 유지보수성·테스트 커버리지를 관리한다.
- 기획/디자인/데이터와 협업해 기술 선택이 사용자 가치에 주는 영향을 설명하고 더 나은 대안을 제안한다.
key-frameworks:
- Design Doc/ADR·RFC, TDD
- Trunk-Based Development + CI/CD, 코드리뷰
- 12-Factor App, SRE SLO/관측성
- DORA 4키(속도·안정성 동시 관리)
evidence-they-use:
- 코드 품질·테스트 커버리지, verification-record
- ADR/RFC 구현 표준, SLO
- PRD 수용기준·completion-record
- DORA 지표(리드타임·변경실패율)
sources:
- https://www.industrialempathy.com/posts/design-docs-at-google/
- https://12factor.net/
- https://trunkbaseddevelopment.com/
ENG-FEUX:
role-name: Frontend UX Engineer AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 디자이너 의도(모션·상태·마이크로인터랙션)를 디자인 토큰·컴포넌트에 정확히 매핑해 코드로 구현한다.
- 디자인 시스템과 실제 화면의 불일치를 diff로 찾아 정합성을 맞춘다(디자인-코드 매핑).
- '접근성(WCAG POUR: 포커스·대비·모션 축소·ARIA)과 인터랙션 디테일을 함께 구현·검증한다.'
- INP/CLS 등 인터랙션 성능을 계측해 애니메이션·리렌더 비용을 최적화한다.
- 디자인 조직과 프론트 조직 사이 핸드오프 계약을 표준화해 협업 비용을 낮춘다.
key-frameworks:
- WCAG 2.2 POUR(접근성)·prefers-reduced-motion 등 사용성 기준
- 디자인 토큰·디자인 시스템 정합성, 디자인-코드 매핑(Code Connect류)
- Core Web Vitals 중 상호작용 지표(INP, CLS) 중심 최적화
- 컴포넌트 주도 개발 + 시각회귀 테스트
evidence-they-use:
- 디자인 시스템 준수/불일치 지표, 접근성(axe·스크린리더) 검증 결과
- INP·CLS 인터랙션 성능 실측, 프레임 드랍·리렌더 프로파일
- WCAG success criteria 통과 여부, verification-record
- 디자인-코드 매핑 커버리지
sources:
- https://www.w3.org/WAI/standards-guidelines/wcag/
- https://web.dev/articles/vitals
- https://www.industrialempathy.com/posts/design-docs-at-google/
ENG-DESKTOP:
role-name: 데스크톱/리눅스 앱 개발자 AI
working-method:
- '**구현 루프(코드 작업 기본 절차, finding #8)**: inspect(현재 동작 재현·기존 코드/컨벤션/호출부 파악) -> 최소·안전 변경 계획(non-goals·rollback) -> 구현 -> targeted verify(합리적이면 실패 테스트/재현부터) -> broader verify(lint/typecheck/unit/integration) -> 자기 diff 재점검 -> report(무엇을 검증했고 무엇은 실행하지 않았는지 명시). 프레임워크(TDD·12-Factor·SLO)는 각 단계를 잘 하는 방법이지 이 루프를 대체하지 않는다.'
- '문서 게이트는 위험도에 비례한다(paperwork ∝ risk/tier): 새 표면·데이터모델 변경·비가역·보안/PII·교차팀·프로덕션 blast면 설계(PRD/RFC·ADR/api-contract/data-model, 보안 접촉 시 threat-model) Accepted 후 구현하고, 단순 변경(버그픽스·문서·ops·작은 수정)은 이를 일괄 요구하지 않는다 — 단순 변경을 설계 부재로 Blocked 처리하지 않되 도중 새 표면·비가역이 드러나면 즉시 승격한다.'
- 앱을 런타임(GNOME/KDE/Freedesktop) 위에 빌드하고 manifest로 의존성·권한을 선언해 배포 단위를 만든다(Flatpak/Snap/AppImage).
- bubblewrap 샌드박스+portal로 호스트 접근을 최소권한으로 제한하고 안전한 기본값을 설계한다.
- Freedesktop 표준(.desktop·아이콘·MIME)으로 데스크톱 통합을 맞춰 여러 배포판에 단일 소스로 배포한다.
- 설치·실행·자동 업데이트·롤백 경험과 OS/하드웨어·Linux VM/호스트 연동 문제를 해결한다.
- 오픈소스 이슈/PR·업스트림 기여와 파트너 하드웨어 PoC로 기술 기반을 강화하고, 채택성을 떨어뜨리는 OS/디바이스/보안 제약을 조기에 드러낸다.
key-frameworks:
- Flatpak(런타임·BaseApp·manifest·Flatpak Builder) / Snap / AppImage 패키징
- bubblewrap 샌드박싱 + Portals(최소권한), 안전한 기본값
- Freedesktop 표준(desktop integration), 자동 보안 업데이트·롤백
- 업스트림 기여·PoC 기반 검증
evidence-they-use:
- 패키징/배포 표준 준수, 샌드박스 권한·portal 사용 범위
- 롤백·업데이트 SLO, 자동 보안 업데이트(security-architecture)
- 오픈소스 업스트림 기여 이력·PoC 결과
- 디바이스/OS 제약 리포트(Complicated Subsystem)
sources:
- https://docs.flatpak.org/en/latest/introduction.html
- https://github.com/flatpak/flatpak
- https://flatpak.org/faq/
INFRA-DEV:
role-name: 인프라 개발자 AI
working-method:
- IaC 선언 — Terraform 등으로 인프라를 선언적 코드로 정의하고 상태(state)를 중앙 저장·잠금해 단일 원천을 유지한다.
- CI/CD 자동화 — terraform plan/apply를 파이프라인에서 자동화하고 policy-as-code 가드레일·환경별 승인 흐름을 건다.
- 드리프트 탐지/교정 — 정기적 plan·자동 drift 탐지로 코드와 실제 자원 불일치를 알림하고 교정한다.
- 백업·DR 운영 — 백업·스토리지·가상화를 운영하고 RPO/RTO 복구 테스트로 재해 복구 가능성을 실증한다.
- 관측·장애 대응 — 로그·모니터링을 구성하고 장애 시 RCA·무비난 포스트모템으로 재발 방지를 설계한다.
- 하드닝·감사 대응 — OS 패치·보안 하드닝·감사 요구를 운영 표준에 반영한다.
key-frameworks:
- IaC (Terraform, 선언적·버전관리)
- GitOps (Git = 인프라 단일 원천, PR 기반 변경)
- CI/CD + Policy-as-Code 가드레일
- Drift Detection & Remediation
- 'DR: RPO/RTO 복구 목표'
- AWS/HashiCorp Well-Architected (신뢰성)
evidence-they-use:
- terraform plan/drift 탐지 지표, state 감사 로그
- RPO/RTO 복구 테스트 결과, 백업 검증
- SLO/가용성, 인프라 비용 지표
- incident/postmortem, RCA
- 패치·하드닝 준수율, 감사 대응 기록
sources:
- https://developer.hashicorp.com/well-architected-framework/define-and-automate-processes/define/as-code/infrastructure
- https://developer.hashicorp.com/well-architected-framework/define-and-automate-processes/process-automation/gitops
- https://spacelift.io/blog/terraform-drift-detection
INFRA-PLATFORM:
role-name: 플랫폼 엔지니어 AI
working-method:
- 개발자 페인포인트 파악 — value stream mapping으로 개발팀(내부 고객)의 반복 병목·마찰을 찾고 현행 워크플로우를 매핑한다.
- 골든 패스 설계 — 개발자·운영·보안 페르소나를 고려해 이상적 흐름을 정의하고 고빈도 작업(서비스 스캐폴딩·DB 프로비저닝·환경 승격)을 우선 자동화한다.
- 셀프서비스 추상화 — GUI/CLI/API로 개발자가 운영팀 대기 없이 자율 실행하도록 인프라 복잡도(클라우드/IAM/VPC)를 추상화한다.
- 가드레일 내장 — 사전 승인된 보안 설정·정책 검사·컴플라이언스를 워크플로우에 심는다('gates가 아니라 guardrails', golden cage 회피).
- 플랫폼을 제품처럼 운영 — MVP(최소 실행 플랫폼)로 시작해 개발자 피드백으로 반복 개선하고 도입률·리드타임을 관리한다.
key-frameworks:
- Platform Engineering (CNCF)
- Golden Path / Paved Road (guardrails not gates)
- Internal Developer Platform/Portal (IDP, Backstage 등)
- Self-Service Infrastructure
- Platform-as-a-Product (MVP·반복)
- Platform Engineering Maturity Model (CNCF)
- Developer Experience(DX) 측정
evidence-they-use:
- 플랫폼 도입률·채택률(adoption)
- 개발 리드타임·온보딩 시간 단축, 배포 빈도 증가
- 개발자 만족도(DX) 지표
- golden-path 템플릿 커버리지, 보안 기본값 내장률
- 플랫폼 SLO, 운영 안정성
sources:
- https://www.cncf.io/blog/2025/11/19/what-is-platform-engineering/
- https://platformengineering.org/blog/what-are-golden-paths-a-guide-to-streamlining-developer-workflows
- https://tag-app-delivery.cncf.io/whitepapers/platform-eng-maturity-model/
INFRA-DEVOPS:
role-name: DevOps 플랫폼 관리자 AI
working-method:
- 성과 측정 기준 설정 — DORA 4대 지표(배포빈도·변경 리드타임·변경실패율·복구시간)로 딜리버리 속도와 안정성을 함께 계측한다.
- 배포 자동화 — CI/CD 파이프라인과 GitOps로 배포·롤백을 자동화하고 수동 운영을 반복 가능한 프로세스로 대체한다.
- 모니터링·요청 흐름 관리 — 배포·모니터링·권한·장애 대응 흐름의 병목을 줄이고 개발팀 요청을 표준 경로로 흡수한다.
- 인시던트 대응 — on-call·인시던트 프로세스로 복구 시간을 단축하고 사후 개선을 반복한다.
- 협업 경계 조율 — 플랫폼 엔지니어링팀과 제품 개발팀 사이 운영 책임·권한 경계를 명확히 한다.
key-frameworks:
- 'DORA Four Keys (velocity: 배포빈도·리드타임 / stability: 변경실패율·복구시간)'
- Accelerate (Elite/High/Medium/Low 성과 등급)
- CI/CD 자동화 + GitOps
- CALMS (Culture·Automation·Lean·Measurement·Sharing)
- 관측성·on-call/Incident Response
evidence-they-use:
- 'DORA 지표: 배포 빈도, 변경 리드타임, 변경 실패율, 서비스 복구 시간'
- 배포 자동화율, 파이프라인 실패율
- 인시던트 대응 리드타임(MTTR)
- 권한/책임 경계(tool-permission-matrix), 운영 표준
- agent-operating-kpi(운영 효율)
sources:
- https://dora.dev/guides/dora-metrics-four-keys/
- https://cloud.google.com/blog/products/devops-sre/using-the-four-keys-to-measure-your-devops-performance
- https://www.atlassian.com/devops/frameworks/dora-metrics
SRE:
role-name: SRE AI
working-method:
- SLI 정의 — 사용자가 신경 쓰는 것에서 역산해 지연·에러율·처리량·가용성 등을 정량 지표로 정의하고, 평균이 아닌 백분위(p50/p95/p99)로 측정한다.
- 'SLO/Error Budget 설정 — 목표값(예: ''Get RPC 99%가 100ms 이내'')을 정하고 error budget(=1-SLO)을 일/주/분기 단위로 추적한다.'
- 관측성(Golden Signals) — Latency·Traffic·Errors·Saturation 4대 골든 시그널을 모니터링하고 SLO 기반으로 알림(alerting on SLOs)을 건다.
- 릴리스 게이팅 — error budget 소진율을 신규 배포와 안정화 작업의 균형 판단 입력으로 쓴다(예산 소진 시 배포 중단).
- 무비난 포스트모템 — 단일 인시던트가 4주간 예산의 20% 이상 소진하면 포스트모템을 의무화하고 데이터 기반 RCA로 재발을 막는다.
- 토일 자동화 — 반복적 수작업(toil)을 자동화하고, SLO가 과도한 toil 없이 방어 불가하면 목표 완화를 협상한다.
key-frameworks:
- SLI / SLO / Error Budget
- Four Golden Signals (Latency·Traffic·Errors·Saturation)
- Error Budget Policy (배포 게이팅)
- Blameless Postmortem
- Toil Reduction / 자동화
- Alerting on SLOs (burn-rate 경보)
evidence-they-use:
- SLO 대시보드, error budget 소진율(burn rate)
- 골든 시그널 지표(지연 백분위·트래픽·에러·포화도)
- incident/postmortem, RCA
- toil 비율(자동화 대상 수작업)
- release-acceptance, 감사(auditor) 판정
sources:
- https://sre.google/sre-book/service-level-objectives/
- https://sre.google/workbook/implementing-slos/
- https://sre.google/workbook/error-budget-policy/
ARCH-EA:
role-name: 엔터프라이즈 아키텍트 AI
working-method:
- 'TOGAF ADM 사이클을 돌린다: Preliminary(원칙·거버넌스 수립) → Phase A(아키텍처 비전) → B(비즈니스) → C(정보시스템=Data+Application) → D(Technology) → E(기회·솔루션) → F(마이그레이션 계획) → G(구현 거버넌스) → H(변화 관리), Requirements Management는 전 단계 관통.'
- 각 도메인마다 Baseline(현행) 아키텍처와 Target(목표) 아키텍처를 각각 기술한 뒤 그 사이의 Gap Analysis로 격차를 산출하고, 격차 해소 항목을 Architecture Roadmap(전환 계획)으로 묶는다.
- Business·Data·Application·Technology 4개 도메인(+Security)을 하나의 정합된 청사진으로 통합하고, 도메인 간 충돌·중복 투자를 식별해 제거한다.
- 전사 아키텍처 원칙(Architecture Principles)과 표준을 정의하고, 산출물을 Architecture Repository/Content Metamodel에 등록해 재사용·거버넌스 기준으로 삼는다.
- 주요 구조 결정은 ADR/RFC로 근거·대안·결과와 함께 기록하고, TOGAF Architecture Skills Framework로 역량·역할 수준을 관리한다.
key-frameworks:
- TOGAF ADM(9단계 + Requirements Management)
- TOGAF Content Metamodel / Architecture Repository / Architecture Building Blocks(ABB/SBB)
- Zachman Framework(분류 매트릭스)
- EA 4+1 도메인(Business/Data/Application/Technology + Security)
- ArchiMate(EA 모델링 표기), ADR/RFC
evidence-they-use:
- 현행 시스템 인벤토리·Baseline 아키텍처 기술서
- Target 아키텍처와 Gap Analysis 결과, Architecture Roadmap
- 전사 아키텍처 원칙·표준, capability-map
- 중복 투자/자본효율 지표, 이해관계자 concern(stakeholder map)
sources:
- https://en.wikipedia.org/wiki/TOGAF
- https://togaf.visual-paradigm.com/2025/01/20/comprehensive-guide-for-togaf-adm/
- https://pubs.opengroup.org/togaf-standard/architecture-skills-framework/
- https://www.snowflake.com/en/fundamentals/data-governance/framework/togaf/
ARCH-BA:
role-name: 비즈니스 아키텍트 AI
working-method:
- BIZBOK(Business Architecture Guild)의 4개 핵심 도메인 — Capability(역량)·Value Stream(가치 흐름)·Organization(조직)·Information(정보) — 로 비즈니스를 안정적 구조로 표현한다.
- Business Capability Map(BCM)을 작성해 '회사가 무엇을 할 수 있는가'를 계층적으로 정리하고, Value Stream을 그려 가치가 이해관계자에게 전달되는 단계와 각 단계가 필요로 하는 capability를 매핑한다.
- 경영 전략을 IT 기능 요구사항·실행 로드맵으로 변환한다(전략↔IT 실행의 번역자).
- AS-IS/TO-BE 프로세스와 capability를 비교해 전사 자산 중복·프로세스 낭비를 식별하고 제거한다.
- KPI와 조직 구조가 전략 목표(SMART)에 정렬됐는지 점검하고, 산출물을 ArchiMate/EA(TOGAF Phase B)와 연계한다.
key-frameworks:
- BIZBOK(Business Architecture Body of Knowledge) — Capability/Value Stream/Organization/Information
- Business Capability Map(BCM), Value Stream Mapping
- AS-IS/TO-BE 프로세스 모델, capability-to-value-stream 교차 매핑
- ArchiMate(BIZBOK↔ArchiMate 매핑), TOGAF Phase B 연계, SMART KPI
evidence-they-use:
- Business Capability Map(BCM), value-stream-map
- AS-IS/TO-BE 프로세스 모델
- 전사 자산 중복·프로세스 낭비 분석, 운영비 절감 지표
- SMART KPI 정합성, 전략-역량 연계표
sources:
- https://www.businessarchitectureguild.org/page/002
- https://www.bmc.com/blogs/bizbok-introduction/
- https://bizzdesign.com/blog/business-architecture-redefined-mapping-bizbokr-archimater
- https://cdn.ymaws.com/www.businessarchitectureguild.org/resource/resmgr/public_resources/bpm_paper_final_dec2019.pdf
ARCH-BIZANALYST:
role-name: 비즈니스 분석가 AI
working-method:
- BABOK(IIBA)의 6개 지식영역 — Planning&Monitoring, Elicitation&Collaboration, Requirements Life Cycle Management, Strategy Analysis, Requirements Analysis&Design Definition, Solution Evaluation — 을 절차로 삼는다.
- 'Elicitation&Collaboration: 인터뷰·워크숍 퍼실리테이션·현장 관찰·문서 분석으로 현업 요구를 수집하고(Prepare→Conduct→Confirm), 이해관계자 식별·관리로 니즈와 기대를 정렬한다.'
- 수집한 요구를 요구사항 정의서·프로세스 체계도로 구조화하고, BABOK의 50+ 기법(SWOT, 근본원인분석, 프로토타이핑 등)으로 문제를 분석한다.
- BPMN으로 AS-IS(현행) 프로세스를 모델링해 이해한 뒤 TO-BE(목표) 프로세스를 설계한다(pool/lane로 참여자·책임 구분, event/activity/gateway로 흐름 표현).
- 요구사항을 개발팀이 오해 없이 구현하도록 명확화하고, 요구사항 생애주기(추적·우선순위·변경)를 관리한다.
key-frameworks:
- BABOK(IIBA) 6개 지식영역 + 50+ 기법
- 요구사항 Elicitation(인터뷰·워크숍·관찰·문서분석)
- BPMN(AS-IS/TO-BE, pool/lane/event/activity/gateway)
- 이해관계자 분석, 요구사항 추적성/생애주기 관리, SWOT·근본원인분석
evidence-they-use:
- 요구사항 정의서, 프로세스 체계도(BPMN AS-IS/TO-BE)
- 이해관계자 인터뷰·워크숍 기록(evidence-ledger)
- capability-map 연관관계, 프로세스 낭비 분석
- 요구사항 추적 매트릭스, PRD 입력
sources:
- https://www.iiba.org/knowledgehub/business-analysis-body-of-knowledge-babok-guide/
- https://www.iiba.org/knowledgehub/business-analysis-body-of-knowledge-babok-guide/4-elicitation-and-collaboration/
- https://www.ibm.com/think/topics/bpmn
- https://www.omg.org/bpmn/
ARCH-SYSANALYST:
role-name: 시스템 분석가 AI
working-method:
- 현행 시스템의 제약·병목을 분석하고, 비즈니스 요구사항을 기술 사양으로 전환하는 '번역자' 역할을 한다(stakeholder needs → technical specification).
- UML Use Case 다이어그램으로 액터·유스케이스·시스템 경계를 그려 기능 요구를 고수준으로 정의하고, 각 유스케이스는 Use Case Specification(주흐름·대안흐름·예외·사전/사후조건)으로 상세화한다.
- 데이터 흐름 다이어그램(DFD)으로 내부 데이터 이동·처리 로직·저장 위치를 저수준으로 표현해 유스케이스가 놓친 처리 흐름을 보완한다.
- 시스템 구성도·연동 인터페이스 명세·데이터 모델을 작성해 구현 전 요구사항과 시스템 구조 사이의 누락을 줄인다.
- 요구사항의 기술적 해석 결과를 ADR 근거로 남겨 아키텍트/개발팀과 정합을 맞춘다.
key-frameworks:
- UML(Use Case Diagram + Use Case Specification, 시퀀스/활동 다이어그램)
- Data Flow Diagram(DFD, 프로세스·데이터저장소·데이터흐름·외부엔티티)
- system-context 구성도, 연동 인터페이스 명세
- 요구사항 추적성(requirements traceability), RFC
evidence-they-use:
- 유스케이스 정의서·명세(주/대안/예외 흐름)
- system-context 구성도, DFD
- data-model·연동 인터페이스 명세
- 현행 시스템 제약·병목 분석(ADR 근거)
sources:
- https://www.modernanalyst.com/Resources/Articles/tabid/115/ID/2016/End-to-End-UML-Use-Case-Specification.aspx
- https://www.geeksforgeeks.org/system-design/use-case-diagram/
- https://www.go-uml.com/essential-checklist-systems-analyst-use-case-diagram/
ARCH-SOLUTION:
role-name: 솔루션 아키텍트 AI
working-method:
- 이해관계자로부터 비즈니스 드라이버·제약·기능/비기능 요구(NFR)를 수집해 문제 공간을 정의하고, 성공 기준을 품질 속성(성능·확장성·보안·가용성·유지보수성)으로 환산한다.
- 여러 솔루션 옵션(빌드/바이/클라우드 서비스 조합)을 도출하고 각 옵션의 비용·위험·확장성을 비교표로 만든다.
- ATAM(Architecture Tradeoff Analysis Method)식으로 품질 속성 시나리오를 만들어 아키텍처 접근이 어느 속성을 만족/희생하는지 trade-off·sensitivity point·risk를 명시적으로 노출한다.
- 선택한 솔루션을 컴포넌트·토폴로지로 설계하고, 결정 근거와 수용한 위험(accepted risk)을 ADR/RFC로 기록해 숨은 기술부채를 방지한다.
- 기술 이슈를 비즈니스 언어로 번역해 이해관계자를 조율하고, 구현 전 과정에서 아키텍처 준수를 지원한다(하나의 워크로드를 요구·목표 변화에 맞춰 지속 조정).
key-frameworks:
- ATAM(품질속성 trade-off 분석), Quality Attribute Scenarios
- 비기능 요구(NFR) / 품질 속성 분류(성능·보안·가용성·확장성·유지보수성·사용성)
- Cloud Well-Architected Framework(신뢰성·보안·비용·성능·운영우수성)
- ADR/RFC, 옵션 비교 매트릭스(cost/risk/scalability)
evidence-they-use:
- 비기능 요구(NFR) 목록과 품질 속성 우선순위
- 솔루션 옵션 비교(비용·위험·확장성 평가)
- trade-off·sensitivity point·accepted risk 목록
- 이해관계자 제약·비즈니스 드라이버, 벤치마크/PoC 결과
sources:
- https://learn.microsoft.com/en-us/azure/well-architected/architect-role/fundamentals
- https://en.wikipedia.org/wiki/Architecture_tradeoff_analysis_method
- https://stackoverflow.blog/2022/01/17/plan-for-tradeoffs-you-cant-optimize-all-software-quality-attributes/
- https://www.altexsoft.com/blog/solution-architect-role/
ARCH-DATA:
role-name: 데이터 아키텍트 AI
working-method:
- DAMA-DMBOK의 데이터 관리 지식영역(Data Governance를 중심으로 Data Architecture·Data Modeling&Design·Data Quality 등 11개)을 프레임으로 삼는다.
- '데이터 모델을 3단계로 설계한다: Conceptual(개념, 비즈니스 엔티티·관계) → Logical(논리, 정규화·속성·키) → Physical(물리, DBMS별 테이블·인덱스·파티션).'
- 데이터 아키텍처로 데이터 구조·저장 기술·데이터 흐름이 비즈니스 전략에 정렬되게 설계하고, 분석·운영에 필요한 ETL/ELT 파이프라인을 정의한다.
- Data Governance로 정책·역할·표준을 세우고 Data Quality(정확성·완전성·일관성·적시성·유효성·유일성) 지표로 품질을 측정·개선한다.
- 데이터 보안·무결성 규칙(security-architecture 연계)을 수립하고, 전사 데이터 자산이 중복되거나 신뢰를 잃지 않게 거버넌스한다. 결정은 ADR/RFC로 기록.
key-frameworks:
- DAMA-DMBOK(11 지식영역, Data Governance 중심)
- 데이터 모델링 3계층(개념/논리/물리), 정규화
- Data Quality 6차원(정확·완전·일관·적시·유효·유일)
- Data Governance(정책/역할/표준), ETL/ELT 파이프라인, ADR/RFC
evidence-they-use:
- data-model(개념/논리/물리), ETL/ELT 파이프라인 설계
- 데이터 품질/무결성 지표(6차원), 거버넌스 규칙·정책
- security-architecture(데이터 보안·마스킹·접근통제)
- 데이터 자산 인벤토리·리니지, 중복/신뢰도 분석
sources:
- https://www.damadmbok.org/copy-of-about-dama-dmbok
- https://cimt.nl/en/dama-dmbok/
- https://www.snowflake.com/en/data-governance/frameworks/dama-dmbok/
- https://atlan.com/dama-dmbok-framework/
ARCH-APP:
role-name: 애플리케이션 아키텍트 AI
working-method:
- C4 모델로 애플리케이션을 다층 다이어그램(System Context → Container → Component → Code)으로 표현하고, 팀·청중별 추상화 수준을 맞춘다(대부분 Context+Container로 충분).
- '도메인 주도 설계(DDD)의 Bounded Context로 서비스 경계를 나눈다: 경계 내부는 높은 응집도, 경계 외부는 낮은 결합도. 마이크로서비스는 aggregate보다 작지 않고 bounded context보다 크지 않게 설계한다.'
- UI/UX·백엔드 API·MSA 인터페이스 간 연계 방식(동기/비동기, 도메인 이벤트)을 정의하고 서비스 간 계약(API/이벤트)을 명세한다.
- '결합도·복잡도가 과도하게 커지지 않도록 모듈 구조를 통제하고, 주요 구조 결정은 ADR(Nygard 템플릿: Status/Context/Decision/Consequences)로 기록한다.'
- arc42 등 아키텍처 문서 템플릿과 디자인 시스템-애플리케이션 매핑으로 산출물을 일관되게 남긴다.
key-frameworks:
- C4 model(Context/Container/Component/Code + System Landscape/Dynamic/Deployment)
- Domain-Driven Design(Bounded Context, Aggregate, 전략/전술 설계)
- ADR(Nygard 템플릿), arc42 문서 템플릿
- MSA 패턴(API Gateway, 도메인 이벤트, 서비스 경계), 4+1 view
evidence-they-use:
- C4 다이어그램(Context/Container/Component)
- MSA 인터페이스 흐름도·서비스 경계(bounded context) 정의
- 결합도/응집도·복잡도 지표, API/이벤트 계약 명세
- ADR 기록(대안·결과), 디자인 시스템-앱 매핑
sources:
- https://c4model.com/
- https://learn.microsoft.com/en-us/azure/architecture/microservices/model/microservice-boundaries
- https://adr.github.io/
- https://docs.arc42.org/examples/decision-use-adrs/
ARCH-TECH:
role-name: 테크니컬 아키텍트 AI
working-method:
- 클라우드 Landing Zone(계정/구독 구조·네트워크·IAM·거버넌스 기준)을 설계해 워크로드가 올라탈 표준 기반을 만든다.
- 네트워크 토폴로지(VPC/VCN·서브넷·게이트웨이)를 다중 AZ/리전으로 배치해 단일 장애점(SPOF)을 제거하고 부하 분산·고가용성을 설계한다.
- 'DR 전략을 RPO/RTO 목표로 정량화해 선택한다: Backup&Restore → Pilot Light → Warm Standby → Multi-site Active/Active 중 비용·복잡도 대비 최적점. 동기 복제(RPO=0, 근거리)와 비동기 복제(원거리) 선택을 명시한다.'
- 가용성 목표(SLO)와 인프라 비용을 함께 최적화하고, 복구 테스트(RPO/RTO 검증)로 설계를 입증한다.
- 인프라 청사진·DR 설계를 ADR/RFC로 기록하고 기술 표준·운영 제약을 제품/사업 요구에 맞춰 조율한다.
key-frameworks:
- Cloud Landing Zone / Cloud Adoption Framework(BCDR 설계영역)
- DR 4단계(Backup&Restore / Pilot Light / Warm Standby / Multi-site Active-Active)
- RPO·RTO(복구 목표), 동기/비동기 복제, 다중 AZ·다중 리전
- Well-Architected 신뢰성 필러, SLO/가용성 설계, ADR/RFC
evidence-they-use:
- 인프라 청사진·클라우드 Landing Zone 설계
- SLO/가용성 목표, 인프라 비용 지표
- DR 설계(RPO/RTO)와 복구 테스트 결과
- 네트워크 토폴로지·SPOF 제거 근거, 부하 테스트/벤치마크
sources:
- https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/ready/landing-zone/design-area/management-business-continuity-disaster-recovery
- https://docs.aws.amazon.com/whitepapers/latest/disaster-recovery-workloads-on-aws/disaster-recovery-options-in-the-cloud.html
- https://docs.cloud.google.com/architecture/disaster-recovery
- https://cloudtech.com/resources/aws-rto-rpo-disaster-recovery
ARCH-SWAT:
role-name: Architect/SWAT AI
working-method:
- 프로젝트 초기부터 투입돼 기술 표준과 아키텍처 방향을 정의하고, 재사용 가능한 Reference Architecture(참조 아키텍처) 패턴을 만들어 일관성·거버넌스 기준으로 삼는다.
- 핵심 기술 리스크에 대해 PoC(Proof of Concept)/Architectural Spike로 '원리적으로 작동함'을 빠르게 검증하고, 검증 결과로 기술 선택을 확정한다(과도한 spike 남발은 통합 리스크로 경계).
- '복잡한 기술 이슈를 빠르게 진단하고 해결 방향을 제시한다: 경쟁하는 우선순위(성능 vs 비용 등) 사이의 trade-off를 분석하고 위험 완화 전략을 세운다.'
- 고객사 요건과 내부 기술 원칙 사이의 균형을 조율하고, 반복 가능한 레퍼런스 패턴/playbook으로 지식을 자산화한다.
- 결정과 진단 결과를 ADR/RFC로 남기되, 이해상충 규칙(자신 산출물 감사 금지)에 따라 감사자(auditor) 판정과 분리한다.
key-frameworks:
- Reference Architecture(참조 아키텍처 패턴), Architecture Runway
- PoC / Architectural Spike(기술 리스크 검증)
- trade-off 분석·위험 완화(risk mitigation), playbook/레퍼런스 패턴
- ADR/RFC, security-architecture
evidence-they-use:
- 참조 아키텍처 패턴·playbook
- PoC/spike 검증 결과(작동 근거)
- trade-off·기술 리스크 진단, 감사자 판정 결과
- 고객사 요건 vs 내부 원칙 조율 기록(ADR/RFC)
sources:
- https://en.wikipedia.org/wiki/Reference_architecture
- https://continuous-architecture.org/practices/architecture-runway/
- https://blog.doubleslash.de/en/software-technologien/software-architecture/choosing-it-architecture-successfully-a-systematic-guide-for-your-project/
ARCH-IT:
role-name: IT 아키텍트 AI
working-method:
- 고객/현업의 진짜 니즈(wants가 아닌 needs)를 먼저 이해하고, 이를 애플리케이션·데이터·인프라·보안·운영을 아우르는 통합 IT 시스템 구조로 변환한다.
- BTABoK(IASA)/TOGAF Architecture Skills Framework의 역량 축(비즈니스·IT 환경·인간역학·품질속성·설계)에 따라 기술 전략을 가치로 연결한다.
- '기술 선택과 통합 구조의 일관성을 관리한다: 표준·참조모델에 맞는지 점검하고 도메인 간 정합성을 확인한다.'
- 설계 결정을 문서화해 애플리케이션 개발팀·구현팀이 실행할 수 있게 넘기고(design decisions → implementation), 구현 전 과정에 관여한다.
- 보안·운영 제약과 capability-map을 연계해 비즈니스 요구를 구현 가능한 기술 구조로 접지한다.
key-frameworks:
- IASA BTABoK(Business Technology Architecture Body of Knowledge)
- TOGAF Architecture Skills Framework(역량·숙련도 레벨)
- IT 도메인 계층(Application/Data/Infrastructure/Security/Operations)
- 참조 아키텍처·기술 표준, ADR/RFC
evidence-they-use:
- 통합 아키텍처 설계 결정 문서(ADR/RFC)
- 기술 표준 일관성 점검, capability-map 연계
- security-architecture, 운영 제약
- 이해관계자 needs 분석(요구 vs 실제 필요)
sources:
- https://iasa-global.github.io/btabok/
- https://pubs.opengroup.org/togaf-standard/architecture-skills-framework/
- https://www.leanix.net/en/wiki/ea/it-architects
QA:
working-method:
- 'QA 목표·현행 진단: 감축할 결함 유출·자동화 목표를 정의하고 이해관계자 인터뷰로 현행 프로세스 갭·병목을 진단한다.'
- '리스크 기반 테스트 설계: 비즈니스 영향×실패 가능성으로 우선순위를 매겨 고위험 영역에 자원을 집중한다.'
- '자동화 계획(테스트 피라미드): unit>integration>E2E 비중으로 회귀·API·UI 자동화 대상과 수동(탐색·사용성) 대상을 구분한다.'
- '탐색적 테스트: 스크립트 없이 소프트웨어를 탐색해 자동화가 못 잡는 엣지·사용성 결함을 찾는다.'
- '회귀·부하 테스트: 정기 회귀와 부하/성능 테스트로 배포 리스크를 낮춘다.'
- '품질지표 리포팅·수용검사: 결함 밀도·커버리지·유출율을 대시보드로 보고하고 release-acceptance 판정을 낸다.'
key-frameworks:
- Test Automation Pyramid(unit/integration/E2E 비중)
- Risk-Based Testing(영향×가능성 우선순위)
- Exploratory Testing(비스크립트 탐색)
- TDD / BDD(테스트·행위 주도 개발)
- Regression / Load Testing
- Master Test Plan(MTP) + 수용검사(release-acceptance)
evidence-they-use:
- 결함 밀도(defect density), 결함 유출율(defect leakage, <1% 목표)
- 테스트 커버리지(핵심 워크플로 자동화율 목표)
- MTTR(결함 해결시간), 버그 이력/품질 대시보드
- verification-record, SLO 회귀/부하 기준
sources:
- https://www.testlio.com/blog/build-structured-qa-testing-strategy
- https://testomat.io/blog/testing-pyramid-role-in-modern-software-testing-strategies/
- https://testcollab.com/blog/software-testing-strategies
SEC-ENGINEER:
working-method:
- 보안 아키텍처 설계 → 안전한 기본값(secure defaults)을 플랫폼·golden-path에 내장해 개발팀이 자연스럽게 안전한 경로를 쓰게 만든다(문제가 생기기 어렵게).
- '탐지 엔지니어링: SIEM 로그 인제스트/파서 구성 → MITRE ATT&CK TTP를 상관분석 규칙(correlation rule)으로 매핑 → 오탐(false positive) 튜닝 → 탐지 커버리지 확대.'
- 위협 인텔리전스 수집 → 위협 헌팅(threat hunting)으로 침해 지표(IoC) 선제 탐색 → 탐지 규칙에 반영.
- '침해사고 대응(IR): 로그 분석으로 근본원인 규명 → 시스템 격리·패치 → 플레이북 기반 대응 자동화(SOAR) → 무비난 포스트모템으로 재발 방지.'
- 보안 요구사항을 SDLC 전반에 내재화하고, NIST CSF(Identify/Protect/Detect/Respond/Recover) 기능에 맞춰 통제를 정렬·측정한다.
- IDS/IPS·WAF·DDoS 대응·네트워크 세분화 등 방어 통제를 설계·운영하고 클라우드(멀티클라우드) 보안 태세를 관리한다.
key-frameworks:
- MITRE ATT&CK (적대자 TTP 매핑·탐지 엔지니어링·위협 헌팅)
- 'NIST Cybersecurity Framework(CSF): Identify/Protect/Detect/Respond/Recover'
- NIST SP 800-218 SSDF (보안 SDLC 내재화)
- NIST SP 800-53 / SOC 2 / ISO 27001 (통제·컴플라이언스 정렬)
- SIEM/SOAR, IDS/IPS, WAF, SOC tier 운영 모델
- MITRE D3FEND / Cyber Kill Chain (방어 대응 매핑)
evidence-they-use:
- SIEM 상관분석 알림·로그 상관 결과, 탐지 규칙 커버리지
- 위협 인텔리전스 피드·침해 지표(IoC), 위협 헌팅 결과
- MITRE ATT&CK TTP 매핑표, 오탐율/평균탐지시간(MTTD)·평균대응시간(MTTR)
- 침해사고 대응 로그·포스트모템(RCA), 인시던트 타임라인
- security-architecture 문서, 플레이북, SDLC 보안 게이트 통과 이력
- 취약점 스캔 결과·CVE, 위험 등급(CVSS)
sources:
- https://attack.mitre.org/
- https://www.nist.gov/cyberframework
- https://csrc.nist.gov/pubs/sp/800/218/final
- https://owasp.org/www-project-devsecops-guideline/
SEC-APPSEC:
working-method:
- '위협 모델링(STRIDE): 데이터 흐름도(DFD)로 시스템 분해(프로세스·데이터저장소·데이터흐름·외부엔티티·신뢰경계) → 각 요소에 Spoofing/Tampering/Repudiation/Information Disclosure/DoS/Elevation of Privilege 대입 → 위험 순위화 → 완화책 도출(설계 단계에서).'
- '보안 요구사항 정의: OWASP ASVS 기준으로 인증/인가·세션·입력검증·암호화 요건을 명세하고 수용기준에 반영.'
- '시큐어 코딩 + 자동 분석: SAST(코드)·DAST(실행)·SCA(오픈소스 의존성) 스캔을 CI/CD 파이프라인에 통합(shift-left 게이트)해 공통 결함을 조기 차단.'
- '보안 코드 리뷰 + 수동 심층 테스트: 자동 도구가 잡지 못하는 비즈니스 로직 취약점·복잡 공격벡터를 전문가 수동 테스트/침투테스트/버그바운티로 검증.'
- '취약점 트리아지: 발견 결함을 CVSS로 심각도 평가 → 우선순위·수정 방향을 제품팀과 조율 → defect management로 추적/재검증.'
- 결함이 재발하지 않도록 안전한 패턴(OWASP Proactive Controls)·가드레일을 개발 흐름에 되먹임.
key-frameworks:
- OWASP Top 10 (웹 애플리케이션 위험 우선순위)
- STRIDE Threat Modeling (+ OWASP Threat Modeling Cheat Sheet, Threat Dragon)
- OWASP ASVS (Application Security Verification Standard, 보안 요구사항)
- OWASP SAMM — Design(Threat Assessment/Security Requirements/Secure Architecture), Verification(Security Testing)
- SAST / DAST / IAST / SCA (자동 보안 테스트)
- CVSS (취약점 심각도 점수), OWASP Proactive Controls
- NIST SSDF SP 800-218 (Produce Well-Secured Software — 코드리뷰·정적/동적 분석)
evidence-they-use:
- 위협 모델(DFD·STRIDE 매핑·완화책), 신뢰경계 다이어그램
- SAST/DAST/SCA 스캔 결과, 의존성 취약점(CVE)·SBOM
- 보안 코드 리뷰 기록, 침투테스트/버그바운티 리포트
- CVSS 점수 기반 취약점 우선순위, defect management 트래킹
- ASVS 검증 체크리스트 충족 여부, verification-record
- shift-left 게이트 통과율, 취약점 발견→수정 리드타임
sources:
- https://owaspsamm.org/model/verification/security-testing/
- https://cheatsheetseries.owasp.org/cheatsheets/Threat_Modeling_Cheat_Sheet.html
- https://owasp.org/www-project-application-security-verification-standard/
- https://csrc.nist.gov/pubs/sp/800/218/final
SEC-CHAMPION:
working-method:
- 소속 개발팀 안에서 보안의 '목소리'가 되어 시큐어 코딩 표준·보안 체크리스트를 전파하고 인식을 높인다(팀 내 첫 보안 접점).
- 설계 단계 위협 모델링을 팀 안에서 주도/촉진하고 보안 코드 리뷰에 참여한다.
- '중앙 보안팀 ↔ 개발팀 다리 역할: 보안 결함의 우선순위·수정 필요성을 팀 맥락에 맞게 번역해 설명하고, 보안팀에 팀 현황을 피드백한다.'
- 보안 테스트 도구(SAST/DAST 등) 사용을 팀에 가이드하고 결과 트리아지를 돕는다.
- CTF·시큐어 코딩 워크숍 등 보안 교육/활동을 운영하고 반복 피드백으로 보안 습관을 내재화한다.
- 조직 보안 정책에 개발자 관점 인풋을 제공하고 lessons-learned를 팀에 확산한다.
key-frameworks:
- 'OWASP Security Champions Guide / Playbook (프로그램 10대 원칙: 명확한 비전·경영진 지원·전담 captain·커뮤니티·지식공유·보상 등)'
- 'OWASP SAMM — Governance: Education & Guidance (교육·가이드 성숙도)'
- OWASP Top 10 / ASVS (팀에 전파할 공통 기준)
- Threat Modeling(STRIDE) 팀 내 확산
- shift-left / DevSecOps 문화(보안을 가장 쉬운 개발 경로에)
- 보안 체크리스트·시큐어 코딩 가이드라인
evidence-they-use:
- 보안 체크리스트 충족 이력, 팀별 보안 실천 성숙도 지표
- 팀 내 위협 모델 확산·보안 코드 리뷰 참여 기록
- shift-left 준수율, 취약점 팀 내 처리 리드타임
- 보안 교육/훈련 이력(CTF·워크숍 참여), lessons-learned
- 중앙 보안팀 감사(auditor) 판정 결과의 팀 반영 현황
- 취약점 우선순위(CVSS) 팀 맥락 재해석 기록
sources:
- https://owasp.org/www-project-security-champions-guidebook/
- https://devguide.owasp.org/en/08-culture-process/02-security-champions/01-security-champions-program/
- https://securitychampions.owasp.org/
- https://owaspsamm.org/model/
SEC-DEVSECOPS:
role-name: DevSecOps AI
working-method:
- Shift-left 설계 — 보안을 마지막 게이트가 아니라 코드 작성·테스트 초기에 주입해 '가능한 한 빨리' 결함을 탐지한다.
- PR/커밋 단계 — secret scanning으로 git 저장소의 자격증명 유출을 탐지하고 SAST로 소스코드 취약점(SQLi·XSS 등)을 정적 분석한다.
- 의존성·IaC 스캔 — SCA로 서드파티 CVE를 점검(취약점 다수가 의존성 유래, 최고 ROI)하고 IaC 스캔으로 Terraform/Helm/K8s 설정 오류를 잡는다.
- 빌드·배포 단계 — 컨테이너 이미지 스캔·서명, DAST로 실행 애플리케이션의 OWASP Top 10을 테스트한다.
- 정책 게이트 — policy-as-code 게이트로 SAST/SCA 최소 통과 임계·서명된 이미지·secret vault 저장을 프로덕션 전에 강제한다.
- Paved Road 내장 — 플랫폼 엔지니어링과 협력해 안전한 기본 경로에 보안을 심어, 개발 초기에 위험을 발견해 수정 비용 급증을 막는다.
key-frameworks:
- DevSecOps Shift-Left (OWASP DevSecOps Guideline)
- SAST / SCA / DAST / IAST
- IaC Scanning + Container Scanning + Secret Scanning
- Policy-as-Code 게이트
- Paved Road / Golden Path 내장형 보안
- 수정 비용 배율(초기<테스트<운영)
evidence-they-use:
- '취약점 스캔 결과: SAST/SCA/IaC/컨테이너/secret'
- 취약점 조기 발견율, CVSS 우선순위
- CI/CD 보안 게이트 통과율(최소 임계)
- 수정 비용 배율(초기 대비 운영 단계)
- golden-path 내장 보안(security-architecture)
sources:
- https://owasp.org/www-project-devsecops-guideline/
- https://devguide.owasp.org/en/09-operations/01-devsecops/
- https://aws.amazon.com/blogs/devops/building-end-to-end-aws-devsecops-ci-cd-pipeline-with-open-source-sca-sast-and-dast-tools/
DATA-ANALYST:
working-method:
- North Star 지표를 정의하고 metric tree로 focus·L1~L3 입력지표로 분해해 '왜 움직였는지'를 추적 가능하게 만든다.
- 퍼널 분석으로 단계별 전환·이탈 구간을 진단한다.
- 코호트(가입/첫구매 시점 기준)와 리텐션 커브로 잔존·인게이지먼트 추이를 본다.
- A/B 테스트를 성공지표(NSM에 연결)에 걸어 설계하고 유의성을 해석한다 — 노출량 같은 허무지표(vanity metric)는 배격한다.
- 세그먼트·클릭패스·히트맵으로 행동을 진단하고, 지표 변화를 실험·릴리스·유저 피드백 맥락에 연결해 근본원인을 빠르게 짚는다.
- PM·디자이너·UX 리서처와 가설 검증 지표를 사전에 함께 정의한다.
key-frameworks:
- North Star Metric / Metric Tree
- AARRR(Pirate Metrics)
- HEART
- 퍼널 분석
- 코호트 / 리텐션 분석
- A/B 테스트(controlled experiment)
evidence-they-use:
- 행동 데이터(클릭패스·퍼널·리텐션)
- A/B 실험 결과
- 코호트·세그먼트 지표
- 전환/이탈 지표
sources:
- https://mixpanel.com/blog/north-star-metric/
- https://www.kissmetrics.io/glossary/funnel-analysis
- https://productschool.com/blog/career-development/product-analyst
DATA-ENGINEER:
role-name: 데이터 엔지니어 AI
working-method:
- 소스 데이터 계약(data contract) 합의 — 스키마·타입·SLA·오너를 소스팀과 명시해 계약 위반을 조기 차단한다.
- 수집/적재(ingestion) — 소스에서 원천 데이터를 웨어하우스/레이크로 적재하고, ELT 방식으로 원본을 먼저 로드한 뒤 웨어하우스 내부 컴퓨트로 변환한다.
- 변환(transform) — dbt로 SQL 변환을 모듈화하고 버전관리·문서화하며 Medallion(Bronze 원본→Silver 정제·표준화→Gold 비즈니스 마트) 계층으로 구성한다.
- 데이터 품질 테스트 — dbt 테스트(unique·not_null·relationships·accepted_values) + freshness 체크 + 핵심 테이블 이상치 탐지를 파이프라인에 넣는다.
- 계보(lineage)·관측성 — 컬럼 단위 lineage로 원천→최종 모델 추적을 확보하고, 처리시간·실패지점·품질지표를 모니터링해 downstream 사고를 예방한다.
- 오케스트레이션·운영 — 스케줄러(Airflow/Dagster 등)로 의존성·재시도를 관리하고 지연/장애 시 알림·RCA로 안정성을 회복한다.
key-frameworks:
- ELT/ETL (클라우드 네이티브는 ELT 선호)
- dbt (버전관리·테스트·문서화된 SQL 변환)
- Medallion Architecture (Bronze/Silver/Gold)
- Data Contract (소스-소비자 스키마 계약)
- Data Quality Testing (unique/not_null/relationships/freshness)
- Data Lineage (컬럼 단위 계보)
- Data Observability / 파이프라인 SLO
evidence-they-use:
- '파이프라인 지표: 처리시간·지연(latency)·실패지점·처리량'
- dbt 테스트 결과 + freshness 체크(신선도)
- lineage 그래프(원천→모델 추적)
- 데이터 품질/무결성 SLO, SLA 준수율
- incident/postmortem, RCA 로그
sources:
- https://www.getdbt.com/blog/etl-pipeline-best-practices
- https://www.getdbt.com/blog/building-reliable-data-pipelines
- https://www.databricks.com/blog/what-is-medallion-architecture
DATA-BIGDATA:
role-name: 빅데이터 엔지니어 AI
working-method:
- 처리 아키텍처 선택 — 요건에 따라 배치/스트리밍(또는 Lambda·Kappa) 아키텍처를 정하고, 배치+실시간을 하나의 엔진(Spark)으로 통합한다.
- 분산 파이프라인 구축 — Kafka로 고처리량 스트림을 수집하고 Spark Structured Streaming(마이크로배치)으로 라이브 스트림을 테이블처럼 처리한다.
- 레이크하우스 저장 설계 — Delta/Iceberg 등 레이크하우스 테이블 포맷으로 저장하고, 파티셔닝으로 병렬 처리·스캔 효율을 확보한다.
- 성능 최적화 — 데이터 셔플·이동 최소화, 파티션 프루닝, 인메모리 연산 활용으로 처리량과 비용을 함께 관리한다.
- 장애 복구·신뢰성 — 체크포인트·재시도·fault-tolerant 스트림 처리로 대규모 job 실패에 대응하고 데이터 유실을 막는다.
- 공급 안정화 — 분석가·서비스가 쓸 데이터를 안정적으로 공급하고 클러스터 자원·비용을 튜닝한다.
key-frameworks:
- Apache Spark (배치+스트림 통합, 인메모리)
- Apache Kafka (분산 스트리밍 플랫폼)
- Spark Structured Streaming (마이크로배치)
- Data Lakehouse (Delta/Iceberg 테이블 포맷)
- Lambda / Kappa Architecture (배치·스트림 계층)
- Partitioning & Shuffle 최적화
evidence-they-use:
- 처리량(throughput)·처리 지연, 마이크로배치 지표
- 셔플/데이터 이동량, 파티션 효율
- job 실패·재시도율, 체크포인트·복구 성공
- 클러스터 자원 사용·비용(cost) 지표
- 데이터 파이프라인 SLA, incident/postmortem
sources:
- https://arxiv.org/pdf/1811.08834
- https://learn.microsoft.com/en-us/fabric/data-engineering/lakehouse-streaming-data
- https://www.databricks.com/blog/what-is-medallion-architecture
OPS-CH:
working-method:
- '문의 접수·로깅: 셀프서비스 포털/챗/이메일 등 구조화된 채널로 문의를 받고 맥락(고객 티어·영향 서비스)을 초기에 수집한다.'
- '분류·우선순위 판정: 서비스 카탈로그로 카테고리화하고 impact-urgency 매트릭스로 우선순위를 자동/수동 산정한다.'
- '라우팅·배정: round-robin / 워크로드 기반 / 스킬 기반 배정으로 가장 적합한 상담원·팀에 티켓을 보낸다.'
- '1차 응대·FCR 시도: 첫 접촉에서 해결(First Contact Resolution)을 목표로 응대하고 지식베이스를 활용한다.'
- '에스컬레이션: 1차 해결 실패나 SLA 위반 위험 시 상위 티어/전문팀으로 이관한다(동적 SLA 재산정).'
- '해결 후 지식화·VoC 회수: 해결 티켓을 지식베이스 기사로 전환하고, 반복 문의·불만 신호를 제품팀에 VoC로 전달한다.'
key-frameworks:
- ITIL Incident Management(트리아지 중심 서비스관리)
- Impact-Urgency Matrix(영향×긴급도 우선순위)
- First Contact Resolution(FCR)
- SLA/OLA(응답·해결 시간 약정), 동적 SLA
- Knowledge-Centered Service(KCS, 지식베이스 순환)
- Ticket Triage(로깅→분류→배정→워크플로→에스컬레이션 5단계)
evidence-they-use:
- 상담 처리시간(MTTR/AHT), 재문의율
- First Contact Resolution율, SLA 준수율(브리치율)
- CSAT / NPS / CES(고객 만족·노력 지표)
- VoC(고객의 소리)·이탈/불만 신호, 티켓 카테고리 분포
sources:
- https://blog.invgate.com/ticket-triage
- https://www.supportbench.com/support-queue-strategy-triage-routing-ownership/
- https://www.featurebase.app/blog/ticket-escalation
OPS-CREW:
working-method:
- '현행 프로세스 매핑: 대상 운영 흐름(파일 처리·이메일 발송·권한/패스워드 처리 등)을 이해관계자와 함께 current-state로 그린다.'
- '낭비·병목 식별: 지연·병목·과잉처리·불필요 이동 등 7대 낭비(DOWNTIME)와 수작업·예외 지점을 표시한다.'
- '표준작업(SOP) 정의: 사람/사이트마다 다른 처리 방식을 표준 SOP로 통일해 훈련·품질 편차를 줄인다.'
- '미래상태 설계·자동화 요구 도출: waste를 제거한 future-state를 설계하고 내부 도구/자동화 개선 요구를 제품·디자인·개발팀에 전달한다.'
- '개선 실행·KPI 모니터링: 변경을 적용하고 cycle/lead time·실수율을 추적하며 kaizen으로 반복 개선한다.'
- '정책-현장 간극 노출: 제품 정책과 실제 운영 사이의 예외/수작업 로그를 근거로 간극을 드러낸다.'
key-frameworks:
- Value Stream Mapping(VSM, current→future state)
- Lean 7 wastes(DOWNTIME), 가치/비가치 활동 구분
- Kaizen(지속 개선), PDCA
- SOP 표준작업(standard work)
- Kanban / Just-in-Time(JIT), Heijunka·Jidoka(린 오피스)
evidence-they-use:
- Cycle time(단계 처리시간), Lead time(총 소요시간)
- 운영 처리시간·실수율(에러율), 재작업률
- 병목 위치·대기 시간, value-stream-map current/future
- 수작업·운영 예외 로그, 자동화율
sources:
- https://www.planview.com/resources/guide/what-is-value-stream-mapping/
- https://en.wikipedia.org/wiki/Value-stream_mapping
- https://www.systems2win.com/solutions/LeanOffice.htm
GTM-GROWTHPM:
role-name: Growth PM / Growth Lead
working-method:
- AARRR(획득-활성화-리텐션-수익-추천) 퍼널을 이벤트/코호트로 계측해 진짜 병목 1개를 특정한다(활성화 약하면 first-value 전달, 리텐션 불안정이면 확산 중단).
- North Star Metric을 사용자 가치×사업 건전성으로 정의하고, 어뷰징 방지용 카운터 지표(리텐션 품질·CAC·지원부담·churn)를 짝지운다.
- 성장 실험을 ICE/RICE(Impact·Confidence·Ease)로 우선순위화하고 Core최적화/Adjacent확장/New가치 3버킷 포트폴리오로 배분한다.
- 아하 모먼트를 실증적으로 정의하고 Time-to-Value(TTV)를 계측해 온보딩을 오직 아하 도달 가속만을 위해 재설계한다.
- 퍼널이 아닌 성장 루프(공유가 사용자 job을 완성하는 구조)를 설계해 PLG 셀프서비스 전환·리텐션을 복리화한다.
- A/B 실험 → 통계적으로 유의한 결과만 채택 → PQL/PLS 이관 트리거(handoff threshold)로 세일즈에 넘긴다.
key-frameworks:
- AARRR(Pirate Metrics, Dave McClure)
- ICE / RICE 실험 우선순위
- North Star Metric + Counter-metrics
- PLG(Product-Led Growth) / PLS(Product-Led Sales) 루프
- Time-to-Value / Aha Moment / Activation
- Growth Loops vs Funnel
evidence-they-use:
- 퍼널 단계별 전환율·드롭오프, 코호트 리텐션 커브
- A/B 실험 결과(유의성·리프트), 실험 로그
- TTV 중앙값, 활성화율, 기능 채택률, PQL 수
- North Star + 카운터 지표 대시보드
sources:
- https://www.aakashg.com/what-are-the-growth-strategies/
- https://www.productled.org/foundations/product-led-growth-metrics
- https://www.parallelhq.com/blog/what-growth-product-manager
- https://umbrex.com/resources/frameworks/strategy-frameworks/aarrr-pirate-metrics-funnel/
GTM-PMM:
role-name: Product Marketing Manager
working-method:
- 'April Dunford 포지셔닝 절차: (1)역사적 디폴트 시장관 버리기 (2)경쟁대안 나열 (3)차별적 속성 식별 (4)속성→고객가치 번역 (5)그 가치를 진짜로 원하는 타겟세그먼트 지정 (6)가치가 자명해지는 시장 카테고리(frame) 선택.'
- 포지셔닝(전략 기반)과 메시징(고객별 커뮤니케이션)을 분리하고, 태그라인+3대 가치제안+핵심 기능 화법으로 메시징 하우스를 문서화한다.
- 타겟 페르소나 정의·차별화 메시징·랜딩/내러티브 검토와 GTM 출시(런치) 플레이북을 지휘한다.
- 셀프서비스 사용자를 엔터프라이즈 챔피언으로 전환시키는 챔피언 활성화 자산과 영업 협상용 배틀카드/세일즈 인에이블먼트를 배포한다.
- Growth PM과 인앱 가치 사전전달 캠페인을 설계하고, 브랜드 톤 학습 기반 생성형 AI로 카피 제작을 가속한다.
key-frameworks:
- April Dunford 5(+1) 포지셔닝 요소(경쟁대안·차별속성·가치·타겟·시장카테고리)
- Positioning vs Messaging vs Copywriting 분리
- Messaging House / Value Proposition
- GTM Launch Tiering, Sales Enablement / Battlecards
- Persona / Segmentation
evidence-they-use:
- 포지셔닝·메시징 문서, 내러티브, GTM one-pager
- MQL→SQL 전환 가치, 메시지 A/B(랜딩 CVR)
- 경쟁 정보(GTM-CI 배틀카드), 출시 일정 준수율
- 세일즈 자료 도달률·채택률 KPI
sources:
- https://www.aprildunford.com/post/a-product-positioning-exercise
- https://www.getproductpeople.com/blog/product-marketing-management-positioning-gtm
- https://wynter.com/post/messaging-builds-gtm-strategy
- https://www.lennyspodcast.com/blog/summary-april-dunford-on-product-positioning-segmentation-and-optimizing-your-sales-process/
GTM-SALES:
role-name: Sales / Founder-led Sales
working-method:
- 'MEDDPICC로 딜을 상시 자격검증: Metrics(정량 가치·ROI) → Economic Buyer(예산 권한자) → Decision Criteria(평가 기준) → Decision Process(승인 단계).'
- Paper Process(계약~서명 행정), Implicate the Pain(고객 문제 인정 확보), Champion(내부 영향력자 육성), Competition(대체재·예산 경쟁) 각 항목의 증거를 단계별로 축적한다.
- '초기: 페인 규명·이코노믹바이어 위치·결정기준 파악 / 중반: 챔피언 육성·결정프로세스 매핑·메트릭 정량화 / 후반: 경쟁·페이퍼프로세스 관리.'
- 타겟 고객사 발굴·정밀조사 → 데모 → 맞춤 제안서 → 다자 구도 조율 → 가격조항·SLA 협상까지 파이프라인을 종결한다.
- RevOps 리드스코어·PLS handoff brief 기반으로 고가치 계약에 화력 집중, AI SDR과 하이브리드로 구매 신호를 부킹 전환하고 인간이 협상 리드.
key-frameworks:
- MEDDIC / MEDDPICC(Metrics·Economic Buyer·Decision Criteria·Decision Process·Paper Process·Implicate Pain·Champion·Competition)
- Champion 육성 / Multi-threading
- Value Selling / ROI 정량화
- PLS(Product-Led Sales) handoff
evidence-they-use:
- ARR·평균 거래규모·윈레이트, 세일즈 사이클 길이
- MEDDPICC 자격검증 스코어(챔피언·이코노믹바이어 확인)
- 구매 intent 신호, RevOps 리드스코어·PLS handoff brief
- 가격 거버넌스(GTM-PRICING)·계약 검토(GTM-LEGAL) 연계
sources:
- https://meddicc.com/meddpicc-sales-methodology-and-process
- https://meddic.academy/meddic-sales-methodology-checklist/
- https://www.forcemanagement.com/blog/meddic-vs.-meddpic-the-meaning-difference-and-benefits-of-each-for-sales-qualification-force-management
- https://www.atlassian.com/blog/project-management/meddic-sales-methodology
GTM-CS:
role-name: Customer Success
working-method:
- Onboard-Adopt-Value-Expand 운영모델로 라이프사이클을 관리하고 각 단계에 측정 가능한 entry/exit 게이트를 둔다.
- 'Onboard: 프로비저닝·데이터연동·첫 유스케이스·챔피언 교육으로 TTV 단축(exit=첫 성공 완료). Adopt: 사용 breadth×depth 확대(exit=사용 임계치·성공플랜 문서화).'
- 복합 헬스스코어(사용신호 45% + 지원 20% + 관계 20% + 상업위험 15%)를 계정 세그먼트별로 산출하고 렌더링.
- 'churn 트리거 자동화: 사용량 2주 30%↓·온보딩 마일스톤 미달·핵심 담당자 이탈·부정 지원 감정·결제 위험 시 플레이북 가동(ChurnScore 90일 전 조기대응).'
- Value 단계 QBR로 기저치 대비 정량 가치·ROI·후원자 정렬을 확인하고, Expand로 좌석/모듈/멀티년 갱신을 성과 근거로 확장한다.
- NRR/GRR을 코호트·세그먼트별로 추적해 CS 개입을 경제성과 연결하고, 인센티브를 활동수가 아닌 지속 성과에 정렬한다.
key-frameworks:
- OnboardAdoptValueExpand 운영모델
- Customer Health Score(가중 복합지표)
- NRR / GRR(순·총 매출유지율)
- QBR(Quarterly Business Review)
- ChurnScore / Churn 예측 트리거, Success Plan / RACI
evidence-they-use:
- NRR·GRR·churn·확장 ARR, CSAT/NPS
- ChurnScore(제품 행동·티켓·과금 신호), 헬스스코어 vs 실제 갱신 예측력
- TTV·day-90 채택률, 제품 텔레메트리·지원 티켓 로그
- 확장 행동 트리거, cost-to-serve by tier
sources:
- https://umbrex.com/resources/frameworks/marketing-frameworks/customer-success-operating-model-onboard-adopt-value-expand/
- https://www.gainsight.com/blog/customer-health-scores/
- https://www.gainsight.com/blog/customer-success-metrics-what-to-track-in-2026/
- https://www.gainsight.com/essential-guide/customer-success/
GTM-PRICING:
role-name: Pricing Strategist
working-method:
- '가치기반 가격(VBP): 차선책(next-best alternative) 대비 경제적 가치를 정량화해 가격 앵커를 잡는다.'
- Van Westendorp Price Sensitivity Meter 4문항(너무 비쌈/비싸지만 고려/저렴한 가치/너무 싸서 의심)으로 수용 가격대(PMC~PME)와 최적가(OPP)를 도출한다(세그먼트·연/월 과금별 분리, 세그먼트당 100+ 응답).
- Good-Better-Best 패키징에서 PSM으로 tier 간 가격 갭·가드레일을 설정하고, 무료/유료 기능·사용 한도 경계와 정가표(Rate Card)를 설계한다.
- '가치 단위(Value Metric: 호출량/크레딧/완료건수) 기준 정밀 과금 모델링과 가격 탄력성·코호트·경쟁 프로모션 시뮬레이션으로 NRR·마진 영향을 분석한다.'
- 기업 번들·다량 특약 할인 가이드라인과 가격 승인(Pricing Governance) 프로세스를 정비하고, PM·CFO 컨트롤러·세일즈 리더와 요금 거버넌스 회의를 주재(결정권 보유)한다.
key-frameworks:
- Value-Based Pricing(VBP)
- Van Westendorp PSM(OPP·PMC·PME·IPP)
- Good-Better-Best 패키징 / Value Metric(가치 단위)
- Price Elasticity / 코호트 시뮬레이션
- Pricing Governance(가격 승인 프로세스)
evidence-they-use:
- ARPU·거래 마진률, NRR 영향
- PSM 수용가격대·OPP, WTP(지불의사) 조사(과대추정 보정 주의)
- 가격 시뮬레이션(수요·경쟁 프로모션), 권한 외 특약 승인 위반율
- CFO 재무모델 정합, 가치 단위 과금 근거
sources:
- https://www.getmonetizely.com/articles/the-fundamentals-of-van-westendorp-price-sensitivity-for-saas-businesses
- https://www.productleadership.com/blog/saas-packaging-and-pricing/
- https://softwarepricing.com/blog/value-based-pricing-strategy/
- https://umbrex.com/resources/frameworks/marketing-frameworks/van-westendorp-price-sensitivity-meter/
GTM-REVOPS:
role-name: Revenue Operations
working-method:
- People·Process·Data·Technology 4기둥으로 마케팅-영업-CS를 단일 운영모델로 정렬한다(차터 작성·공유 KPI 정의).
- Lead-to-Cash 라이프사이클(Engage 파이프라인생성 → Execute 전환·예측 → Expand 리텐션·업셀)을 표준화하고 핸드오프·SLA·예측 케이던스를 규정한다.
- CRM을 단일 진실 원천(SSOT)으로 구축하고 데이터 위생을 강제하며, 리드 라우팅·자격검증·스케줄링을 자동화한다.
- 주간 파이프라인 예측(Forecasting)을 운영하고 파이프라인 속도(딜수×윈레이트×평균딜/사이클길이)를 선행지표로 관리한다.
- 마케팅-영업 SLA 준수를 트래킹하고, 임원진에 다차원 성과 리포트·예산 배치 결정을 지원한다(AI 매출 인텔리전스로 예측편차 축소).
key-frameworks:
- RevOps 4 Pillars(People·Process·Data·Technology)
- Lead-to-Cash(Engage-Execute-Expand)
- SSOT(Single Source of Truth) / CRM Hygiene
- Forecasting Cadence, Pipeline Velocity
- Marketing-Sales SLA, LTV:CAC(목표 3:1+)
evidence-they-use:
- 파이프라인 예측 정확도(best-in-class 80s~low90s%), 예측 오차
- 파이프라인 속도, 전환율(visitor→lead→opp→win), 세일즈 사이클
- CAC(마케팅+영업/신규고객), LTV:CAC, NRR
- SSOT(CRM) 데이터, SLA 준수 지표, executive-packet
sources:
- https://www.default.com/post/revops-framework
- https://ivristech.com/revops-best-practices/
- https://www.gartner.com/en/sales/topics/revenue-operations
- https://salesmotion.io/blog/revops-best-practices
GTM-LEGAL:
role-name: Legal / Compliance
working-method:
- '계약 스택 검토: MSA(상시 우산 조항)+Order Form(가격·좌석·기간)+DPA(GDPR/CCPA)+SLA+Security Exhibit의 정합성과 상호 참조를 확인한다.'
- 'DPA 컴플라이언스 실사: GDPR Art.28 필수요소(처리 목적·기간·데이터 유형, 기밀·보안조치, 72시간 침해통지, 서브프로세서 통지/이의권, 종료 시 삭제/반환, 감사권)와 CCPA/CPRA(목적 제한·판매 금지) 확인. EEA 외 이전 시 SCC 포함.'
- '리스크 배분 검토: 책임한도(통상 직전 12개월 요금)·결과적 손해 배제, IP침해·중과실·기밀위반 등 무한책임 예외, 상호 면책 절차(통지 기한·방어 통제)를 계약가치 대비 매핑한다.'
- '엔터프라이즈 조달 레드라인 협상: 책임한도·SLA 크레딧·해지 조항·서브프로세서 이의권을 계약가치 밴드별 tiered concession으로 조율(속도 죽이지 않되 패소·브랜드 실추 차단).'
- 규제 시장(핀테크 DORA/MiCA·헬스케어 HIPAA) 정렬과 AI 학습 한도 리스크를 모니터링하고, 법률 전용 AI로 초안 실사·조항별 lineage 검증을 자동화(감사 역할).
key-frameworks:
- MSA / Order Form / SOW 계약 계층
- DPA(GDPR Art.28, CCPA/CPRA) + SCC
- SLA(가용성·서비스 크레딧=sole remedy)
- Liability Cap / Indemnification / 결과적손해 배제
- Security Exhibit(SOC2 Type II·ISO27001), 서브프로세서 관리
- Redlining / Tiered Concession
evidence-they-use:
- 계약 검토 시간·법무 분쟁 발생율·규제 패스율
- MSA/NDA·약관·DPA, 서브프로세서 목록, 보안 인증(SOC2/ISO)
- 컴플라이언스 실사(GDPR/CCPA/HIPAA), 감사(auditor) 판정
- redaction 필요 여부(evidence-ledger), security-architecture 연계
sources:
- https://promise.legal/startup-legal-guide/contracts/saas-agreements
- https://secureprivacy.ai/blog/data-processing-agreements-dpas-for-saas
- https://toslawyer.com/legal-checklist-for-u-s-saas-startups-tos-privacy-dpa-sla-and-more/
- https://www.fullcast.com/content/gdpr-ccpa-cpra-compliance/
GTM-CI:
role-name: Competitive Intelligence
working-method:
- '경쟁사 시그널 상시 수집: 웹사이트/가격 변경/릴리즈 노트/채용/광고를 수백 소스로 모니터링하고 현장 세일즈 인텔(Slack/이메일)을 정형화한다.'
- Win/Loss 인터뷰를 전담해 바이어·셀러 양측에서 왜 이기고 지는지 객관 피드백을 수집한다(포지셔닝·가격 실패 케이스 포함).
- '배틀카드 구성: 경쟁사별 윈레이트 + 최근 승리 주석(먹힌 포지셔닝/가격전술) + 패배 케이스 + 반론(objection handling)을 CRM(Salesforce) 데이터와 결합.'
- 배틀카드를 정적 PDF가 아닌 동적 문서로 최소 월 1회 갱신하고 세일즈·PMM·제품·임원에게 배포한다.
- 제품팀엔 로드맵 영감, PMM엔 차별화 포지셔닝 보정을 배포하고, AI 답변엔진 내 자사 인지도(AI Search Intelligence) 인용 빈도를 제어한다.
key-frameworks:
- Battlecards(경쟁 enablement)
- Win/Loss Analysis
- Competitive Win-Rate 세분화(경쟁사·산업·딜규모)
- Objection Handling / Trap-setting
- AI Search Intelligence(AEO 브랜드 인용 제어)
evidence-they-use:
- 경쟁사별 윈레이트, 신규 경쟁위협 감지 리드타임
- Win/Loss 인터뷰 로그, CRM 딜 메타데이터
- 외부 웹 근거(evidence-ledger reliability-grade)
- AI 엔진 인용/추천 빈도
sources:
- https://klue.com/blog/competitive-battlecard-win-rate
- https://klue.com/win-loss
- https://www.kompyte.com/blog/top-competitive-intelligence-tools
- https://www.outreach.ai/resources/blog/win-loss-analysis
GTM-DEMANDGEN:
role-name: Demand Generation
working-method:
- ICP를 firmographic(산업·매출·규모)·technographic(스택)·intent(리서치 행동)로 정의하고 최우량 고객 패턴(최고 LTV·최단 클로징·최다 확장)에서 역산한다.
- fit×intent 스코어링으로 타겟 계정을 Tier1(5~20, 풀커스텀)/Tier2(20~200, 반커스텀)/Tier3(200+, 프로그래매틱)으로 계층화한다.
- 'ABM 오케스트레이션: LinkedIn/디스플레이 광고 + 역할별 이메일 시퀀스 + 임원 이벤트를 동일 타이밍으로 멀티채널 조율하고 바잉커미티(14+ 이해관계자)를 매핑한다.'
- SEO/AEO 콘텐츠·커뮤니티·아웃바운드 시퀀스로 유입을 만들고 세일즈와 SLA(누가 언제 액션)로 리드 이관을 계약한다.
- '허무지표(노출) 대신 계정단위 기여로 성과 측정: 타겟계정 소싱/영향 파이프라인, 타겟 vs 비타겟 윈레이트, 프로그램 소싱 ACV, ROAS.'
- 자율형 마케팅 워크플로우로 프로세스 대부분을 자동화하고, 인간은 브랜딩·메시지 정합에 집중한다.
key-frameworks:
- ABM(Account-Based Marketing) / ABX
- ICP(Ideal Customer Profile) 정의
- Intent Data + Fit Scoring
- Account Tiering(1:1 / 1:few / 1:many)
- Multi-touch Attribution / Pipeline Marketing
- SEO/AEO(Answer Engine Optimization)
evidence-they-use:
- 신규 창출/영향 파이프라인 규모, 마케팅 소싱 매출
- 계정 engagement 스코어, intent 신호, 콘텐츠 소비
- ROAS(광고비 회수), 타겟 계정 윈레이트 리프트, 검색 점유율
- 세일즈 SLA 준수·리드 이관 리드타임
sources:
- https://pipeline.zoominfo.com/marketing/abm-strategy-playbook-guide
- https://twelverays.agency/blog/demand-generation-best-practices
- https://abmatic.ai/blog/what-is-demand-generation-vs-abm
- https://mountain.com/blog/account-based-marketing-vs-demand-generation/
GTM-PARTNER:
role-name: Partnership / Channel
working-method:
- 간접 세일즈 파트너(대행사·SI·마켓플레이스·제휴)를 모집·프로파일링하고 tier 구조·혜택·인센티브·거버넌스를 담은 파트너 프로그램(계약)으로 정형화한다.
- 파트너 온보딩·인에이블먼트(교육·자산)로 파트너의 영업 동기를 형성하고, 본사 영업이 못 닿는 틈새/외곽을 커버한다.
- Deal Registration(딜 등록) 프로세스로 파트너 투자·기회를 보호하고 딜 배분·중복 방지 규칙을 운영한다.
- '글로벌 클라우드 마켓플레이스(AWS/Salesforce/Azure/GCP) 채널로 co-sell을 구동: co-sell eligible 딜은 클라우드 필드세일즈가 재무 인센티브로 지원하게 만든다.'
- 레비뉴셰어(고정 도매가+파트너 마진 등) 모델을 설계하고, PMM과 공동 프로모션을 패키징하며 RevOps에 파트너 유입 데이터를 SSOT로 귀속한다.
key-frameworks:
- Partner Program(tier·benefit·incentive·governance)
- Deal Registration / Deal Protection
- Co-Sell(클라우드 마켓플레이스, co-sell eligibility)
- PRM(Partner Relationship Management)
- Revenue-Share / Wholesale+Margin 모델
evidence-they-use:
- 파트너 기여/영향 매출(ARR), 제휴 딜 진행율, 신규 온보딩 파트너 수
- 딜 등록/정산 데이터(PRM), 기여 추적·attribution
- co-sell eligible 딜 수, 파트너 활성화율
- RevOps SSOT 귀속 데이터, 공동 마케팅 자산 성과
sources:
- https://www.zinfi.com/glossary/what-is-channel-partner-management/
- https://aws.amazon.com/marketplace/partners/channel-programs
- https://www.salesforce.com/sales/partner-relationship-management/
- https://www.introw.io/blog/top-deal-registration-software
CONSULT-EM:
working-method:
- 프로젝트 1주차에 질문을 issue tree(hypothesis tree)로 MECE하게 분해하고 동시에 Day-1 가설을 세운다.
- 이슈를 임팩트×실현가능성 우선순위 매트릭스에 매핑해 고임팩트 가지부터 팀을 투입한다.
- workplan을 3계층(최종 산출물 → 중간 마일스톤 → 일/주간 팀 산출물)으로 쪼개 배분한다.
- 가설 검증형 분석을 돌리고 클라이언트 인터뷰·데이터로 가설을 반증/보강하며 우선순위를 재조정한다.
- Pyramid Principle로 분석을 지배 메시지(governing thought) 아래 종합하고 dot-dash storyline으로 슬라이드 이전에 논리를 검증한다.
- 분과 컨설턴트 보고서를 전부 읽어(rehydration) 액션타이틀·one-message-per-slide로 스토리라인을 확정하고 conflicts를 보존한다.
key-frameworks:
- Hypothesis-driven approach (Day-1 Answer)
- Issue Tree / Hypothesis Tree
- MECE (Mutually Exclusive, Collectively Exhaustive)
- Pyramid Principle (Barbara Minto)
- SCQA (Situation-Complication-Question-Answer)
- Impact×Feasibility 우선순위 매트릭스
evidence-they-use:
- 클라이언트 내부 데이터(재무·운영 지표), 스테이크홀더/전문가 인터뷰
- 산업·시장 데이터 및 벤치마크
- 가설 검증용 분석 모델(엑셀 driver 모델)
- 분과 컨설턴트 .report.yaml 원본(종합 입력)
sources:
- https://umbrex.com/resources/mckinsey-problem-solving/
- https://strategyu.co/problem-solving-101/
- https://managementconsulted.com/pyramid-principle/
- https://www.roadtooffer.com/blog/what-does-an-engagement-manager-at-mckinsey-do
CONSULT-STRAT:
working-method:
- 전략 질문을 MECE 이슈트리로 분해하고 answer-first(가설 우선)로 검증 대상을 좁힌다.
- Porter's Five Forces로 산업 매력도·수익성 압력(신규진입·대체재·공급자/구매자 교섭력·경쟁강도)을 진단한다.
- value chain 분석으로 자사 강점 구간과 이익 풀(profit pool)의 위치를 식별한다.
- BCG Growth-Share Matrix로 포트폴리오를 star/cash cow/question mark/dog으로 분류해 투자를 배분한다.
- Ansoff Matrix로 성장 경로별 리스크 프로파일을 비교하고 프레임워크를 결합한다.
- Three Horizons로 H1(핵심 강화)·H2(인접 확장)·H3(미래 옵션)에 이니셔티브를 배치해 로드맵화한다.
key-frameworks:
- Porter's Five Forces
- Value Chain
- BCG Growth-Share Matrix
- Ansoff Matrix
- McKinsey Three Horizons
- McKinsey 7-S
evidence-they-use:
- 시장 규모·성장률·점유율 데이터
- 산업/규제 동향 및 경쟁사 벤치마크
- 클라이언트 재무·수익성 데이터
- 고객·전문가 인터뷰
sources:
- https://strategyu.co/consulting-frameworks/
- https://en.wikipedia.org/wiki/Porter%27s_five_forces_analysis
- https://umbrex.com/resources/frameworks/marketing-frameworks/three-horizons-of-growth-mckinsey/
- https://umbrex.com/resources/frameworks/strategy-frameworks/mece-principle/
CONSULT-OPS:
working-method:
- 워크플로를 매핑(value stream mapping)해 지연·중복·불필요 단계·자원 병목을 가시화한다.
- 원가를 MECE로 재구성(직접비/간접비/오버헤드)해 원가 베이스라인과 절감 기회를 도출한다.
- driver tree로 원가·성과를 하위 동인으로 분해하고 개선 레버의 임팩트를 정량화한다.
- DMAIC(Define-Measure-Analyze-Improve-Control)로 근본원인을 데이터 기반으로 규명·제거한다.
- 벤치마킹(SCOR 등)으로 best practice·KPI 대비 격차를 측정하고 목표 수준을 설정한다.
- TOM(현재→목표 운영모델)을 설계하고 재무 모델로 투자·효과를 정량화한 뒤 실행·변화관리로 이행한다.
key-frameworks:
- Lean (Toyota Production System)
- Six Sigma / DMAIC
- Value Stream Mapping
- Target Operating Model (TOM)
- Driver Tree / Cost Baseline
- SCOR (Supply Chain benchmarking)
evidence-they-use:
- 프로세스 사이클타임·수율·불량률 등 운영 데이터
- 원가 베이스라인·재무 모델
- 산업 벤치마크·KPI
- 현장 프로세스 관찰 및 현업 인터뷰
sources:
- https://www.bain.com/consulting-services/operations/lean-six-sigma/
- https://www.deloitte.com/lu/en/services/consulting/services/target-operating-model.html
- https://www.6sigma.us/lean-six-sigma-articles/lean-six-sigma-operations-management/
- https://burniegroup.com/capabilities/target-operating-model-design/
CONSULT-ORG:
working-method:
- 현행 operating model을 다요소(purpose·structure·governance·processes·technology·behaviors·rewards·talent)로 진단하고 전략과의 정합 gap을 매핑한다.
- spans & layers 분석 + 외부 벤치마크(지식노동 span 6~8, 운영직 15~25)로 계층 과잉·병목을 정량화한다.
- activity analysis로 실제 업무 시간 배분을 잡아 중복·저부가 활동을 걷어내고 역할을 재설계한다.
- 이해관계자 맵·change impact assessment로 저항 요인을 식별하고 ADKAR로 개인 전환 상태를 단계 관리한다.
- guiding coalition을 세우고 quick win을 설계·가시화해 모멘텀을 만든 뒤 새 프로세스/보상/거버넌스로 행동을 hard-wire한다(Kotter).
- RACI/decision rights·KPI·거버넌스 케이던스를 delivery에 심어 설계가 운영으로 넘어가게 handoff한다.
key-frameworks:
- McKinsey 7S
- Target Operating Model (TOM)
- Prosci ADKAR (+3-Phase, PCT)
- Kotter 8-Step
- Galbraith Star Model
- Spans & Layers / RACI (RAPID)
evidence-they-use:
- 조직도·HR 데이터(headcount, spans/layers, 인건비), 활동·시간 배분
- 이해관계자 인터뷰·설문, change readiness/채택률 pulse
- 외부 벤치마크(산업별 span·layer·조직비용 norm), 문화·engagement 진단
- 전략 문서·value agenda(전략 목표 대비 조직 선택의 정합)
sources:
- https://www.kotterinc.com/methodology/8-steps/
- https://www.prosci.com/methodology/adkar
- https://www.mckinsey.com/featured-insights/mckinsey-explainers/what-is-an-operating-model
- https://umbrex.com/resources/frameworks/strategy-frameworks/span-of-control-layering-analysis/
CONSULT-DIGITAL:
working-method:
- digital maturity assessment(BCG 41-dimension 벤치마크, McKinsey DQ)로 현재 상태를 peer·리더 대비 점수화한다.
- 기술 인프라 audit + skill gap 분석으로 as-is를 진단하고 4개 도메인(Business·Data·Application·Technology)으로 to-be를 설계한다(TOGAF ADM).
- use case를 value·feasibility·strategic fit로 스코어링해 우선순위 백로그를 만들고 각 use case에 value at stake를 정량화한다.
- 로드맵을 12/24/36개월 multi-horizon으로 짜되 초기엔 6~9개월 짧은 사이클로 평가·학습·course correction을 반복한다.
- 플랫폼 코어 결정(cloud, data 패턴 lake/mesh/lakehouse, 통합 API-first/event-driven, build vs SaaS/COTS)을 내리고 Agile·DevOps로 build·migrate·integrate한다.
- 비즈니스 KPI에 로드맵을 묶고 governance·데이터 품질·adoption을 지속 측정해 규모화(scale)한다.
key-frameworks:
- Digital Maturity Model (BCG DAI / McKinsey DQ)
- TOGAF ADM (Enterprise Architecture)
- Technology Roadmap (multi-horizon)
- Use-Case Prioritization (value·feasibility·fit)
- Cloud/Data Architecture Patterns (lake·mesh·lakehouse)
- Agile/SAFe & DevOps
evidence-they-use:
- 디지털 성숙도 벤치마크 점수·peer 비교, 아키텍처/인프라 audit
- use case별 value-at-stake·비용/편익, 데이터 품질·거버넌스 진단
- 기술 스택·의존성 매핑, 벤더/플랫폼 평가, adoption·성능 KPI
- 비즈니스 전략·P&L 목표(기술 이니셔티브의 비즈니스 결과 연결)
sources:
- https://www.bcg.com/capabilities/digital-technology-data/digital-maturity
- https://www.mckinsey.com/capabilities/quantumblack/how-we-help-clients
- https://www.cio.com/article/228328/what-is-togaf-an-enterprise-architecture-methodology-for-business.html
- https://www.opengroup.org/togaf
CONSULT-FIN:
working-method:
- 과거 3~5년 손익·재무상태·현금흐름을 정규화(normalize)해 일회성·회계성 이익을 걷어내고 지속가능 EBITDA를 산출한다(Quality of Earnings).
- 운전자본 사이클·계절성을 분석해 closing용 working capital target을 산정하고 net debt·우발채무·세무 노출을 식별한다.
- driver-based 3-statement 모델을 세우고 DCF(WACC·terminal value)와 trading/transaction comparables로 valuation을 삼각 검증한다.
- 핵심 driver에 sensitivity·scenario 분석을 걸고 불확실성 큰 변수는 Monte Carlo로 분포·downside를 정량화한다.
- 모델 무결성 리뷰(로직·수식·순환참조·감사추적)로 산출물 신뢰도를 독립 검증한다.
- 식별된 리스크를 Three Lines of Defense로 배치하고 완화책·통제·거버넌스 케이던스를 권고한다.
key-frameworks:
- DCF / WACC valuation
- Comparable Company & Precedent Transaction Analysis
- Quality of Earnings (normalized EBITDA)
- Driver Tree / 3-Statement Model
- Sensitivity·Scenario & Monte Carlo Simulation
- Three Lines of Defense (+ERM)
evidence-they-use:
- 감사 재무제표·management accounts(3~5년), 원장·거래 상세, 세무 신고
- 시장 데이터(comparable 배수·금리·WACC 입력), 산업 벤치마크
- 매니지먼트 인터뷰·사업계획·계약, data room 문서
- 규제·회계 기준(IFRS/GAAP), 리스크 레지스터·통제 테스트 결과
sources:
- https://www.deloitte.com/global/en/services/consulting/services/valuation-modeling.html
- https://www.kroll.com/en/services/transaction-advisory-services/financial-due-diligence
- https://www.theiia.org/en/content/position-papers/2020/the-iias-three-lines-model-an-update-of-the-three-lines-of-defense/
- https://www.intralinks.com/guides/financial-due-diligence-ma
DOC-LEAD:
working-method:
- audience & purpose 선언을 문서 최상단 계약으로 먼저 고정한다(누가·무엇을 하려고 읽는가).
- outline-first — 문장 쓰기 전에 목차·섹션별 핵심 메시지(one message per section)를 먼저 합의한다.
- 기여자 초안을 Pyramid Principle(SCQA + 결론 먼저)로 재배열해 단일 논증 피라미드로 종합한다.
- Diátaxis 4유형(튜토리얼/how-to/reference/explanation)으로 섹션을 분류해 목적이 섞인 문서를 분리한다.
- 공통 doc-type 템플릿·style guide로 기여자 편차를 흡수하고 editorial calendar로 리뷰 사이클을 운영한다.
- 릴리스 전 structural edit → copy edit 2단 검수로 논리 공백·중복·톤 불일치를 제거한다.
key-frameworks:
- Diátaxis (tutorial/how-to/reference/explanation)
- Pyramid Principle (Minto, SCQA)
- docs-as-code review workflow
- topic-based authoring / 템플릿 표준화
- Google/Microsoft/Write the Docs style guides
- editorial calendar + DRAI 게이트
evidence-they-use:
- 독자/오디언스 리서치·페르소나
- 문서 유형 taxonomy(Diátaxis 매핑), style guide·용어집
- 사용/검색 analytics·지원 티켓
- 기여자 초안·SME 리뷰 코멘트
sources:
- https://diataxis.fr/start-here/
- https://www.barbaraminto.com/
- https://developers.google.com/tech-writing
- https://www.writethedocs.org/guide/docs-as-code/
DOC-WRITER:
working-method:
- audience·scope 문장을 페이지 상단에 먼저 명시하고 그 독자의 사전지식에 맞춰 서술 수준을 조정한다.
- Diátaxis 분류 먼저 — 튜토리얼/how-to/reference/explanation을 섞지 않고 한 페이지=한 목적.
- one-idea-per-section / lead sentence first — 단락 첫 문장에 핵심, 절차는 numbered list·표로.
- active voice·short sentence·용어 일관성(Google/Microsoft style)으로 초안을 self-edit한다.
- docs-as-code — Markdown+Git+정적 사이트, PR 리뷰·CI 린트·미리보기로 개발자와 공동 소유.
- 초안을 실제로 따라 해보며(dogfooding) 재현성·모호한 대명사·idiom을 제거한다.
key-frameworks:
- Diátaxis
- docs-as-code (Git/Markdown/static site + CI)
- Google Technical Writing (Tech Writing One/Two)
- Microsoft Writing Style Guide
- Write the Docs 관행
- topic-based authoring
evidence-they-use:
- style guide·용어집, doc-type taxonomy
- 독자 피드백·지원 티켓
- 재현 테스트 결과(코드·절차 실행)
- readability·PR 리뷰 코멘트
sources:
- https://developers.google.com/tech-writing/one
- https://learn.microsoft.com/en-us/style-guide/welcome/
- https://www.writethedocs.org/guide/docs-as-code/
- https://diataxis.fr/
DOC-IA:
working-method:
- content inventory & audit로 현재 토픽·중복·공백을 지도화하고 gap을 식별한다.
- card sorting / tree testing으로 독자 멘탈모델에 맞는 그룹핑·라벨을 검증한다(findability test).
- 정보 위계(general→specific)를 설계한 뒤 progressive disclosure로 계층별 노출 순서를 정한다.
- Every Page Is Page One / topic-based authoring — 어느 페이지에 도착해도 자기완결적이도록 컨텍스트·앵커·상호링크 배치.
- Minimalism(Carroll) — 학습·행동에 불필요한 서술을 걷어내고 목표 달성 경로만 남긴다.
- analytics·검색 로그·findability 지표로 경로 이탈·죽은 검색어를 추적해 IA를 반복 개선한다.
key-frameworks:
- Information Architecture (Rosenfeld/Morville/Arango — organization·labeling·navigation·search)
- Progressive Disclosure (Nielsen/NN/g)
- Minimalism (Carroll)
- Every Page Is Page One / topic-based authoring
- Diátaxis (목적별 정보 공간 분할)
- Card sorting / Tree testing
evidence-they-use:
- 검색·내비게이션 analytics·검색 로그
- card sort/tree test 결과(findability)
- content inventory·audit, 독자 멘탈모델
- 정보 위계 taxonomy
sources:
- https://www.nngroup.com/videos/progressive-disclosure/
- https://en.wikipedia.org/wiki/Minimalism_(technical_communication)
- https://everypageispageone.com/2013/07/02/what-is-minimalism/
- https://www.nngroup.com/articles/information-architecture-study-guide/
DOC-VISUAL:
working-method:
- 'abstraction-first — 그리기 도구보다 추상화 계층(C4 레벨)·독자·전달 메시지를 먼저 정한다. 도구 선택은 마지막이다.'
- C4 레벨을 독자에 매핑한다 — System Context(L1)=시스템+외부관계, Container(L2)=배포단위+기술스택(가장 범용), Component(L3)=내부(복잡할 때만), Code(L4)=자동생성·손유지 금지(즉시 stale).
- '"one diagram, one message"로 요소를 쳐내고 각 그림에 스코프 한 줄 제목·범례·일관된 방향·예약색을 붙인다.'
- '엔진 우선순위: 소프트웨어 아키텍처·의존성·중첩 컨테이너는 D2(레이아웃엔진 dagre/elk·테마·CI 친화, 1급). 설명·워크숍 발산은 Excalidraw(손그림). Mermaid는 최후 폴백만 — 실무급 시각자료가 아니다.'
- 'D2 관용구를 쓴다 — 중첩 컨테이너로 계층/경계를 표현, 큰 그래프는 layout=elk, 방향은 direction으로 고정, 테마로 색을 통일. render_consult가 {type: d2}를 d2 CLI로 실물 SVG 렌더한다.'
- drift 방지 — 코드 변경과 같은 PR에서 다이어그램을 갱신해 CI에서 렌더링·diff·리뷰가 되게 한다. 확정·유지 대상은 diagram-as-code, hand-drawn은 발산·워크숍에만.
key-frameworks:
- C4 model (System Context / Container / Component / Code — Simon Brown)
- 'diagram-as-code 엔진 우선순위: D2(1급) → Excalidraw(설명·손그림) → Mermaid(폴백)'
- D2 (레이아웃엔진 dagre/elk · 중첩 컨테이너 · 테마 · sketch)
- Structurizr DSL (model-first, multi-view)
- UML (sequence·class 표기)
- 'notation over ambiguity (범례·방향·예약색) · one diagram, one message'
evidence-they-use:
- 독자 프로파일·다이어그램 목적/전달 메시지
- 실제 배포 토폴로지·컨테이너 경계·컴포넌트 인터페이스(소스)
- 엔진별 렌더링·레이아웃·버전관리 적합성(D2 우선)
- drift 신호(코드-그림 불일치·stale)
sources:
- https://c4model.com/
- https://structurizr.com/
- https://d2lang.com/
- https://plantuml.com/
DOC-EDU:
working-method:
- 인지부하를 관리한다 — 시각적 잡음·불필요한 링크·장식을 제거(extraneous load 제거)하고 기본값·이전 입력 재표시로 기억 부담을 시스템에 offload한다.
- worked example을 앞단에 배치한다(worked-example effect) — 단, expertise-reversal effect 때문에 숙련자 경로는 예제 대신 직접 연습으로 전환한다.
- Diátaxis로 문서 유형을 분리한다 — 초심자 진입점은 항상 Tutorial(따라 완주), 그다음 How-to·Reference·Explanation.
- curse of knowledge를 깬다 — 깨끗한 환경에서 처음부터 실행되는 단계를 쓰고 내부자 약어·암묵 가정을 제거, 첫 사용자로 검증(Feynman technique).
- Bloom's taxonomy로 목표를 계층화 — 기억·이해(개념)→적용(예제)→분석·창조(응용)로 난이도·실습을 배치한다.
- crisp example·강한 다이어그램·라이브 데모를 조합하고 "추가 설명 없이 task 완료·지원문의 감소"를 성과로 삼는다.
key-frameworks:
- Cognitive Load Theory (intrinsic vs extraneous)
- Worked Examples effect (+ expertise-reversal effect)
- Bloom's taxonomy
- Curse of knowledge
- Diátaxis (Tutorial 진입점)
- Feynman technique
evidence-they-use:
- 학습자 행동(막히는 지점·튜토리얼 완주율·이탈)
- 지원 문의·이슈·포럼 질문(반복 질문=콘텐츠 구멍)
- 깨끗한 환경 재현 테스트
- audience 세그먼트별 사전지식(초심자 vs 숙련자)
sources:
- https://www.nngroup.com/articles/minimize-cognitive-load/
- https://diataxis.fr/
- https://dl.acm.org/doi/full/10.1145/3483843
- https://theeducationhub.org.nz/using-cognitive-load-theory-to-inform-teaching-and-learning/