npm - @walwal-harness/cli - Versions diffs - 6.1.1 → 6.1.2 - Mend

@walwal-harness/cli 6.1.1 → 6.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md +8 -0
package/README.md +305 -368
package/assets/templates/config.json +7 -0
package/assets/templates/progress.json.template +13 -0
package/package.json +1 -1
package/scripts/harness-session-start.sh +54 -0
package/scripts/harness-token-limit.sh +99 -0
package/scripts/harness-user-prompt-submit.sh +23 -0

package/CHANGELOG.md CHANGED Viewed

@@ -29,6 +29,14 @@ docmeta:
 # Changelog
+## 6.1.2 — TokenLimit hold/resume checker (2026-05-08)
+### Added
+- `TaskStopReason: TokenLimit` 기반의 저비용 작업 재개 플로우 추가
+- `scripts/harness-token-limit.sh mark|resume-probe` 도입
+- SessionStart / UserPromptSubmit 가 TokenLimit hold 를 감지해 전체 작업 중지 및 재개 타이밍을 안내
+- `progress.json.task_stop` 과 `config.token_limit` 필드 추가
 ## 6.1.1 — COO hypothesis routing activation (2026-05-08)
 ### Why

package/README.md CHANGED Viewed

@@ -1,499 +1,436 @@
 # @walwal-harness/cli
