@uzysjung/agent-harness 26.83.0

package/templates/project-claude/fragments/data/agents.md

@@ -0,0 +1,6 @@
+| Agent | Scope | Model | 역할 |
+|-------|-------|-------|------|
+| reviewer | global | opus | 검증 전용 (SOD). 코드/문서/분석 관점 전환 |
+| data-analyst | global | opus | DuckDB/Trino/ML/PySide6 전문 |
+| code-reviewer | project | sonnet | 일상적 코드 리뷰. CRITICAL -> LOW 분류 |
+| security-reviewer | project | sonnet | 데이터 접근 권한, PII 처리 검증 |

package/templates/project-claude/fragments/data/boundaries.md

@@ -0,0 +1,20 @@
+**Always (자동 실행)**:
+- 코드 변경 후 code-reviewer 실행
+- 커밋 전 보안 체크 (하드코딩된 시크릿/DB 자격증명 탐지)
+- 데이터 파이프라인에 입력 검증 확인
+- ML 실험에 랜덤 시드 고정 확인
+- git pull로 세션 시작
+
+**Ask First (확인 후 실행)**:
+- 대용량 데이터 처리 실행 (메모리/디스크 영향)
+- 모델 학습 시작 (GPU 자원 소비)
+- Trino 클러스터 쿼리 실행
+- main 브랜치 머지
+
+**Never (금지)**:
+- main 직접 커밋
+- 시크릿/자격증명 하드코딩
+- PII 데이터를 로그/커밋에 포함
+- 시드 없는 ML 실험 (재현 불가)
+- 게이트 건너뛰기 (Hotfix 예외)
+- DO NOT CHANGE 영역 수정

package/templates/project-claude/fragments/data/commands.md

@@ -0,0 +1,6 @@
+| Namespace | Command | 용도 |
+|-----------|---------|------|
+| uzys: | spec, plan, build, test, review, ship | 6-gate 개발 사이클 |
+| ecc: | security-scan, instinct-status, evolve, promote | 보안 스캔, 학습 관리 |
+| imm: | teach, polish, critique, audit | 디자인 품질 관리 (PySide6 UI) |
+| gsd: | (선택 설치) | 대형 프로젝트 오케스트레이션 |

package/templates/project-claude/fragments/data/plugins.md

@@ -0,0 +1,2 @@
+- **agent-skills**: 6-gate 워크플로우 엔진
+- **Railway**: 배포 자동화 (데이터 파이프라인, API 서빙)

package/templates/project-claude/fragments/data/skills.md

@@ -0,0 +1,3 @@
+- **agent-skills**: 워크플로우 백본 (spec-driven-development, idea-refine)
+- **ECC CL-v2**: instinct 기반 학습. 세션 관찰 -> 패턴 축적
+- **Impeccable**: 디자인 품질 (PySide6 UI 용도)

package/templates/project-claude/fragments/data/stack.md

@@ -0,0 +1,7 @@
+- **Language**: Python 3.12+
+- **Query Engine**: DuckDB (로컬 분석) + Trino (분산 쿼리)
+- **ML/DL**: scikit-learn, PyTorch, transformers
+- **Data**: pandas, polars, Apache Arrow, Parquet
+- **Visualization**: matplotlib, seaborn, plotly
+- **Desktop**: PySide6 (Qt for Python)
+- **Notebook**: Jupyter / JupyterLab

package/templates/project-claude/fragments/data/tagline.md

@@ -0,0 +1 @@
+Python 기반 데이터 분석 + ML + PySide6 데스크탑 위주의 데이터 사이언스 트랙.

package/templates/project-claude/fragments/data/workflow.md

@@ -0,0 +1,9 @@
+6-gate 개발 워크플로우 적용:
+
+```
+Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
+```
+
+- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
+- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).
+- 탐색적 분석(EDA)은 Build 게이트에서 노트북 기반 진행 허용.

package/templates/project-claude/fragments/executive/active-rules.md

@@ -0,0 +1,6 @@
+| Rule | 설명 |
+|------|------|
+| git-policy | 브랜치 전략, 산출물 버전 관리 |
+| change-management | 변경 영향 분석, 문서 이력 추적 |
+
+**참고**: 개발 관련 규칙(test-policy, code-style, error-handling 등)은 적용하지 않음.

