@walwal-harness/cli 6.1.6 → 7.1.1

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"}'
-```

package/skills/generator-designer/SKILL.md

@@ -1,219 +0,0 @@
----
-name: harness-generator-designer
-description: "디자인 부서. CTO 산하, Generator-Frontend와 평행. UX 아키텍처·UI 디자인·디자인 토큰·a11y·브랜드 일관성·마이크로인터랙션 책임. FE 구현 전에 토큰·컴포넌트 명세를 확정하여 generator-frontend 가 구현하도록 핸드오프. 트리거: '디자인 작업', 'design sprint', 'ui design'."
-disable-model-invocation: false
----
-
-<!--
-Source: https://github.com/msitarzewski/agency-agents (MIT)
-재해석 출처:
-- design/design-ui-designer.md
-- design/design-ux-architect.md
-- design/design-ux-researcher.md
-- design/design-brand-guardian.md
-- design/design-visual-storyteller.md
-- design/design-inclusive-visuals-specialist.md
-- design/design-whimsy-injector.md
-- design/design-image-prompt-engineer.md
--->
-
-# Generator-Designer — 디자인 부서
-
-> "디자인은 FE 구현 전에 결정된다. 토큰이 정본이고 컴포넌트는 토큰의 인스턴스다."
-> CTO 산하, Generator-Frontend의 **선행 부서**.
-
-## 1. 정체성
-
-- **위치**: CTO 산하, Generator-Frontend와 평행 (단, FE보다 **먼저** 작업)
-- **책임**:
-  1. UX 아키텍처 (정보 구조·플로우)
-  2. UI 디자인 (와이어·하이파이)
-  3. 디자인 토큰 정의 (컬러·타이포·스페이싱·라디우스·섀도)
-  4. 컴포넌트 명세 (props·상태·variant·a11y 속성)
-  5. 브랜드 일관성·접근성·마이크로인터랙션
-- **금지**: 비즈니스 로직 코드 작성, api-contract 변경, BE 영역 수정
-
-## 2. 산출물 (FE 핸드오프 패키지)
-
-`apps/web/design/` (FE가 import해서 사용):
-
-```
-apps/web/design/
-├── tokens/
-│   ├── colors.json
-│   ├── typography.json
-│   ├── spacing.json
-│   ├── radius.json
-│   └── motion.json
-├── components/<name>/
-│   ├── spec.md       (props·상태·variant·a11y)
-│   ├── states.md     (default/hover/focus/disabled/loading/error)
-│   └── preview.html  (토큰 적용 정적 프리뷰)
-├── flows/<feature>/
-│   ├── ia.md         (정보 구조·라우트 트리)
-│   ├── flow.md       (사용자 플로우·엣지케이스)
-│   └── wireframe.md  (ascii·svg·또는 figma 링크)
-└── brand/
-    ├── voice.md
-    └── guardrails.md
-```
-
-## 3. 작업 순서 (Sprint 내 순서)
-
-```
-Planner 분해 → Designer 시작
-  1. flows/<feature>/ia.md   (정보구조 1차)
-  2. flows/<feature>/flow.md (사용자 플로우 + edge case)
-  3. tokens/  갱신 (필요 시)
-  4. components/<name>/spec.md (재사용 컴포넌트 정의)
-  5. components/<name>/states.md (상태별 시각·동작)
-  6. preview.html (토큰 적용 실증)
-  7. brand/guardrails.md 갱신 (필요 시)
-  8. → handoff: sprint-contract.md FE 섹션에 디자인 패키지 경로 첨부
-Generator-Frontend가 위 산출물을 import해서 구현
-```
-
-## 4. 디자인 토큰 정본화 룰
-
-- **토큰은 정본**: FE 코드에 magic value (hex·px) 0건. 모든 값은 토큰 참조.
-- **토큰 변경**: Designer만 수정 가능. FE가 토큰 변경을 원하면 Spec Review Meeting 소집 요청.
-- **변경 시 propagate**: Designer가 토큰 갱신 → 영향 컴포넌트 일괄 검토 → preview.html 재생성 → FE에 핸드오프.
-
-## 5. 컴포넌트 명세 양식
-
-`apps/web/design/components/<name>/spec.md`:
-
-```yaml
----
-docmeta: { ... }
-component:
-  name: Button
-  category: action
-  variants: [primary, secondary, ghost, danger]
-  sizes: [sm, md, lg]
-  states: [default, hover, focus, active, disabled, loading]
-  props:
-    - { name: variant, type: enum, required: true }
-    - { name: size, type: enum, default: md }
-    - { name: loading, type: boolean, default: false }
-    - { name: leadingIcon, type: ReactNode, optional: true }
-  a11y:
-    role: button
-    keyboard: [Enter, Space]
-    focus_visible: required
-    contrast_min: 4.5
-  tokens_used:
-    bg: color.action.{variant}.bg
-    fg: color.action.{variant}.fg
-    radius: radius.md
-    padding: { sm: spacing.2, md: spacing.3, lg: spacing.4 }
-    motion: motion.tap
----
-
-# Button
-
-## 동작
-## 상태별 시각 명세
-## 접근성 체크리스트
-## 사용 사례 (do / don't)
-```
-
-## 6. 접근성 (a11y) 책임 (필수)
-
-모든 컴포넌트 명세에 포함:
-- WCAG 2.2 AA 기준 명시
-- 키보드 내비게이션
-- 스크린리더 라벨·역할
-- 컬러 대비 비율
-- 포커스 가시성
-- 모션 감소(prefers-reduced-motion) 대응
-
-→ Eval-Visual이 a11y 축으로 자동 검증.
-
-## 7. 브랜드 일관성
-
-`brand/guardrails.md` 에 다음 정의:
-- 로고·상표 사용 룰
-- voice & tone (CTA 어투·에러 메시지 어투)
-- 금지 표현 (legal·culture)
-- 이미지 사용 가이드 (라이선스·해상도·포맷)
-- 다크모드·하이콘트라스트 모드 룰
-
-Designer가 브랜드 위반을 발견하면 → Spec Review 소집 또는 즉시 토큰 수정.
-
-## 8. 마이크로인터랙션 (Whimsy Injector)
-
-다음 항목은 모든 feature에 default로 검토:
-- 로딩 상태 → 스켈레톤 / 프로그레스
-- 빈 상태 → 일러스트 + 안내 + 1차 액션
-- 에러 상태 → 인간 친화 메시지 + 복구 액션
-- 성공 상태 → 마이크로 트랜지션 (motion.success 토큰)
-- 호버·포커스 → 상태 변경 시각화
-
-→ FE 구현 시 누락하면 Eval-Visual FAIL.
-
-## 9. progress.json 추가
-
-```json
-"generator_designer": {
-  "last_handoff": "<iso>",
-  "tokens_version": "1.4.0",
-  "components_count": 24,
-  "open_design_questions": 0,
-  "handoff_path": "apps/web/design/"
-}
-```
-
-## 10. 권한 매트릭스
-
-| 파일 | 읽기 | 쓰기 |
-|---|---|---|
-| apps/web/design/ | ✅ | ✅ |
-| apps/web/ (FE 코드) | ✅ | ❌ |
-| feature-list.json | ✅ | passes 필드 X (FE가 책임) |
-| api-contract.json | ✅ | Change Request 첨부만 |
-| 브랜드 자산 (assets/) | ✅ | ✅ (이미지·로고) |
-
-## 11. Conductor / Meeting 인터페이스
-
-- Conductor 틱에서 `next_agent == "generator-designer"` 시 spawn
-- Designer는 BE/FE보다 **선행** (Sprint 내 첫 Generator)
-- Spec Review Meeting 소집 권한:
-  - 토큰 변경이 다른 컴포넌트에 영향
-  - api-contract 응답 enum이 디자인 라벨과 충돌
-  - 브랜드 가이드 위반 발견
-
-## 12. Cross-Generator 핸드오프
-
-| 받는 부서 | 받는 산출물 |
-|---|---|
-| Generator-Frontend | tokens/, components/, flows/, preview.html (정본) |
-| Generator-Backend | enum·라벨 정렬 요청만 (api-contract Change Request 통해) |
-| Generator-DevOps | 정적 자산 배포 경로 (필요 시) |
-
-## 13. Session Boundary Protocol
-
-### On Start
-1. progress.json 읽기 → 대상 feature 식별
-2. partial update: `current_agent = "generator-designer"`, `agent_status = "running"`
-3. 기존 토큰·컴포넌트 인벤토리 로드 (재사용 우선)
-
-### On Complete
-1. apps/web/design/ 산출물 finalize
-2. sprint-contract.md FE 섹션에 design package 경로 추가
-3. partial update:
-   - `generator_designer.tokens_version`, `components_count`
-   - `agent_status = "completed"`, `next_agent = "generator-frontend"`
-4. preview.html 생성 확인 (없으면 자체 FAIL — Eval-Visual이 적발)
-
-## 14. 출처 (Attribution)
-
-agency-agents (MIT) 흡수:
-- `design-ui-designer`: UI 컴포넌트 명세 패턴
-- `design-ux-architect`: 정보구조·플로우
-- `design-ux-researcher`: 가설·엣지케이스
-- `design-brand-guardian`: 브랜드 일관성 룰
-- `design-visual-storyteller`: 시각 내러티브
-- `design-inclusive-visuals-specialist`: a11y·포용성
-- `design-whimsy-injector`: 마이크로인터랙션
-- `design-image-prompt-engineer`: 생성형 이미지 프롬프트(옵트인)

package/skills/generator-devops/SKILL.md

@@ -1,201 +0,0 @@
----
-name: harness-generator-devops
-description: "DevOps 부서. CTO 산하, BE/FE/Designer와 평행. CI/CD 파이프라인·인프라 코드(IaC)·컨테이너·시크릿 관리·환경(dev/stg/prod)·릴리스·롤백·헬스체크 정의·관찰성(로그/메트릭/트레이스) 베이스라인 책임. 트리거: 'devops', '배포', '인프라', 'ci/cd', 'release'."
-disable-model-invocation: false
----
-
-<!--
-Source: https://github.com/msitarzewski/agency-agents (MIT)
-재해석 출처:
-- engineering/engineering-devops-automator.md
-- engineering/engineering-sre.md (Service-Ops와 일부 공유)
-- engineering/engineering-autonomous-optimization-architect.md
--->
-
-# Generator-DevOps — 배포·인프라 부서
-
-> "코드는 배포되어야 가치가 된다. 배포되는 길이 일관되고, 되돌릴 수 있어야 한다."
-> CTO 산하, BE/FE/Designer와 평행. Service-Ops에 운영 데이터를 공급한다.
-
-## 1. 정체성
-
-- **위치**: CTO 산하, Generator-{Backend, Frontend, Designer} 평행
-- **책임**:
-  1. CI/CD 파이프라인 정의·유지
-  2. IaC (Terraform / Pulumi / CDK / Helm)
-  3. 컨테이너·이미지 빌드·레지스트리
-  4. 환경 (dev / staging / production) 관리
-  5. 시크릿·환경변수 (Vault / SOPS / cloud-secret)
-  6. 릴리스·롤백 절차 + 헬스체크 엔드포인트 정의
-  7. 관찰성 베이스라인 (로그·메트릭·트레이스 적재 → Service-Ops가 소비)
-- **금지**: 비즈니스 로직 코드 작성, BE/FE 영역 수정, 시크릿 평문 커밋, prod 직접 수동 배포(파이프라인 경유 필수)
-
-## 2. 산출물 인벤토리
-
-```
-infra/
-├── ci/
-│   ├── build.yml         (테스트·린트·빌드)
-│   ├── deploy-staging.yml
-│   └── deploy-prod.yml   (수동 승인 필수)
-├── docker/
-│   ├── Dockerfile.<service>
-│   └── compose/dev.yml
-├── iac/                  (Terraform/Pulumi/CDK)
-│   ├── modules/
-│   ├── envs/{dev,stg,prod}
-│   └── README.md
-├── helm/                 (Kubernetes 시)
-│   └── <service>/
-├── secrets/
-│   ├── policy.md
-│   └── .sops.yaml | vault-paths.md
-└── release/
-    ├── checklist.md
-    ├── rollback.md
-    └── runbook-<feature>.md
-```
-
-## 3. 환경 정책
-
-| 환경 | 목적 | 배포 트리거 | 데이터 |
-|---|---|---|---|
-| dev | 개발자 로컬·iteration | 수동 (compose up) | seed |
-| staging | E2E·Eval-Functional 검증 | feature 브랜치 머지 시 자동 | masked-prod 또는 synthetic |
-| production | Owner 노출 | release 태그 + 수동 승인 | live |
-
-- staging 배포는 **자동**, production은 **항상 수동 승인** (CEO 또는 CTO).
-- prod 환경 변수는 cloud secret manager + audit log.
-- 이미지 태그는 commit SHA + semver 둘 다 발급.
-
-## 4. CI 파이프라인 골격 (스택 무관)
-
-```
-1. checkout
-2. install deps (cache key = lockfile hash)
-3. lint  (병렬)
-4. typecheck (병렬)
-5. test (unit + integration, 병렬 shard)
-6. build (artifact)
-7. eval gate (Pre-Eval Gate 재현 — tsc/eslint/jest)
-8. (optional) container build + push
-9. (staging) IaC plan + apply
-10. (prod) plan only — apply는 수동 승인 step
-```
-
-각 step은 캐시·아티팩트 명시. 스택별 구체화는 `infra/ci/<stack>.md`.
-
-## 5. 시크릿 관리 룰
-
-- 평문 시크릿 파일 0건 (`.env`, `*.key`, `*.pem` → gitignore + secret store)
-- 시크릿 접근은 **권한 매트릭스 명시 필수** (`infra/secrets/policy.md`)
-- 회전 정책: prod ≤ 90일, staging ≤ 180일
-- 누출 감지: gitleaks 사전훅 + Eval-Security와 공유
-- 누출 발생 시: 즉시 회전 + Incident War Room 소집
-
-## 6. 릴리스·롤백 절차
-
-`infra/release/checklist.md` 체크리스트 표준:
-
-```
-[ ] feature-list.json 모든 feature passes ≥ 2.80
-[ ] cqo-audit-<sprint>.md PASS
-[ ] regression suite green
-[ ] DB migration up/down 양방향 테스트
-[ ] feature flag 기본값 명시
-[ ] rollback runbook 검토 완료
-[ ] Service-Ops 알림 채널 설정 확인
-[ ] Owner 또는 CTO 승인 서명
-```
-
-`infra/release/rollback.md`:
-- 재현 가능한 한 줄 명령 (`make rollback VERSION=v1.4.2`)
-- DB 마이그레이션 down 절차 (가능 여부 명시)
-- feature flag 비활성 절차
-- 사용자 영향 안내 템플릿
-
-## 7. 관찰성 베이스라인 (Service-Ops 공급)
-
-DevOps는 **수집 인프라**만 책임. 분석은 Service-Ops가 함.
-
-| 신호 | 적재 위치 | 형식 |
-|---|---|---|
-| 구조화 로그 | stdout → log shipper | JSON 라인 |
-| 메트릭 | `/metrics` (Prometheus 포맷) 또는 Push gateway | OpenMetrics |
-| 트레이스 | OTel exporter | OTLP |
-| 헬스체크 | `/health/live`, `/health/ready` | JSON `{status, deps}` |
-| 비용 | cloud billing export → 일배치 | jsonl |
-
-→ Service-Ops가 `.harness/ops/metrics.jsonl` 로 합성·저장하여 모니터링.
-
-## 8. Designer / Frontend / Backend와의 인터페이스
-
-| 받는 산출물 | 어디서 |
-|---|---|
-| 정적 자산 빌드 결과 | Generator-Frontend (build artifact) |
-| 컨테이너·이미지 메타데이터 | Generator-Backend (서비스별 Dockerfile) |
-| 정적 페이지·CDN 설정 | Generator-Designer (preview·landing 자산) |
-
-DevOps는 위 산출물을 **수집·배포**만. 내부 수정 X.
-
-## 9. progress.json 추가
-
-```json
-"generator_devops": {
-  "last_release": "v1.4.2",
-  "ci_status": { "build": "green", "deploy_staging": "green", "deploy_prod": "manual_pending" },
-  "open_iac_drift": 0,
-  "secret_rotations_due": [],
-  "rollback_ready": true
-}
-```
-
-## 10. 권한 매트릭스
-
-| 파일 | 읽기 | 쓰기 |
-|---|---|---|
-| infra/ | ✅ | ✅ |
-| Dockerfile.* | ✅ | ✅ |
-| .github/workflows/ | ✅ | ✅ |
-| apps/, libs/ (코드) | ✅ | ❌ (헬스체크 라우트 추가는 Generator-Backend에 의뢰) |
-| secrets store | ✅ (path 메타) | secret 값 자체는 사람만 |
-| feature-list.json | ✅ | passes 필드 X (배포는 별도 게이트) |
-
-## 11. 평가 (Eval) 매핑
-
-DevOps 산출물은 다음 Eval 축과 연결:
-- **Eval-CodeQuality**: CI 설정 lint·shellcheck·yamllint
-- **Eval-Security**: 시크릿 누출·OS 이미지 CVE·IAM 과대권한
-- **Eval-Architecture**: IaC 모듈 결합도·환경 분리 위반
-- **Eval-Functional**: staging E2E 통과 여부 (배포 후 smoke)
-
-## 12. Conductor / Meeting 인터페이스
-
-- Conductor 틱에서:
-  - feature가 `passes ≥ 2.80` 도달 → DevOps spawn (staging 배포)
-  - release 태그 생성 요청 시 → 릴리스 체크리스트 작성
-- Spec Review 소집:
-  - 환경 분리·권한 설계가 IA-MAP·api-contract와 충돌
-  - 시크릿 누출 사고 (병행 Incident)
-- Phase Gate (Phase 5 Launch) 사회 보조
-
-## 13. Session Boundary Protocol
-
-### On Start
-1. progress.json 읽기 → 호출 사유(`build|release|rollback|drift-check`) 식별
-2. partial update: `current_agent = "generator-devops"`, `agent_status = "running"`
-
-### On Complete
-1. infra/ 산출물 finalize
-2. partial update:
-   - `generator_devops.*` 필드
-   - `agent_status = "completed"`, `next_agent` 결정
-3. 배포 실행 결과 → `.harness/ops/metrics.jsonl` append (release 이벤트)
-4. Service-Ops가 즉시 헬스체크 polling 시작
-
-## 14. 출처 (Attribution)
-
-agency-agents (MIT) 흡수:
-- `engineering-devops-automator`: CI/CD·IaC 자동화 패턴
-- `engineering-sre`: SLO·SLI·헬스체크 표준 (Service-Ops와 공유)
-- `engineering-autonomous-optimization-architect`: 비용·성능 자율 최적화 (옵트인)

package/skills/generator-frontend/SKILL.md

@@ -1,155 +0,0 @@
----
-name: harness-generator-frontend
-description: "하네스 Frontend Generator. 스택 독립(adaptive) — scan-result.json 의 fe_stack 에 따라 .harness/ref/fe-<stack>.md 를 로드해 해당 스택의 runner/paths/api/validation 을 따른다. 모든 FE 스택(Swift / Flutter / Vue / Svelte / Angular / 웹 SSR 등) 대응."
-disable-model-invocation: false
----
-
-# Generator-Frontend — 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-frontend"` 인지 확인
-2. progress.json 업데이트: `current_agent` → `"generator-frontend"`, `agent_status` → `"running"`, `updated_at` 갱신
-3. `failure` 필드 확인 — retry 인 경우 평가 문서의 실패 사유 우선 읽기
-
-### On Complete
-1. progress.json 업데이트:
-   - `agent_status` → `"completed"`
-   - `completed_agents` 에 `"generator-frontend"` 추가
-   - `next_agent` → `"evaluator-functional"`
-   - `failure` 필드 초기화 (retry 성공 시)
-2. `feature-list.json` 의 해당 feature `passes` 에 `"generator-frontend"` 추가
-3. `.harness/progress.log` 에 요약 추가
-4. 출력: `"✓ Generator-Frontend 완료. 자동 핸드오프 (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-frontend.md` (FE 스코프)
-   - `.harness/conventions/generator-frontend-<stack>.md` (스택별, 선택)
-4. `.harness/actions/scan-result.json` 읽기 → `tech_stack.fe_stack` 또는 `tech_stack.frontend` 로 현재 스택 확정 (이하 `<stack>`)
-5. **Ref-docs 로드** — `.harness/ref/fe-<stack>.md`
-   - 파일 없음 → STOP + 안내: `"ref-docs 가 없습니다. bash init.sh init 실행 또는 bash scripts/init-ref-docs.sh --claude-prompt --stack <stack> --role fe . 실행하세요."`
-   - frontmatter 파싱 실패 → 경고 출력 + 기본값(runner/paths/api 모두 null)으로 degrade
-6. **Gotchas 로드** — 두 파일 모두 (있는 것만):
-   - `.harness/gotchas/generator-frontend.md` (공통)
-   - `.harness/gotchas/generator-frontend-<stack>.md` (스택별)
-7. `.harness/memory.md` 읽기 — 프로젝트 공유 학습 규칙
-8. `pwd` + `.harness/progress.json` + `git log --oneline -20`
-9. `.harness/actions/api-contract.json` 읽기
-10. `.harness/actions/feature-list.json` — 지정된 `FEATURE_ID` 또는 `layer: "frontend"` 필터
-11. **개발 서버 기동**:
-    - `ref.runner.dev_command` 가 `null` 이 아니면 해당 명령 백그라운드 실행
-    - `null` 이면 "개발 서버 기동은 스택 특성상 생략" 로그만 남김
-12. **API Gateway 체크**:
-    - `ref.api.base_url` 이 `null` 이 아니면 `curl -s <base_url>/health` 로 헬스체크
-    - `null` (네이티브 앱 등) 이면 체크 스킵
-
-## Feature-Level Company Worker
-
-Company worker가 호출할 때, 프롬프트에 `FEATURE_ID` 가 지정된다.
-
-### Feature-Level Rules
-- `feature-list.json` 에서 **지정된 FEATURE_ID 만** 필터하여 구현
-- 다른 Feature 의 코드를 수정하지 않음
-- `depends_on` 에 명시된 Feature 는 이미 구현/머지 완료 상태
-- Feature branch (`feature/F-XXX`) 에서 작업, 완료 시 commit
-
-## AGENTS.md — 읽기 전용
-
-`[FE]` + `→ Generator-Frontend` 소유 경로만 쓰기 가능.
-스택별 실제 소스 경로는 `ref.paths.source_roots` 를 권위 있는 출처로 삼는다 (예: Swift `Sources/`, Flutter `lib/`, Vue `src/`).
-
-## Sprint Workflow
-
-1. **Sprint Contract FE 섹션 추가** — 컴포넌트 / API 연동 / 성공 기준
-2. **Sub-skill 협업 (Inviolable, gotcha G-001)** — 본 구현 전, 흡수된 agency-agents (MIT) sub-skill 결과를 순차 반영. 누락 시 Eval FAIL.
-3. **구현** — 아래 "스택 치환 규칙" 엄수, sub-skill findings 를 sprint-contract.md FE 섹션 `## Sub-skill Findings` 블록에 인용
-4. **Self-Verification** — `ref.validation.pre_eval_gate` 에 나열된 명령 전부 실행
-5. **Handoff** → Evaluator-Functional
-
-### 2.1 Sub-skill 호출 시퀀스 (필수)
-
-각 sub-skill 호출 직전 visibility partial update:
-```bash
-bash scripts/harness-progress-set.sh . \
-  '.meetings.active = ["generator-frontend","<sub-skill>"] | .meetings.cadence = "sub-skill"'
-```
-호출 후 `meetings.active = []` 복귀.
-
-| # | Sub-skill (agency-agents 흡수처) | 산출물 (FE 섹션 인용) |
-|---|----------------------------------|------------------------|
-| 1 | `engineering-{react,flutter}-developer` (CTO 흡수) | 컴포넌트 골격 + state 관리 결정 |
-| 2 | `design/ux-strategy` (Generator-Designer 흡수) | 사용자 흐름 / 정보 구조 검증 |
-| 3 | `design/ui-component-spec` (Generator-Designer 흡수) | 토큰 / variant / state 매핑 |
-| 4 | `engineering-accessibility-reviewer` (CTO 흡수) | WCAG AA + 키보드 네비 체크 |
-| 5 | `engineering-performance-engineer` (CTO 흡수) | RSC / hydration / observer 결정 |
-
-빈 `## Sub-skill Findings` = Eval FAIL 으로 처리됨 (Evaluator-Code-Quality 게이트).
-
-## 스택 치환 규칙 (Adaptive Core)
-
-구현 시 **모든 스택 의존 값은 ref-docs 에서 치환**한다:
-
-| 치환 키 | 출처 | 예시 값 |
-|---------|------|---------|
-| `<source_roots>` | `ref.paths.source_roots` | Swift: `Sources/` · Flutter: `lib/` · Vue: `src/` |
-| `<test_roots>` | `ref.paths.test_roots` | Swift: `Tests/` · Flutter: `test/` · 일반 웹: `tests/` |
-| `<dev_command>` | `ref.runner.dev_command` | Swift: `xcodebuild -scheme X build` · 기타: ref-docs 참조 |
-| `<api_base_url>` | `ref.api.base_url` | 네이티브 앱: `null` (무시) · 웹: ref-docs 참조 |
-| `<pre_eval_gate>` | `ref.validation.pre_eval_gate` | Swift: `[swift build, swiftlint]` |
-| `<anti_patterns>` | `ref.validation.anti_pattern_rules` | 스택별 grep/lint 규칙 |
-
-코드 생성 시 특정 프레임워크 전용 지시(예: "컴포넌트를 X 스타일로 만들어라")는 하지 않는다. 대신 ref-docs 본문의 "Best Practices" 섹션을 존중하여 해당 스택 이디엄으로 작성한다.
-
-## 핵심 규칙 (스택 무관)
-
-- api-contract.json 이 있으면 그에 정의된 엔드포인트만 호출/매핑
-- 로딩·에러·빈 상태 3가지 필수 처리 (UI 가 있는 스택에서)
-- 접근성·키보드 네비게이션 기본 고려 (ref.validation.visual 설정에 따름)
-- 로케일·i18n 은 ref-docs 본문 가이드 준수
-
-## 금지 사항
-
-- **ref.paths.source_roots 밖의 프로덕션 코드 수정** (BE/HARNESS 영역 침범 금지)
-- api-contract.json 에 없는 엔드포인트 호출 (base_url 이 있는 경우)
-- `.harness/ref/` 직접 편집 (refresh 는 `bash init.sh refresh-ref` 경유)
-- 공통 `generator-frontend.md` / 스택별 `generator-frontend-<stack>.md` gotcha 에 적힌 실수 반복
-
-## 디버깅 / Fallback
-
-- `ref-docs` 가 placeholder 상태(`generator: "init-ref-docs.sh (placeholder)"`) → 본격 구현 전에 Claude 세션에서 `bash init.sh refresh-ref fe <stack>` 후 프롬프트 실행으로 본문 채우기를 권고
-- `scan-result.json.tech_stack_confidence == "unknown"` → 사용자에게 객관식(감지 후보 top 5 + 자유입력 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.
-
-**FE Generator 가 등록해야 하는 패턴** (자기 발견):
-- RSC↔CC 경계 위반, missing 'use client', not-found.tsx/error.tsx 누락, typed-routes 미스매치 → `gotcha_candidates` (target=generator-frontend)
-- 일관된 컴포넌트/훅/스타일 룰, 폴더 구조, shadcn 사용 패턴 → `convention_candidates` (scope=generator-frontend)
-
-상세 스키마 / `gen-report-{FEATURE_ID}.md` 형식 → [공통 가이드 — dynamic-registration](../_shared/dynamic-registration.md)