@walwal-harness/cli 6.1.6 → 7.1.1

package/gotchas/evaluator-functional.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-evaluator-functional
-  title: Gotchas — uevaluator-ufunctional
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, evaluator-functional]
----
-
-# Gotchas — uevaluator-ufunctional
-
-> Dispatcher 가 관리. uevaluator-ufunctional 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/evaluator-security.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-evaluator-security
-  title: Gotchas — uevaluator-usecurity
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, evaluator-security]
----
-
-# Gotchas — uevaluator-usecurity
-
-> Dispatcher 가 관리. uevaluator-usecurity 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/evaluator-visual.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-evaluator-visual
-  title: Gotchas — uevaluator-uvisual
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, evaluator-visual]
----
-
-# Gotchas — uevaluator-uvisual
-
-> Dispatcher 가 관리. uevaluator-uvisual 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/generator-backend-laravel.md

@@ -1,19 +0,0 @@
----
-docmeta:
-  id: gotchas-generator-backend-laravel
-  title: Gotchas — Generator-Backend (Laravel/Livewire/Filament)
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, generator-backend, laravel]
----
-
-# Gotchas — Generator-Backend · Laravel/Livewire/Filament
-
-> 스택별 가드. Generator-Backend 는 Laravel 스택을 감지하면 `gotchas/generator-backend.md` 와 함께 이 파일을 추가로 읽습니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/generator-backend.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-generator-backend
-  title: Gotchas — ugenerator-ubackend
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, generator-backend]
----
-
-# Gotchas — ugenerator-ubackend
-
-> Dispatcher 가 관리. ugenerator-ubackend 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/generator-designer.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-generator-designer
-  title: Gotchas — ugenerator-udesigner
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, generator-designer]
----
-
-# Gotchas — ugenerator-udesigner
-
-> Dispatcher 가 관리. ugenerator-udesigner 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/generator-devops.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-generator-devops
-  title: Gotchas — ugenerator-udevops
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, generator-devops]
----
-
-# Gotchas — ugenerator-udevops
-
-> Dispatcher 가 관리. ugenerator-udevops 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/generator-frontend.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-generator-frontend
-  title: Gotchas — ugenerator-ufrontend
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, generator-frontend]
----
-
-# Gotchas — ugenerator-ufrontend
-
-> Dispatcher 가 관리. ugenerator-ufrontend 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/meeting-manager.md

@@ -1,30 +0,0 @@
----
-docmeta:
-  id: gotchas-meeting-manager
-  title: Gotchas — umeeting-umanager
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, meeting-manager]
----
-
-# Gotchas — umeeting-umanager
-
-> Dispatcher 가 관리. umeeting-umanager 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [G-SYS-MINUTES-NOT-OPS-TABLE] 회의록을 Service-Ops 상태표로 대체하지 말 것
-
-- Status: verified
-- Date: 2026-05-10
-- Trigger: hourly report 또는 meeting record가 서버 health table, queue 상태, "continue loop" 한 줄만 남기고 CEO/COO/CTO/CQO/Service-Ops가 무엇을 논의했는지 보여주지 않음.
-- Rule: Meeting-Manager의 산출물은 운영 리포트가 아니라 임원 회의록이다. `## Role Briefs` 또는 `## Required Role Positions`에 Dispatcher/CEO, Planner/COO, CTO, CQO, Service-Ops 전원의 Position/Evidence/Action이 있어야 하며, `## Discussion`, `## Decision JSON`, `## Action Items`가 없으면 회의 완료로 보고하지 않는다.
-- Fix: Service-Ops health table은 evidence로만 넣고, 토론과 decision owner/action_type으로 내부 실행 owner를 지정한다.

package/gotchas/planner.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-planner
-  title: Gotchas — uplanner
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, planner]
----
-
-# Gotchas — uplanner
-
-> Dispatcher 가 관리. uplanner 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/service-ops.md