package/templates/project-claude/fragments/executive/agents.md

@@ -0,0 +1,6 @@
+| Agent | Scope | Model | 역할 |
+|-------|-------|-------|------|
+| reviewer | global | opus | 검증 전용 (SOD). 문서/제안서 품질 검증 |
+| strategist | global | opus | 사업 전략, 제안서, DD, 재무 모델 전문 |
+
+**참고**: code-reviewer, security-reviewer는 이 트랙에 불필요.

package/templates/project-claude/fragments/executive/boundaries.md

@@ -0,0 +1,17 @@
+**Always (자동 실행)**:
+- 산출물 완성 후 reviewer 검증 실행
+- 수치/날짜/법규 인용 시 1차 출처 확인
+- 근거 불충분 시 명시 ("근거 불충분" 라벨링)
+- 변경 이력 git으로 관리
+
+**Ask First (확인 후 실행)**:
+- 최종 문서 포맷 선택 (pptx vs docx vs pdf)
+- 외부 데이터 소스 참조 (API 호출, 웹 검색)
+- 민감한 재무/전략 정보 포함 여부
+- main 브랜치 머지
+
+**Never (금지)**:
+- 검증되지 않은 수치를 사실처럼 제시
+- 출처 없는 통계/시장 데이터 사용
+- 민감 정보(NDA 대상 등) 커밋
+- 6-gate 워크플로우 강제 적용 (이 트랙은 자연어 기반)

package/templates/project-claude/fragments/executive/commands.md

@@ -0,0 +1,11 @@
+| Namespace | Command | 용도 |
+|-----------|---------|------|
+| uzys: | (미적용) | Executive 트랙은 6-gate 미사용 |
+| ecc: | (미적용) | 개발 보안 스캔 불필요 |
+| imm: | (미적용) | 프론트엔드 디자인 불필요 |
+| gsd: | (미적용) | 개발 오케스트레이션 불필요 |
+
+대신 자연어로 직접 요청:
+- "제안서 작성해줘" -> strategist + document-skills(pptx/docx)
+- "경쟁사 분석" -> strategist 분석 + document-skills(xlsx)
+- "DD 보고서" -> strategist DD 프레임워크 적용

package/templates/project-claude/fragments/executive/plugins.md

@@ -0,0 +1 @@
+없음. Executive 트랙은 플러그인 의존 없이 에이전트 + document-skills로 동작.

package/templates/project-claude/fragments/executive/skills.md

@@ -0,0 +1,7 @@
+- **document-skills (pptx)**: PowerPoint 프레젠테이션 생성/편집
+- **document-skills (docx)**: Word 문서 생성/편집
+- **document-skills (xlsx)**: Excel 스프레드시트 생성/편집/분석
+- **document-skills (pdf)**: PDF 생성/합치기/분할
+- **document-skills (doc-coauthoring)**: 구조화된 문서 공동 작성 워크플로우
+
+**참고**: agent-skills(6-gate), ECC CL-v2, Impeccable은 이 트랙에 미적용.

package/templates/project-claude/fragments/executive/stack.md

@@ -0,0 +1,4 @@
+- **Output**: PPT (pptx), Excel (xlsx), Word (docx), PDF
+- **Tools**: Anthropic document-skills (pptx, docx, xlsx, pdf)
+- **Analysis**: 사업 제안서, Due Diligence, 경쟁 분석, 재무 모델
+- **No Dev Stack**: 코드 개발 프로젝트가 아님

package/templates/project-claude/fragments/executive/tagline.md

@@ -0,0 +1 @@
+사업 제안서/DD/경쟁분석/재무모델 등 임원급 문서 산출물 중심의 비개발 트랙.

package/templates/project-claude/fragments/executive/workflow.md

@@ -0,0 +1,10 @@
+자연어 워크플로우 (6-gate 미적용):
+
+```
+요청 -> strategist 에이전트 분석 -> document-skills로 산출물 생성 -> reviewer 검증 -> 전달
+```
+
+- 6-gate 개발 워크플로우를 사용하지 않음.
+- 자연어 요청을 받아 strategist 에이전트가 구조화.
+- document-skills가 최종 문서 형식(pptx/docx/xlsx/pdf) 생성.
+- reviewer가 논리 흐름, 설득력, 범위 커버리지 검증.

