charlie-harness

charlie-harness

워크플로우 네이티브 메타 하네스 — 도메인 요청을 받아, 그 도메인을 위한 에이전트 팀·스킬·결정적 JavaScript Workflow 오케스트레이터를 한 번에 생성하는 빌더. v1 프로즈 하네스(harness)의 재개발판.

charlie-harness is a meta-harness that compiles orchestration into code. v1 described agent teams in prose Markdown that a model re-interpreted every run (non-deterministic). v2 emits a deterministic Claude Code Workflow script (agent() / pipeline() / parallel() / JSON Schema / budget / resume) plus a thin trigger skill and an SSOT manifest.

---

v1 → v2 패러다임 전환

축	v1 harness (prose orchestrator)	v2 charlie-harness (workflow-native)
오케스트레이션	산문 마크다운, 런타임에 모델이 해석	결정적 {domain}.js Workflow 스크립트
제어 흐름	자연어 지시 (루프/조건/팬아웃)	pipeline() / parallel() JS 제어 흐름
에이전트 간 계약	"데이터 shape" 문장	JSON Schema + agent({schema}) 강제
검증	"교차 비교하라" 권고	적대적 verify 단계가 코드로 박힘
모델 정책	블랭킷 model: opus	역할별 티어 (haiku/sonnet → opus)
폴백	무성 단일 에이전트 degradation	throw + .filter(Boolean) + log()
SSOT	오케스트레이터가 자체 로스터 유지 (drift)	.charlie/manifest.json 단일 레지스트리
실패 복구	전량 재실행	resumeFromRunId 저널 기반 재개
관측성	불투명	meta.phases + /workflows 라이브 트리

핵심: "모델이 매번 해석하는 지시서" → "버전 관리·테스트·재현 가능한 실행 가능 산출물".

---

Requirements

• Claude Code with the Workflow tool available.
• ultracode opt-in — 빌드 워크플로우는 다수의 서브에이전트를 스폰한다. 빌드는 1회성(컴파일타임)이며, 생성된 실행 하네스는 사용자가 규모를 선택한다.

---

Quick start

설치 (이 마켓플레이스를 추가하고 플러그인을 설치):

/plugin marketplace add <this-repo-url-or-path>
/plugin install charlie-harness

빌드 (대상 프로젝트에서 메타 스킬을 트리거):

하네스 구성해줘 — 도메인: <당신의 도메인 한 줄 설명>

또는 명시 호출: /charlie-harness 후 도메인을 기술한다. 메타 스킬이 빌드 워크플로우 build-harness.js를 실행하고, 대상 프로젝트에 하네스를 생성한다.

v1에는 install 명령 버그(RED)가 있었다. 위 두 줄이 유일한 정본이다 — 다른 변형(수동 디렉토리 복사, npm install 등)을 따르지 말 것.

---

생성되는 출력 구조

도메인 하네스 1개를 빌드하면 대상 프로젝트에 다음이 생성된다:

프로젝트/
├── .claude/
│   ├── agents/{role}.md                  # 에이전트 페르소나 (agentType 참조 대상)
│   ├── skills/
│   │   ├── {role-skill}/SKILL.md          # 절차 스킬 (선택적)
│   │   └── {domain}-harness/SKILL.md      # 얇은 트리거 스킬 → Workflow({name}) 호출
│   └── workflows/{domain}.js              # 결정적 오케스트레이터
├── .charlie/
│   ├── manifest.json                      # SSOT — 에이전트·스킬·워크플로우·스키마 레지스트리
│   └── schemas/{name}.json                # 에이전트 간 산출물 계약
└── CLAUDE.md                              # 하네스 포인터 + 변경 이력

빌드 워크플로우 자체의 phase: Audit → Analyze → Design → Generate → Verify → Register. 빌더가 자기 산출물에 스키마 강제·적대적 검증을 적용한다 (dogfooding).

---

문서

문서	내용
docs/01-advantages-prediction.md	Workflow/ultracode 도입 예상 장점 (구현 이전 예측)
docs/02-design.md	설계·개선안 — 빌드 SPEC (단일 진실 원천)
docs/03-review-evaluation.md	예측 대비 실측 검증 (정적 검증 결과)
docs/04-*	향후 과제

스킬 본체와 템플릿은 skills/charlie-harness/에 있다.