@@ -1,30 +0,0 @@
----
-docmeta:
-  id: gotchas-service-ops
-  title: Gotchas — uservice-uops
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, service-ops]
----
-
-# Gotchas — uservice-uops
-
-> Dispatcher 가 관리. uservice-uops 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [G-SYS-ALERT-MUST-BECOME-MEETING-ACTION] 운영 경고를 혼자 남기고 끝내지 말 것
-
-- Status: verified
-- Date: 2026-05-10
-- Trigger: Service-Ops가 서버 down, health fail, KPI drift를 감지했지만 ops-report만 쓰고 CTO/CQO/Meeting-Manager action으로 연결하지 않음.
-- Rule: Service-Ops의 경고는 최종 산출물이 아니라 회의 evidence다. red-alert/down/degraded가 있으면 incident-war-room 또는 followup-review를 요구하고, CTO runtime-recovery action과 CQO evidence gate가 회의록에 남도록 해야 한다.
-- Fix: `.service_ops.incident.open[]`, ops-report path, health table을 evidence로 제출하고 `.meetings.requested_type`/`.meetings.requested_reason` 또는 meeting decision을 통해 다음 owner를 지정한다.

package/skills/_shared/dynamic-registration.md

@@ -1,120 +0,0 @@
----
-docmeta:
-  id: dynamic-registration
-  title: 동적 Gotcha / Convention 등록 — 모든 worker mandatory
-  type: input
-  createdAt: 2026-04-27T00:00:00Z
-  updatedAt: 2026-04-27T00:00:00Z
-  source:
-    producer: user
-    skillId: harness
-  inputs: []
-  tags: [harness, gotcha, convention, dynamic-registration, mandatory]
----
-
-# 동적 Gotcha / Convention 등록 — 모든 worker mandatory
-
-모든 Generator / Evaluator / Lead 는 자기 작업 결과물(`evaluation-*.md` / `gen-report-*.md` / `lead-report-*.md`) 끝에 **두 개의 fenced JSON 블록**을 반드시 포함한다. `harness-next.sh` 와 Team mode Lead 가 작업 직후 자동으로 `harness-gotcha-register.sh --scan-all` 을 호출하여 두 블록을 dedup append 한다.
-
-**왜 mandatory 인가**: 사용자 명시 — "Gen/Eval 이 발견한 패턴은 메뉴얼로 시키기 전에 동적으로 등록되어야 한다. 자동으로 패턴화되는 이슈는 등록하라." 한 번 발견된 실수가 다음 sprint 에서 반복되지 않게 하려면 발견자가 그 자리에서 등록하는 것이 유일한 closure.
-
-**금지**: 두 블록 중 하나라도 누락된 채로 작업 종료. 비어 있어도 `[]` 로 명시 (블록 자체 생략 금지).
-
----
-
-## 1) gotcha_candidates — 부정 가이드 (실수 패턴)
-
-**누가 등록**:
-- Evaluator: 평가 중 발견한 generator 의 반복 가능한 결함
-- Generator: 자기 작업 중 한 번 시도했다가 깨졌던 접근, 자체 fix 한 코드 실수
-- Lead (Team mode): worker 보고서들에서 N 회 반복되는 패턴 (≥2 occurrences 권장)
-
-**검출 기준** (하나라도 해당):
-- 같은 sprint 내 다른 feature 에서도 재발할 가능성이 있는 결함
-- generator 가 자주 빠뜨리는 케이스 (RSC↔CC 경계, schema 누락, missing not-found.tsx 등)
-- spec/contract 위반 패턴
-- AC 부분 통과 / Hard Gate 위반 사유
-- lint/type 이 한 번에 안 잡힌 케이스 (정적 분석으로 못 잡는 결함)
-
-**스키마**:
-```gotcha_candidates
-[
-  {
-    "target": "generator-frontend",
-    "rule_id": "rsc-cc-boundary-monitoring",
-    "title": "Server Component 에서 useState/useEffect 호출",
-    "wrong": "app/monitoring/page.tsx 에 'use client' 없이 hook 사용 → 빌드 통과해도 런타임에 깨짐",
-    "right": "client-side state 사용 시 파일 최상단에 'use client' 명시. 또는 server component 로 유지하면서 client 부분만 분리.",
-    "why": "Next.js App Router 의 RSC↔CC 경계는 정적 분석으로 100% 안 잡힘. F-209 에서 발견.",
-    "scope": "app/**/page.tsx, app/**/layout.tsx",
-    "source": "evaluator-functional:F-209"
-  }
-]
-```
-
-비어 있으면:
-```gotcha_candidates
-[]
-```
-
-필수 필드: `target`, `rule_id`, `title`. 권장 필드: `wrong`, `right`, `why`, `scope`, `source`.
-
-`target` 가능 값: `planner`, `dispatcher`, `brainstorming`, `generator-backend`, `generator-frontend`, `generator-frontend-flutter`, `evaluator-code-quality`, `evaluator-functional`, `evaluator-visual`, `evaluator-functional-flutter`.
-
-`rule_id` 는 dedup key — 같은 rule_id 가 이미 있으면 Occurrences +1 만 증가하고 본문은 안 바뀜. **kebab-case 짧고 의미 있는 식별자**.
-
----
-
-## 2) convention_candidates — 긍정 가이드 (반복 가능한 best practice)
-
-**누가 등록**:
-- Evaluator: 평가 중 확립된 반복 가능한 모범 사례
-- Generator: 작업 중 적용한 일관된 패턴 (다른 feature 에 모방되어야 하는)
-- Lead: sprint 전반에서 합의된 룰
-
-**검출 기준**:
-- 같은 sprint 의 다른 feature 가 모방해야 할 패턴
-- API 계약 / 폴더 구조 / 명명 규칙 관련 결정
-- 사용자가 "이렇게 해" 라고 한 한 번의 발언이 평가/생성에서 일반화 가능한 경우
-
-**스키마**:
-```convention_candidates
-[
-  {
-    "scope": "generator-frontend",
-    "rule_id": "route-segment-files",
-    "title": "App Router 세그먼트 필수 파일 세트",
-    "rule": "모든 app/**/page.tsx 는 같은 폴더에 not-found.tsx, error.tsx, loading.tsx 를 함께 배치한다.",
-    "why": "Next.js 의 segment-level 에러/로딩 처리. 누락 시 default 흰 화면 노출. F-209 평가에서 표준화 결정.",
-    "source": "evaluator-functional:F-209"
-  }
-]
-```
-
-비어 있으면:
-```convention_candidates
-[]
-```
-
-필수 필드: `rule_id`, `title`, `rule`. 권장 필드: `scope`, `why`, `source`.
-
-`scope` 가능 값: `shared` (전체 공통), `generator-backend`, `generator-frontend`, `evaluator-*`, `planner`. 미지정 시 `shared`.
-
----
-
-## 3) 등록 결과 확인
-
-작업 완료 후 다음 명령으로 등록된 항목 확인 가능:
-```bash
-bash scripts/harness-gotcha-register.sh . --scan-all  # 수동 재스캔
-ls .harness/gotchas/ .harness/conventions/             # 누적 결과
-tail -20 .harness/progress.log | grep gotcha-register  # 등록 로그
-```
-
-## 4) Team mode 추가 룰
-
-Team mode 에서 Lead 는 worker PASS/FAIL 처리 직후 (merge 전) 다음을 실행한다:
-```bash
-bash scripts/harness-gotcha-register.sh . --scan-all
-```
-이로써 worker 가 작성한 두 블록이 즉시 누적되며, 다음 worker spawn 시 새 worker 가 갱신된 gotchas/conventions 를 startup 에 읽어 같은 실수를 반복하지 않는다.

