@walwal-harness/cli 1.0.0

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

@@ -0,0 +1,32 @@
+# 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"}'
+```

package/skills/generator-frontend/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: harness-generator-frontend
+description: "하네스 Frontend Generator. React/Next.js + TypeScript로 UI 컴포넌트, 상태관리, API Gateway 연동을 구현한다. api-contract.json 기반으로 Gateway만 바라보며 내부 서비스 존재를 모른다."
+disable-model-invocation: true
+---
+
+# Generator-Frontend — React/Next.js
+
+## Startup
+
+1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인
+2. `.harness/gotchas/generator-frontend.md` 읽기 — **과거 실수 반복 금지**
+3. `pwd` + `.harness/progress.txt` + `git log --oneline -20`
+4. `.harness/actions/api-contract.json` 읽기 — **Gateway가 유일한 API 인터페이스**
+5. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
+6. Gateway 확인: `curl -s http://localhost:3000/health`
+7. Frontend 시작: `cd apps/web && npm run dev`
+
+## AGENTS.md — 읽기 전용
+
+`[FE]` + `→ Generator-Frontend` 소유 경로만 쓰기 가능.
+
+## Prerequisites
+
+**Backend 통합 러너가 동작 중이어야 함.** Gateway 미응답 시 → STOP.
+
+## Sprint Workflow
+
+1. **Sprint Contract FE 섹션 추가** — 컴포넌트, API 연동, 성공 기준
+2. **구현** — API 타입 변환 + 컴포넌트 + 상태관리
+3. **Self-Verification** — tsc + Vitest
+4. **Handoff** → Evaluator-Functional
+
+컴포넌트 패턴 → [참조](references/component-patterns.md)
+AI슬롭 방지 → [참조](references/anti-slop-rules.md)
+
+## 핵심 규칙
+
+- api-contract.json → `src/api/types.ts` 1:1 변환
+- API base URL: `http://localhost:3000` (Gateway만)
+- 로딩/에러/빈 상태 3가지 필수 처리
+- 시맨틱 HTML + 키보드 네비게이션
+- Tailwind CSS, 4px 기반 spacing
+
+## 금지 사항
+
+- Backend 코드 수정, Gateway 내부 서비스 직접 호출
+- api-contract.json에 없는 엔드포인트 호출
+- 인라인 스타일 남용, AI슬롭 패턴

package/skills/generator-frontend/references/anti-slop-rules.md

@@ -0,0 +1,21 @@
+# Anti-Slop Rules
+
+## 감점 패턴
+
+| 패턴 | 감점 | 설명 |
+|------|------|------|
+| 보라색/파란색 그라디언트 + 흰 카드 | -2 | AI 기본 테마 답습 |
+| 과도한 box-shadow 남발 | -1 | 모든 카드에 동일 그림자 |
+| 기본 아이콘팩 무분별 사용 | -1 | 의미 없는 장식 아이콘 |
+| "Welcome to [AppName]" 히어로 | -1 | 제너릭 랜딩 패턴 |
+| 둥근 아바타 + 카드 그리드 | -1 | SaaS 템플릿 클리셰 |
+| 전체 fade-in 애니메이션 | -1 | 로드 시 모든 요소 fade |
+| 과도한 보더/구분선 | -1 | 시각적 노이즈 |
+
+## 대신 해야 할 것
+
+- 프로젝트 고유 색상 팔레트 (CSS custom properties)
+- 의미 있는 spacing scale (Tailwind 기본 scale 활용)
+- 아이콘은 기능에 필요한 경우만
+- 애니메이션은 사용자 피드백 목적만 (로딩, 전환)
+- 타이포그래피 계층 명확히 (h1 > h2 > h3)

package/skills/generator-frontend/references/component-patterns.md