package/templates/project-claude/fragments/growth-marketing/active-rules.md

@@ -0,0 +1,7 @@
+| Rule | 설명 |
+|------|------|
+| git-policy | 콘텐츠 버전 관리 |
+| change-management | 캠페인 변경 영향 분석 |
+| gates-taxonomy | Pre-flight/Revision/Escalation/Abort 게이트 분류 |
+
+**참고**: 개발 관련 규칙(test-policy, code-style, error-handling 등)은 적용하지 않음.

package/templates/project-claude/fragments/growth-marketing/agents.md

@@ -0,0 +1,6 @@
+| Agent | Scope | Model | 역할 |
+|-------|-------|-------|------|
+| reviewer | global | opus | 검증 전용 (SOD). 메시지/데이터 인용 정확도 검증 |
+| strategist | global | opus | GTM 전략, 경쟁 분석, 시장 진입 의사결정 |
+
+**참고**: code-reviewer, security-reviewer는 이 트랙에 불필요.

package/templates/project-claude/fragments/growth-marketing/boundaries.md

@@ -0,0 +1,17 @@
+**Always (자동 실행)**:
+- 시장 데이터 / 통계 인용 시 1차 출처 확인 — 못 하면 "근거 불충분" 명시
+- 메시지 작성 시 브랜드 보이스 일관성 (.impeccable.md 가용 시 참조)
+- 변경 이력 git으로 관리
+- 산출물 완성 후 reviewer 검증
+
+**Ask First (확인 후 실행)**:
+- 외부 채널(메일/광고/SNS) 실제 발행
+- 민감한 캠페인 예산/타겟 데이터 포함 여부
+- 경쟁사 직접 비교 콘텐츠 발행
+- main 브랜치 머지
+
+**Never (금지)**:
+- 검증되지 않은 통계를 사실처럼 제시 (예: "고객의 X%는...")
+- 출처 없는 시장 규모 추정 (TAM/SAM/SOM 무근거)
+- 경쟁사 비방/허위 비교
+- 6-gate 워크플로우 강제 적용 (이 트랙은 자연어 기반)

package/templates/project-claude/fragments/growth-marketing/commands.md

@@ -0,0 +1,11 @@
+| Namespace | Command | 용도 |
+|-----------|---------|------|
+| uzys: | (미적용) | 본 트랙은 6-gate 미사용 |
+| ecc: | (미적용) | 보안 스캔 불필요 |
+
+대신 자연어로 직접 요청:
+- "이 페르소나용 SEO 블로그 5개 안 작성" -> content-creator
+- "Q3 demand gen 플레이북" -> demand-gen
+- "경쟁사 X 시장 조사 요약" -> research-summarizer
+- "twitter thread 작성" -> marketing-skills (twitter)
+- "CRO 가설 + AB 테스트 설계" -> marketing-skills (CRO)

package/templates/project-claude/fragments/growth-marketing/plugins.md

@@ -0,0 +1,9 @@
+이 트랙은 alirezarezvani/claude-skills marketplace + 별도 plugin을 통해 동작:
+
+- marketing-skills (alirezarezvani/claude-skills)
+- business-growth-skills (alirezarezvani/claude-skills, executive 트랙과 공유)
+- content-creator (별도 plugin)
+- demand-gen (별도 plugin)
+- research-summarizer (별도 plugin)
+
+설치는 `/plugin marketplace add` + `/plugin install` (자동 — installer가 처리).

package/templates/project-claude/fragments/growth-marketing/skills.md

@@ -0,0 +1,8 @@
+- **marketing-skills (44)**: content/SEO/CRO/channels/growth/intelligence/sales/twitter
+- **business-growth-skills (4)**: customer success, sales eng, RevOps, contract
+- **content-creator**: SEO content + brand voice + frameworks
+- **demand-gen**: multi-channel demand gen + paid media + partnership
+- **research-summarizer**: 시장 조사 요약
+- **document-skills (docx/xlsx/pptx)**: 캠페인 브리프, 지표 시트, 투자 자료
+
+**참고**: agent-skills(6-gate), ECC CL-v2, Impeccable 코딩 스킬은 이 트랙에 미적용.

package/templates/project-claude/fragments/growth-marketing/stack.md

