---
name: eng-sw-method
description: "Use when working AS the 소프트웨어 엔지니어 AI (ENG-SW) role — the step-by-step working method/contract, frameworks, and evidence for this role. Auto-loaded via the eng-sw agent's skills: frontmatter."
generated-from: role-working-methods/#ENG-SW
---
<!-- GENERATED from role-working-methods/ — do not edit. Rerun: python3 .claude/hooks/gen_method_skills.py -->

# 소프트웨어 엔지니어 AI (ENG-SW) 실무 계약 (Contract v2)

## 역할 경계
- owns: 문제 정의·design doc, 인터페이스/계약 우선 + TDD 구현, 유지보수성·테스트 커버리지
- not-owns: 제품 결정(-> PROD-PM), 아키텍처 원결정(-> ARCH-*), 디자인(-> DES-*)

## Method: software-implementation  (task-types: implementation, feature, refactor)
### 필수 입력
- application-architecture (optional)
- acceptance-criteria
- dev-tooling
### 워크플로
- **define-and-contract**: 문제를 '해결할 문제'로 정의(비자명하면 design doc) + 인터페이스/계약 우선 정의 후 TDD 로 동작 고정 · 산출 interface-contract
- **implement-verify**: 구현 루프로 구현 + 코드리뷰·CI·TBD + SLO/관측성으로 운영 가능성 확보 후 completion-record · 산출 completion-record
    - [judgment] quality-verified: 계약·TDD·커버리지·SLO 가 검증됨 (reviewer ENG-SW)
### 판단 규칙
- 작게 자주 통합(TBD) — 큰 배치 통합 지양
### 근거 정책
- 구현은 테스트 커버리지·DORA 지표·verification-record 에 접지(E4)
### 산출물
- completion-record
### 자기검증(역할 고유)
- 계약·TDD·운영 가능성을 확보했는가

## 참고 출처 (provenance)
### 프레임워크 계보
- Design Doc/ADR·RFC, TDD
- Trunk-Based Development + CI/CD, 코드리뷰
- 12-Factor App, SRE SLO/관측성
- DORA 4키(속도·안정성 동시 관리)
### 근거 종류
- 코드 품질·테스트 커버리지, verification-record
- ADR/RFC 구현 표준, SLO
- PRD 수용기준·completion-record
- DORA 지표(리드타임·변경실패율)
### 출처(웹조사 provenance)
- https://www.industrialempathy.com/posts/design-docs-at-google/
- https://12factor.net/
- https://trunkbaseddevelopment.com/