@@ -0,0 +1,52 @@
+# Component Patterns
+
+## 프로젝트 구조
+
+```
+apps/web/src/
+├── api/
+│   ├── client.ts           # fetch 인스턴스 (base: localhost:3000)
+│   ├── types.ts            # api-contract.json → TypeScript 1:1
+│   └── [domain].ts         # 도메인별 API 함수
+├── components/
+│   ├── ui/                 # Button, Input, Modal, Card
+│   └── [domain]/           # 도메인별 컴포넌트
+├── pages/ (또는 app/)
+├── hooks/
+│   └── use[Domain].ts
+├── stores/                 # Zustand (클라이언트 상태만)
+└── styles/
+    └── globals.css         # Tailwind directives
+```
+
+## API 타입 변환
+
+```typescript
+// api-contract.json의 response_200을 그대로 반영
+interface ItemResponse {
+  id: number;
+  name: string;
+  created_at: string;
+}
+```
+
+## 상태관리
+
+- 서버 상태: TanStack Query (캐시, 리페치, 낙관적 업데이트)
+- 클라이언트 상태: Zustand (최소한, 서버 상태와 중복 금지)
+
+## 3가지 상태 필수 처리
+
+```tsx
+if (isLoading) return <Skeleton />;
+if (error) return <ErrorMessage error={error} />;
+if (data.length === 0) return <EmptyState />;
+return <ItemList items={data} />;
+```
+
+## 접근성
+
+- `<button>`, `<nav>`, `<main>`, `<form>` 시맨틱 태그
+- `aria-label` 필요 시 추가
+- Tab 순서 논리적, Enter/Escape 동작
+- 색상 대비 4.5:1 이상

package/skills/planner/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: harness-planner
+description: "하네스 Planner 에이전트. 사용자의 프로젝트 설명을 제품 사양(plan.md), 기능 목록(feature-list.json), API 계약서(api-contract.json), AGENTS.md로 확장. pipeline.json의 planner_mode(light/full)에 따라 동작."
+disable-model-invocation: true
+---
+
+# Planner Agent
+
+## Startup
+
+1. `AGENTS.md` 읽기
+2. `.harness/gotchas/planner.md` 읽기 — **과거 실수 반복 금지**
+3. `.harness/progress.txt` 읽기
+4. `.harness/actions/pipeline.json` 읽기 — `planner_mode` 확인
+
+## Outputs (4개)
+
+| 파일 | 설명 |
+|------|------|
+| `actions/plan.md` | 제품 사양서 |
+| `actions/feature-list.json` | 기능 추적 (layer + service 필드) |
+| `actions/api-contract.json` | API 계약서 (Gateway ↔ Services ↔ Frontend) |
+| `AGENTS.md` | IA-MAP 갱신 |
+
+## planner_mode
+
+- **full**: MSA 서비스 분할 + 전체 설계 (FULLSTACK, BE-ONLY)
+- **light**: OpenAPI → api-contract.json 변환 + FE 설계만 (FE-ONLY)
+
+## Process
+
+1. 사양서 작성 → [plan 템플릿](references/plan-template.md)
+2. API 계약서 → [api-contract 스키마](references/api-contract-schema.md)
+3. feature-list.json → layer/service/depends_on 필드 필수
+4. AGENTS.md IA-MAP 갱신 → [IA-MAP 가이드](references/ia-map-guide.md)
+
+## Constraints
+
+- 기술 구현 세부사항은 Generator에 위임
+- Sprint당 기능 3-5개 권장
+- 각 기능에 `layer`, `service`, `depends_on` 명시
+- API 계약의 스키마는 Pydantic/class-validator로 직접 변환 가능한 수준
+
+## After Completion
+
+1. `progress.txt` 업데이트 (Phase: PLANNED)
+2. 사용자에게 plan.md + api-contract.json 리뷰 요청
+3. 승인 후 → 다음 에이전트 (pipeline.json 참조)

package/skills/planner/references/api-contract-schema.md

