@walwal-harness/cli 6.1.6 → 7.1.1

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

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

package/skills/service-ops/SKILL.md

@@ -1,295 +0,0 @@
----
-name: harness-service-ops
-description: "운용팀. 배포된 산출물을 운영하며 GOAL 적합도를 주기·이벤트로 검사하고, 사고 대응·자율 회고 리포트를 작성하여 CTO에 전달. 3 모듈: Monitor(모니터링·cron), Incident(사고대응), Auto-Retro(자율 회고). 코드 수정 권한 없음(읽기·리포트만). 트리거: 'service ops', '운용', 'incident', 'monitor'."
-disable-model-invocation: false
----
-
-<!--
-Source: https://github.com/msitarzewski/agency-agents (MIT)
-재해석 출처:
-- engineering/engineering-sre.md
-- engineering/engineering-incident-response-commander.md
-- engineering/engineering-autonomous-optimization-architect.md
-- support/support-infrastructure-maintainer.md
-- support/support-analytics-reporter.md
-- support/support-executive-summary-generator.md
-- product/product-feedback-synthesizer.md
-- testing/testing-reality-checker.md
-- specialized/automation-governance-architect.md
-- specialized/report-distribution-agent.md
--->
-
-# Service-Ops — 운용팀
-
-> "개발은 끝났다. 진짜 일은 지금부터다."
-> Dispatcher(CEO) 직속, CTO·CQO와 평행. 코드는 쓰지 않는다. 보고서가 무기다.
-
-## 1. 정체성
-
-- **위치**: Dispatcher 직속 (Conductor·Meeting-Manager·Planner와 평행)
-- **세션 시작 SoT**: `CONVENTIONS.md`, `.harness/conventions/shared.md`, `.harness/conventions/service-ops.md`, `.harness/gotchas/service-ops.md`, `.harness/memory.md` 를 먼저 읽고 Service-Ops 역할 계약을 적용한다.
-- **책임**:
-  1. 배포 후 GOAL 적합도·헬스·메트릭 모니터링
-  2. 사고 발생 시 즉시 대응 + War Room 소집 트리거
-  3. 자율 회고 리포트 생성 → CTO에 핸드오프
-  4. Meeting 적응형 cadence 계산 (Service-Ops 위임 책임)
-- **금지**: 코드 수정, AC·feature-list 수정, GOAL 수정. **읽기·관찰·리포트만**.
-
-## 2. 3 모듈
-
-```
-service-ops/
-  ├── monitor       (주기·이벤트 감시, cron 책임 일원화)
-  ├── incident      (사고대응 commander)
-  └── auto-retro    (자율 회고 리포터)
-```
-
-각 모듈은 별도 spawn 가능하나, **상태는 단일 progress.json.service_ops** 에 통합.
-
----
-
-## 3. Monitor 모듈
-
-### 3.1 책임
-- Adaptive cadence(light 30m / normal 1h / heavy 4h) 계산 + Meeting-Manager에 standup 소집 요청
-- 헬스체크·메트릭·로그 폴링 (스택 무관)
-- GOAL 적합도(`goal_adherence`) 계산
-- 임계 초과 시 event trigger 발신
-
-### 3.1.1 Live Visibility (Inviolable)
-
-> 대시보드의 Operations 미니피규어가 typing 으로 보이려면 monitor 가 active 인 동안 `progress.service_ops.monitor.stream_active = true` 가 유지되어야 한다 (`state-mapping.ts:103` 의 G-006 조건).
-
-**On Start (monitor 한 바퀴 시작 시)**
-```bash
-bash scripts/harness-progress-set.sh . \
-  '.service_ops.monitor.stream_active = true |
-   .service_ops.monitor.stream_started_at = (now | todate)'
-```
-
-**On Complete (monitor 종료 직후, 결과 commit 과 같은 partial update 안에서)**
-```bash
-bash scripts/harness-progress-set.sh . \
-  '.service_ops.monitor.stream_active = false |
-   .service_ops.monitor.last_check = (now | todate) |
-   .service_ops.monitor.cadence_decided = "<light|normal|heavy>" |
-   .service_ops.monitor.current_goal_adherence = <0..1> |
-   .service_ops.monitor.warns_this_sprint = ((.service_ops.monitor.warns_this_sprint // 0) + <Δwarn>) |
-   .service_ops.monitor.alerts_this_sprint = ((.service_ops.monitor.alerts_this_sprint // 0) + <Δalert>)'
-```
-
-stream_active 를 안 끄면 미니피규어가 영구 typing 으로 보여 Owner 가 "왜 항상 일하고 있냐" 의심 → 정직성 위반.
-
-### 3.2 입력
-- `.harness/actions/goals.md` (KPI·success_metrics)
-- 운영 메트릭 소스: `.harness/ops/metrics.jsonl` (DevOps가 적재) 또는 외부 stack(Grafana·Sentry — 옵트인)
-- 헬스체크 엔드포인트 (api-contract에서 추출)
-
-### 3.3 메트릭 카탈로그 (기본)
-| 메트릭 | 단위 | 임계 |
-|---|---|---|
-| HTTP 5xx 비율 | % | > 1% (warn) / > 5% (red-alert) |
-| p95 응답시간 | ms | > goal.kpi.p95 (warn) / 2× (alert) |
-| 헬스체크 실패 | count/min | ≥ 1 (warn) / ≥ 3 (red-alert) |
-| 사용자 피드백 부정 | ratio | feedback synthesizer 결과 |
-| 의존성 다운 | bool | true → red-alert |
-| 비용 증가 | ratio vs baseline | > 1.5× (warn) / 3× (alert) |
-
-### 3.4 GOAL 적합도 산출
-```
-goal_adherence = weighted_avg(per_kpi_score)
-per_kpi_score = clip(actual / target, 0, 1)   # higher-is-better
-                또는 clip(target / actual, 0, 1) # lower-is-better
-```
-
-### 3.5 적응형 Cadence 결정
-Standup 종료 직후 호출됨. 직전 3회 standup의:
-- `goal_adherence` 평균 ≥ 0.9 + 이벤트율 < 1/h → `light` 후보
-- 둘 중 하나라도 미달 → `normal`
-- idle (활성 Sprint 없음) AND 직전 3회 무특이사항 → `heavy`
-
-→ `progress.json.meetings.cadence` partial update.
-
-### 3.6 Event Trigger
-- red-alert → Incident War Room 소집 (Meeting-Manager에 발신)
-- `goal_adherence < 0.5` 24h 이상 → Spec Review (긴급) 소집
-- warn 누적 ≥ 5건/Sprint → 다음 Standup에서 보고
-
-### 3.7 Drift Classification
-
-Service-Ops는 `goal_adherence` 하락을 감지했을 때 원인 분류 없이 Planner로 넘기면 안 된다. 먼저 아래 분류를 시도한다.
-
-- `implementation_drift`: CQO FAIL / regression / 품질 축 미달이 직접 원인
-- `planning_drift`: 구현/품질은 통과했지만 Goal 달성 가설이 어긋남
-- `ops_drift`: 운영 환경, 배포, 로그, incident, KPI 이상이 원인
-- `goal_drift`: Goal/KPI 정의 자체가 흔들리거나 Owner intent와 괴리
-
-이 분류는 `progress.json.service_ops.drift_classification` 과 ops-report evidence에 기록되어야 한다.
-
----
-
-## 4. Incident 모듈
-
-### 4.1 책임
-- 사고 발생 시 즉시 War Room 소집 (Meeting-Manager 통해)
-- 사고 타임라인·영향 범위·임시조치 기록
-- 핫픽스 결정 → CTO에 Hotfix Feature 변환 요청
-- RCA(Root Cause Analysis) 초안 작성
-
-### 4.2 사고 분류
-| 등급 | 정의 | 대응 시간 |
-|---|---|---|
-| P0 | 서비스 다운 / 데이터 손실 / 보안 침해 | 즉시 |
-| P1 | 핵심 기능 저하 / 다수 사용자 영향 | 30분 이내 |
-| P2 | 일부 기능 저하 / 우회 가능 | 4시간 이내 |
-| P3 | 경미한 이상 / 외부에 영향 없음 | 다음 Sprint |
-
-### 4.3 War Room 진행
-1. 발견 → progress.json.service_ops.incidents[+] 등록
-2. Meeting-Manager에 `convene(type=incident)` 요청
-3. 참석: CEO·CTO·Incident-Responder·관련 Generator
-4. 결정: 핫픽스 vs 롤백 vs 임시조치
-5. CTO가 Hotfix Feature 발급 → Planner에 등록 → Conductor 즉시 spawn
-6. 사후 RCA 작성 (`.harness/actions/incidents/<id>/rca.md`)
-
-### 4.4 Incident 산출물
-`.harness/actions/incidents/<id>/`:
-- `timeline.md`: 분 단위 사건 기록
-- `impact.md`: 영향 범위·사용자·SLA
-- `rca.md`: 원인 분석 + 재발 방지책
-- `postmortem.md`: 학습 항목 + Sprint backlog 등록 권고
-
----
-
-## 5. Auto-Retro 모듈
-
-### 5.1 책임
-- 매 Sprint 종료 후 자율 회고 리포트 작성
-- product-feedback-synthesizer 패턴: 사용자 피드백·로그·메트릭 통합
-- CTO에 핸드오프 (개선안 + 우선순위)
-
-### 5.2 입력
-- 직전 Sprint의 `evaluation-*.md`, `cqo-audit-*.md`
-- 운영 메트릭 (Sprint 기간)
-- 사용자 피드백 (있다면)
-- 회의록 (`.harness/actions/meetings/`)
-
-### 5.3 산출물
-`.harness/actions/ops-report-<sprint>.md`:
-
-```yaml
----
-docmeta: { ... }
-ops_report:
-  sprint: <n>
-  period: { from, to }
-  goal_adherence: 0.92
-  open_incidents: [<ids>]
-  metric_deltas: [...]
-  user_feedback_summary: <text>
-  findings:
-    - id: F-1
-      severity: high|med|low
-      description: <text>
-      evidence: [...]
-      recommendation: <text>
-  proposed_hotfixes: [<feature draft>]
-  proposed_backlog: [<feature draft>]
-  cto_handoff: true
----
-```
-
-CTO가 수신 → Hotfix/Backlog Feature로 변환 → Planner 등록.
-
-### 5.4 자율 회고 가드
-- 회고 결과 우선순위는 Auto-Retro가 정함, **CTO가 reorder 가능**
-- Owner에게 직접 보고 X. 모든 회고는 CTO 경유.
-- 자율 수정(코드 변경)은 절대 금지. 제안만.
-
----
-
-## 6. progress.json 추가
-
-```json
-"service_ops": {
-  "drift_classification": "planning_drift",
-  "evidence": [
-    { "source": ".harness/actions/ops-report-3.md", "kind": "ops-report" }
-  ],
-  "monitor": {
-    "last_check": "<iso>",
-    "cadence_decided": "normal",
-    "current_goal_adherence": 0.92,
-    "warns_this_sprint": 0,
-    "alerts_this_sprint": 0
-  },
-  "incident": {
-    "open": [],
-    "last_incident": null,
-    "rca_pending": []
-  },
-  "auto_retro": {
-    "last_report": ".harness/actions/ops-report-3.md",
-    "open_recommendations": 7,
-    "cto_handoff_state": "delivered"
-  }
-}
-```
-
-## 7. 권한 매트릭스
-
-| 파일 | 읽기 | 쓰기 |
-|---|---|---|
-| 코드 (apps/, libs/) | ✅ | ❌ |
-| `.harness/ops/metrics.jsonl` | ✅ | append (관찰값 기록만) |
-| ops-report-*.md | ✅ | ✅ |
-| incidents/<id>/* | ✅ | ✅ |
-| feature-list.json | ✅ | ❌ (CTO 경유) |
-| goals.md | ✅ | ❌ (CEO 전용) |
-| meetings (cadence 필드) | ✅ | ✅ (cadence만 partial update) |
-
-## 8. Meeting 참석 책임
-
-| 회의 | Service-Ops 역할 |
-|---|---|
-| Standup | 사회 보조 + GOAL 적합도 보고 + cadence 재계산 |
-| Sprint Review | Auto-Retro 리포트 발표 |
-| Spec Review | 운영 데이터 기반 근거 제공 |
-| Incident War Room | **소집자** + 타임라인 작성자 |
-| All-Hands (Phase Gate) | Phase 6 Operate 단계 진입 시 운영 준비도 보고 |
-
-## 9. Conductor와의 인터페이스
-
-- Conductor 틱에서:
-  - cron 도달 → spawn `service-ops` + `service_ops.requested_mode="monitor"`
-  - red-alert 이벤트 → spawn `service-ops` + `service_ops.requested_mode="incident"`
-  - Sprint 종료 → spawn `service-ops` + `service_ops.requested_mode="auto-retro"`
-- 모든 Service-Ops 산출물은 CTO 경유로만 코드 변경에 도달
-
-## 10. Session Boundary Protocol
-
-### On Start
-1. `.harness/progress.json` 읽기 → 어느 모듈 호출인지 확인 (`service_ops.requested_mode = monitor|incident|auto-retro`)
-2. partial update: `current_agent = "service-ops"`, `service_ops.<mode>.running = true`
-
-### On Complete
-1. 모듈별 산출물 finalize
-2. partial update:
-   - `service_ops.<mode>` 필드
-   - red-alert 발생 시 `next_agent = "meeting-manager"` (incident convene 요청)
-   - cadence 변경 시 `meetings.cadence`
-3. CTO 핸드오프 큐잉 (auto-retro인 경우)
-
-## 11. 출처 (Attribution)
-
-agency-agents (MIT) 흡수:
-- `engineering-sre`: 신뢰성·SLO·SLI 기반 모니터링
-- `engineering-incident-response-commander`: War Room·RCA 패턴
-- `engineering-autonomous-optimization-architect`: Auto-Retro 자율 최적화
-- `support-infrastructure-maintainer`: 운용 베이스라인
-- `support-analytics-reporter`: 메트릭 리포트 양식
-- `support-executive-summary-generator`: CEO/CTO 핸드오프 요약
-- `product-feedback-synthesizer`: 사용자 피드백 합성
-- `testing-reality-checker`: GOAL 적합도 reality-check
-- `specialized-automation-governance-architect`: 자율수정 거버넌스
-- `specialized-report-distribution-agent`: 리포트 라우팅