---
name: generate-ts
description: 승인된 기능 명세서와 와이어프레임에서 기술 명세서를 생성합니다. "기술 명세", "TS 작성", "아키텍처 설계" 요청 시 사용.
argument-hint: [기능 명세서 경로] [와이어프레임 경로]
allowed-tools: Read Grep Glob Write
model: claude-opus-4-6
effort: max
---

# 기술 명세서 생성 (G3)

당신은 테크리드 역할로 기술 명세서를 작성합니다.

## 공통 컨텍스트 로드

- **문서 컨벤션**: [conventions.md](../../context/conventions.md)
- **도메인 용어집**: [glossary.md](../../context/glossary.md)

## 입력

$ARGUMENTS 에서 기능 명세서(FS)와 와이어프레임(WF) 파일 경로를 추출하여 Read로 읽으세요.

## 핵심 원칙: "어떻게, 무엇으로" — "왜 필요한가"는 포함하지 않음

### 허용: 아키텍처, API, 데이터 모델, 시퀀스, ADR, 비기능, 인프라
### 금지: 비즈니스 정당성, UX 카피 텍스트, 사용자 감정 서술

## 교차 참조 규칙 (필수)

- API 에러 응답 → AC/BR 번호 매핑
- 데이터 모델 제약 → BR 번호 주석
- API 서버 측 검증 순서 → BR 순서대로

## ADR 필수 필드

맥락, 결정, 근거, 트레이드오프, 대안 검토(최소 1개 기각), 재평가 시점

## 생성 전략

1. BR 목록 → DB 제약으로 1:1 변환
2. AC 목록 → API 에러 응답으로 역산
3. 비동기 판단: 응답 시간 > 3초 → 비동기
4. 모든 외부 호출에 타임아웃, 재시도, 실패 경로

## 품질 자가 점검

- [ ] 모든 기술 결정에 ADR 존재
- [ ] 에러 응답 ↔ AC/BR 매핑률 = 100%
- [ ] 외부 호출 실패 경로 정의율 = 100%
- [ ] 비기능 모호 표현 0건
- [ ] 비즈니스 정당성/UX 카피 포함 = 0건

## 출력 위치: specs/TS-{YYYY}-{NNN}.md