@@ -0,0 +1,7 @@
+- **Output**: 콘텐츠(blog/landing/twitter), SEO 최적화, demand gen 캠페인, 시장 조사 요약
+- **Tools**: marketing-skills (44 — content/SEO/CRO/channels/growth/intelligence/sales/twitter)
+- **Tools**: business-growth-skills (4 — customer success, sales engineering, RevOps, contract)
+- **Tools**: content-creator (SEO content + brand voice + frameworks)
+- **Tools**: demand-gen (multi-channel demand gen + paid + partnership)
+- **Tools**: research-summarizer (시장 조사 요약)
+- **No Dev Stack**: 코드 개발 프로젝트가 아님. 산출물은 콘텐츠/캠페인 자료.

package/templates/project-claude/fragments/growth-marketing/tagline.md

@@ -0,0 +1 @@
+콘텐츠 + SEO + demand gen + 시장 조사 등 그로스/마케팅 산출물 중심의 비개발 트랙.

package/templates/project-claude/fragments/growth-marketing/workflow.md

@@ -0,0 +1,11 @@
+자연어 워크플로우 (6-gate 미적용):
+
+```
+요청 -> Growth/Marketing skill 호출 -> 산출물 생성 -> reviewer 검증 -> 전달
+```
+
+- 6-gate 개발 워크플로우를 사용하지 않음.
+- 자연어 요청을 받아 적절한 marketing skill 호출.
+- 시장 조사 → research-summarizer → content-creator → marketing-skills/CRO 흐름.
+- demand-gen은 multi-channel 캠페인 설계 시 호출.
+- reviewer가 메시지 일관성, 브랜드 보이스 정합성, 데이터 인용 정확도 검증.

package/templates/project-claude/fragments/project-management/active-rules.md

@@ -0,0 +1,7 @@
+| Rule | 설명 |
+|------|------|
+| git-policy | 산출물 버전 관리 |
+| change-management | 변경 영향 분석, 결정 로그 |
+| gates-taxonomy | Pre-flight/Revision/Escalation/Abort 게이트 분류 |
+
+**참고**: 개발 관련 규칙(test-policy, code-style, error-handling 등)은 적용하지 않음.

package/templates/project-claude/fragments/project-management/agents.md

@@ -0,0 +1,6 @@
+| Agent | Scope | Model | 역할 |
+|-------|-------|-------|------|
+| reviewer | global | opus | 검증 전용 (SOD). PRD/RICE 우선순위 근거 검증 |
+| strategist | global | opus | 전략적 의사결정 — RICE score 합리화, 로드맵 자료 |
+
+**참고**: code-reviewer, security-reviewer는 이 트랙에 불필요.

package/templates/project-claude/fragments/project-management/boundaries.md

@@ -0,0 +1,16 @@
+**Always (자동 실행)**:
+- 우선순위 결정 시 명시적 기준 (RICE/MoSCoW 등) 사용 — 추정 금지
+- PRD 작성 시 acceptance criteria 명시
+- 변경 이력 git/Confluence로 관리
+- 산출물 완성 후 reviewer 검증
+
+**Ask First (확인 후 실행)**:
+- 외부 시스템 (Jira/Confluence) 실제 변경
+- 민감 정보 (인사/재무 추정) 포함 여부
+- main 브랜치 머지
+
+**Never (금지)**:
+- 검증되지 않은 우선순위 제시 ("그냥 중요해 보임")
+- 출처 없는 데이터로 RICE Reach/Impact 산정
+- Jira ticket 임의 closed/reopened
+- 6-gate 워크플로우 강제 적용 (이 트랙은 자연어 기반)

package/templates/project-claude/fragments/project-management/commands.md

@@ -0,0 +1,10 @@
+| Namespace | Command | 용도 |
+|-----------|---------|------|
+| uzys: | (미적용) | 본 트랙은 6-gate 미사용 |
+| ecc: | (미적용) | 보안 스캔 불필요 |
+
+대신 자연어로 직접 요청:
+- "이번 스프린트 retro 정리해줘" -> scrum master skill
+- "이 feature RICE 점수 매겨줘" -> product-skills RICE
+- "PRD 초안 만들어줘" -> product-skills PRD generator
+- "Confluence 회의록 정리" -> Confluence expert

package/templates/project-claude/fragments/project-management/plugins.md

