Tech Spec

1. Context Check (계속)

{프로젝트 폴더}에서 다음 파일을 확인한다:

• PROJECT.md — 프로젝트 범위와 요구사항
• SITE-SURVEY.md — 현장 조건 (전력, 네트워크, 공간)
• DISPLAY-CALC.md — 디스플레이 계산 결과
• TECH-SPEC.md / TECH-SPEC.docx — 이미 있으면 업데이트할지 새로 만들지 질문

2. Input Gathering (한 번에 하나씩)

Q1 — 사양서 용도

"이 사양서의 용도는 무엇인가요?"

이 선택에 따라 문서 톤과 디테일 수준이 달라진다.

Q2 — 시스템 구성 (프로젝트 타입별 기본 구성)

"프로젝트에 포함되는 시스템을 알려주세요."

해당하는 항목을 선택/설명:

• Display (프로젝터, LED, 모니터)
• Computing (미디어서버, 컨트롤 PC)
• Network (LAN, WiFi, 제어 네트워크)
• Sensor / Input (카메라, 뎁스센서, 터치, 기타)
• Audio (스피커, 앰프, DSP)
• Lighting (조명, DMX)
• Structure (구조물, 마운트, 리깅)

PROJECT.md가 있으면 자동 추론하고 확인만 받는다.

프로젝트 타입별 기본 시스템 구성:

Q3~QN — 시스템별 상세 (선택된 시스템만)

각 시스템에 대해 한 번에 하나씩 질문한다. 이전 단계에서 읽은 컨텍스트 (DISPLAY-CALC.md, SITE-SURVEY.md 등)가 있으면 해당 정보를 보여주고 확인/보완만 받는다.

Display 상세:

"디스플레이 시스템의 상세를 알려주세요."

• 유형, 모델, 수량, 해상도, 밝기, 배치
• DISPLAY-CALC.md가 있으면 자동 반영

Computing 상세:

"미디어서버/컴퓨팅 장비를 알려주세요."

• 장비명, 사양, 역할 (재생, 렌더링, 제어 등)
• references/hardware-db.md의 미디어서버 목록 참조

Network 상세:

"네트워크 구성을 알려주세요."

• 토폴로지 (스타, 체인 등)
• IP 대역, VLAN 분리 여부
• 프로토콜 (ArtNet, sACN, OSC, NDI, MIDI 등)

Sensor 상세:

"센서/입력 시스템을 알려주세요."

• 센서 종류, 모델, 감지 범위, 인터페이스
• references/hardware-db.md의 센서 목록 참조

Audio 상세:

"오디오 시스템을 알려주세요."

• 스피커 수량/배치, 채널 수, 앰프, DSP

Power 계산 (자동): 모든 장비 정보가 모이면 전력 소비량을 자동 계산:

총 소비전력 = Σ(각 장비 소비전력 × 수량)
필요 회로 = ceil(총 소비전력 / 단일 회로 용량)

SITE-SURVEY.md의 가용 전력과 비교하여 부족 여부를 경고한다.

3. Content Specification

references/codec-reference.md를 참조하여 콘텐츠 사양을 자동 생성:

• 해상도 (DISPLAY-CALC.md 기반)
• 포맷/코덱 (미디어서버 호환성 기반으로 추천)
• 프레임레이트
• 비트레이트 가이드라인
• 색공간 (references/color-spaces.md 참조)

4. Validation (검증)

기술 사양의 실현 가능성을 references/와 프로젝트 문서로 대조한다:

장비 스펙 검증 (references/hardware-db.md):

• 프로젝터: 선택 모델의 해상도, 밝기, throw ratio가 실제 스펙과 일치하는지
• LED: 피셀 피치, 밝기가 실제 제품군 스펙 범위 내인지
• 미디어서버: 필요 출력 수/해상도가 선택 서버의 최대 출력 이내인지
• 센서: 설치 공간 크기가 센서 유효 범위 이내인지

전력 검증 (SITE-SURVEY.md):

• 총 소비전력 ≤ 현장 가용 전력
  • 초과 시: ❌ + 추가 전력 공사 필요 명시 + 예상 비용 안내
