@walwal-harness/cli 6.1.5 → 7.1.0

package/skills/evaluator-visual/SKILL.md

@@ -1,165 +0,0 @@
----
-name: harness-evaluator-visual
-description: "하네스 Visual Evaluator. Playwright MCP로 스크린샷, 반응형 검증, 접근성 트리 분석, AI슬롭 감지를 수행한다. Evaluator-Functional이 PASS한 후에만 실행. 기준 미달 = FAIL → Generator-Frontend 재작업."
-disable-model-invocation: false
----
-
-# Evaluator-Visual — Design & Accessibility
-
-## progress.json 업데이트 규칙 (v5.6.3+)
-
-⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
-덮어쓰면 `mode` / `company_state` / 기타 top-level 필드가 누락되어 회사모드 병렬 루프가
-끊기는 등 런타임 오류가 발생한다.
-
-**올바른 방법** — 반드시 partial update 로 갱신:
-
-```bash
-# 헬퍼 스크립트 (권장)
-bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
-
-# 또는 직접 jq 로 partial update
-jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
-```
-
-위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
-
-## Session Boundary Protocol
-
-### On Start
-1. `.harness/progress.json` 읽기 — `next_agent`가 `"evaluator-visual"`인지 확인
-2. progress.json 업데이트: `current_agent` → `"evaluator-visual"`, `agent_status` → `"running"`, `updated_at` 갱신
-
-### On Complete (PASS)
-1. **Screenshot Cleanup** — 이번 평가에서 `browser_take_screenshot` 으로 생성한 모든 PNG/JPEG 파일 삭제:
-   ```bash
-   find . -maxdepth 3 \( -name "screenshot*.png" -o -name "screenshot*.jpg" -o -name "playwright-*.png" \) -newer .harness/progress.json -delete 2>/dev/null
-   ```
-   판정 증거는 `evaluation-visual.md` 에 텍스트로 기술 — 파일은 남기지 않는다.
-2. progress.json 업데이트:
-   - `agent_status` → `"completed"`
-   - `completed_agents`에 `"evaluator-visual"` 추가
-   - `next_agent` → `"archive"`
-   - `failure` 필드 초기화
-3. `feature-list.json`의 통과 feature `passes`에 `"evaluator-visual"` 추가
-4. `.harness/progress.log`에 PASS 요약 추가
-5. 출력: `"✓ Evaluator-Visual PASS. 자동 핸드오프 (Conductor 자율 시동) (아카이브)."`
-6. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 아카이브 단계로 자동 핸드오프** (회사모드 내부 핸드오프).
-
-### On Fail
-1. **Screenshot Cleanup** — PASS 와 동일하게 스크린샷 파일 삭제 (FAIL 시에도 정리 필수).
-2. progress.json 업데이트:
-   - `agent_status` → `"failed"`
-   - `failure.agent` → `"evaluator-visual"`
-   - `failure.location` → `"frontend"` (비주얼 = 항상 프론트)
-   - `failure.message` → 실패 요약 (1줄)
-   - `failure.retry_target` → `"generator-frontend"`
-   - `next_agent` → `"generator-frontend"`
-   - `sprint.retry_count` 증가
-3. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
-4. `.harness/progress.log`에 FAIL 요약 추가
-5. 출력: `"✖ Evaluator-Visual FAIL. 자동 핸드오프 (Conductor 자율 시동) (재작업 대상으로 라우팅)."`
-6. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 `failure.retry_target` 으로 자동 핸드오프** (회사모드 내부 핸드오프).
-
-## FE Playwright Mandatory Rule (v5.4)
-
-**웹 렌더링 가능한 FE Feature에 대해서는 Playwright MCP 사용이 강제**된다 (`validation.visual.enabled == true` 또는 전통 웹 스택).
-
-- 필수 호출: `mcp__playwright__browser_navigate` + `mcp__playwright__browser_take_screenshot` (AC당 최소 1장) + 레이아웃/반응형 검증을 위한 `browser_resize`.
-- 접근성: `browser_snapshot`으로 accessibility tree 확보 후 axe-core 평가 연결.
-- **금지**: 스크린샷/스냅샷 없이 "코드만 봐서 OK" 처리.
-- `evaluation-visual.md`에 사용한 playwright 도구 이름과 뷰포트/URL을 명시. 도구 호출 증거 없으면 해당 기준 자동 0점.
-- `validation.visual.enabled == false`인 네이티브 스택은 Visual Skip Flow 적용 (예외).
-
-## Startup
-
-1. `AGENTS.md` 읽기
-2. `CONVENTIONS.md` (루트) 읽기 — 프로젝트 최상위 원칙 (있을 때만)
-3. `.harness/conventions/shared.md` + `.harness/conventions/evaluator-visual.md` — **긍정 하우스 스타일 적용**
-4. `.harness/gotchas/evaluator-visual.md` 읽기 — **과거 실수 반복 금지**
-5. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
-6. `actions/evaluation-functional.md` — Verdict: PASS 확인
-7. **Stack-Adaptive Gate** (v5.2) — `scan-result.json.tech_stack` 으로 스택 확인 후 `.harness/ref/fe-<stack>.md` 의 `validation.visual` 파싱:
-   - `visual.enabled == false`: 즉시 **MANUAL_REQUIRED 모드** 로 전환 — 아래 "Visual Skip Flow" 수행 후 종료
-   - `visual.enabled == true` (또는 ref-docs 없이 웹 전통 스택): 계속 진행, ref 에 `visual.base_url` 이 있으면 그 URL 로, 없으면 `ref.runner.dev_command` 로 서버 기동 후 Playwright 접속
-
-## Visual Skip Flow (네이티브 앱 / 비-브라우저 스택)
-
-`validation.visual.enabled == false` (예: Swift macOS, Flutter mobile, CLI 앱) 인 경우:
-
-1. Playwright 스크린샷·axe-core·AI슬롭 감지 **전부 skip**
-2. `.harness/actions/evaluation-visual.md` 에 다음을 기록:
-   ```
-   VERDICT: MANUAL_REQUIRED
-   STACK: <stack>
-   REASON: {ref.validation.visual.reason}
-   MANUAL_CHECK: {ref.validation.visual.manual_check}
-   ```
-3. progress.json: `agent_status = "completed"`, `next_agent = "archive"` (PASS 경로와 동일 라우팅)
-4. `progress.log` 에 `"visual skipped (manual required)"` 이벤트 기록
-5. 사용자에게 `manual_check` 문자열 출력 + 확인 요청
-
-## Evaluation Steps
-
-1. **Full Page Capture** — 모든 라우트 Desktop 스크린샷
-2. **Responsive Check** — 375px / 768px / 1280px 3 breakpoint
-3. **Design Consistency** — 색상, 타이포, 간격, 모서리 통일성
-4. **AI Slop Detection** — 감점 패턴 감지
-5. **Accessibility** — 시맨틱 HTML, 키보드 네비게이션, 색상 대비
-
-반응형 체크리스트 → [참조](references/responsive-checklist.md)
-채점 기준 → [스코어링 루브릭](references/scoring-rubric.md)
-
-## Scoring
-
-| 차원 | 가중치 | 하드 임계값 |
-|------|--------|------------|
-| Design Consistency | 30% | 6/10 |
-| Responsiveness | 25% | 7/10 |
-| Accessibility | 25% | 6/10 |
-| Originality | 20% | 5/10 |
-
-**어떤 차원이든 하드 임계값 미달 → FAIL**
-
-## Auto Gotcha Registration — v5.7.1+
-
-**필수 emission**: `actions/evaluation-visual.md` 끝부분에 `gotcha_candidates` JSON 블록을 반드시 포함 (후보 없으면 `[]`). `harness-next.sh` 가 Evaluator 완료 직후 이 블록을 스캔해 자동 등록한다.
-
-````
-```gotcha_candidates
-[
-  {
-    "target": "generator-frontend",
-    "rule_id": "fe-contrast-fail",
-    "title": "텍스트 대비 WCAG AA 미달",
-    "wrong": "버튼 #888 on #aaa — 3.0:1 (AA 4.5:1 미만)",
-    "right": "primary 버튼은 body 컬러 대비 4.5:1 이상 보장. Tailwind tokens 활용.",
-    "why": "접근성은 Evaluator-Visual 하드 임계",
-    "scope": "모든 인터랙티브 엘리먼트",
-    "source": "evaluator-visual:F-004"
-  }
-]
-```
-````
-
-등록 규칙:
-- `target`: 실수를 반복할 대상 에이전트 (일반적으로 `generator-frontend`, 디자인 토큰 결함은 `planner`).
-- `rule_id`: dedup 키.
-- 신규 항목은 `Status: unverified`. Planner 리뷰 후 `verified` 승격.
-- **FAIL 시**: 실패 근본 원인 1건 이상 반드시 등록.
-- **PASS 시**: 감지된 경미한 디자인 편차가 있으면 등록 (반복 방지).
-
-## After Evaluation
-
-- **PASS** → Session Boundary Protocol On Complete (PASS) 실행
-- **FAIL** → Session Boundary Protocol On Fail 실행
-
-## ⚠ MANDATORY — 동적 Gotcha / Convention 등록
-
-evaluation-visual.md 의 끝에 **반드시 `gotcha_candidates` 와 `convention_candidates` fenced JSON 블록**을 작성한다 (비어 있으면 `[]`). harness-next.sh / Team Lead 가 자동 스캔하여 `.harness/gotchas/` `.harness/conventions/` 에 dedup append.
-
-**Visual eval 특화 검출 대상**:
-- 콘솔 에러/Hydration mismatch → `gotcha_candidates` (target=generator-frontend)
-- 디자인 토큰 불일치, 일관된 spacing/font 룰 → `convention_candidates` (scope=generator-frontend)
-
-상세 스키마 / 예시 / 필수 필드 → [공통 가이드 — dynamic-registration](../_shared/dynamic-registration.md)

