biz-harness

SLIT 팀(도현/지상/원준) 전용 OpenCode 플러그인.
스프린트 기반 가설 검증 워크플로우를 AI 에이전트 23개로 자동화한다.

팀 운영 원칙

• 완성하지 않음. 검증함.
• 1주 1아이템 — 월요일 가설 → 금요일 kill/pivot/continue

설치

방법 1: npm 패키지 (권장)

# 프로젝트 디렉토리에서
npx biz-harness setup

셋업 위자드가 3가지를 물어본다:

1. 이름 — 도현 / 지상 / 원준
2. Obsidian Vault 경로 — . (현재 디렉토리) 또는 절대/상대 경로
3. AI 모델 조합 — Claude만 / Codex만 / 둘 다

완료되면 자동으로:

• .slit/config.json 생성
• opencode.json에 "biz-harness" 플러그인 등록

방법 2: 수동 설치

1) opencode.json 설정

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["biz-harness"]
}

2) 설정 파일 생성

.slit/config.json:

{
  "maxConcurrentAgents": 5,
  "vaultPath": ".",
  "sprintCycleDay": "sunday",
  "killDecisionDay": "friday",
  "killDecisionTime": "17:00",
  "teamMembers": ["도현", "지상", "원준"],
  "relativePathsOnly": true,
  "obsidianTagNamespaces": ["type", "domain", "status", "team"],
  "aiProvider": "claude",
  "currentUser": "도현"
}

설치 확인

OpenCode를 실행하면 플러그인이 자동 로드된다.
처음 실행 시 .slit/config.json이 없으면 셋업 안내 메시지가 뜬다.

AI 모델 배치 전략

셋업에서 선택한 aiProvider에 따라 23개 에이전트에 모델이 자동 배정된다.

| Tier | 에이전트 | Claude만 | Codex만 | 둘 다 | |------|---------|----------|---------|-------| | 1 (핵심 판단) | coordinator, oracle, hypothesis-analyst, kill-judge | opus-4-6 | codex-5.3 | opus-4-6 | | 2 (분석/실행) | sprint-planner, task-manager 외 10개 | opus-4-6 | codex-5.3 | codex-5.3 | | 3 (경량 작업) | vault-explorer, reference-librarian 외 5개 | haiku-4-5 | codex-5.3 | haiku-4-5 |

에이전트 (23개)

핵심 판단 (Tier 1)

| 에이전트 | 역할 | |---------|------| | coordinator | 요청 의도 분류 및 에이전트 라우팅 | | oracle | 고비용 심층 분석, 어려운 의사결정 상담 | | hypothesis-analyst | 가설 구조화, 반증 가능성 평가 | | kill-judge | 금요일 kill/pivot/continue 판정 |

분석/실행 (Tier 2)

| 에이전트 | 역할 | |---------|------| | sprint-planner | 주간 스프린트 설계 | | task-manager | 태스크 CRUD 및 추적 | | experiment-designer | 가설 → 실험 계획 변환 | | evidence-collector | 실험 근거 수집 및 등급화 | | market-researcher | TAM/SAM/SOM, 시장 수요 분석 | | competitor-tracker | 경쟁사 및 대체재 추적 | | meeting-facilitator | 팀 회의 진행 및 기록 | | retrospective-host | 스프린트 회고 운영 | | progress-reporter | 진행 상황 리포트 | | risk-monitor | 리스크 감시 및 경고 | | document-writer | 문서 작성 지원 | | system-reviewer | 플러그인 자체 개선 리뷰 |

경량 작업 (Tier 3)

| 에이전트 | 역할 | |---------|------| | vault-explorer | Obsidian 볼트 검색 및 패턴 발견 | | reference-librarian | 외부 참조 자료 검색 | | linker | Obsidian 노트 간 링크 연결 | | formatter | 문서 포맷 표준화 | | template-manager | 템플릿 관리 | | onboarding-guide | 팀원 온보딩 가이드 | | plugin-guide | 플러그인 사용법 안내 |

도구 (28개)

모든 도구는 slit_ 접두사를 사용한다.

스프린트