@@ -0,0 +1,6 @@
+이 트랙은 Atlassian + 마켓플레이스 plugin을 통해 동작:
+
+- pm-skills (alirezarezvani/claude-skills marketplace)
+- product-skills (alirezarezvani/claude-skills marketplace)
+
+설치는 `/plugin marketplace add` + `/plugin install` (자동 — installer가 처리).

package/templates/project-claude/fragments/project-management/skills.md

@@ -0,0 +1,5 @@
+- **pm-skills (6)**: senior PM, scrum master, Jira expert, Confluence expert, Atlassian admin, template creator
+- **product-skills (15)**: RICE, PRD, agile PO, UX researcher, UI design system, competitive teardown, landing page generator, SaaS scaffolder, product analytics, experiment designer, product discovery, roadmap communicator, code-to-prd, research summarizer, apple-hig-expert
+- **document-skills (docx/xlsx/pptx)**: PRD/agenda/지표 시트/스폰서 덱
+
+**참고**: agent-skills(6-gate), ECC CL-v2, Impeccable 코딩 스킬은 이 트랙에 미적용.

package/templates/project-claude/fragments/project-management/stack.md

@@ -0,0 +1,4 @@
+- **Output**: Jira tickets, Confluence pages, PRD/RICE/agile artifacts, sprint reports
+- **Tools**: pm-skills (6 — senior PM, scrum master, Jira expert, Confluence expert, Atlassian admin, template creator)
+- **Tools**: product-skills (15 — RICE, PRD, agile PO, UX research, landing page, SaaS scaffolder ...)
+- **No Dev Stack**: 코드 개발 프로젝트가 아님. 산출물은 문서/티켓/리포트.

package/templates/project-claude/fragments/project-management/tagline.md

@@ -0,0 +1 @@
+Jira/Confluence/PRD/RICE 등 PM·스크럼 산출물 중심의 비개발 트랙.

package/templates/project-claude/fragments/project-management/workflow.md

@@ -0,0 +1,12 @@
+자연어 워크플로우 (6-gate 미적용):
+
+```
+요청 -> PM/Scrum 에이전트 분석 -> pm-skills/product-skills로 산출물 생성 -> reviewer 검증 -> 전달
+```
+
+- 6-gate 개발 워크플로우를 사용하지 않음.
+- 자연어 요청을 받아 PM/Scrum/RICE 등 적절한 skill 호출.
+- pm-skills + product-skills 양쪽 도구가 모두 설치되어 있음 — 상황에 맞춰 선택:
+  - **pm-skills**: Jira/Confluence/Atlassian admin, scrum master 운영 — 운영 중심
+  - **product-skills**: RICE/PRD/agile PO/UX research/SaaS scaffolder — 기획 중심
+- reviewer가 논리 흐름, 우선순위 근거, 범위 적합성 검증.

package/templates/project-claude/fragments/ssr-htmx/active-rules.md

@@ -0,0 +1,11 @@
+| Rule | 설명 |
+|------|------|
+| git-policy | 브랜치 전략, PR 필수, main 직접 커밋 금지 |
+| change-management | 변경 영향 분석, DO NOT CHANGE 영역 보호 |
+| test-policy | 단위/통합/E2E (pytest + Playwright). 커버리지 80% 이상 |
+| ship-checklist | 배포 전 최종 점검 체크리스트 |
+| code-style | 불변성(Pydantic 모델), 소형 파일, 함수 50줄 이하 |
+| error-handling | 명시적 에러 처리. HTTPException 계층화 |
+| design-workflow | UI/UX 설계 프로세스. shape -> build -> polish |
+| htmx | HTMX 속성 규칙, 부분 렌더링, hx-swap 전략 |
+| seo | 시맨틱 HTML, 메타 태그, OG 태그, 구조화된 데이터 |

package/templates/project-claude/fragments/ssr-htmx/agents.md

@@ -0,0 +1,5 @@
+| Agent | Scope | Model | 역할 |
+|-------|-------|-------|------|
+| reviewer | global | opus | 검증 전용 (SOD). 코드/문서/UI 관점 전환 |
+| code-reviewer | project | sonnet | 일상적 코드 리뷰. CRITICAL -> LOW 분류 |
+| security-reviewer | project | sonnet | OWASP Top 10, CSRF/XSS 방어 검증 |