package/skills/evaluator-visual/references/responsive-checklist.md

@@ -1,44 +0,0 @@
-# Responsive Checklist
-
-## Breakpoints
-
-| Breakpoint | Size | 검증 항목 |
-|------------|------|----------|
-| Mobile | 375x812 | 단일 컬럼, 터치 타겟 44px+, 햄버거 메뉴 |
-| Tablet | 768x1024 | 적응형 레이아웃, 사이드바 토글 |
-| Desktop | 1280x720 | 풀 레이아웃, 사이드바 상시 표시 |
-
-## 검증 절차
-
-각 breakpoint에서 모든 페이지:
-```
-1. browser_resize → 해당 크기
-2. browser_take_screenshot → 캡처
-3. browser_snapshot → 레이아웃 구조 확인
-```
-
-## 확인 항목
-
-- [ ] 콘텐츠 잘림 / 오버플로우 없음
-- [ ] 가로 스크롤 없음
-- [ ] 텍스트 가독성 (mobile 최소 14px)
-- [ ] 터치 타겟 크기 (mobile 44px+)
-- [ ] 네비게이션 접근성
-
-## 키보드 네비게이션
-
-```
-1. browser_press_key → Tab (반복)
-2. 포커스 이동 순서 논리적인지 확인
-3. browser_press_key → Enter (인터랙티브 요소 활성화)
-4. browser_press_key → Escape (모달 닫기)
-```
-
-## 접근성 트리 (browser_snapshot)
-
-확인:
-- 시맨틱: button, nav, main, header, footer, form
-- heading 순서: h1 → h2 → h3 (건너뛰기 없음)
-- 인터랙티브 요소에 접근 가능한 이름
-- 이미지 alt 텍스트
-- 폼 label 연결

