Spec scaling

Skill uzysjung/uzys-agent-harness/.claude/skills/spec-scaling

Detects when SPEC.md or PRD.md exceeds 300 lines and proposes feature-based splitting with a master route document. Use when SPEC.md grows too large to be effectively used as a single document.From its SKILL.md

Install

npx -y skills add uzysjung/uzys-agent-harness --skill spec-scaling

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.0 KB, ~1.0k tokens by cl100k_base, as published. Nobody here has run it

Spec Scaling

When to Use

SPEC.md 또는 PRD.md가 300줄을 초과했을 때 자동 트리거.

Process

현재 SPEC.md/PRD.md의 줄 수를 확인한다.
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   # 시뮬레이터 영역

도메인 비종속 구조. 본 패턴에서는 docs/PRD/ 하위에 위치. 두 패턴 모두 마스터 = 인덱스 + 공통, 하위 = 독립 참조 가능 단위 원칙.

마스터 SPEC.md 구조:

# SPEC: [프로젝트명]

## 공통 규칙
[전체 적용 Boundaries, Tech Stack, DO NOT CHANGE]

## 기능별 스펙
- [인증/인가](specs/auth.md)
- [대시보드](specs/dashboard.md)
- [결제](specs/payment.md)

마스터 PRD.md 구조:

# 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 (인증 의존)

인간 승인 후에만 분리 실행. 자동 분리 금지.

Rules

공통 규칙(Boundaries, Tech Stack, DO NOT CHANGE)은 마스터에 유지.
각 하위 파일은 독립적으로 참조 가능해야 한다 — 다른 파일을 읽지 않아도 의미 통해야 함.
영역/기능 간 의존성은 마스터에 명시.
분리 후 기존 SPEC.md/PRD.md는 마스터로 변환 (삭제 아님).
하위 파일도 다시 300줄 초과하면 sub-area로 추가 분리 (재귀 적용).

When to Split SPEC vs PRD

경우	분리 대상
비즈니스 맥락 / 사용자 시나리오가 큰 비중	PRD 우선 분리
기술 스펙이 핵심 (API, 데이터 모델, AC)	SPEC 우선 분리
둘 다 큰 경우	PRD를 영역별로, SPEC를 기능별로 (서로 cross-link)

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.