package/templates/project-claude/fragments/ssr-htmx/boundaries.md

@@ -0,0 +1,20 @@
+**Always (자동 실행)**:
+- 코드 변경 후 code-reviewer 실행
+- 커밋 전 보안 체크 (하드코딩된 시크릿 탐지)
+- Jinja2 템플릿에서 사용자 입력 자동 이스케이프 확인
+- HTMX 응답에 적절한 Content-Type 헤더 확인
+- git pull로 세션 시작
+
+**Ask First (확인 후 실행)**:
+- Alembic 마이그레이션 실행
+- Railway 배포
+- SEO 관련 메타 태그/sitemap 변경
+- main 브랜치 머지
+
+**Never (금지)**:
+- main 직접 커밋
+- 시크릿 하드코딩
+- Jinja2 autoescaping 비활성화
+- 프로덕션 DB 직접 조작
+- 게이트 건너뛰기 (Hotfix 예외)
+- DO NOT CHANGE 영역 수정

package/templates/project-claude/fragments/ssr-htmx/commands.md

@@ -0,0 +1,6 @@
+| Namespace | Command | 용도 |
+|-----------|---------|------|
+| uzys: | spec, plan, build, test, review, ship | 6-gate 개발 사이클 |
+| ecc: | security-scan, instinct-status, evolve, promote | 보안 스캔, 학습 관리 |
+| imm: | teach, polish, critique, audit, shape, adapt | 디자인 품질 관리 |
+| gsd: | (선택 설치) | 대형 프로젝트 오케스트레이션 |

package/templates/project-claude/fragments/ssr-htmx/plugins.md

@@ -0,0 +1,2 @@
+- **agent-skills**: 6-gate 워크플로우 엔진
+- **Railway**: 배포 자동화 (FastAPI 서비스 + PostgreSQL)

package/templates/project-claude/fragments/ssr-htmx/skills.md

@@ -0,0 +1,3 @@
+- **agent-skills**: 워크플로우 백본 (spec-driven-development, idea-refine)
+- **ECC CL-v2**: instinct 기반 학습. 세션 관찰 -> 패턴 축적
+- **Impeccable**: 프론트엔드 디자인 품질 (polish, critique, audit)

package/templates/project-claude/fragments/ssr-htmx/stack.md

@@ -0,0 +1,6 @@
+- **Backend**: FastAPI + Python 3.12+ (uvicorn)
+- **Templating**: Jinja2
+- **Frontend**: HTMX + Alpine.js (필요 시)
+- **UI**: Tailwind CSS + daisyUI
+- **Database**: PostgreSQL (SQLAlchemy / SQLModel)
+- **Infra**: Railway

package/templates/project-claude/fragments/ssr-htmx/tagline.md

@@ -0,0 +1 @@
+FastAPI + Jinja2 + HTMX 기반 서버 사이드 렌더링 웹 앱 트랙.

package/templates/project-claude/fragments/ssr-htmx/workflow.md

@@ -0,0 +1,8 @@
+6-gate 개발 워크플로우 적용:
+
+```
+Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
+```
+
+- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
+- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/ssr-nextjs/active-rules.md

@@ -0,0 +1,12 @@
+| Rule | 설명 |
+|------|------|
+| git-policy | 브랜치 전략, PR 필수, main 직접 커밋 금지 |
+| change-management | 변경 영향 분석, DO NOT CHANGE 영역 보호 |
+| test-policy | 단위/통합/E2E (Vitest + Playwright). 커버리지 80% 이상 |
+| ship-checklist | 배포 전 최종 점검 체크리스트 |
+| code-style | 불변성, 소형 파일(800줄 이하), 함수 50줄 이하 |
+| error-handling | 명시적 에러 처리. error.tsx 바운더리 활용 |
+| design-workflow | UI/UX 설계 프로세스. shape -> build -> polish |
+| nextjs | App Router 규칙, Server/Client 컴포넌트 경계, 캐싱 전략 |
+| seo | 시맨틱 HTML, generateMetadata, OG 이미지, sitemap.xml |
+| shadcn | shadcn/ui 컴포넌트 사용 규칙, 커스터마이징 패턴 |

package/templates/project-claude/fragments/ssr-nextjs/agents.md

