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 의 내용을 타겟 프로젝트에서 연 Claude Code 세션에 그대로 붙여넣는다. Claude 가 이 레포를 얕은 clone 해서 필요한 파일을 복사하고, 프로젝트의 기동 방식에 맞춘 ux_probe_adapter.py 까지 써준다.

자율 주행 하네스 전체 이식

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 가 쓰는 gate 기반 자율 빌드 하네스를 스택 중립으로 추출한 키트(findings-cycles-goals/)다. 위의 install-harness (ideation→build 루프)와는 별개의 시스템으로, 루핑 에이전트가 machine-verified gate 로 "완료"를 증명하며 미션 스택을 쌓아 올린다.

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.