@uzysjung/agent-harness 26.88.0 → 26.89.0

package/templates/commands/uzys/auto.md

@@ -1,190 +0,0 @@
-SPEC 확정 후 나머지 5단계(Plan → Build → Test → Review → Ship)를 자동으로 순차 진행하고, **SPEC 정합성이 충족될 때까지 Ralph loop로 반복 검증**한다.
-
-## 사전 조건
-
-1. `docs/SPEC.md` 존재 확인. 없으면 "/uzys:spec을 먼저 실행하세요" 안내 후 **중단**.
-2. `.claude/gate-status.json`의 `define.completed` = true 확인. false면 **중단**.
-
-## 실행 순서
-
-각 단계를 **순차 실행**. 각 단계 완료 시 gate-status.json을 자동 업데이트하고 다음 단계로 진행한다.
-
-### 1. Plan
-- `docs/plan.md` + `docs/todo.md` 생성
-- plan-checker agent로 Goal-backward 검증 (Revision Gate, 최대 3회)
-- 완료 시: `jq '.plan.completed = true | .plan.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json`
-
-### 2. Build
-- `docs/todo.md`에서 미완료 task를 순차 선택
-- 각 task에 TDD 사이클 적용 (RED → GREEN → REFACTOR)
-- 각 task 완료 시 **즉시 커밋** (commit-policy 준수)
-- todo.md 체크박스 업데이트
-- 모든 task 완료 시: gate-status build.completed = true
-
-### 3. Test
-- 전체 테스트 스위트 실행
-- test-policy.md 커버리지 기준 확인 (UI 60%, API 80%, 로직 90%)
-- 미달 시 추가 테스트 작성 시도 (최대 3회)
-- 통과 시: gate-status verify.completed = true
-
-### 4. Review
-- reviewer subagent (context: fork) 호출
-- 5축 리뷰: correctness, readability, architecture, security, performance
-- CRITICAL 이슈 발견 시 즉시 수정 시도 (최대 3회)
-- CRITICAL 0건 시: gate-status review.completed = true
-
-### 5. SPEC Compliance Check (Ralph Loop) ← 핵심
-
-**Ship 전에 반드시 실행**. SPEC.md에 정의된 모든 요구사항이 실제로 구현됐는지 확인하고, 미달이면 Build로 돌아가 수정한다.
-
-#### 5.1 SPEC 파싱
-
-`docs/SPEC.md`에서 다음을 자동 추출:
-- **Objective** 섹션의 핵심 목표
-- **Features** 섹션의 각 기능 항목 (체크리스트 또는 표)
-- **Acceptance Criteria** (있으면)
-- **Boundaries > DO NOT CHANGE** 영역
-- **Non-Goals** 목록
-
-#### 5.2 구현 검증 (자동)
-
-추출된 각 항목에 대해:
-
-1. **파일 존재 확인**: 해당 기능이 구현된 파일이 프로젝트에 존재하는가? (Glob/Grep)
-2. **코드 매칭**: 기능 키워드가 소스 코드에 등장하는가? (Grep)
-3. **테스트 존재**: 해당 기능에 대한 테스트 파일이 있는가?
-4. **빌드 통과**: 프로젝트 빌드/타입체크가 PASS인가?
-5. **DO NOT CHANGE 미침범**: 보호 영역이 수정되지 않았는가?
-6. **Non-Goals 미침범**: Non-Goals에 해당하는 구현이 추가되지 않았는가?
-
-#### 5.3 결과 분류
-
-각 항목을 다음 3가지로 분류:
-- **PASS**: 구현 확인됨
-- **PARTIAL**: 파일은 있지만 불완전 (예: stub, TODO, 빈 함수)
-- **MISSING**: 구현 없음
-
-#### 5.4 Ralph Loop (반복 수정)
-
-```
-iteration = 0
-MAX_ITERATIONS = 5
-
-while MISSING 또는 PARTIAL 항목 존재:
-    iteration += 1
-    if iteration > MAX_ITERATIONS:
-        → Escalation Gate: 사용자에게 "5회 시도 후에도 미달 항목 N건" 보고
-        → 사용자 결정 대기 (계속 / 중단 / 수동 수정)
-        break
-
-    1. MISSING/PARTIAL 항목 목록 출력
-    2. 각 항목에 대해:
-       - 구현 코드 작성 (Build 단계 로직 재사용)
-       - 해당 기능의 테스트 작성
-       - 즉시 커밋
-    3. 전체 빌드/테스트 재실행
-    4. SPEC Compliance 재검증 (5.2 반복)
-    5. 결과 출력: "Iteration {iteration}: PASS {n}, PARTIAL {m}, MISSING {k}"
-
-if 모든 항목 PASS:
-    → "SPEC 정합성 100% 달성" 출력
-    → gate-status verify.completed = true (이미 안 되어있으면)
-```
-
-#### 5.5 검증 보고서
-
-각 iteration 후 보고:
-
-```
-## SPEC Compliance Report — Iteration {N}/{MAX}
-
-| # | Feature | Status | Evidence |
-|---|---------|--------|----------|
-| 1 | 노트 CRUD | PASS | src/services/note.ts:15 + tests/note.test.ts |
-| 2 | 카테고리 트리 | PARTIAL | src/components/Sidebar.tsx 있지만 중첩 미구현 |
-| 3 | FTS 검색 | MISSING | 검색 관련 파일 없음 |
-
-PASS: X / PARTIAL: Y / MISSING: Z
-Next: {Y+Z}건 수정 후 재검증
-```
-
-### 6. Ship (SPEC 100% 달성 후)
-- agentshield-gate 자동 실행 (CRITICAL 차단)
-- spec-drift-check ship 모드 실행
-- 전부 통과 시: gate-status ship.completed = true
-- 최종 커밋 + 태그 제안
-
-### 7. Post-Ship: CLAUDE.md 리뷰 (자동)
-Ship 완료 후 CLAUDE.md를 자동 검토한다:
-
-1. **instinct 확인**: `/ecc:instinct-status` 실행 → confidence ≥ 0.8인 instinct를 CLAUDE.md 또는 `.claude/rules/` 반영 후보로 제안
-2. **패턴 체크**: 이번 세션에서 반복된 교정/실수 패턴이 있으면 CLAUDE.md에 추가 제안
-3. **모순 검출**: 기존 CLAUDE.md 지시와 이번 세션 행동이 충돌한 부분 보고
-4. **rules-distill**: ECC `rules-distill` 스킬로 현재 스킬에서 cross-cutting 원칙 추출 가능성 확인
-
-**제약**: 제안만. 직접 수정 금지 (인간 승인 필수). 변경 제안을 사용자에게 목록으로 출력.
-
-**예시 출력**:
-```
-## CLAUDE.md 개선 제안 (Post-Ship Review)
-
-1. [instinct] "Rust 에러는 Result<T, E> 반환 강제" (confidence 0.85) → error-handling rule 보강 후보
-2. [반복 교정] 사용자가 3회 "커밋 먼저 해" 교정 → commit-policy 강조 필요
-3. [모순 없음]
-4. [rules-distill] 해당 없음
-
-승인 시 적용할 항목 번호를 알려주세요 (또는 "skip"):
-```
-
-## 자동 재시도 (Revision Gate 패턴)
-
-각 단계에서 실패 시:
-1. 원인 분석 + 즉시 수정 시도
-2. 최대 **3회** 재시도 (단계별)
-3. SPEC Compliance Loop는 **최대 5회** (전체 루프)
-4. 초과 시 **사용자에게 escalation** (Escalation Gate)
-5. 사용자 응답 대기
-
-## 중단 조건 (Abort Gate)
-
-- SPEC.md 300줄 초과 → spec-scaling 제안 + 중단
-- 동일 이슈 3회 연속 미해결 → escalation
-- SPEC Compliance 5회 반복 후 MISSING 잔존 → escalation
-- 사용자 Ctrl+C → 현재 상태 보존
-
-## Arguments
-
-```
-/uzys:auto                  # Plan부터 시작 (기본)
-/uzys:auto from=build       # Build부터 (Plan 이미 완료 시)
-/uzys:auto from=test        # Test부터
-/uzys:auto from=review      # Review부터
-/uzys:auto from=ship        # Ship부터 (SPEC compliance 포함)
-/uzys:auto from=verify      # SPEC compliance check만 실행
-```
-
-## Ralph Loop 동작 요약
-
-```
-/uzys:spec (사용자)
-    ↓
-/uzys:auto (자동 시작)
-    ↓
-  Plan → Build → Test → Review
-    ↓
-  SPEC Compliance Check ← Ralph Loop 진입
-    ↓         ↑
-  MISSING?  → Build로 돌아가 수정 → Test → 재검증
-    ↓ (PASS)
-  Ship
-```
-
-**핵심**: Ship은 SPEC.md의 **모든 Feature가 PASS일 때만** 진입 가능. 한 건이라도 MISSING이면 Build로 돌아가 구현. 이 루프가 "될 때까지 계속 돈다".
-
-## 참조
-
-- gate-check.sh는 `/uzys:auto`를 게이트 체크 대상에서 **제외**. auto 커맨드가 내부에서 gate-status를 직접 관리.
-- 각 단계의 상세 동작은 개별 `/uzys:plan`, `/uzys:build` 등의 커맨드 정의를 따른다.
-- gates-taxonomy.md의 4유형 게이트 (Pre-flight/Revision/Escalation/Abort) 적용.
-- verification-loop 스킬 (ECC): Build→Type→Lint→Test→Security→Diff 6단계 검증 사이클. SPEC compliance check 내에서 활용.
-- P9 Circuit Breakers: 5회 반복 상한. 무한 루프 방지.

