# cc-system

Claude Code 용 skill · sub-agent · harness 자산 모음. 프로젝트마다 필요한 조각만 골라 이식한다.

## 디렉토리

```
.claude/
  skills/
    persuasion-review/   잠재고객 페르소나 시뮬 (설득력 검토)
    ideation/            페르소나 시뮬 결과로 다음 요구사항 1개를 도출 + tech-critic-lead 결재
    plan-and-build/      task/phase 분해 → run-phases.py 실행까지 자동화
    commit/              대화 컨텍스트 기반 정교한 git commit/push
    skill-creator/       skill 생성 도우미
    slash-command-creator/
    subagent-creator/
    hook-creator/
    gmail/ · google-calendar/ · youtube-collector/
  agents/
    tech-critic-lead.md   "기능은 비용" 전제의 비판적 CTO 서브에이전트
    brand-logo-finder.md

scripts/
  run-server.py          사람 개입 0회 자율 주행 루프 (ideation→commit→build→check→rollback)
  run-phases.py          plan-and-build 이 만든 task/phase 를 순차 실행
  gen-docs-diff.py       phase 0 완료 후 docs-diff.md 자동 생성 (run-phases 내부 호출)
  _utils.py

prompts/
  task-create.md         plan-and-build 이 따르는 task/phase 파일 규격

prompt/
  install-harness.md               ← 자율 주행 하네스 전체를 이식하는 프롬프트
  install-persuasion-review.md     ← persuasion-review 만 단독 이식하는 프롬프트
  install-findings-cycles-goals.md ← findings→cycles→goals 빌드 하네스 이식 프롬프트
  crystalize-prompt.md
  design-pipeline.md

findings-cycles-goals/   vooster 의 findings→cycles→goals 하네스를 스택 중립으로 추출한 이식 키트
  scripts/               goal-agnostic 오케스트레이터 (completion/active-check, next-task, gate-cache, rigor)
  goals/                 미션 스택 (_meta + 0-example 트리오 + AGENTS.md)
  cycles/ · findings/    루프 드라이버 / 부채 큐 규약 (AGENTS.md + EXAMPLE)
  guidelines/ · docs/    goal-iteration.md · goal-design.md
  prompts/cycle-generate.md  사이클 문서 생성 메타 프롬프트

docs/
  cc/                    Claude Code hook / slash-command / sub-agent 참고 문서
```

## 이식

### persuasion-review 단일 이식

[`prompt/install-persuasion-review.md`](prompt/install-persuasion-review.md) 의 내용을 타겟 프로젝트에서 연 Claude Code 세션에 그대로 붙여넣는다. Claude 가 이 레포를 얕은 clone 해서 필요한 파일을 복사하고, 프로젝트의 기동 방식에 맞춘 `ux_probe_adapter.py` 까지 써준다.

### 자율 주행 하네스 전체 이식

[`prompt/install-harness.md`](prompt/install-harness.md) 를 타겟 프로젝트 Claude Code 세션에 붙여넣으면 아래 파일 전체를 clone → 복사하고 필요한 데이터 디렉토리까지 스캐폴드한다.

복사 대상 (수동으로 체크하고 싶다면):

- `.claude/skills/{persuasion-review, ideation, plan-and-build, commit}/` (4개 skill 통째)
- `.claude/agents/tech-critic-lead.md`
- `scripts/run-server.py`, `scripts/run-phases.py`, `scripts/gen-docs-diff.py`, `scripts/_utils.py`
- `prompts/task-create.md`

타겟 프로젝트가 추가로 갖춰야 할 것:

- `docs/{mission,spec,testing,user-intervention}.md` — plan-and-build 이 읽는 컨텍스트
- `persuasion-data/personas/<1명 이상>/profile.md` — ideation 시뮬 대상
- `persuasion-data/probe_tasks.md` + `persuasion-data/ux_probe_adapter.py` — UX probe 용 (install-persuasion-review 프롬프트가 프로젝트별로 작성)
- git 초기 커밋 1개 이상 — rollback 타겟용
- `claude` CLI 설치 + 로그인

`HARNESS_HEADLESS=1` 이 무인 모드 시그널이다. (레거시로 `BET_HEADLESS` 도 fallback 으로 수용됨 — 추후 제거 예정.)

### findings → cycles → goals 빌드 하네스 이식

[`vibemafiaclub/vooster`](https://github.com/vibemafiaclub/vooster) 가 쓰는 **gate 기반 자율 빌드 하네스**를 스택 중립으로 추출한 키트(`findings-cycles-goals/`)다. 위의 `install-harness` (ideation→build 루프)와는 별개의 시스템으로, 루핑 에이전트가 **machine-verified gate** 로 "완료"를 증명하며 미션 스택을 쌓아 올린다.

[`prompt/install-findings-cycles-goals.md`](prompt/install-findings-cycles-goals.md) 를 타겟 프로젝트 Claude Code 세션에 붙여넣으면 `findings-cycles-goals/` 의 자산을 clone → 복사하고, `_meta` 검사와 goal 0 을 타겟 스택에 맞게 적응시킨 뒤 검증까지 한다.

3-자산 모델:

- **findings** (`docs/findings/`) — out-of-scope 발견을 잃지 않는 부채/통찰 큐 (검증 없음).
- **cycles** (`cycles/`) — 무한 루프 에이전트에 넘기는 한 세션 프롬프트 (이력).
- **goals** (`goals/`) — `<n>-<name>.{md,gates.sh,next-task.sh}` 세 파일/goal. 가장 낮은 번호의 실패 goal 이 active. `scripts/completion-check.sh` 가 전체 체인을 병렬 검증한다.

설계·규약 단일 출처는 키트 안의 `docs/goal-design.md`, `guidelines/goal-iteration.md`, 각 폴더 `AGENTS.md` 다. 자세한 매핑은 [`findings-cycles-goals/README.md`](findings-cycles-goals/README.md).