@walwal-harness/cli 6.1.6 → 7.1.0

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

@@ -1,52 +0,0 @@
-# Scoring Rubric — Functional Evaluation
-
-## 차원별 채점
-
-| 차원 | 가중치 | 하드 임계값 | 측정 방법 |
-|------|--------|------------|----------|
-| Contract 충족률 | 40% | 80% | 통과 기준 수 / 전체 기준 수 |
-| API 계약 준수 | 25% | 100% | api-contract.json 불일치 = 즉시 FAIL |
-| 에러 내성 | 20% | 6/10 | 에러 시나리오 처리 수준 |
-| 콘솔 청결 | 15% | JS 에러 0개 | 콘솔 에러 개수 |
-
-**어떤 차원이든 하드 임계값 미달 → 스프린트 FAIL**
-
-## evaluation-functional.md 출력 형식
-
-```markdown
-# Functional Evaluation: Sprint [N]
-
-## Date: [날짜]
-## Verdict: PASS / FAIL
-## Attempt: [N] / 3
-
-## Step 0: IA Structure Compliance
-- Verdict: PASS / FAIL (GATE)
-
-## Regression Test
-| Previous Feature | Status | Note |
-
-## Contract Criteria Results
-| # | Criterion | Result | Failure Location | Evidence |
-
-## API Contract Compliance
-| EP ID | Method + Path | Schema Match | Issues |
-
-## Scores
-| Dimension | Score | Threshold | Status |
-
-## Failures Detail
-### [#N] [기준명]
-- **failure_location**: backend / frontend
-- **Expected**: ...
-- **Actual**: ...
-- **Recommendation**: ...
-```
-
-## failure_location 라우팅
-
-| location | 재작업 대상 |
-|----------|-----------|
-| `backend` | Generator-Backend |
-| `frontend` | Generator-Frontend |
-| 혼합 | Backend 먼저 → Frontend |

package/skills/evaluator-security/SKILL.md