package/templates/commands/uzys/build.md

@@ -1,42 +0,0 @@
-Build phase — TDD로 점진적 구현한다.
-
-## Gate Check
-
-`docs/todo.md`가 존재하는지 확인한다. 없으면 "Plan 단계(`/uzys:plan`)를 먼저 완료하세요" 경고.
-
-## Process
-
-1. `docs/todo.md`에서 다음 미완료 task를 선택한다.
-2. agent-skills의 incremental-implementation + test-driven-development 스킬을 따른다:
-   - RED: 실패하는 테스트 먼저 작성
-   - GREEN: 테스트를 통과하는 최소 구현
-   - REFACTOR: 코드 개선 (테스트 유지)
-3. 완료된 task를 todo.md에서 체크한다.
-4. **git-policy.md 적용: 즉시 commit → push**. issue_tracking enabled 시 commit message에 issue 번호 포함:
-   - 진행 중: `<type>: 설명 (refs #N)`
-   - task 완전 완료: PR에서 `Closes #N` 권장 (commit 단위 close 지양)
-5. Build 중 새 bug/feature 발견 → `gh-issue-workflow` skill로 backlog 등록 (5섹션 ISSUE 템플릿). 현재 작업 흐름 깨지 않고 비동기 기록.
-
-## Context-Aware Skill Selection
-
-현재 편집 중인 파일에 따라 추가 스킬을 자동 활성화:
-
-| 파일 유형 | 추가 활성화 |
-|-----------|------------|
-| `.tsx`, `.jsx`, `.html`, `.css` | frontend-ui-engineering 스킬 + DESIGN.md/.impeccable.md 참조 |
-| API 라우트, 엔드포인트 | api-and-interface-design 스킬 |
-| 외부 라이브러리 사용 | source-driven-development 스킬 (공식 문서 확인) |
-
-## Auto-Actions
-
-- SPEC.md가 300줄 초과 시 spec-scaling 스킬로 분리 제안.
-- 커밋 없이 다음 task로 넘어가면 경고.
-- 각 task 완료 시 todo.md 자동 업데이트.
-
-## Gate Status Update
-
-이 단계가 성공적으로 완료되면 `.claude/gate-status.json`의 `build.completed`를 `true`로, `build.timestamp`를 현재 시각으로 업데이트한다.
-
-```bash
-jq '.build.completed = true | .build.timestamp = now | .build.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json
-```