@@ -0,0 +1,34 @@
+# API Contract Schema
+
+```json
+{
+  "version": "1.0.0",
+  "gateway_base_url": "/api/v1",
+  "services": {
+    "gateway": { "port": 3000, "description": "API Gateway" },
+    "service-a": { "port": 3001, "transport": "TCP", "description": "..." }
+  },
+  "endpoints": [
+    {
+      "id": "EP-001",
+      "method": "POST",
+      "path": "/api/v1/items",
+      "gateway_route": true,
+      "target_service": "service-a",
+      "message_pattern": "create_item",
+      "description": "...",
+      "request_body": { "name": "string (required)" },
+      "response_200": { "id": "number", "name": "string", "created_at": "string (ISO 8601)" },
+      "response_errors": [
+        { "status": 400, "when": "유효성 검증 실패" }
+      ],
+      "related_features": ["F-001"]
+    }
+  ]
+}
+```
+
+## 규칙
+- Gateway가 외부 진입점, 내부 서비스는 message pattern으로 통신
+- request/response 스키마는 Pydantic/class-validator로 직접 변환 가능한 수준
+- 이 계약서가 Frontend ↔ Gateway ↔ Services 간 유일한 진실의 원천

package/skills/planner/references/ia-map-guide.md

@@ -0,0 +1,31 @@
+# IA-MAP Guide
+
+## 형식
+
+```
+├── path/to/dir/    # [TAG] 한줄 설명    → 소유 에이전트
+```
+
+## 태그
+
+| 태그 | 의미 | 소유 |
+|------|------|------|
+| `[BE]` | Backend | Generator-Backend |
+| `[FE]` | Frontend | Generator-Frontend |
+| `[HARNESS]` | 하네스 시스템 | Planner / Evaluator |
+| `[META]` | 프로젝트 메타 | Planner |
+| `[INFRA]` | 인프라/배포 | Planner |
+| `[TEST]` | 테스트 코드 | Evaluator / Generator |
+| `[?]` | 미분류 | TBD (Planner가 확정) |
+
+## 갱신 시점
+
+- Sprint 0 (최초): 전체 구조 설계
+- Sprint 간 전환: 새 폴더/파일 반영, Change Request 처리
+- Generator/Evaluator가 남긴 Change Request 검토 후 반영
+
+## 규칙
+
+- Planner만 AGENTS.md 수정 가능
+- Generator는 sprint-contract.md에 `## Change Request`로 요청
+- Evaluator는 evaluation에 `## AGENTS.md Drift`로 보고

package/skills/planner/references/plan-template.md

@@ -0,0 +1,51 @@
+# Plan Template
+
+```markdown
+# Product Specification: [제품명]
+
+## 1. Vision & Value Proposition
+[왜 이 제품이 존재해야 하는가]
+
+## 2. User Persona
+[타겟 사용자, 사용 시나리오]
+
+## 3. System Architecture
+
+### 3.1 MSA Service Map
+- API Gateway (NestJS) — 라우팅, 인증, 레이트리밋
+- Service A: [도메인] — [책임]
+- Service B: [도메인] — [책임]
+
+### 3.2 Communication
+- Dev: TCP transport
+- Prod: RabbitMQ / NATS
+
+### 3.3 Monorepo Structure
+project-root/
+├── apps/
+│   ├── gateway/
+│   ├── service-a/
+│   └── web/
+├── libs/
+│   ├── shared-dto/
+│   ├── database/
+│   └── common/
+└── package.json
+
+### 3.4 Tech Stack Decisions
+- 각 결정의 **근거** 포함
+
+## 4. Data Model
+[서비스별 핵심 엔티티 — 서비스 경계 명확히]
+
+## 5. Sprint Roadmap
+### Sprint 1: [테마]
+  - BE-Gateway: [작업]
+  - BE-ServiceA: [작업]
+  - FE: [작업]
+  - 의존성: [선행 조건]
+
+## 6. AI Integration Opportunities
+
+## 7. Non-Functional Requirements
+```