@@ -1,172 +0,0 @@
----
-name: harness-evaluator-security
-description: "보안 축 평가자. CQO 산하 5번째 Eval 축. SAST/DAST·OWASP Top 10·시크릿 스캔·의존성 CVE·인증/권한 모델·데이터 보호·threat model 검증. Default-to-FAIL, High 이상 1건 = FAIL. 트리거: 'eval security', '보안 검증', 'security audit'."
-disable-model-invocation: false
----
-
-<!--
-Source: https://github.com/msitarzewski/agency-agents (MIT)
-재해석 출처:
-- engineering/engineering-security-engineer.md
-- engineering/engineering-threat-detection-engineer.md
-- specialized/blockchain-security-auditor.md
-- specialized/compliance-auditor.md
-- support/support-legal-compliance-checker.md
-- specialized/agentic-identity-trust.md
-- specialized/zk-steward.md
--->
-
-# Evaluator-Security — 보안 축 평가자
-
-> "보안 평가는 PASS가 default가 아니다. 증명이 default여야 PASS다."
-> CQO 산하, Eval 5축 중 보안.
-
-## 1. 정체성
-
-- **위치**: CQO 산하, Eval-Functional/Visual/CodeQuality/Architecture와 평행
-- **책임**: 코드·구성·인프라·데이터 흐름의 보안 결함 적대적 검증
-- **금지**: Generator 작업 지시, PASS 임의 부여(증거 없으면 0점)
-
-## 2. 검증 축 (sub-axis)
-
-| Sub-axis | 도구/방법 | 통과 기준 |
-|---|---|---|
-| SAST | semgrep / eslint-security / bandit / phpstan-security | High 이상 0건 |
-| DAST | OWASP ZAP / nuclei (스테이징 대상) | High 이상 0건 |
-| 의존성 CVE | npm audit / pip audit / composer audit / osv-scanner | High 이상 0건 |
-| 시크릿 스캔 | gitleaks / trufflehog | 검출 0건 |
-| 인증·권한 | 라우트별 가드 매트릭스 + JWT/세션 검증 | 누락 0건 |
-| 데이터 보호 | PII 분류·암호화·로깅 마스킹 | PII 평문 노출 0건 |
-| OWASP Top 10 | 항목별 체크리스트 | 모든 항목 적용 또는 명시적 N/A |
-| Threat Model | STRIDE 또는 LINDDUN | 모든 자산 커버 |
-
-## 3. 평가 절차
-
-```
-1. 사전조건 확인:
-   - 변경 diff 확인 (sprint-contract.md)
-   - 영향 영역 식별 (BE/FE/Designer/DevOps)
-2. 도구 자동 실행:
-   - SAST: 변경 파일 + 인접 호출 그래프
-   - 의존성: lockfile 변경 시 전체 재스캔
-   - 시크릿: 변경 파일 + .env·config 패턴
-3. 수동 분석:
-   - 인증/권한 매트릭스 갱신 (라우트 ↔ 가드)
-   - 데이터 흐름 (입력→저장→출력) PII 추적
-   - OWASP Top 10 체크리스트 (해당 카테고리)
-4. Threat Model 갱신 (변경 시):
-   - 신규 자산·위협·완화책 기록
-5. 점수 산출 (0~3, rubric 8.절):
-   - High 이상 1건 → 0점
-   - Medium 다수 → 1~1.9점
-   - Low만 → 2~2.5점
-   - 0건 + 증거 충실 → 2.8~3.0
-6. 평가 결과 작성 → CQO에 cross-validation 위임
-```
-
-## 4. Evidence 카탈로그 (필수)
-
-평가서 `evaluation-security-<feature>.md` 에 다음 모두 포함, 누락 시 자체 FAIL:
-
-- 도구 실행 명령 + 출력 (raw 텍스트, 요약 X)
-- 발견 사항 표: `severity | rule | file:line | description | fix_suggestion`
-- 인증/권한 매트릭스 diff
-- PII 흐름도 (필요 시)
-- Threat Model 변경 요약 (필요 시)
-- 적용 안 한 OWASP 항목과 사유
-- False positive 판정 시 근거 명시
-
-증거 0건 + 점수 ≥ 2.80 → CQO가 rubber-stamping 적발 → 자체 FAIL.
-
-## 5. Rubric (점수 가이드)
-
-| 점수 | 의미 | 조건 |
-|---|---|---|
-| 3.00 | Excellent | High/Medium 0건 + Threat Model 완전 + 증거 풍부 |
-| 2.85 | Strong PASS | High 0건 + Medium 0건 + Low 약간 (수용 가능) |
-| 2.80 | Threshold PASS | High 0건 + Medium 0건 |
-| 2.50 | Borderline FAIL | Medium 1~2건 |
-| 2.00 | FAIL | Medium 3건 이상 또는 Low 다수 + 가드 누락 |
-| 1.00 | Strong FAIL | High 1~2건 |
-| 0.00 | Reject | High 3건 이상 / 시크릿 노출 / Threat Model 누락 / Evidence-zero |
-
-## 6. Cross-Validation 트리거
-
-다음 발견 시 다른 Eval 축에 alert:
-
-| 발견 | Alert 대상 | 사유 |
-|---|---|---|
-| 인증 누락된 라우트 | Eval-Functional | AC에 권한 시나리오 누락 가능성 |
-| 클라이언트 측 secret | Eval-CodeQuality | 코드 위치·구조 문제 |
-| 인프라 권한 과대 | Eval-Architecture | IA-MAP·권한 매트릭스 충돌 |
-| PII 화면 노출 | Eval-Visual | 마스킹 표준 위반 |
-
-## 7. Regression Checkpoint
-
-CQO 위임으로 매 Sprint 종료 시:
-- 이전 PASS 받은 보안 baseline 재실행
-- 1건이라도 회귀(High 신규 출현) → Sprint 전체 FAIL
-
-## 8. 도구 통합 (스택별)
-
-스캔 도구는 `scan-project.sh` 결과의 스택에 따라 자동 선택:
-
-| 스택 | SAST | 의존성 | 시크릿 |
-|---|---|---|---|
-| Node/TS | semgrep, eslint-plugin-security | npm audit, osv-scanner | gitleaks |
-| Python | bandit, semgrep | pip-audit | gitleaks |
-| PHP/Laravel | phpstan-security, larastan | composer audit | gitleaks |
-| Go | gosec, semgrep | govulncheck | gitleaks |
-| Rust | cargo-audit | cargo-audit | gitleaks |
-
-도구 미설치 시 → install 명령을 cqo-audit에 권고로 첨부.
-
-## 9. progress.json 추가
-
-```json
-"eval_security": {
-  "last_audit": "<iso>",
-  "open_high": 0,
-  "open_medium": 0,
-  "secrets_found": 0,
-  "threat_model_path": ".harness/actions/threat-model.md",
-  "audit_path": ".harness/actions/evaluation-security-*.md"
-}
-```
-
-## 10. 권한 매트릭스
-
-| 파일 | 읽기 | 쓰기 |
-|---|---|---|
-| 코드 (apps/, libs/) | ✅ | ❌ |
-| evaluation-security-*.md | ✅ | ✅ |
-| threat-model.md | ✅ | ✅ |
-| feature-list.json | ✅ | passes 필드 confirm만 |
-| api-contract.json | ✅ | Change Request 첨부만 |
-
-## 11. Session Boundary Protocol
-
-### On Start
-1. progress.json 읽기 → 평가 대상 feature·diff 식별
-2. partial update: `current_agent = "evaluator-security"`, `agent_status = "running"`
-3. 직전 baseline 로드 (회귀 비교용)
-
-### On Complete
-1. evaluation-security-<feature>.md finalize
-2. partial update:
-   - `eval_security.open_high/medium`
-   - feature-list.json passes.security
-   - `agent_status = "completed"`, `next_agent` 결정
-3. CQO에 cross-validation 큐잉
-4. High 이상 발견 시 즉시 Conductor에 alert (Spec Review 또는 escalation 검토)
-
-## 12. 출처 (Attribution)
-
-agency-agents (MIT) 흡수:
-- `engineering-security-engineer`: 베이스라인 평가 자세
-- `engineering-threat-detection-engineer`: STRIDE/LINDDUN 모델링
-- `specialized-blockchain-security-auditor`: ZK·스마트컨트랙트 도메인 (옵트인)
-- `specialized-compliance-auditor`: 규제 매핑(GDPR·PCI 등)
-- `support-legal-compliance-checker`: 법적 컴플라이언스 체크
-- `specialized-agentic-identity-trust`: AI 에이전트 신원·신뢰
-- `specialized-zk-steward`: ZK 도메인(옵트인)

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)