package/templates/commands/uzys/plan.md

@@ -1,55 +0,0 @@
-Plan phase — 작업을 검증 가능한 작은 단위로 분해한다.
-
-## Gate Check
-
-`docs/SPEC.md`가 존재하는지 확인한다. 없으면 "Define 단계(`/uzys:spec`)를 먼저 완료하세요" 경고.
-
-## Plan Depth — 변경 복잡도에 맞춰라
-
-모든 SPEC을 동일하게 분해하지 않는다. 복잡도별로 plan 깊이를 조정:
-
-| 복잡도 | 신호 | Plan 형태 |
-|--------|------|----------|
-| **Trivial** | diff를 1문장으로 설명 가능 / single file / 명확한 fix | **Plan skip 가능**. todo.md에 1-task entry만 (또는 plan 단계 자체 건너뛰기 사용자 합의 시) |
-| **Standard** | multi-file / 여러 모듈 / unfamiliar 코드 일부 | **Milestone plan** (3-5개 outcome). per-task AC는 milestone 수준 |
-| **Complex** | 새 기능 / cross-cutting / ambiguous 요구사항 | **Detailed plan** (vertical slice 10+ task, per-task AC, 의존성 그래프) |
-
-판단 기준: Anthropic best practices — *"if you can describe the diff in one sentence, skip the plan"*. Opus급 모델은 자율 분해 가능하므로 micro-task 강제 시 ceremony가 됨.
-
-## Process
-
-1. SPEC.md를 읽고 전체 범위 + **복잡도** 판정 (위 표).
-1.5. **GitHub Issue 우선 fetch (issue_tracking: enabled 시)**:
-   - `gh issue list --state open --json number,title,body,labels` 호출
-   - 각 issue body에서 `방향성 (YYYY-MM-DD 확정)` 패턴 grep — 확정된 것만 후보
-   - 전제(Given) 미충족 issue 제외
-   - 우선순위 정렬 (label P0 > P1 > P2 > unlabeled)
-   - 상위 1-3개 issue → todo.md 진입 후보
-2. **Trivial이면**: todo.md만 생성하고 즉시 Build로. plan.md는 1-2줄.
-3. **Standard/Complex이면**: agent-skills의 planning-and-task-breakdown 스킬을 따라 분해:
-   - Vertical slicing: 수평 레이어가 아닌 수직 기능 단위
-   - 각 task에 Acceptance Criteria 정의 (Standard는 milestone 수준, Complex는 task 수준)
-   - 의존성 순서 정렬
-4. **North Star 4-gate 체크 (Complex 복잡도 + `docs/NORTH_STAR.md` 존재 시)**:
-   - 신규 기능/task가 NORTH_STAR.md §5 Decision Heuristics의 4-gate(Trend/Persona/Capability/Lean)를 모두 통과하는가?
-   - 1개 이상 fail 시 사용자에게 보고 후 결정 대기 (자동 진행 금지)
-   - NORTH_STAR.md 부재 시 skip
-5. Sprint Contract: 범위(포함/제외) + 완료 기준 + 제약 조건.
-6. `docs/plan.md` + `docs/todo.md` 생성.
-
-## Output
-
-- `docs/plan.md` — 전체 계획, Phase 분해, 의존성
-- `docs/todo.md` — 체크리스트 형태의 할 일 목록
-
-## Gate
-
-plan.md + todo.md가 존재하고, 최소 1개 task가 정의되어 있어야 완료.
-
-## Gate Status Update
-
-이 단계가 성공적으로 완료되면 `.claude/gate-status.json`의 `plan.completed`를 `true`로, `plan.timestamp`를 현재 시각으로 업데이트한다.
-
-```bash
-jq '.plan.completed = true | .plan.timestamp = now | .plan.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json
-```