package/skills/evaluator-visual/references/scoring-rubric.md

@@ -1,59 +0,0 @@
-# Scoring Rubric — Visual Evaluation
-
-## 차원별 채점
-
-| 차원 | 가중치 | 하드 임계값 |
-|------|--------|------------|
-| Design Consistency | 30% | 6/10 |
-| Responsiveness | 25% | 7/10 |
-| Accessibility | 25% | 6/10 |
-| Originality | 20% | 5/10 |
-
-**어떤 차원이든 하드 임계값 미달 → FAIL**
-
-## AI Slop 감점표
-
-| 패턴 | 감점 |
-|------|------|
-| 보라색/파란색 그라디언트 + 흰 카드 | -2 |
-| 과도한 box-shadow 남발 | -1 |
-| 기본 아이콘팩 무분별 사용 | -1 |
-| "Welcome to [AppName]" 히어로 | -1 |
-| 둥근 아바타 + 카드 그리드 | -1 |
-| 전체 fade-in 애니메이션 | -1 |
-| 과도한 보더/구분선 | -1 |
-
-## evaluation-visual.md 출력 형식
-
-```markdown
-# Visual Evaluation: Sprint [N]
-
-## Date / Verdict / Attempt
-
-## Responsive Check
-| Page | Mobile (375) | Tablet (768) | Desktop (1280) | Issues |
-
-## Design Consistency
-- Color Palette: [통일/혼재]
-- Typography Scale: [일관/불일관]
-- Spacing System: [체계적/비체계적]
-- Border Radius: [통일/혼재]
-
-## AI Slop Detection
-| Pattern | Found | Deduction |
-| **Total Deduction** | | **-X** |
-
-## Accessibility
-- Semantic HTML: PASS/FAIL
-- Heading Order: PASS/FAIL
-- Keyboard Navigation: PASS/FAIL
-- Color Contrast: PASS/FAIL
-- Form Labels: PASS/FAIL
-
-## Scores
-| Dimension | Score | Threshold | Status |
-
-## Failures Detail
-### [차원명]
-- Issue / Screenshot / Recommendation
-```