-**AI 에이전트를 위한 프로덕션 하네스 엔지니어링 프레임워크**
+AI 에이전트 개발을 위한 회사형 하네스 프레임워크.
+walwal-harness 는 단일 에이전트를 오래 붙잡는 대신, 문서와 상태 파일을 기준으로 여러 역할을 이어 붙입니다.
+핵심 개념은 "하나의 프로젝트 = 하나의 회사" 입니다.
+- Owner: 사용자
+- Dispatcher: CEO, 유일한 대화 창구
+- Planner: COO, 기획·가설·HR
+- CTO: 구현 총괄
+- CQO: 품질 총괄
+- Service-Ops: 운영·모니터링·회고
+- Conductor: 자율 라우터
+- Meeting-Manager: 회의 소집기
+이 프레임워크는 Anthropic 의 harness engineering 방향과 NEXUS-style company loop 를 walwal-harness 구조에 맞게 재해석한 것입니다.
+## 핵심 원칙
+- 에이전트는 대화 기억보다 문서 팩트를 우선합니다.
+- 작업 전환은 항상 `progress.json`, `handoff.json`, `task session` 을 기준으로 이뤄집니다.
+- 회의는 동기화와 의사결정에 쓰고, 단순 런타임 복구는 값싼 상태 기반 로직으로 처리합니다.
+- TokenLimit, retry, drift, handoff 같은 운영 문제를 코드가 아니라 하네스 레벨에서 다룹니다.
+## 회사 구조
+```text
+Owner
+  ↕
+Dispatcher (CEO)
+  ├─ Conductor
+  └─ Meeting-Manager
+       ↓
+  Planner (COO + HR)
+    ├─ COO Hypothesis Cell
+    │  ├─ coo-developer
+    │  └─ documentationer
+    ├─ CTO
+    │  ├─ generator-backend
+    │  ├─ generator-frontend
+    │  ├─ generator-designer
+    │  └─ generator-devops
+    ├─ CQO
+    │  ├─ evaluator-code-quality
+    │  ├─ evaluator-functional
+    │  ├─ evaluator-visual
+    │  ├─ evaluator-architecture
+    │  └─ evaluator-security
+    └─ Service-Ops
+```
+### 각 부서가 하는 일
+- `Dispatcher`: 사용자 요청을 회사가 처리할 목표와 루프로 변환
+- `Meeting-Manager`: Standup, Sprint Review, Spec Review, Incident War Room, All-Hands 소집
+- `Conductor`: 다음 owner 와 next agent 를 재결정
+- `Planner`: 스펙, feature-list, api-contract, 가설 검증 셀 운영
+- `CTO`: 구현 라인 총괄, hotfix/기술 판단
+- `CQO`: 적대적 평가와 회귀 차단
+- `Service-Ops`: cadence, 운영 drift, auto-retro
+- `coo-developer`: 빠른 spike, backdata 검증
+- `documentationer`: 웹 리서치, 실험 보고서, 가설 유효/무효 판정
-> Solo: 20min/$9 (broken) → Harness: 6hr/$200 (fully functional)
-> — [Anthropic Engineering Blog](https://www.anthropic.com/engineering/harness-design-long-running-apps)
-같은 AI 모델이라도 **하네스 설계에 따라 결과물 품질이 극적으로 달라집니다.** walwal-harness는 Anthropic이 제안한 하네스 엔지니어링 패턴을 설치 한 번으로 즉시 사용할 수 있게 패키징한 프레임워크입니다.
----
+## 설치
-## Run Book — 0 → 첫 스프린트 완주
+프로젝트 루트에서:
-> 프로젝트 루트에서 `npm i @walwal-harness/cli` 를 마치고 Claude Code 를 재시작한 뒤 아래 순서 그대로 진행합니다.
+```bash
+npm i @walwal-harness/cli
+```
-### Step 1. Dispatcher — 들어오자마자
+설치 후 Claude Code 를 재시작합니다.
-Claude Code 세션을 연 뒤 첫 메시지로:
+초기화가 필요하면:
-```
-하네스 엔지니어링 시작
+```bash
+npx walwal-harness
 ```
-Dispatcher 가:
-- 요청을 분류 (기능 요청 / 실수 지적 / 메타 질문)
-- `FULLSTACK` / `FE-ONLY` / `BE-ONLY` 파이프라인 결정 → `actions/pipeline.json`
-- 신규/재플래닝이면 "Brainstormer 를 거칠지" 한 번 묻고 `next_agent` 설정 후 STOP
+기존 설치를 현재 패키지 버전에 맞게 다시 정리하려면:
-완료되면 **새 세션을 열기만 하면** SessionStart 훅이 다음 에이전트(`planner` 또는 `brainstorming`)를 안내합니다.
+```bash
+npx walwal-harness --force
+```
-### Step 2. Planner
+## 시작 방법
-새 세션에서:
+새 Claude Code 세션의 첫 메시지:
-```
-/harness-planner
+```text
+하네스 엔지니어링 시작
 ```
-Planner 가 `plan.md` + `feature-list.json` + `api-contract.json` 을 생성합니다. AC(Acceptance Criteria)는 반드시 **Executable** 포맷으로 기술됩니다.
+기본 흐름:
-### Step 3. Solo / Team 모드 선택
+1. `dispatcher` 가 요청을 분류하고 pipeline/runbook 을 정합니다.
+2. 필요하면 `meeting-manager` 가 CEO intake 회의를 엽니다.
+3. `planner` 가 `plan.md`, `feature-list.json`, `api-contract.json` 을 만듭니다.
+4. `conductor` 가 회사 루프에 따라 CTO/CQO/Service-Ops/Meeting 으로 라우팅합니다.
+5. generator / evaluator / cqo / ops 가 문서 기반으로 이어집니다.
-Planner 완료 후 두 갈래 중 하나.
+## 상태 파일
-| 선택 | 명령 | 언제 |
-|------|------|------|
-| **Solo** | 프롬프트로 `/harness-generator-backend` → `/harness-generator-frontend` → `/harness-evaluator-*` 순차 호출 | 학습 목적 · feature 3개 이하 · 레이아웃이 좁음 |
-| **Team** | `/harness-team` | feature 4개 이상 · 병렬로 확 밀고 싶을 때 |
+하네스의 기준 상태는 `.harness/` 아래에 있습니다.
-### Step 4. Team 모드 — Dashboard 띄우기
+| 파일 | 역할 |
+|---|---|
+| `.harness/progress.json` | 현재 회사 상태의 단일 기준 |
+| `.harness/handoff.json` | 다음 agent 실행 문서 |
+| `.harness/progress.log` | 사람 읽기용 활동 로그 |
+| `.harness/actions/` | 활성 sprint 문서 |
+| `.harness/archive/` | 완료 sprint 보관 |
-Team 모드는 tmux 통합 Studio 레이아웃을 제공합니다:
+### 중요한 progress 필드
-```bash
-# Claude Code 내에서
-> /harness-team
+- `current_agent`, `agent_status`, `next_agent`
+- `workflow.stage`
+- `meetings.*`
+- `task_sessions.current`
+- `task_stop.*`
+- `goals.*`
+- `conductor.*`, `planner.*`, `cto.*`, `cqo.*`, `service_ops.*`
-# 또는 외부 터미널에서
-npx walwal-harness team
-```
+## Task Session
-첫 실행 시 자동으로:
-1. `feature-queue.json` 초기화 (의존성 topological sort)
-2. tmux (또는 iTerm2 native split) 레이아웃 구축
-3. 3개 팀 worker 가 Gen → Eval 루프를 병렬 실행
-4. 팀이 feature 완료 시 자동 dequeue
-5. 5회 초과 실패하면 사용자 개입 요청
+각 agent 전환 시 `.harness/actions/task-sessions/<agent>/...md` 가 생성됩니다.
-#### 대시보드 구성
+목적:
-```
-┌────────────────────┬───────────────┬───────────┐
-│ Dashboard          │ Gotchas       │ TEAM 1    │
-│  - pipeline/sprint │  (활성 에이전트)│  Gen|Eval │
-│  - feature 진행도  ├───────────────┤           │
-│  - queue 상태      │ Conventions   ├───────────┤
-│                    │  (하우스 스타일)│ TEAM 2    │
-├────────────────────┤               │  Gen|Eval │
-│ Archive Prompt     ├───────────────┤           │
-│  (완료 feature 요약)│ Memory        ├───────────┤
-│                    │  (공유 교훈)   │ TEAM 3    │
-│                    │               │  Gen|Eval │
-└────────────────────┴───────────────┴───────────┘
-```
+- 이전 채팅 문맥을 들고 가지 않기
+- 자기편향적 사고를 줄이기
+- 사실과 추론을 분리하기
+- 재개 시에도 문서 기준으로만 이어가기
-| 패널 | 내용 | 소스 |
-|------|------|------|
-| **Dashboard** | Pipeline · Sprint · Feature passes · Queue R:B:P · Retry | `harness-dashboard.sh` |
-| **Gotchas** | 활성 에이전트의 누적 실수 (`[G-NNN]`) — v5.9.1 부터 독립 패널 | `harness-gotcha-memory.sh --mode gotcha` |
-| **Conventions** | 하우스 스타일 (`[C-NNN]`) — v5.9.1 부터 독립 패널, 독립 스크롤 | `harness-gotcha-memory.sh --mode conventions` |
-| **Memory** | 공유 교훈 (`memory.md`) — v5.9.1 부터 독립 패널 | `harness-gotcha-memory.sh --mode memory` |
-| **TEAM 1–3** | 각 워커의 현재 feature · phase(Gen/Eval) · 실시간 stdout | `harness-queue-manager.sh` worker loop |
-| **Archive Prompt** | 직전 완료 feature 요약 (다음 팀 컨텍스트 주입용) | archive 디렉토리 |
+에이전트는 task session, handoff, progress 를 단일 사실원으로 사용해야 합니다.
-> **v5.9.1+** Rules 컬럼이 3분할(Gotchas/Conventions/Memory)되어 각각 독립 스크롤됩니다. tmux/iTerm2 모두 동일한 레이아웃을 보장합니다.
+## 회의 시스템
-##### Feature 상태 아이콘 (v5.6.4+)
+회의는 계속 유지됩니다. 토큰 제한 복구 로직이 회의를 대체하지 않습니다.
-| 아이콘 | 상태 | 의미 |
-|--------|------|------|
-| `●` (녹색) | PASS | Evaluator 통과 · merge 완료 |
-| `◐` (청색) | IN PROGRESS | 현재 team 배정됨 (phase 표기: T1:gen / T2:eval) |
-| `○` (노랑) | READY | 의존성 해소됨 · idle team 배정 대기 |
-| `◍` (자색) | **BLOCKED** | 선행 feature 대기 · deps 개수 함께 표시 |
-| `◌` (어두움) | PENDING | 아직 큐 미등록 (sprint 미진입 or 사전 분석 단계) |
-| `✗` (빨강) | FAILED | 재시도 한도 도달 · 사용자 개입 필요 |
+지원 회의:
-##### Team Idle Auto-Dispatch (v5.6.4+)
+- `Standup`
+- `Sprint Review`
+- `Spec Review`
+- `Incident War Room`
+- `All-Hands`
-Worker 완료 시 Lead 는 `auto-dispatch` 한 호출로 **모든 idle team ↔ ready feature** 쌍을 원자적으로 재배정합니다. 의존성 없는 작업은 병렬로 즉시 시작되어 team idle 시간은 "Agent 생성 소요 초" 로 수렴:
+역할:
-```bash
-bash scripts/harness-queue-manager.sh auto-dispatch .
-# → [{"team":1,"feature":"F-001"},{"team":2,"feature":"F-002"}]
+- 회의: owner 결정, drift 분류, evidence 집계, action item 생성
+- Conductor: 회의 결과를 읽고 next agent 갱신
+- Service-Ops: cadence 계산
-bash scripts/harness-queue-manager.sh idle-slots .
-# → {"idle_teams":["3"], "ready_features":["F-003","F-004"], "dispatchable":1}
-```
+기본 cadence:
-- 새로고침 주기: `HARNESS_REFRESH=5` (초). 환경변수로 조정.
-- 단축키: `tmux prefix + 방향키` 로 패널 이동, `prefix + z` 로 확대/축소.
-- 종료: `npx walwal-harness team --kill`.
+- `light`: 30m
+- `normal`: 1h
+- `heavy`: 4h
-### Step 5. Feedback 등록 — 학습 누적
+## TokenLimit Hold / Resume
-대화 중 사용자 피드백은 **성격에 따라 3개 저장소** 중 하나로 자동 분류됩니다.
+`TokenLimit` 은 회의가 아니라 런타임 중단 복구 문제로 취급합니다.
-| 유형 | 성격 | 시그널 | 저장 위치 | ID |
-|------|------|--------|----------|-----|
-| **Gotcha** | 에이전트 실수(부정) | "~하지 마", "잘못됐어" | `.harness/gotchas/<agent>.md` | `G-NNN` |
-| **Convention** | 하우스 스타일(긍정) | "~해야 해", "이렇게 해줘" | `.harness/conventions/<scope>.md` | `C-NNN` |
-| **Memory** | 전체 공통 교훈 | "모든 에이전트가~" | `.harness/memory.md` | `M-NNN` |
+즉:
-#### 5a. Gotcha — "이러면 안 돼"
+- 회의 시스템은 그대로 유지
+- TokenLimit 은 별도 저비용 복구 레이어로 처리
-사용자가 에이전트의 실수를 지적하면 Dispatcher 가 해당 에이전트의 `.harness/gotchas/<agent>.md` 에 자동 append. 다음 세션부터 그 에이전트는 세션 시작 시 자기 gotcha 파일을 읽고 같은 실수를 피합니다.
+### 동작 방식
-#### 예제 — 실수 지적
+토큰 한도로 작업이 중단되면:
-```
-아니 그렇게 하면 안 되지. Generator-Backend 가 MockServer 를 무시하고
-실제 DB 에 붙으려고 하는데, npm run dev 에서 MockServer 가 concurrent 로
-기동되어 있으니 그걸 먼저 확인하고 써.
+```bash
+bash scripts/harness-token-limit.sh . mark
 ```
-Dispatcher 는 자동으로 분류:
-- **대상 에이전트**: `generator-backend`
-- **저장 위치**: `.harness/gotchas/generator-backend.md`
-- **ID 할당**: `[G-002]` (기존 항목 다음 번호)
-#### 기록 포맷 (Dispatcher 가 자동 작성)
-```markdown
-### [G-002] MockServer + npm run dev 자동 기동 + OpenAPI 동기화
-- **Date**: 2026-04-22
-- **Severity**: HIGH
-- **Occurrences**: 1
-- **Symptom**: 실제 DB 연결 시도 → 연결 실패로 스프린트 중단
-- **Rule**: `npm run dev` 는 MockServer 를 concurrent 로 기동한다.
-  API 호출 전 `http://localhost:3001/health` 를 확인할 것.
-- **Applies to**: generator-backend
-```
+기본 정책:
-#### 5b. Convention — "이렇게 해줘"
+- `TaskStopReason = TokenLimit`
+- 현재 작업은 `paused`
+- `progress.json.task_stop` 에 아래가 기록됨
+  - `wake_target`
+  - `resume_after`
+  - `stopped_agent`
+  - `stopped_next_agent`
+  - `task_session_path`
-긍정 가이드는 하우스 스타일로 등록됩니다:
+그 다음:
-```
-API 응답 필드는 전부 snake_case 로 해야 해. FE TS 모델이
-snake_case 로 정의돼 있어서 변환 레이어를 두기 싫어.
-```
+- `SessionStart` 는 별도 모델 probe 없이 시간만 확인
+- 아직 hold 중이면 `retry_after` 와 `wake target` 만 출력
+- 시간이 지나면 `# Harness resume ready` 를 출력하고 원래 CXX/agent 로 복귀
+테스트용:
-Dispatcher 자동 분류:
-- **스코프**: `generator-backend` (API 응답 → BE 스코프)
-- **저장 위치**: `.harness/conventions/generator-backend.md`
-- **ID 할당**: `[C-001]` (해당 파일의 기존 최댓값 + 1)
-기록 포맷 (자동 작성):
-```markdown
-### [C-001] API 응답 필드는 snake_case
-- **Date**: 2026-04-22
-- **Scope**: generator-backend
-- **Rule**: 모든 API 응답 JSON 필드는 snake_case (created_at, user_id 등).
-- **Rationale**: FE TS 모델이 snake_case 로 정의돼 있어 변환 레이어 불필요.
-- **Applies to**: generator-backend, libs/shared-dto
-- **Added from**: user prompt (2026-04-22 16:12)
+```bash
+bash scripts/harness-token-limit.sh . mark 300
 ```
-#### 스코프 판별 (Convention)
+중요:
-| 키워드 | 스코프 (파일) |
-|--------|-------------|
-| backend, API, controller, service, DTO, NestJS | `generator-backend.md` |
-| frontend, React, Next.js, UI, component, hook | `generator-frontend.md` |
-| plan, sprint, feature-list | `planner.md` |
-| Playwright, E2E, browser | `evaluator-functional.md` |
-| layout, screenshot, a11y, responsive | `evaluator-visual.md` |
-| code quality, lint, architecture | `evaluator-code-quality.md` |
-| 매칭 실패 + 에이전트 국한 | `shared.md` |
-| 프로젝트 철학 (예: "우리는 TDD") | 루트 `CONVENTIONS.md` 권고 |
+- 회의는 유지됩니다.
+- TokenLimit checker 는 회의를 대체하지 않습니다.
+- 에이전트는 복귀 시 이전 대화가 아니라 `task_session_path` 와 문서를 보고 이어갑니다.
-#### 에이전트 와이어링
+## COO Hypothesis Cell
-각 에이전트는 세션 시작 시 다음 순서로 읽고 적용:
+정규 CTO/CQO 라인에 넣기 전, COO 직속으로 빠른 가설 검증 셀을 돌릴 수 있습니다.
-```
-1. CONVENTIONS.md              (루트, 최상위 원칙)
-2. .harness/conventions/shared.md      (공통)
-3. .harness/conventions/<self>.md      (자기 스코프)
-4. .harness/gotchas/<self>.md          (과거 실수)
-5. .harness/memory.md                  (공유 교훈)
-```
+구성:
-충돌 시 우선순위: `<self>` > `shared` > 루트.
+- `coo-developer`
+- `documentationer`
-#### 5c. Memory — 프로젝트 전체 규칙
+흐름:
-한 에이전트 실수가 아니라 **모든 에이전트에 적용할 구조적 교훈** 이면 `.harness/memory.md` 로 승격:
+1. `planner.requested_mode = "hypothesis"`
+2. `documentationer` 가 리서치/질문 정리
+3. `coo-developer` 가 spike / backdata 실험
+4. `documentationer` 가 보고서와 verdict 작성
+5. `planner` 가 결과를 정규 sprint artifact 로 승격하거나 폐기
-```
-이건 특정 Generator 실수가 아니라 이 프로젝트 공통 규칙이야 —
-모든 테스트는 MockServer seed data 기반이어야 한다는 걸
-메모리에 올려줘.
-```
+핵심은 운영 품질이 아니라 빠른 사실 확인입니다.
-→ Dispatcher 가 `memory.md` 에 `### [M-NNN] ...` 로 기록. Planner 리뷰 후 `unverified → verified` 로 승격.
+## 모드
-#### 동적 Gotcha/Convention 자동 등록 (v5.9.0+)
+### Company / Team
-Worker 가 `gen-report-*.md` / `evaluation-*.md` 본문에 `gotcha_candidates` / `convention_candidates` 블록을 작성하면, Lead 가 PASS merge 직후 자동으로 dedup append:
+기본 경로입니다. Conductor 가 `mode=auto` 에서 선택합니다.
-```bash
-bash scripts/harness-gotcha-register.sh . --scan-all
-```
+특징:
+- 회사형 루프 유지
+- control-plane 과 worker-plane 분리
+- feature queue 기반 병렬 처리
+- tmux studio 사용 가능
-→ 다음 worker spawn 전에 갱신된 gotchas/conventions 가 file system 에 반영. **한 sprint 안에서 발견된 실수를 같은 sprint 의 다음 worker 가 즉시 회피**할 수 있게 됨. Generator 도 mandatory — 모든 에이전트가 후보를 자기 보고서에 남기는 것을 강제합니다.
+강제 전환:
-#### 주의 — 데이터 보존
+```text
+/harness-team
+```
-`npm install` postinstall 은 **누적 엔트리(`[G-NNN]` 또는 `[C-NNN]`)가 있는 파일을 절대 덮어쓰지 않습니다**. 스캐폴드 템플릿인 경우에만 갱신됩니다. v5.5.2 이전 버전은 gotchas 에 이 버그가 있었으므로 `5.6.0+` 사용을 권장합니다.
+### Solo
-#### 기존 프로젝트 마이그레이션 (첫 설치 시 자동)
+비상용 fallback 입니다.
-기존 `CLAUDE.md` / `AGENTS.md` 에 Convention/Gotcha 성격의 섹션(`Conventions`, `Coding Standards`, `Best Practices`, `Gotchas`, `Don't`, `주의사항`, `금지사항` 등)이 있다면 첫 설치 시 자동으로 추출되어:
+사용 시점:
-- **Convention 성격** → `.harness/conventions/<scope>.md` 에 `[C-NNN]` 으로 이관
-- **Gotcha 성격** → `.harness/gotchas/<agent>.md` 에 `[G-NNN]` 으로 이관
-- **원본** → `.harness/archive/pre-harness-*.md.bak` 에 백업
-- **리포트** → `.harness/MIGRATION_REPORT.md` 에 이관 내역 + 수동 확인 요청 사항 기록
+- 디버깅
+- 스크립트 장애
+- 짧은 수동 복구
-마이그레이션은 heuristic(키워드 기반)이므로 리포트를 확인해 스코프 재배정이 필요한지 검토하세요. 이미 하네스 서명(`[BE]`/`[FE]`/`[HARNESS]`)이 있는 문서는 skip 됩니다.
+강제 전환:
----
+```text
+/harness-solo
+```
-## Detail Architecture
+### Stop
-여기부터는 어떻게 구성되어 있는지, 왜 그렇게 설계했는지에 대한 상세 문서입니다.
+Team 모드를 안전하게 멈추고 진행 중이던 feature 를 ready 로 복구합니다.
-## 두 가지 모드
+```text
+/harness-stop
+```
-| 모드 | 설명 | 실행 방법 |
-|------|------|----------|
-| **Solo** | 순차 실행 — 프롬프트 기반으로 Planner → Generator → Evaluator 순서대로 진행 | `/harness-solo` 또는 프롬프트로 진행 |
-| **Team** | 병렬 실행 — 3 Team이 Feature 단위 Gen→Eval 루프를 자동 핸즈오프로 동시 실행 | `/harness-team` 또는 `npx walwal-harness team` |
+## Team Studio
-두 모드는 언제든 전환 가능합니다. Team 모드 중단 후 Solo로 이어가거나, Solo에서 Team으로 전환해도 진행 상태가 보존됩니다.
+Team 모드에서는 tmux 기반 Studio 레이아웃을 사용합니다.
----
+시작:
-## 설치
+```text
+/harness-team
+```
-### 첫 설치
+또는:
 ```bash
-cd your-project
-npm install @walwal-harness/cli
+npx walwal-harness team
 ```
-`postinstall`이 자동으로:
-1. `.harness/` 디렉토리 스캐폴딩
-2. `.claude/skills/` 에 에이전트 스킬 설치 (8개)
-3. `.claude/commands/` 에 모드 제어 커맨드 설치 (3개)
-4. `scripts/` 에 오케스트레이션 스크립트 설치
-5. SessionStart / UserPromptSubmit 훅 등록
-6. `AGENTS.md` + `CLAUDE.md` 심볼릭 링크 생성
+Team Studio 는 보통 다음을 보여줍니다.
-> **중요:** 설치 후 Claude Code 세션을 **재시작**해야 skills/commands가 인식됩니다.
+- Dashboard
+- Gotchas
+- Conventions
+- Memory
+- Team 1~3 worker pane
+- Archive prompt
-### 업데이트
+Queue 관련 유용한 명령:
 ```bash
-npm update @walwal-harness/cli
+bash scripts/harness-queue-manager.sh status .
+bash scripts/harness-queue-manager.sh auto-dispatch .
+bash scripts/harness-queue-manager.sh idle-slots .
 ```
-npm update 시 모든 시스템 파일(scripts, skills, commands, config 템플릿)이 **자동으로 교체**됩니다. 사용자 데이터(progress.json, progress.log, **gotchas 누적 엔트리**, memory.md, archive)는 보존됩니다.
+## Generator / Evaluator Chain
-### CLI 명령어
+구현과 평가는 분리됩니다.
-```bash
-npx walwal-harness              # 초기화 / 스크립트 업데이트
-npx walwal-harness --force      # 강제 재초기화
-npx walwal-harness team         # Team Mode tmux 레이아웃 실행
-npx walwal-harness team --kill  # Team Mode tmux 세션 종료
-npx walwal-harness --help       # 도움말
-```
+일반적인 흐름:
----
+1. `generator-backend`
+2. `generator-frontend`
+3. `evaluator-code-quality`
+4. `evaluator-functional`
+5. `evaluator-visual`
+6. `cqo`
+7. `service-ops`
-## 에이전트 구성
+평가자 체인 원칙:
-| 에이전트 | 역할 | 모델 |
-|----------|------|------|
-| **Dispatcher** | 요청 분석 → 파이프라인 결정 · gotcha 관리 | opus |
-| **Brainstormer** | 러프한 요구사항 → 구조화된 spec | opus |
-| **Planner** | 제품 사양 + API 계약서 + 서비스 분할 | opus |
-| **Generator-Backend** | NestJS MSA 서비스 구현 | sonnet |
-| **Generator-Frontend** | React/Next.js UI 구현 | sonnet |
-| **Evaluator-Code-Quality** | 코드 유지보수성/아키텍처/Best Practice (BE/FE/libs 공통, 브라우저 없음) | opus |
-| **Evaluator-Functional** | Playwright E2E 기능 검증 · API 계약 준수 | opus |
-| **Evaluator-Visual** | 레이아웃/접근성/AI슬롭 검증 | opus |
+- 앞단 FAIL 시 뒤 평가는 생략 가능
+- Evidence 없는 점수는 0
+- regression 1건 이상이면 전체 FAIL
+- evaluator 는 읽기 전용
-### Evaluator Chain (v5.5+)
+## Gotchas / Conventions / Memory
-Generator 이후는 **3-Evaluator 직렬 체인 + 조기 종료** 로 동작:
+하네스는 피드백을 세 저장소로 나눠 누적합니다.
-```
-Generator
-  → Evaluator-Code-Quality  (정적 · 저비용 · 브라우저 없음)
-  → Evaluator-Functional    (동작 · 중비용 · Playwright/curl)
-  → Evaluator-Visual        (렌더 · 고비용 · 스크린샷)
-  → Archive
-```
+| 종류 | 용도 |
+|---|---|
+| `gotchas/` | 에이전트가 반복한 실수 |
+| `.harness/conventions/` | 하우스 스타일 |
+| `.harness/memory.md` | 프로젝트 전역 교훈 |
-앞단 FAIL 시 뒤 평가자는 실행하지 않고 바로 Generator 재작업으로 리라우팅. BE-ONLY 파이프라인에서는 Visual 이 체인에서 제외됩니다.
+각 agent 는 세션 시작 시 다음 순서로 읽습니다.
-| 단계 | 채점 축 | Weight | 도구 |
-|------|---------|--------|------|
-| Code-Quality | C1 Layer · C2 Readability · C3 DRY · C4 Type/Error · C5 Test | 25/15/20/25/15 | Read/Grep + tsc/eslint |
-| Functional   | R1 Contract · R2 AC · R3 Negative · R4 E2E · R5 Error | 25/25/20/15/15 | Playwright 또는 curl |
-| Visual       | V1 Layout · V2 Responsive · V3 A11y · V4 Consistency · V5 Interaction | 20×5 | Playwright 스크린샷 |
+1. `CONVENTIONS.md`
+2. `.harness/conventions/shared.md`
+3. `.harness/conventions/<self>.md`
+4. `.harness/gotchas/<self>.md`
+5. `.harness/memory.md`
-### Evaluation 기준
-- PASS: Weighted Score ≥ 2.80 / 3.00
-- AC 100% 충족 필수 (부분 통과 = FAIL)
-- Regression 실패 1건+ = FAIL (이전 Sprint PASS 기능 재검증)
-- Evidence 없는 Score = 0점 강제 재계산
-- Cross-Validation 불일치 1건+ = CONDITIONAL FAIL
-- Team Mode: 최대 5회 재시도 후 사용자 개입 요청
+## 주요 스크립트
----
+| 스크립트 | 역할 |
+|---|---|
+| `scripts/harness-next.sh` | handoff 생성과 다음 agent 결정 |
+| `scripts/conductor-tick.sh` | company loop 라우팅 |
+| `scripts/harness-session-start.sh` | 새 세션 시작 시 자동 안내 |
+| `scripts/harness-user-prompt-submit.sh` | prompt 훅 주입/차단 |
+| `scripts/harness-task-session.sh` | agent 별 task session 생성 |
+| `scripts/harness-token-limit.sh` | TokenLimit hold/resume 마킹 |
+| `scripts/harness-queue-manager.sh` | team queue 관리 |
+| `scripts/harness-dashboard.sh` | dashboard 렌더 |
+| `scripts/harness-meeting-doc.sh` | 회의 문서 skeleton / decision 처리 |
-## 솔로 파이프라인 상세
+## 디렉토리 구조
-```
-사용자 요청 → Dispatcher → (Brainstormer) → Planner
-→ Generator-Backend → Generator-Frontend
-→ Evaluator-Code-Quality → Evaluator-Functional → Evaluator-Visual
-→ PASS: 다음 Sprint | FAIL: Generator로 재시도 (최대 5회)
-```
+```text
+.harness/
+├── actions/
+│   ├── plan.md
+│   ├── feature-list.json
+│   ├── api-contract.json
+│   ├── sprint-contract.md
+│   ├── meetings/
+│   ├── incidents/
+│   └── task-sessions/
+├── archive/
+├── progress.json
+├── handoff.json
+├── progress.log
+├── config.json
+└── doctrine/
+```
+상세 조직 규칙은 다음 문서를 봅니다.
+- `AGENTS.md`
+- `.harness/doctrine/nexus.md`
+- `.harness/agency-mapping.md`
+- `.harness/HARNESS.md`
-각 에이전트는 **독립 Claude Code 세션** 에서 실행됩니다. Session Boundary Protocol 이 On Start / On Complete / On Fail 훅으로 progress.json 을 갱신하고 STOP. 다음 세션을 열면 SessionStart 훅이 자동으로 다음 에이전트를 안내합니다.
+## Troubleshooting
-## 팀 파이프라인 상세
+### 다음 agent 가 안 뜸
 ```bash
-# Planner 완료 후
-> /harness-team
-# 자동 실행 흐름:
-# 1. feature-queue.json 초기화 (의존성 topological sort)
-# 2. tmux Studio 레이아웃 구축
-# 3. 3개 팀이 병렬로 Gen→Eval 루프 자동 실행
-# 4. 팀 완료 시 자동으로 다음 feature dequeue
-# 5. 5회 초과 실패 시 사용자 개입 요청
+cat .harness/progress.json | jq '{current_agent, agent_status, next_agent, workflow, task_stop}'
 ```
-### 모드 전환
-| 명령 | 설명 |
-|------|------|
-| `/harness-team` | Team 모드 시작/재개 |
-| `/harness-solo` | Solo 모드로 전환 (진행 상태 보존) |
-| `/harness-stop` | Team 모드 중단 (queue 보존, 나중에 재개 가능) |
+### handoff 재생성
-```
-Team 실행 중 → /harness-stop → /harness-solo → 프롬프트로 계속
-                                    ↓
-                              /harness-team → 나머지 feature 팀 재개
+```bash
+bash scripts/harness-next.sh .
 ```
----
-## 디렉토리 구조
+### SessionStart 안내 확인
-```
-your-project/
-├── .harness/
-│   ├── config.json                    # 하네스 설정
-│   ├── progress.json                  # 런타임 상태 (mode, sprint, agent)
-│   ├── progress.log                   # 실시간 이벤트 로그
-│   ├── memory.md                      # 공유 학습 기록 (모든 에이전트 공통)
-│   ├── HARNESS.md                     # 하네스 상세 가이드
-│   ├── actions/                       # 활성 스프린트 문서
-│   │   ├── pipeline.json              # Dispatcher 결정 (evaluator_chain 포함)
-│   │   ├── plan.md
-│   │   ├── feature-list.json          # Feature 목록 + Executable AC
-│   │   ├── api-contract.json
-│   │   ├── feature-queue.json         # Feature Queue 상태 (Team Mode)
-│   │   ├── sprint-contract.md
-│   │   ├── evaluation-code-quality.md
-│   │   ├── evaluation-functional.md
-│   │   └── evaluation-visual.md
-│   ├── archive/                       # 완료 스프린트 보관 (불변, 마이그레이션 백업도 여기)
-│   ├── gotchas/                       # 에이전트 실수 기록 [G-NNN] (누적 보존)
-│   │   ├── planner.md
-│   │   ├── generator-backend.md
-│   │   ├── generator-frontend.md
-│   │   ├── evaluator-code-quality.md
-│   │   ├── evaluator-functional.md
-│   │   └── evaluator-visual.md
-│   ├── conventions/                   # 하우스 스타일 [C-NNN] (v5.6+, 누적 보존)
-│   │   ├── shared.md
-│   │   ├── planner.md
-│   │   ├── generator-backend.md
-│   │   ├── generator-frontend.md
-│   │   ├── evaluator-code-quality.md
-│   │   ├── evaluator-functional.md
-│   │   └── evaluator-visual.md
-│   └── MIGRATION_REPORT.md            # 첫 설치 시 기존 문서 이관 내역 (있을 때만)
-├── .claude/
-│   ├── skills/harness-*/              # 에이전트 스킬 (8개)
-│   ├── commands/harness-*.md          # 모드 제어 커맨드 (3개)
-│   └── settings.json                  # 훅, statusline
-├── scripts/
-│   ├── harness-tmux.sh                # 통합 tmux 레이아웃 (Solo/Team)
-│   ├── harness-dashboard.sh           # 통합 대시보드
-│   ├── harness-gotcha-memory.sh       # Gotcha & Memory 패널
-│   ├── harness-monitor.sh             # 에이전트 모니터
-│   ├── harness-queue-manager.sh       # Feature Queue 관리
-│   ├── harness-next.sh                # 에이전트 전환 라우터
-│   ├── harness-session-start.sh       # SessionStart 훅
-│   ├── harness-user-prompt-submit.sh  # UserPromptSubmit 훅
-│   ├── harness-statusline.sh          # 상태바
-│   ├── harness-prompt-history.sh      # 프롬프트 히스토리
-│   └── lib/                           # 공유 라이브러리
-├── AGENTS.md                          # 프로젝트 컨텍스트 (IA-MAP)
-├── CLAUDE.md → AGENTS.md              # 심볼릭 링크
-└── CONVENTIONS.md                     # 최상위 원칙 (사용자 자유 기술, 하위는 .harness/conventions/)
+```bash
+bash scripts/harness-session-start.sh
 ```
----
-## Troubleshooting
+### TokenLimit hold 상태 확인
-### Skills/Commands가 인식되지 않음
 ```bash
-# Claude Code 세션 재시작
-/exit
-claude
+cat .harness/progress.json | jq '.task_stop'
 ```
-### Team 모드에서 "No features ready"
+### queue 상태 확인
 ```bash
-# Queue 상태 확인
 bash scripts/harness-queue-manager.sh status .
-# 실패한 feature requeue
-bash scripts/harness-queue-manager.sh requeue F-001 .
 ```
-### 모드 전환 후 상태 꼬임
-```bash
-# progress.json 직접 확인
-cat .harness/progress.json | jq '{mode, sprint, current_agent, next_agent}'
+### mode 강제 전환
-# 강제 Solo 복귀
-jq '.mode = "solo"' .harness/progress.json > /tmp/p.json && mv /tmp/p.json .harness/progress.json
+```text
+/harness-team
+/harness-solo
+/harness-stop
 ```
-### 대시보드에 feature title 이 "?" 로 표시
-- v5.5.1 에서 해결 (feature 의 `name`/`title`/`description` 순으로 fallback).
-- 그 이전 버전이면 `npm i @walwal-harness/cli@latest` 로 업데이트.
-### Gotcha 가 누적되지 않고 사라짐
-- v5.5.2 에서 해결 (postinstall 이 누적 엔트리를 절대 덮어쓰지 않도록 수정).
-- 반드시 `5.5.2+` 사용.
+## 버전 호환성
-### Dashboard 헤더가 SOLO 인데 실제로는 팀 모드로 돌고 있음
-- v5.9.5 에서 해결. `feature-queue.json.queue.in_progress > 0` 이면 dashboard refresh / tmux 재기동 시 자동으로 `mode=team` 으로 self-heal 합니다.
-- 그 이전 버전: `progress.json` 의 `mode` 만 직접 수정하거나 새 세션을 열어 SessionStart 훅의 heal 을 트리거.
+README 는 v6.1 계열 회사형 하네스를 기준으로 작성되었습니다.
-### `progress.json` 손상 시 dashboard crash
-- v5.9.4 에서 해결. invalid JSON 인 경우 안내 메시지로 graceful degrade. 복구 가이드는 dashboard 본문에 inline 표시됩니다.
+이 문서에서 전제하는 기능:
----
+- company loop
+- conductor / meeting-manager / cto / cqo / service-ops
+- task-session isolation
+- COO hypothesis cell
+- TokenLimit hold/resume
 ## License

package/assets/templates/config.json CHANGED Viewed

@@ -342,6 +342,13 @@
     "auto_route_dispatcher": true,
     "auto_route_dispatcher_description": "true 이면 사용자의 모든 프롬프트가 harness-dispatcher 경유로 분류/라우팅 된다. 사용자가 'harness skip' 등을 말하면 단일 메시지 한정으로 건너뛴다."
   },
+  "token_limit": {
+    "comment": "모델 토큰 제한으로 작업이 중단됐을 때의 저비용 재개 정책. 별도 probe 호출 없이 시간 기반으로만 재개 알림을 계산한다.",
+    "stop_reason_flag": "TokenLimit",
+    "retry_after_seconds": 3600,
+    "re_notify_every_seconds": 3600,
+    "owner": "session-start"
+  },
   "mode_selection": {
     "comment": "v6.0 — Solo/Team 모드를 사용자가 아닌 Conductor 가 결정. progress.json.mode='auto' 일 때 Conductor 가 feature-list 의 ready_count + 의존성 깊이 + sprint feature 수를 보고 룰을 적용. 사용자는 /harness-solo 또는 /harness-team 으로 override 가능하며 그 결정은 progress.json.mode_decision.user_override 에 기록된다.",
     "default_mode": "auto",

package/assets/templates/progress.json.template CHANGED Viewed

@@ -28,6 +28,19 @@
     "message": null,
     "retry_target": null
   },
+  "task_stop": {
+    "active": false,
+    "reason": null,
+    "stopped_at": null,
+    "resume_after": null,
+    "resume_ready": false,
+    "resume_notified_at": null,
+    "wake_target": null,
+    "stopped_agent": null,
+    "stopped_next_agent": null,
+    "task_session_path": null,
+    "hold_count": 0
+  },
   "artifacts": {
     "plan.md": { "status": "pending", "updated_by": null, "updated_at": null },
     "feature-list.json": { "status": "pending", "updated_by": null, "updated_at": null },

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.1.1",
+  "version": "6.1.2",
   "description": "Production harness for AI agent engineering — NEXUS-adapted company metaphor (Dispatcher/CEO + Conductor + Meeting-Manager + COO/Planner + CTO + CQO + Service-Ops). Solo/Team mode, Brainstormer, Planner, Generator(BE/FE/Designer/DevOps), Evaluator chain (Code-Quality → Functional → Visual + Architecture/Security). Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-session-start.sh CHANGED Viewed

@@ -27,6 +27,23 @@ next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
 agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
 mode=$(jq -r '.mode // "team"' "$PROGRESS" 2>/dev/null)
 conductor_state=$(jq -r '.conductor.state // "idle"' "$PROGRESS" 2>/dev/null)
+task_stop_active=$(jq -r '.task_stop.active // false' "$PROGRESS" 2>/dev/null)
+task_stop_reason=$(jq -r '.task_stop.reason // "null"' "$PROGRESS" 2>/dev/null)
+task_stop_resume_after=$(jq -r '.task_stop.resume_after // "null"' "$PROGRESS" 2>/dev/null)
+task_stop_notified_at=$(jq -r '.task_stop.resume_notified_at // "null"' "$PROGRESS" 2>/dev/null)
+task_stop_wake_target=$(jq -r '.task_stop.wake_target // .next_agent // "none"' "$PROGRESS" 2>/dev/null)
+task_stop_task_session=$(jq -r '.task_stop.task_session_path // "null"' "$PROGRESS" 2>/dev/null)
+parse_iso_epoch() {
+  local iso="${1:-}"
+  [ -n "$iso" ] && [ "$iso" != "null" ] || return 1
+  date -u -j -f "%Y-%m-%dT%H:%M:%SZ" "$iso" "+%s" 2>/dev/null \
+    || date -u -d "$iso" "+%s" 2>/dev/null
+}
+now_epoch() {
+  date -u "+%s"
+}
 # ─────────────────────────────────────────
 # Auto-heal mode drift — Team 상태 유실 복구
@@ -79,6 +96,43 @@ if [ "$mode" = "paused" ]; then
   exit 0
 fi
+# ─────────────────────────────────────────
+# TokenLimit hold — zero-token resume reminder
+# ─────────────────────────────────────────
+if [ "$task_stop_active" = "true" ] && [ "$task_stop_reason" = "TokenLimit" ]; then
+  retry_interval=$(jq -r '.token_limit.re_notify_every_seconds // 3600' "$CONFIG" 2>/dev/null || echo 3600)
+  resume_after_epoch=$(parse_iso_epoch "$task_stop_resume_after" || echo 0)
+  now_ts=$(now_epoch)
+  notified_epoch=$(parse_iso_epoch "$task_stop_notified_at" || echo 0)
+  if [ "$now_ts" -lt "$resume_after_epoch" ]; then
+    echo "# Harness paused — TokenLimit hold"
+    echo "# Wake target: /harness-${task_stop_wake_target}"
+    echo "# Retry after: ${task_stop_resume_after}"
+    if [ "$task_stop_task_session" != "null" ] && [ -n "$task_stop_task_session" ]; then
+      echo "# Task session: ${task_stop_task_session}"
+    fi
+    exit 0
+  fi
+  if [ "$notified_epoch" -eq 0 ] || [ $((now_ts - notified_epoch)) -ge "$retry_interval" ]; then
+    bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
+      ".agent_status = \"pending\" |
+       .current_agent = null |
+       .next_agent = \"${task_stop_wake_target}\" |
+       .task_stop.active = false |
+       .task_stop.resume_ready = true |
+       .task_stop.resume_notified_at = (now | todate)" \
+      >/dev/null 2>&1 || true
+    echo "# Harness resume ready — TokenLimit hold expired"
+    echo "# Resume target: /harness-${task_stop_wake_target}"
+    if [ "$task_stop_task_session" != "null" ] && [ -n "$task_stop_task_session" ]; then
+      echo "# Resume with task session: ${task_stop_task_session}"
+    fi
+    exit 0
+  fi
+fi
 # ─────────────────────────────────────────
 # init 상태: 첫 안내
 # ─────────────────────────────────────────

package/scripts/harness-token-limit.sh ADDED Viewed

@@ -0,0 +1,99 @@
+#!/bin/bash
+# harness-token-limit.sh — mark/resume token-limit interruptions
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+PROJECT_ROOT="$(resolve_harness_root "${1:-.}")" || exit 1
+CMD="${2:-mark}"
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+CONFIG="$PROJECT_ROOT/.harness/config.json"
+[ -f "$PROGRESS" ] || exit 1
+command -v jq >/dev/null 2>&1 || exit 1
+parse_iso_epoch() {
+  local iso="${1:-}"
+  [ -n "$iso" ] && [ "$iso" != "null" ] || return 1
+  date -u -j -f "%Y-%m-%dT%H:%M:%SZ" "$iso" "+%s" 2>/dev/null \
+    || date -u -d "$iso" "+%s" 2>/dev/null
+}
+mark_token_limit() {
+  local retry_secs current next task_path target stop_reason
+  retry_secs="${3:-$(jq -r '.token_limit.retry_after_seconds // 3600' "$CONFIG" 2>/dev/null || echo 3600)}"
+  stop_reason=$(jq -r '.token_limit.stop_reason_flag // "TokenLimit"' "$CONFIG" 2>/dev/null || echo "TokenLimit")
+  current=$(jq -r '.current_agent // "null"' "$PROGRESS")
+  next=$(jq -r '.next_agent // "null"' "$PROGRESS")
+  task_path=$(jq -r '.task_sessions.current.path // "null"' "$PROGRESS")
+  target="$current"
+  if [ "$target" = "null" ] || [ -z "$target" ]; then
+    target="$next"
+  fi
+  [ "$target" != "null" ] || target="dispatcher"
+  local stopped_at resume_after
+  stopped_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  resume_after="$(date -u -v+"${retry_secs}"S +%Y-%m-%dT%H:%M:%SZ 2>/dev/null \
+    || date -u -d "+${retry_secs} seconds" +%Y-%m-%dT%H:%M:%SZ)"
+  bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" "
+    .agent_status = \"paused\" |
+    .next_agent = \"$target\" |
+    .task_stop.active = true |
+    .task_stop.reason = \"$stop_reason\" |
+    .task_stop.stopped_at = \"$stopped_at\" |
+    .task_stop.resume_after = \"$resume_after\" |
+    .task_stop.resume_ready = false |
+    .task_stop.resume_notified_at = null |
+    .task_stop.wake_target = \"$target\" |
+    .task_stop.stopped_agent = $(jq -Rn --arg v "$current" '$v') |
+    .task_stop.stopped_next_agent = $(jq -Rn --arg v "$next" '$v') |
+    .task_stop.task_session_path = $(jq -Rn --arg v "$task_path" '$v') |
+    .task_stop.hold_count = ((.task_stop.hold_count // 0) + 1)
+  " >/dev/null
+  echo "[token-limit] marked: target=$target resume_after=$resume_after"
+}
+resume_probe() {
+  local active reason resume_after wake_target
+  active=$(jq -r '.task_stop.active // false' "$PROGRESS")
+  reason=$(jq -r '.task_stop.reason // "null"' "$PROGRESS")
+  resume_after=$(jq -r '.task_stop.resume_after // "null"' "$PROGRESS")
+  wake_target=$(jq -r '.task_stop.wake_target // .next_agent // "null"' "$PROGRESS")
+  if [ "$active" != "true" ] || [ "$reason" != "TokenLimit" ]; then
+    echo "[token-limit] no active TokenLimit hold"
+    exit 0
+  fi
+  local resume_epoch now_ts
+  resume_epoch=$(parse_iso_epoch "$resume_after" || echo 0)
+  now_ts=$(date -u "+%s")
+  if [ "$now_ts" -lt "$resume_epoch" ]; then
+    echo "[token-limit] still held until $resume_after"
+    exit 1
+  fi
+  bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" "
+    .agent_status = \"pending\" |
+    .current_agent = null |
+    .next_agent = \"$wake_target\" |
+    .task_stop.active = false |
+    .task_stop.resume_ready = true |
+    .task_stop.resume_notified_at = (now | todate)
+  " >/dev/null
+  echo "[token-limit] resume ready: wake_target=$wake_target"
+}
+case "$CMD" in
+  mark) mark_token_limit "$@" ;;
+  resume-probe) resume_probe ;;
+  *)
+    echo "usage: $0 <project-root> <mark|resume-probe> [retry_seconds]" >&2
+    exit 2
+    ;;
+esac

package/scripts/harness-user-prompt-submit.sh CHANGED Viewed

@@ -42,6 +42,17 @@ if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
   AGENT_STATUS=$(jq -r '.agent_status // "pending"' "$CWD/.harness/progress.json" 2>/dev/null || echo "pending")
 fi
+TASK_STOP_ACTIVE="false"
+TASK_STOP_REASON="null"
+TASK_STOP_RESUME_AFTER="null"
+TASK_STOP_WAKE_TARGET="none"
+if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
+  TASK_STOP_ACTIVE=$(jq -r '.task_stop.active // false' "$CWD/.harness/progress.json" 2>/dev/null || echo "false")
+  TASK_STOP_REASON=$(jq -r '.task_stop.reason // "null"' "$CWD/.harness/progress.json" 2>/dev/null || echo "null")
+  TASK_STOP_RESUME_AFTER=$(jq -r '.task_stop.resume_after // "null"' "$CWD/.harness/progress.json" 2>/dev/null || echo "null")
+  TASK_STOP_WAKE_TARGET=$(jq -r '.task_stop.wake_target // .next_agent // "none"' "$CWD/.harness/progress.json" 2>/dev/null || echo "none")
+fi
 # ── 명령 히스토리 기록 (모든 모드 공통) ──
 PROGRESS_LOG="$CWD/.harness/progress.log"
 if [ -n "$PROMPT" ] && [ -d "$CWD/.harness" ]; then
@@ -79,6 +90,18 @@ EOF
   exit 0
 fi
+if [ "$TASK_STOP_ACTIVE" = "true" ] && [ "$TASK_STOP_REASON" = "TokenLimit" ]; then
+  cat <<EOF
+[harness] token-limit hold | wake_target=${TASK_STOP_WAKE_TARGET}
+## TokenLimit Hold
+- 모든 작업은 일시중지 상태입니다.
+- 재개 대상: /harness-${TASK_STOP_WAKE_TARGET}
+- retry_after: ${TASK_STOP_RESUME_AFTER}
+- 이 상태는 문서 기반으로만 복구되며, 별도 모델 probe는 수행하지 않습니다.
+EOF
+  exit 0
+fi
 # ── Mode 기반 분기 ──
 MODE="team"
 if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then