package/templates/commands/uzys/review.md

@@ -1,44 +0,0 @@
-Review phase — 다중 관점 리뷰로 품질을 검증한다.
-
-## Gate Check
-
-Verify 단계가 완료되었는지 확인한다. 테스트가 통과하지 않았으면 경고.
-
-## Process
-
-1. agent-skills의 code-review-and-quality + security-and-hardening 스킬을 활성화한다.
-2. **reviewer subagent를 호출한다** (SOD: 구현과 검증 분리):
-   - reviewer는 context: fork로 격리 실행
-   - 5축 리뷰: correctness, readability, architecture, security, performance
-3. 프로젝트 레벨 에이전트도 활성화:
-   - code-reviewer (ECC, sonnet): 일상적 코드 리뷰
-   - security-reviewer (ECC, sonnet): OWASP Top 10, 보안 패턴
-4. 산출물 유형에 따라 리뷰 관점 자동 선택:
-   - 코드: 5축 리뷰
-   - 문서/제안서: 논리 흐름, 설득력, 범위 커버리지
-   - UI: 디자인 일관성, 접근성, 반응형
-5. **UI 변경이 있고 `docs/visual-review-<phase>.md`가 존재**하면 visual review 결과를 입력으로 흡수:
-   - REGRESSION 1건이라도 있으면 **Review Gate 차단** (CRITICAL과 동급)
-   - CHANGED 항목은 의도성 검증 (커밋 메시지/PR 본문과 매칭)
-   - 부재 시 ui-visual-review skill 호출 권유 (UI Track 한정)
-
-## Severity Classification
-
-| Severity | Action |
-|----------|--------|
-| CRITICAL | 즉시 수정 필수. Review 게이트 통과 불가 |
-| HIGH | 수정 권장. 합리적 사유 있으면 예외 가능 |
-| MEDIUM | 제안. 현재 PR에서 안 해도 됨 |
-| LOW | 참고 |
-
-## Gate
-
-CRITICAL 이슈 0건이어야 Review 게이트 통과.
-
-## Gate Status Update
-
-이 단계가 성공적으로 완료되면 `.claude/gate-status.json`의 `review.completed`를 `true`로, `review.timestamp`를 현재 시각으로 업데이트한다.
-
-```bash
-jq '.review.completed = true | .review.timestamp = now | .review.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json
-```