package/skills/generator-backend/SKILL.md

@@ -1,153 +0,0 @@
----
-name: harness-generator-backend
-description: "하네스 Backend Generator. 스택 독립(adaptive) — scan-result.json 의 be_stack / language 에 따라 .harness/ref/be-<stack>.md 를 로드해 runner/paths/api/validation 을 따른다. 모든 BE 스택(FastAPI / Django / Go / Rails / Phoenix / Spring / Express 등) 대응."
-disable-model-invocation: false
----
-
-# Generator-Backend — Adaptive (Stack-Agnostic)
-
-## progress.json 업데이트 규칙 (v5.6.3+)
-
-⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
-덮어쓰면 `mode` / `company_state` / 기타 top-level 필드가 누락되어 회사모드 병렬 루프가
-끊기는 등 런타임 오류가 발생한다.
-
-**올바른 방법** — 반드시 partial update 로 갱신:
-
-```bash
-# 헬퍼 스크립트 (권장)
-bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
-
-# 또는 직접 jq 로 partial update
-jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
-```
-
-위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
-
-## Session Boundary Protocol
-
-### On Start
-1. `.harness/progress.json` 읽기 — `next_agent` 가 `"generator-backend"` 인지 확인
-2. progress.json 업데이트: `current_agent` → `"generator-backend"`, `agent_status` → `"running"`, `updated_at` 갱신
-3. `failure` 필드 확인 — retry 인 경우 평가 문서의 실패 사유 우선 읽기
-
-### On Complete
-1. progress.json 업데이트:
-   - `agent_status` → `"completed"`
-   - `completed_agents` 에 `"generator-backend"` 추가
-   - `next_agent` → 파이프라인에 따라 (`"generator-frontend"` 또는 `"evaluator-functional"`)
-   - `failure` 필드 초기화 (retry 성공 시)
-2. `feature-list.json` 의 해당 feature `passes` 에 `"generator-backend"` 추가
-3. `.harness/progress.log` 에 요약 추가
-4. 출력: `"✓ Generator-Backend 완료. 자동 핸드오프 (Conductor 자율 시동)."`
-5. **즉시 내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 다음 에이전트로 자동 핸드오프** (회사모드 내부 핸드오프).
-
-## Startup (Adaptive Loading)
-
-1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인
-2. `CONVENTIONS.md` (루트) 읽기 — 프로젝트 최상위 원칙 (있을 때만)
-3. **Conventions 로드** — 세 파일 모두 (있는 것만):
-   - `.harness/conventions/shared.md` (모든 에이전트 공통)
-   - `.harness/conventions/generator-backend.md` (BE 스코프)
-   - `.harness/conventions/generator-backend-<stack>.md` (스택별, 선택)
-4. `.harness/actions/scan-result.json` 읽기 → `tech_stack.backend` 또는 `tech_stack.language` 로 현재 스택 확정 (이하 `<stack>`)
-5. **Ref-docs 로드** — `.harness/ref/be-<stack>.md`
-   - 파일 없음 → STOP + 안내: `"ref-docs 가 없습니다. bash init.sh init 실행 또는 bash scripts/init-ref-docs.sh --claude-prompt --stack <stack> --role be . 실행하세요."`
-   - frontmatter 파싱 실패 → 경고 출력 + 기본값으로 degrade
-6. **Gotchas 로드** — 두 파일 모두 (있는 것만):
-   - `.harness/gotchas/generator-backend.md` (공통)
-   - `.harness/gotchas/generator-backend-<stack>.md` (스택별)
-7. `.harness/memory.md` 읽기 — 프로젝트 공유 학습 규칙
-8. `pwd` + `.harness/progress.json` + `git log --oneline -20`
-9. `.harness/actions/api-contract.json` 읽기 — **이 계약이 유일한 BE 외부 인터페이스**
-10. `.harness/actions/feature-list.json` — 지정된 `FEATURE_ID` 또는 `layer: "backend"` 필터
-11. **DB / 외부 의존성 부트스트랩**:
-   - `ref.runner.install_command` 가 있으면 1회 실행
-   - `ref.runner.dev_command` 를 백그라운드 실행 (있는 경우)
-
-## Feature-Level Company Worker
-
-Team Worker 가 호출할 때 프롬프트에 `FEATURE_ID` 가 지정된다. Feature branch 에서 단일 feature 만 구현.
-
-## AGENTS.md — 읽기 전용
-
-`[BE]` + `→ Generator-Backend` 소유 경로만 쓰기 가능. 스택별 실제 소스 경로는 `ref.paths.source_roots` 가 권위 있는 출처 (예: FastAPI `app/`, Go `cmd/` + `internal/`, Rails `app/`).
-
-## Sprint Workflow
-
-1. **Sprint Contract BE 섹션 추가** — 엔드포인트 / DB 스키마 / 서비스 분할 / 성공 기준
-2. **구현** — api-contract.json ↔ 해당 스택 타입 시스템 1:1 매핑
-3. **Self-Verification** — `ref.validation.pre_eval_gate` 의 모든 명령 실행
-4. **Handoff** → Evaluator-Functional (또는 Generator-Frontend, 파이프라인에 따라)
-
-## 스택 치환 규칙 (Adaptive Core)
-
-구현 시 **모든 스택 의존 값은 ref-docs 에서 치환**한다:
-
-| 치환 키 | 출처 | 예시 |
-|---------|------|------|
-| `<source_roots>` | `ref.paths.source_roots` | FastAPI: `app/` · Go: `cmd/`, `internal/` · Rails: `app/` |
-| `<test_roots>` | `ref.paths.test_roots` | FastAPI: `tests/` · Go: `_test.go` 동거 · Rails: `spec/` |
-| `<dev_command>` | `ref.runner.dev_command` | FastAPI: `uvicorn app.main:app` · Go: `go run ./cmd/server` |
-| `<api_base_url>` | `ref.api.base_url` | 로컬 개발 baseurl (ref-docs 참조) |
-| `<pre_eval_gate>` | `ref.validation.pre_eval_gate` | FastAPI: `[ruff, mypy, pytest]` · Go: `[go vet, go test ./...]` |
-| `<anti_patterns>` | `ref.validation.anti_pattern_rules` | 스택별 grep/lint 규칙 |
-
-api-contract.json 의 DTO 스키마는 해당 스택의 타입 표현(Pydantic / struct / class-validator / ActiveRecord 등)으로 직접 매핑한다.
-
-## 서비스 간 통신 규칙
-
-- MSA 환경이면 서비스 간 **직접 DB 접근 금지** (메시지 큐 / 이벤트 / RPC 만)
-- 모놀리스 환경이면 modules/packages 경계 준수
-- 어느 쪽인지 `ref.paths.source_roots` 구조와 `ref` 본문의 "Architecture" 섹션으로 판단
-
-## 핵심 규칙 (스택 무관)
-
-- api-contract.json 에 없는 엔드포인트 **구현 금지**
-- 로깅 / 에러 핸들링 / 트랜잭션 경계 필수
-- 보안: OWASP Top 10 (인증·인가·입력 검증·SQL Injection 등) 기본 준수
-- 테스트: `ref.validation.functional_tests` 에 나열된 명령이 전부 통과해야 PASS
-
-## 금지 사항
-
-- **ref.paths.source_roots 밖의 프로덕션 코드 수정** (FE/HARNESS 영역 침범 금지)
-- api-contract.json 에 없는 엔드포인트 신설
-- `.harness/ref/` 직접 편집 (refresh 는 `bash init.sh refresh-ref` 경유)
-- 공통 `generator-backend.md` / 스택별 `generator-backend-<stack>.md` gotcha 에 적힌 실수 반복
-
-## 디버깅 / Fallback
-
-- `ref-docs` 가 placeholder 상태 → 본격 구현 전에 `bash init.sh refresh-ref be <stack>` 으로 채우기 권고
-- `scan-result.json.tech_stack_confidence == "unknown"` → 사용자에게 객관식 + 자유입력 fallback 로 스택 확인 요청
-
-## ⚠ MANDATORY — 동적 Gotcha / Convention 등록 (Generator 도 mandatory)
-
-작업 완료 시 `.harness/actions/gen-report-{FEATURE_ID}.md` 를 작성하고 끝에 **`gotcha_candidates` 와 `convention_candidates` fenced JSON 블록 두 개**를 포함한다 (비어 있으면 `[]`). harness-next.sh / Team Lead 가 자동 스캔하여 `.harness/gotchas/` `.harness/conventions/` 에 dedup append.
-
-**Generator 가 등록해야 하는 패턴** (자기 발견):
-- 한 번 시도했다가 깨졌던 접근, 자체 fix 한 코드 실수 → `gotcha_candidates` (target=generator-backend, source="generator-backend:F-XXX")
-- 작업 중 적용한 일관된 코드 구조/패턴 (다른 feature 가 모방해야 할) → `convention_candidates` (scope=generator-backend)
-
-`gen-report-{FEATURE_ID}.md` 최소 형식:
-```markdown
-# Generator-Backend Report — {FEATURE_ID}
-
-## 변경 파일
-- ...
-
-## 자체 게이트 결과
-- tsc: OK · eslint: 0 warn · jest: N/N
-
-## 발견 패턴
-(짧은 설명)
-
-```gotcha_candidates
-[]
-```
-
-```convention_candidates
-[]
-```
-```
-
-상세 스키마 → [공통 가이드 — dynamic-registration](../_shared/dynamic-registration.md)