package/skills/brainstorming/SKILL.md

@@ -1,220 +0,0 @@
----
-name: harness-brainstorming
-description: "사용자의 러프한(바이브코딩) 요구사항을 대화형으로 구체화하여 Planner가 바로 쓸 수 있는 디자인/스펙 문서(.harness/actions/brainstorm-spec.md)로 만든다. Dispatcher가 사용자에게 '브레인스토밍 필요?' 라고 확인한 뒤에만 호출된다. 원본: obra/superpowers MIT."
-disable-model-invocation: false
----
-
-# Brainstormer — 요구사항 구체화 (obra/superpowers 파생)
-
-> **Attribution**: 이 스킬의 방법론은 [obra/superpowers](https://github.com/obra/superpowers)
-> (MIT License) 의 `skills/brainstorming` 을 walwal-harness 파이프라인에 맞게 이식한 것입니다.
-> 원본 저자(J. Hubbard 등)에게 감사드립니다. 상세 원본 텍스트 + 라이센스는
-> [references/attribution.md](references/attribution.md) 참조.
-
-## 역할
-
-walwal-harness 에서 Brainstormer 의 유일한 목적은 **러프한 바이브코딩 아이디어를
-Planner 가 곧바로 plan.md / feature-list.json / api-contract.json 으로 변환할 수 있는
-수준의 fit 한 요구사항 문서**로 구체화하는 것이다. 결과물은 단 하나:
-
-```
-.harness/actions/brainstorm-spec.md
-```
-
-이 파일이 생성되면 Planner 는 이것을 PRD 대체 입력으로 읽는다.
-
-## 언제 호출되는가
-
-**Dispatcher 가 사용자에게 명시적으로 "브레인스토밍 과정이 필요합니까?" 라고 묻고
-사용자가 승인한 경우에만 실행된다.** 이외의 모든 경로 (피드백, 이터레이션, 직접 에이전트
-명령, Gotcha 교정, 스프린트 retry) 에서는 호출되지 않는다. 사용자가 명확한 PRD 를
-제공하거나 브레인스토밍 불필요를 선언하면 Dispatcher 는 곧바로 `next_agent = planner`
-로 라우팅한다.
-
-## 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 == "brainstorming"` 인지 확인
-   - 아니면 즉시 STOP + "Dispatcher 를 먼저 실행하세요" 안내
-2. progress.json 업데이트: `current_agent` → `"brainstorming"`, `agent_status` → `"running"`, `updated_at` 갱신
-3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
-4. **Skip 조건 검사**: `.harness/actions/brainstorm-spec.md` 가 이미 존재하고
-   사용자가 "새로 브레인스토밍" 을 명시하지 않았다면:
-   - 사용자에게 "기존 brainstorm-spec.md 가 있습니다. 재사용(Y) / 새로 작성(N)?" 질문
-   - Y → 즉시 On Complete 로 이동 (interactive 단계 전부 스킵)
-   - N → 기존 파일을 `.harness/archive/brainstorm-spec-<timestamp>.md` 로 이동 후 interactive 시작
-
-### On Complete
-1. `.harness/actions/brainstorm-spec.md` 가 존재하고 "User Review Gate" 를 통과했는지 확인
-2. progress.json 업데이트:
-   - `agent_status` → `"completed"`
-   - `completed_agents` 에 `"brainstorming"` 추가
-   - `next_agent` → `"planner"`
-3. `.harness/progress.log` 에 요약 추가: `Brainstormer → Planner (spec: <경로>)`
-4. 출력: `"✓ Brainstormer 완료. brainstorm-spec.md 검토 후 승인 신호를 주세요. 승인 시 자동 핸드오프 (Conductor 자율 시동) (Planner)."`
-5. **사용자 승인 게이트**: 사용자의 명시적 승인 ("이 디자인 승인한다", "ok", "다음", "Planner 가자" 등) 을 기다린 후, **내부 핸드오프 (scripts/harness-next.sh) 를 호출하여 Planner 로 자동 핸드오프**.
-6. 사용자가 피드백/수정 요청을 하면 brainstorm-spec.md 를 갱신하고 다시 승인 요청. 승인 없이는 `/harness-next` 호출 금지 (HARD-GATE 준수).
-
-### On Fail / Abort
-사용자가 중간에 "중단" / "취소" / "abort" 를 요청하면:
-1. progress.json 업데이트: `agent_status` → `"blocked"`, `failure.message` → `"user aborted brainstorming"`
-2. 작성 중이던 `brainstorm-spec.md` 는 `.harness/archive/brainstorm-spec-draft-<timestamp>.md` 로 이동
-3. **STOP**. 사용자에게 "재시작 원하면 'dispatcher 다시'" 안내
-
-## HARD-GATE (원본에서 계승)
-
-> **Planner / Generator / 어떤 구현 에이전트도 호출하지 말라. 사용자가 "이 디자인 승인한다" 고
-> 명시적으로 말하기 전까지는 brainstorm-spec.md 를 저장하지도 않는다.**
-
-아무리 간단해 보이는 프로젝트라도 이 게이트를 건너뛰지 않는다. "Simple" 한 프로젝트가
-오히려 검증되지 않은 가정 때문에 가장 많은 시간을 낭비시킨다.
-
-## 체크리스트 (Brainstormer 내부 워크플로우)
-
-각 항목을 **순서대로** 수행하고 각 단계 끝에서 사용자 확인을 받는다:
-
-1. **프로젝트 컨텍스트 탐색** — 기존 파일, docs, 최근 커밋, `AGENTS.md`, `.harness/actions/`
-2. **Visual Companion 제안** (시각 요소가 많을 예정이라면, 단일 메시지로) — [visual-companion 가이드](references/visual-companion.md)
-3. **명확화 질문** — 한 번에 **하나씩**, 목적/제약/성공 기준 파악 (가능하면 객관식)
-4. **스코프 점검** — 여러 독립 서브시스템이 섞여 있으면 먼저 분할 제안 (예: "플랫폼 A + 채팅 + 결제" → 먼저 A 만)
-5. **2~3 개 접근법 제시** — 각 접근의 장단점 + 추천안 + 추천 이유
-6. **디자인 섹션별 제시** — 복잡도에 맞춰 섹션별 길이 조절, 각 섹션 끝에 사용자 확인
-   - 아키텍처, 컴포넌트, 데이터 흐름, 에러 처리, 테스트
-7. **사용자 디자인 승인** 받기
-8. **brainstorm-spec.md 저장** — `.harness/actions/brainstorm-spec.md` 에 커밋 (아래 스펙 포맷)
-9. **Spec Self-Review** — 플레이스홀더, 모순, 애매성, 스코프, YAGNI 체크. 발견 시 inline 수정
-   상세 → [spec-document-reviewer-prompt.md](references/spec-document-reviewer-prompt.md)
-10. **User Review Gate** — 사용자에게 작성된 파일을 리뷰 요청. 변경 요청 시 → 8번으로 복귀
-11. **Planner 로 핸드오프** — Session Boundary Protocol On Complete 실행
-
-## 핵심 원칙 (원본 계승)
-
-- **한 번에 한 질문** — 질문 폭탄 금지
-- **객관식 우선** — 가능하면 A/B/C/D 형태로
-- **YAGNI** — 요청되지 않은 기능은 전부 제거
-- **대안 탐색** — 결정하기 전에 항상 2-3 개 접근법 제시
-- **점진적 검증** — 섹션별로 제시하고 승인 후 다음
-- **유연성** — 중간에 "이건 안 맞는 것 같아" 가 나오면 언제든 이전 단계로 복귀
-
-## 출력 포맷: `.harness/actions/brainstorm-spec.md`
-
-```markdown
----
-docmeta:
-  id: brainstorm-spec
-  title: Brainstorm Spec — <프로젝트/기능 이름>
-  type: output
-  createdAt: <ISO 8601>
-  updatedAt: <ISO 8601>
-  source:
-    producer: agent
-    skillId: harness-brainstorming
-  inputs:
-    - documentId: user-conversation
-      uri: (inline — 사용자와의 대화 전체)
-      relation: output-from
-  tags: [brainstorming, spec, planner-input]
----
-
-# Brainstorm Spec — <프로젝트/기능 이름>
-
-## 1. 목적 (Purpose)
-<무엇을, 왜 만드는가 — 1-2 문단>
-
-## 2. 성공 기준 (Success Criteria)
-- [ ] ...
-- [ ] ...
-
-## 3. 스코프 (Scope)
-### In
-- ...
-### Out (명시적 제외)
-- ...
-
-## 4. 제약 (Constraints)
-- 기술 스택:
-- 성능:
-- 보안/컴플라이언스:
-- 기타:
-
-## 5. 선택된 접근법 (Chosen Approach)
-<2-3 개 대안 중 사용자가 승인한 것 + 이유>
-
-### 고려했던 대안
-- **Alt A**: ... (장/단점)
-- **Alt B**: ... (장/단점)
-
-## 6. 아키텍처 스케치
-<구성요소 + 상호작용 — ASCII 다이어그램 또는 간단한 설명>
-
-## 7. 주요 컴포넌트 / 엔티티
-- Component A — 책임:
-- Entity X — 필드/관계:
-
-## 8. 데이터 흐름 (Data Flow)
-<입력 → 처리 → 출력 → 저장 경로>
-
-## 9. 에러 처리 전략
-- 경계 에러:
-- 내부 에러:
-- 사용자 노출 메시지:
-
-## 10. 테스트 전략 (High-level)
-- Unit:
-- Integration:
-- E2E:
-
-## 11. Open Questions (Planner 가 확정할 것)
-- Q1: ...
-- Q2: ...
-
-## 12. 사용자 승인 로그
-- YYYY-MM-DD HH:MM — 섹션 <N> 승인 ("네, 좋아요")
-- YYYY-MM-DD HH:MM — 디자인 전체 승인
-- YYYY-MM-DD HH:MM — 작성 스펙 파일 리뷰 통과
-```
-
-## Planner 와의 인터페이스
-
-Planner 는 On Start 에 이 파일을 읽고:
-
-1. `1. 목적`, `2. 성공 기준`, `3. 스코프` → `plan.md` 의 사양서 도입부로 직접 반영
-2. `5. 선택된 접근법`, `6. 아키텍처 스케치` → MSA 서비스 분할 (full 모드) 또는 컴포넌트 설계의 베이스
-3. `7. 주요 컴포넌트 / 엔티티` → `feature-list.json` 초기 feature 목록 시드
-4. `11. Open Questions` → Planner 가 해소 (API 계약으로 확정)
-
-Planner 는 brainstorm-spec.md 에 있는 **승인된 결정** 을 뒤엎지 않는다. 필요한 경우
-`## Change Request` 섹션을 추가해 Dispatcher 를 통한 재논의 요청.
-
-## 금지 사항
-
-- `brainstorm-spec.md` 승인 전에 `plan.md`, `feature-list.json`, `api-contract.json` 작성
-- 코드 작성 / scaffolding / 파일 생성 (scripts/visual-companion 제외)
-- 여러 질문을 한 메시지에 몰아 넣기
-- 사용자 승인 없이 임의로 다음 섹션으로 진행
-- `.harness/archive/` 쓰기 금지 원칙 위반 (skip/abort 시 draft 이동 외에는 금지)
-
-## 참고
-
-- 원본 방법론 + 라이센스 → [references/attribution.md](references/attribution.md)
-- Visual Companion (브라우저 기반 목업/다이어그램 서버) → [references/visual-companion.md](references/visual-companion.md)
-- Spec self-review 상세 → [references/spec-document-reviewer-prompt.md](references/spec-document-reviewer-prompt.md)
-- Visual Companion 실행 스크립트 → `scripts/start-server.sh` (실행은 선택)