package/templates/commands/uzys/ship.md

@@ -1,49 +0,0 @@
-Ship phase — 프리런치 체크리스트 실행 후 배포한다.
-
-## Gate Check
-
-Review 단계가 완료되었는지 확인한다. CRITICAL 이슈가 남아 있으면 경고.
-
-## Process
-
-1. agent-skills의 shipping-and-launch 스킬을 활성화한다.
-2. `.claude/rules/ship-checklist.md` 게이트를 순차 확인:
-
-   - [ ] E2E 테스트 전부 PASS
-   - [ ] test-policy.md 커버리지 기준 충족
-   - [ ] `npx ecc-agentshield scan` — CRITICAL/HIGH 없음
-   - [ ] SPEC.md/PRD.md 대비 배포 항목 일치 확인
-
-3. 하나라도 실패하면 배포 차단 + 실패 항목 보고.
-
-4. 전부 통과하면:
-   - Railway MCP/플러그인으로 배포 (Railway 사용 시)
-   - Health check 엔드포인트 응답 확인
-   - 배포 후 smoke test
-
-5. Post-Ship:
-   - SPEC/PRD 불일치 발견 시 → 업데이트 후 커밋
-   - 아키텍처 결정이 있었으면 → `docs/decisions/` 에 ADR 기록
-   - Change Log 최종 확정
-
-## Issue Closure (issue_tracking: enabled 시)
-
-PR body에 다음 컨벤션 강제 — 머지 시 GitHub Issue 자동 close:
-- 완전 해결: `Closes #N` 또는 `Fixes #N`
-- 부분 진행 (close 안 함): `Refs #N`
-- 후속 issue 분기 시 원본 issue body의 "후속 작업" 섹션에 `#M` cross-link
-
-`gh-issue-workflow` skill의 PR 컨벤션 검증 — 머지 직전 PR body grep으로 1건이라도 issue 참조 누락이면 경고.
-
-## Hotfix Mode
-
-긴급 수정 시 Build → Verify → Ship 단축 경로 허용.
-Define/Plan/Review 게이트 건너뛰기 가능하지만, Verify(테스트)는 필수.
-
-## Gate Status Update
-
-이 단계가 성공적으로 완료되면 `.claude/gate-status.json`의 `ship.completed`를 `true`로, `ship.timestamp`를 현재 시각으로 업데이트한다.
-
-```bash
-jq '.ship.completed = true | .ship.timestamp = now | .ship.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json
-```

package/templates/commands/uzys/spec.md