package/skills/generator-backend/references/nestjs-msa-patterns.md

@@ -1,69 +0,0 @@
-# NestJS MSA Patterns
-
-## 모노레포 구조
-
-```
-apps/
-├── gateway/                    # API Gateway (port 3000)
-│   └── src/
-│       ├── main.ts             # bootstrap, CORS
-│       ├── app.module.ts       # ClientsModule 등록
-│       ├── controllers/        # HTTP → MessagePattern 변환
-│       └── guards/
-├── service-[name]/             # Microservice (TCP)
-│   └── src/
-│       ├── main.ts             # TCP bootstrap
-│       ├── [name].module.ts
-│       ├── [name].controller.ts  # @MessagePattern 핸들러
-│       ├── [name].service.ts
-│       └── entities/
-└── web/                        # (Frontend — 별도 에이전트)
-
-libs/
-├── shared-dto/                 # api-contract.json에서 파생
-├── database/                   # TypeORM/Prisma 설정
-└── common/                     # 필터, 인터셉터, 가드
-```
-
-## 통합 러너 (package.json)
-
-```json
-{
-  "scripts": {
-    "dev": "concurrently \"npm run start:gateway\" \"npm run start:service-a\"",
-    "start:gateway": "nest start gateway --watch",
-    "start:service-a": "nest start service-a --watch"
-  }
-}
-```
-
-## Gateway ↔ Microservice 패턴
-
-```typescript
-// apps/gateway/src/controllers/items.controller.ts
-@Controller('api/v1/items')
-export class ItemsController {
-  constructor(@Inject('SERVICE_A') private readonly serviceA: ClientProxy) {}
-
-  @Post()
-  create(@Body() dto: CreateItemDto) {
-    return this.serviceA.send({ cmd: 'create_item' }, dto);
-  }
-}
-
-// apps/service-a/src/items.controller.ts
-@Controller()
-export class ItemsController {
-  @MessagePattern({ cmd: 'create_item' })
-  create(dto: CreateItemDto) {
-    return this.service.create(dto);
-  }
-}
-```
-
-## 규칙
-
-- Gateway = 라우팅 + 검증만, 비즈니스 로직은 서비스에서
-- 서비스 간 통신: `ClientProxy.send()` (요청-응답)
-- CORS: Gateway에서 `localhost:5173` 허용
-- 각 서비스 독립 기동 가능해야 함