@@ -0,0 +1,5 @@
+| Agent | Scope | Model | 역할 |
+|-------|-------|-------|------|
+| reviewer | global | opus | 검증 전용 (SOD). 코드/문서/UI 관점 전환 |
+| code-reviewer | project | sonnet | 일상적 코드 리뷰. CRITICAL -> LOW 분류 |
+| security-reviewer | project | sonnet | OWASP Top 10, Server Actions 보안 검증 |

package/templates/project-claude/fragments/ssr-nextjs/boundaries.md

@@ -0,0 +1,20 @@
+**Always (자동 실행)**:
+- 코드 변경 후 code-reviewer 실행
+- 커밋 전 보안 체크 (하드코딩된 시크릿 탐지)
+- Server/Client 컴포넌트 경계 확인 ("use client" 지시어)
+- generateMetadata 누락 여부 확인 (페이지 추가 시)
+- git pull로 세션 시작
+
+**Ask First (확인 후 실행)**:
+- DB 마이그레이션 실행
+- Railway 배포
+- next.config 변경 (빌드 영향)
+- main 브랜치 머지
+
+**Never (금지)**:
+- main 직접 커밋
+- 시크릿 하드코딩
+- Server Component에서 useState/useEffect 사용
+- 프로덕션 DB 직접 조작
+- 게이트 건너뛰기 (Hotfix 예외)
+- DO NOT CHANGE 영역 수정

package/templates/project-claude/fragments/ssr-nextjs/commands.md

@@ -0,0 +1,6 @@
+| Namespace | Command | 용도 |
+|-----------|---------|------|
+| uzys: | spec, plan, build, test, review, ship | 6-gate 개발 사이클 |
+| ecc: | security-scan, instinct-status, evolve, promote | 보안 스캔, 학습 관리 |
+| imm: | teach, polish, critique, audit, shape, adapt | 디자인 품질 관리 |
+| gsd: | (선택 설치) | 대형 프로젝트 오케스트레이션 |

package/templates/project-claude/fragments/ssr-nextjs/plugins.md

@@ -0,0 +1,2 @@
+- **agent-skills**: 6-gate 워크플로우 엔진
+- **Railway**: 배포 자동화 (Next.js standalone 빌드)

package/templates/project-claude/fragments/ssr-nextjs/skills.md

@@ -0,0 +1,5 @@
+- **agent-skills**: 워크플로우 백본 (spec-driven-development, idea-refine)
+- **ECC CL-v2**: instinct 기반 학습. 세션 관찰 -> 패턴 축적
+- **Impeccable**: 프론트엔드 디자인 품질 (polish, critique, audit)
+- **react-best-practices**: React 패턴, 훅 규칙, 상태 관리
+- **shadcn-ui**: shadcn/ui 컴포넌트 가이드, 테마 커스터마이징

package/templates/project-claude/fragments/ssr-nextjs/stack.md

@@ -0,0 +1,5 @@
+- **Framework**: Next.js (App Router) + TypeScript
+- **Frontend**: React + Server Components + Server Actions
+- **UI**: shadcn/ui + Tailwind CSS
+- **Database**: PostgreSQL (Drizzle ORM / Prisma)
+- **Infra**: Railway

package/templates/project-claude/fragments/ssr-nextjs/tagline.md

@@ -0,0 +1 @@
+Next.js App Router + Server Components 기반 서버 사이드 렌더링 풀스택 트랙.

package/templates/project-claude/fragments/ssr-nextjs/workflow.md

@@ -0,0 +1,8 @@
+6-gate 개발 워크플로우 적용:
+
+```
+Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
+```
+
+- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
+- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/tooling/active-rules.md

@@ -0,0 +1,11 @@
+| Rule | 적용 |
+|------|------|
+| git-policy | feature branch, push/PR 의무 |
+| change-management | CR 분류, Decision Log, DO NOT CHANGE |
+| commit-policy | 즉시 커밋 |
+| ship-checklist | 배포 전 체크 (security scan, 의존성 audit) |
+| code-style | shellcheck 기준, 명명 규칙 |
+| error-handling | exit code, stderr |
+| ecc-git-workflow | Conventional Commits |
+| ecc-testing | 80% 커버리지, TDD, AAA |
+| **cli-development** | Bash 스크립트 표준, cross-platform, hook 컨벤션 |