• 필요 회로 수 ≤ 현장 가용 차단기 수

네트워크 검증:

• 필요 대역폭 (NDI, ArtNet 등)이 현장 네트워크 사양 내인지
• IP 대역 충돌 가능성

콘텐츠 사양 검증 (references/codec-reference.md):

• 추천 코덱이 선택한 미디어서버에서 지원되는지
• 비트레이트가 스토리지 I/O 한계 이내인지

반입 검증 (SITE-SURVEY.md):

• 가장 큰 장비의 크기가 출입문/엘리베이터 크기 이내인지

검증 출력:

## Validation Report

| 항목 | 기준값 | 사양값 | 결과 |
|------|--------|--------|------|
| 프로젝터 출력 (PT-RQ25K) | 25,000 lm | 필요 18,000 lm | ✅ 충분 |
| 미디어서버 출력 (Resolume) | 최대 8x 4K | 2x 4K 필요 | ✅ 가능 |
| 센서 범위 (RealSense D455) | 0.4-6m | 공간 폭 5m | ✅ 커버 |
| 총 소비전력 vs 가용 전력 | 30A (6,600W) | 5,200W | ✅ 여유 1,400W |
| 장비 반입 (최대 장비: 120cm) | 출입문 150cm | 120cm | ✅ 통과 |

5. Generate TECH-SPEC.md

templates/TECH-SPEC.md.tmpl을 기반으로 마크다운을 생성한 뒤, scripts/md-to-docx.py로 .docx로 변환한다.

{프로젝트 폴더}/TECH-SPEC.md    ← 원본
{프로젝트 폴더}/TECH-SPEC.docx  ← Word

시스템 개요 다이어그램: ASCII art로 전체 신호 흐름을 그린다.

[Media Server] --HDMI--> [Splitter] --HDMI--> [Projector 1]
                                    --HDMI--> [Projector 2]
[Control PC]   --LAN---> [Switch]  --LAN---> [Media Server]
                                   --LAN---> [Sensor PC]
[Sensor]       --USB---> [Sensor PC] --OSC--> [Media Server]

클라이언트 납품용인 경우:

• {프로젝트 폴더}/TECH-SPEC-ko.docx + .md (한국어)
• {프로젝트 폴더}/TECH-SPEC-en.docx + .md (영어) 이중 언어 버전을 생성할 수 있다 (사용자에게 확인).

5. Post-generation

기술 사양서가 생성되었습니다:
- {프로젝트 폴더}/TECH-SPEC.docx (Word)
- {프로젝트 폴더}/TECH-SPEC.md (원본)

시스템 구성: Display(2) + Computing(1) + Network + Sensor(3)
총 소비전력: 2,400W (20A 회로 1개 필요)

다음 단계:
- /estimate 로 이 사양 기반의 견적을 산출할 수 있습니다
- /display-calc 로 디스플레이 배치를 상세 계산할 수 있습니다
- /content-pipeline 으로 콘텐츠 제작 파이프라인을 설정할 수 있습니다
- /install-guide 로 설치 매뉴얼을 생성할 수 있습니다

Data Handoff (입출력 규격)

Input (읽는 문서)

Output (쓰는 필드) → 다음 스킬이 읽는 구조

Core Principles

1. 시스템 전체를 본다 — 개별 장비가 아닌 시스템 간 연결과 신호 흐름을 중심으로 기술한다.
2. 수치 기반 — 모든 스펙은 측정 가능한 수치로 명시한다.
3. 용도에 맞는 톤 — 클라이언트에게는 쉽게, 내부에는 기술적으로, 외주에는 명확하게.
4. 전력은 반드시 계산 — 현장에서 가장 흔한 문제가 전력 부족이다. 항상 총 소비전력을 산출하고 가용 전력과 비교한다.
5. 검증 필수 — 장비 스펙, 전력, 반입 가능성을 references/와 SITE-SURVEY.md로 대조한다.
6. 한 번에 하나의 질문 — 시스템이 많아도 하나씩 질문한다.
7. 레퍼런스 활용 — references/ 디렉토리의 데이터를 근거로 활용한다.
8. 언어를 따른다 — 사용자의 언어로 대화하고 문서를 생성한다.