spec-scalinglisted

# Spec Scaling ## When to Use SPEC.md 또는 PRD.md가 300줄을 초과했을 때 자동 트리거. ## Process 1. 현재 SPEC.md/PRD.md의 줄 수를 확인한다. 2. 300줄 초과 시 기능별 분리를 제안한다 (SPEC와 PRD 둘 다 동일 패턴): ### SPEC 분리 (기능별) ``` docs/ ├── SPEC.md # 마스터 — 공통 규칙 + 각 기능 파일 라우트 ├── specs/ │ ├── auth.md # 인증/인가 기능 스펙 │ ├── dashboard.md # 대시보드 기능 스펙 │ └── payment.md # 결제 기능 스펙 ``` ### PRD 분리 (제품 영역별) ``` docs/ ├── PRD.md # 마스터 — 비전, 사용자, 큰 그림 + 영역 파일 라우트 └── PRD/ # 영역별 세부 사양 ├── platform-common.md # 플랫폼 공통 (인증, 권한, 인프라) ├── feature-screener.md # 스크리너 영역 ├── feature-portfolio.md # 포트폴리오 영역 └── feature-simulator.md # 시뮬레이터 영역 ``` > Vantage 프로젝트의 `.claude/PRD/` 구조를 일반화한 것 (도메인 비종속). 본 패턴에서는 `docs/PRD/` 하위에 위치. > 두 패턴 모두 **마스터 = 인덱스 + 공통**, **하위 = 독립 참조 가능 단위** 원칙. 3. 마스터 SPEC.md 구조: ```markdown # SPEC: [프로젝트명] ## 공통 규칙 [전체 적용 Boundaries, Tech Stack, DO NOT CHANGE] ## 기능별 스펙 - [인증/인가](specs/auth.md) - [대시보드](specs/dashboard.md) - [결제](specs/payment.md) ``` 4. 마스터 PRD.md 구조: ```markdown # PRD: [프로젝트명] ## 1. 비전 / Personas / NSM [North Star 요약 (없으면 생략)] ## 2. 영역별 사양 - [Platform Common](PRD/platform-common.md) — 인증/권한/인프라 - [Feature: Screener](PRD/feature-screener.md) - [Feature: Portfolio](PRD/feature-portfolio.md) ## 3. 영역 간 의존성 - Screener → Portfolio (선택 결과 전달) - All → Platform Common (인증 의존) ``` 5. **인간 승인 후에만 분리 실행**. 자동 분리 금지. ## Rules - 공통 규칙(Boundaries, Tech Stack, DO NOT CHANG