package/templates/project-claude/fragments/tooling/agents.md

@@ -0,0 +1,5 @@
+| Agent | Model | 역할 |
+|-------|-------|------|
+| reviewer (global) | opus, fork | SOD 검증 (5축 리뷰) |
+| code-reviewer (ECC) | sonnet | 일상 코드 리뷰 |
+| security-reviewer (ECC) | sonnet | 시크릿/취약점 |

package/templates/project-claude/fragments/tooling/boundaries.md

@@ -0,0 +1,17 @@
+### Always
+- 코드/문서 변경 시 즉시 커밋 → push
+- 모든 bash 스크립트는 shellcheck 통과
+- Hook 스크립트는 jq 폴백 포함
+- 변수 인용 (`"$var"`) 일관 적용
+
+### Ask First
+- 새 Track 추가
+- setup-harness.sh 흐름 변경
+- ECC cherry-pick 항목 추가/제거
+- 글로벌 vs 프로젝트 스코프 결정
+
+### Never
+- main 직접 커밋
+- `.env`, lock 파일, 인증서 파일 수정
+- `--no-verify`로 hook 우회
+- 게이트 건너뛰기 (`/uzys:` 순서 무시)

package/templates/project-claude/fragments/tooling/commands.md

@@ -0,0 +1,4 @@
+| Namespace | 용도 |
+|-----------|------|
+| `/uzys:*` (6개) | 6단계 워크플로우 |
+| `/ecc:*` (8개) | security-scan, instinct 관리, checkpoint |

package/templates/project-claude/fragments/tooling/skills.md

@@ -0,0 +1,4 @@
+- **agent-skills**: 6단계 워크플로우 (필수)
+- **continuous-learning-v2**: 경험 축적 (선택, observer disabled by default)
+- **spec-scaling**: SPEC.md > 300줄 시 분할
+- **strategic-compact**: 장시간 세션 컨텍스트 압축

package/templates/project-claude/fragments/tooling/stack.md

@@ -0,0 +1,5 @@
+- **Shell**: Bash 5+ (macOS, Linux)
+- **Templates**: Markdown (`.md`) with YAML frontmatter
+- **JSON**: `jq` for parsing/transformation
+- **Optional**: Python 3 for CL-v2 scripts
+- **Testing**: shellcheck, bats

package/templates/project-claude/fragments/tooling/tagline.md

@@ -0,0 +1 @@
+Bash 스크립트 + 마크다운 템플릿 + CLI 도구 위주의 메타 프로젝트.

package/templates/project-claude/fragments/tooling/workflow.md

@@ -0,0 +1,5 @@
+```
+Define(/uzys:spec) → Plan(/uzys:plan) → Build(/uzys:build) → Verify(/uzys:test) → Review(/uzys:review) → Ship(/uzys:ship)
+```
+
+각 단계는 `.claude/hooks/gate-check.sh`로 강제. 이전 단계 미완료 시 다음 단계 실행 차단.

package/templates/rules/api-contract.md

@@ -0,0 +1,33 @@
+# API Contract Rules
+
+CSR Track에서 적용. 백엔드-프론트엔드 타입 일관성 보장.
+
+## Contract-First Development
+
+1. **Backend Pydantic = SSOT**: 백엔드 Pydantic 모델이 API 스키마의 source of truth.
+2. **OpenAPI 생성**: FastAPI가 자동 생성하는 `/openapi.json` 사용.
+3. **Frontend 타입 생성**: `openapi-typescript`로 TypeScript 타입 자동 생성.
+4. **수동 타입 정의 금지**: 프론트엔드에서 API 응답 타입을 직접 작성하지 않음.
+
+## Direction
+
+```
+Backend Pydantic → OpenAPI spec → openapi-typescript → Frontend types
+```
+
+역방향(Frontend → Backend) 금지.
+
+## API Response Format
+
+```python
+class ApiResponse(BaseModel, Generic[T]):
+    success: bool
+    data: T | None = None
+    error: ErrorDetail | None = None
+    meta: PaginationMeta | None = None
+```
+
+## Versioning
+
+- API 경로: `/api/v1/...`
+- 신규 엔드포인트는 v1에 추가. 기존 시그니처 변경 시 v2 고려.