• slit_sprint_plan — 스프린트 생성
• slit_sprint_status — 현재 스프린트 상태 조회
• slit_sprint_review — 스프린트 종료/리뷰

태스크

• slit_task_create — 태스크 생성
• slit_task_update — 태스크 수정
• slit_task_list — 태스크 목록 조회
• slit_task_complete — 태스크 완료 처리

가설

• slit_hypothesis_create — 가설 생성
• slit_hypothesis_evaluate — 가설 평가

Obsidian

• slit_link_notes — 노트 간 링크 생성
• slit_update_frontmatter — 프론트매터 수정
• slit_check_graph — 볼트 그래프 조회

위임/협업

• slit_delegate_task — 에이전트 간 태스크 위임
• slit_create_pr — 변경 제안(PR) 생성
• slit_read_agent_registry — 에이전트 목록 조회

상태/메모

• slit_state_read — 상태 읽기
• slit_state_write — 상태 쓰기
• slit_notepad_read — 노트패드 읽기
• slit_notepad_write_priority — 우선순위 메모 쓰기
• slit_notepad_write_working — 작업 메모 쓰기

스킬

• slit_skill_list — 스킬 목록
• slit_skill_get — 스킬 상세 조회

세션

• slit_session_list — 세션 목록
• slit_session_read — 세션 읽기
• slit_session_restore — 세션 복구
• slit_session_save — 세션 저장

백그라운드

• slit_background_execute — 백그라운드 실행
• slit_background_output — 결과 수집
• slit_background_cancel — 취소

스킬 (12개)

에이전트가 특정 작업 수행 시 로드하는 도메인 지식 파일.

| 스킬 | 용도 | |------|------| | sprint-planning | 스프린트 설계 프로토콜 | | hypothesis-evaluation | 가설 품질 평가 체크리스트 | | experiment-design | 실험 유형 카탈로그, MSC 기준 | | kill-decision | kill/pivot/continue 판정 프레임워크 | | market-research | TAM/SAM/SOM, 한국 데이터 소스 | | meeting-facilitation | 회의 진행 가이드 | | retrospective | 회고 운영 프로토콜 | | vault-exploration | 볼트 검색 전략, 다중 렌즈 | | reference-research | 외부 소스 신뢰도 평가 | | deep-analysis | 다중 요인 의사결정 분석 | | system-review | 플러그인 자체 진단 | | plugin-help | 사용법 안내 |

모드 (4개)

| 모드 | 설명 | |------|------| | sprint-mode | 요일/페이즈에 따라 자동 라우팅 (월=가설, 금=판정) | | completion-loop | 미완료 태스크가 있으면 자동 반복 | | focus-mode | 단일 작업에 집중, 다른 에이전트 위임 차단 | | coordinator-mode | coordinator가 모든 작업을 위임으로 처리 |

템플릿 (7개)

새 문서 생성 시 사용되는 Obsidian 마크다운 템플릿:

• sprint-plan.md — 스프린트 계획서
• hypothesis.md — 가설 문서
• experiment.md — 실험 설계서
• evidence.md — 근거 기록
• meeting-note.md — 회의록
• retrospective.md — 회고록
• daily-standup.md — 데일리 스탠드업

폴더 구조

프로젝트/
├── opencode.json          ← 플러그인 등록
├── .slit/
│   ├── config.json        ← 런타임 설정
│   ├── state/             ← 에이전트 상태 저장
│   └── agent-registry.json ← 에이전트 목록 스냅샷
├── 스프린트/               ← 주간 스프린트 폴더
├── 가설-아이디어/           ← 가설 문서
├── 실험/                   ← 실험 설계/결과
├── 근거/                   ← 수집된 증거
├── 로그/                   ← 회의록, 일지
├── 투두/                   ← 태스크 파일
└── 참조/                   ← 외부 레퍼런스

주간 워크플로우

월요일    가설 선정 → hypothesis-analyst
화~목요일  실험 실행 → experiment-designer + evidence-collector
금요일    Kill/Pivot/Continue 판정 → kill-judge
일요일    다음 스프린트 계획 → sprint-planner

라이선스

UNLICENSED (팀 내부 전용)