@@ -1,93 +0,0 @@
-Define phase — 구조화된 스펙을 코드 작성 전에 작성한다.
-
-## Process
-
-1. 요청이 모호하면 먼저 아이디어를 정제한다 (agent-skills idea-refine 패턴 활용).
-2. agent-skills의 spec-driven-development 스킬을 따라 SPEC.md를 작성한다.
-   - 6가지 핵심 영역: Objective, Commands, Project Structure, Code Style, Testing Strategy, Boundaries
-3. 대형 프로젝트(비즈니스 맥락 필요)면 PRD 템플릿(Docs/dev/PRD-TEMPLATE-standalone.md)을 참조하여 확장.
-4. Non-Goals를 반드시 명시한다 — "미언급 = 범위 밖" 원칙.
-5. DO NOT CHANGE 영역을 식별하고 SPEC에 기록한다.
-6. SPEC.md를 `docs/SPEC.md`에 저장한다.
-
-## Pre-SPEC 필수 접수 (UI/Test/E2E)
-
-SPEC 작성 **전에** 다음 항목을 사용자에게 질문하고 SPEC에 기록한다. 미기재 시 SPEC 미완료 — Build 단계에서 drift 버그로 이어짐.
-
-### A. Test Environment Parity
-
-1. **Prod DB 엔진** — Postgres/MySQL/SQLite/Redis 등 + 버전
-2. **테스트 DB 전략** — testcontainer / docker-compose / staging DB / none. SQLite 대체는 Prod가 SQLite인 경우에만 허용 (test-policy.md Dev-Prod Parity)
-3. **외부 의존성** — Stripe, Supabase, Railway, SES 등. 각각 Mock / Live staging 중 어떤 전략인지
-
-→ SPEC.md "Testing Strategy" 섹션에 표로 정리.
-
-### B. 핵심 E2E 플로우
-
-- **Mock 금지 대상 목록**: 인증(login/callback/me), 결제(checkout/webhook), 파일업로드 등
-- 각 플로우별 성공 기준 (예: "login → /me 200 + user_id 일치")
-
-→ SPEC.md "Testing Strategy"의 E2E 하위 목록으로.
-
-### C. Design Context (UI Track인 경우)
-
-UI 포함 Track(csr-*/ssr-*/full)이면 SPEC 전에 다음 확인:
-
-1. **`DESIGN.md` 존재 여부** — 디자인 방향/톤/레이아웃 원칙 기록. 없으면 `/teach` 또는 `/shape` 스킬로 먼저 작성 유도
-2. **`.impeccable.md` 존재 여부** — 브랜드/청중/톤 컨텍스트. 없으면 `/teach` 선행
-3. **디자인 참조물** — Figma 링크, 스크린샷, 경쟁사 레퍼런스 등
-
-디자인 컨텍스트 없이 UI 코드 작성 금지. Generic AI 미학 산출물 방지.
-
-### D'. GitHub Issue Tracking (선택)
-
-`git remote -v`로 GitHub remote 확인 가능 + 사용자가 issue를 backlog/소통 채널로 쓰고 싶으면:
-
-- `docs/SPEC.md`에 `issue_tracking: enabled` 라인 명시 (opt-in)
-- 활성화 시 `gh-issue-workflow` skill이 `/uzys:plan`, `/uzys:build`, `/uzys:ship`에서 자동 결합
-- ISSUE 본문은 `templates/skills/gh-issue-workflow/ISSUE.template.md`의 5섹션(배경/전제/방향성/AC/후속) 강제
-
-기본은 비활성. SPEC에 명시 없으면 모든 단계에서 skip.
-
-### D. North Star (선택, 대형 프로젝트 권장)
-
-`docs/NORTH_STAR.md` 부재 + 다음 중 1개 이상 해당 시 작성 권장:
-
-- 6개월 이상 지속 예상되는 프로젝트
-- 복수 Phase / 복수 사용자 / 외부 의존성이 명확한 경우
-- 신규 기능 우선순위 결정이 잦을 것으로 예상
-
-작성 시 `north-star` 스킬 호출 → `templates/skills/north-star/NORTH_STAR.template.md`를 `docs/NORTH_STAR.md`로 복사 후 7개 섹션(NS Statement / NSM / Will-Won't / Phase / 4-gate / Versioning / Changelog) 채움. 단순 1회성 작업이면 skip.
-
----
-
-위 A/B/C **세 블록은 SPEC 작성 전 접수** (D는 선택). 답변 없으면 "이 항목 정의가 필요합니다" 질문으로 돌아가 반복. 모두 수집된 후에 본 SPEC 작성 진행.
-
-## Gate
-
-이 단계가 완료되어야 `/uzys:plan`으로 진행 가능.
-SPEC.md가 존재하고, 최소 Objective + Boundaries가 정의되어 있어야 완료.
-
-## Auto-Actions
-
-- SPEC.md가 300줄을 초과하면 spec-scaling 스킬로 기능별 분리 제안.
-- change-management.md 규칙 적용: 이후 SPEC 변경 시 CR 분류.
-
-## Gate Status Update
-
-이 단계가 성공적으로 완료되면 `.claude/gate-status.json` 을 다음 두 동작으로 갱신한다:
-
-1. `define.completed = true` + `define.timestamp = now`
-2. **후속 5단계 (`plan` / `build` / `verify` / `review` / `ship`) 모두 리셋** — `completed = false`, `timestamp = null`
-
-**원칙**: SPEC 재정의 = 새 cycle 시작 = 후속 모든 게이트 리셋. 이전 cycle 의 ship 완료 상태가 새 cycle 게이트를 만족시키는 정합성 위반을 차단한다 (gate bypass 방지).
-
-```bash
-jq '.define.completed = true
-    | .define.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))
-    | .plan.completed   = false | .plan.timestamp   = null
-    | .build.completed  = false | .build.timestamp  = null
-    | .verify.completed = false | .verify.timestamp = null
-    | .review.completed = false | .review.timestamp = null
-    | .ship.completed   = false | .ship.timestamp   = null' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json
-```

package/templates/commands/uzys/test.md

@@ -1,58 +0,0 @@
-Verify phase — TDD 워크플로우와 Track별 커버리지 게이트를 실행한다.
-
-## Process
-
-1. agent-skills의 test-driven-development 스킬을 따른다.
-2. agent-skills의 **test-engineer 에이전트**를 활성화하여 테스트 전략 설계, 시나리오 분석(happy path, boundary, error path, concurrency)을 수행한다.
-3. `.claude/rules/test-policy.md`의 Track별 커버리지 기준을 참조한다:
-   - UI 컴포넌트: 60%
-   - API 엔드포인트: 80%
-   - 비즈니스 로직: 90%
-3. 브라우저 테스트가 필요한지 판단한다:
-   - UI 변경이 있으면 → browser-testing 스킬 + Playwright 활성화
-   - API/로직만이면 → unit/integration 테스트만
-4. 전체 테스트 스위트를 실행하고 결과를 보고한다.
-5. 커버리지가 기준 미달이면 추가 테스트 작성을 제안한다.
-
-## 핵심 사용자 기능 플로우 E2E (필수)
-
-다음 플로우가 프로젝트에 존재하면 **실환경(staging 또는 로컬 docker-compose) Live E2E 1건 이상 필수**:
-
-- **인증**: login → magic-link/OAuth callback → /me (또는 보호된 엔드포인트) 200
-- **결제**: checkout → webhook → refund (존재 시)
-- **외부 API 의존 플로우**: Stripe, Supabase, Railway, SES 등
-
-검증 방식: Mock이 아닌 실제 서비스 호출. unit/integration의 Mock 테스트는 보조.
-Prod가 Postgres면 테스트도 Postgres (testcontainer/docker-compose) — test-policy.md Dev-Prod Parity 준수.
-
-## UI Visual Review (UI Track 자동)
-
-Track이 csr-*/ssr-*/full이고 E2E 테스트가 PASS인 경우, **`ui-visual-review` 스킬 호출 권유**:
-
-- 핵심 화면 N개 자동 캡처 (chrome-devtools MCP 또는 Playwright)
-- 이전 baseline과 diff (해시 → pixelmatch → 시각 비교 단계적)
-- 에이전트 1차 판정 (REGRESSION / CHANGED / PASS)
-- `docs/visual-review-<phase>.md` 보고서 → 사용자 승인 게이트
-
-`docs/visual-pages.json` 부재 시 skill 첫 실행에서 핵심 화면 목록 질의. `data`/`tooling`/`executive` Track은 skip.
-
-## Bug Fix Mode
-
-버그 수정 시 Prove-It 패턴:
-1. 버그를 재현하는 테스트 작성
-2. 테스트가 실패하는지 확인 (버그 존재 증명)
-3. 수정 구현
-4. 테스트가 통과하는지 확인
-5. 가드 테스트로 유지
-
-## Gate
-
-모든 테스트 PASS + 커버리지 기준 충족 시 완료.
-
-## Gate Status Update
-
-이 단계가 성공적으로 완료되면 `.claude/gate-status.json`의 `verify.completed`를 `true`로, `verify.timestamp`를 현재 시각으로 업데이트한다.
-
-```bash
-jq '.verify.completed = true | .verify.timestamp = now | .verify.timestamp = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))' .claude/gate-status.json > /tmp/gate-tmp.json && mv /tmp/gate-tmp.json .claude/gate-status.json
-```

package/templates/hooks/agentshield-gate.sh

@@ -1,101 +0,0 @@
-#!/bin/bash
-# ============================================================
-# agentshield-gate.sh — PreToolUse Skill hook (uzys:ship 차단)
-#
-# 목적: /uzys:ship Skill 실행 전 ECC AgentShield 보안 스캔 실행.
-#       CRITICAL 발견 + .agentshield-ignore 미매칭 시 exit 2.
-#
-# 입력: PreToolUse stdin JSON (Skill hook)
-# 출력: stderr 경고 + exit 2 (차단) 또는 exit 0 (통과)
-#
-# 활성화 조건:
-#   1. 이 hook이 settings.json Skill matcher에 등록
-#   2. npx 명령 사용 가능 (Node.js 환경)
-#
-# False-positive 허용:
-#   .agentshield-ignore 파일 — 한 줄에 하나의 정규식.
-#   매칭되는 finding은 CRITICAL이어도 무시.
-# ============================================================
-set -u
-
-# Skill 이름 파싱 — uzys:ship 만 대상
-INPUT=$(cat 2>/dev/null || echo "{}")
-SKILL_NAME=""
-if command -v jq &>/dev/null; then
-  SKILL_NAME=$(echo "$INPUT" | jq -r '.tool_input.skill // empty' 2>/dev/null || echo "")
-else
-  SKILL_NAME=$(echo "$INPUT" | grep -oE '"skill"[[:space:]]*:[[:space:]]*"[^"]*"' | sed -E 's/.*"([^"]*)"$/\1/')
-fi
-
-# 대상 아니면 즉시 통과
-case "$SKILL_NAME" in
-  uzys:ship) ;;
-  *) exit 0 ;;
-esac
-
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-IGNORE_FILE="$PROJECT_DIR/.agentshield-ignore"
-SCAN_LOG="/tmp/agentshield-scan-$$.log"
-
-cd "$PROJECT_DIR" || exit 0
-
-# npx ecc-agentshield 실행 (타임아웃 안전 장치 없음 — ship 시점이라 사용자 대기 허용)
-if ! command -v npx &>/dev/null; then
-  echo "[agentshield-gate] npx not found — scan skipped (manual review required)" >&2
-  exit 0
-fi
-
-npx ecc-agentshield@1.4.0 scan > "$SCAN_LOG" 2>&1 || true
-
-# CRITICAL 섹션에서 finding 라인 추출
-CRITICAL_FINDINGS=$(awk '
-  /● CRITICAL/ { in_crit=1; next }
-  /● HIGH|● MEDIUM|● LOW|● INFO/ { in_crit=0 }
-  in_crit && /^[[:space:]]*●/ { print }
-' "$SCAN_LOG")
-
-if [ -z "$CRITICAL_FINDINGS" ]; then
-  rm -f "$SCAN_LOG"
-  echo "[agentshield-gate] No CRITICAL findings. Ship allowed." >&2
-  exit 0
-fi
-
-# ignore 파일 매칭
-FILTERED_FINDINGS=""
-while IFS= read -r line; do
-  [ -z "$line" ] && continue
-  MATCHED=false
-  if [ -f "$IGNORE_FILE" ]; then
-    while IFS= read -r pattern; do
-      # 빈 라인 / 주석 skip
-      case "$pattern" in
-        ""|"#"*) continue ;;
-      esac
-      # v26.11.2 — grep -F (fixed string) — `.*` 같은 regex로 모든 finding bypass 차단 (M4)
-      if echo "$line" | grep -qF "$pattern"; then
-        MATCHED=true
-        break
-      fi
-    done < "$IGNORE_FILE"
-  fi
-  if [ "$MATCHED" = false ]; then
-    FILTERED_FINDINGS="$FILTERED_FINDINGS$line"$'\n'
-  fi
-done <<< "$CRITICAL_FINDINGS"
-
-if [ -z "$FILTERED_FINDINGS" ]; then
-  rm -f "$SCAN_LOG"
-  echo "[agentshield-gate] CRITICAL findings all matched .agentshield-ignore. Ship allowed." >&2
-  exit 0
-fi
-
-# BLOCK
-echo "[agentshield-gate] BLOCKED: CRITICAL security findings detected" >&2
-echo "" >&2
-echo "$FILTERED_FINDINGS" >&2
-echo "" >&2
-echo "다음 조치 중 하나 필요:" >&2
-echo "  1. 실제 취약점 수정" >&2
-echo "  2. false-positive인 경우 .agentshield-ignore에 정규식 추가" >&2
-echo "  3. 스캔 로그 확인: $SCAN_LOG" >&2
-exit 2