package/skills/generator-backend/references/sprint-contract-be.md

@@ -1,32 +0,0 @@
-# Sprint Contract — Backend Section Template
-
-```markdown
-## Backend Scope
-
-### Services Affected
-| Service | Port | Changes |
-|---------|------|---------|
-| gateway | 3000 | EP-XXX 라우팅 추가 |
-| service-a | 3001 | message_pattern 핸들러 추가 |
-
-### Message Patterns
-| Pattern | From | To | Payload | Response |
-|---------|------|----|---------|----------|
-| create_item | gateway | service-a | CreateItemDto | ItemResponse |
-
-### Database Schema Changes
-- Service-A DB: items (id, name, description, created_at, updated_at)
-
-### Shared DTOs (libs/shared-dto)
-- CreateItemDto: { name: string, description?: string }
-- ItemResponse: { id: number, name: string, created_at: string }
-
-### Success Criteria (Backend)
-1. [ ] Gateway → POST /api/v1/items → service-a → 201
-2. [ ] 유효성 검증 — 빈 name → 400
-3. [ ] 서비스 간 TCP 통신 정상
-4. [ ] Jest 통과
-
-### Test Commands
-curl -X POST http://localhost:3000/api/v1/items -H "Content-Type: application/json" -d '{"name":"Test"}'
-```