taco-harness
개인 개발 워크플로우를 구조화하는 Claude Code 플러그인.
아이디어부터 학습까지 7단계 파이프라인으로 개발 과정을 안내하고,
단계별 보안 가드와 3-model 리뷰로 품질을 보장한다.
왜 만들었나
- 코드부터 짜고 나중에 후회하는 패턴을 깨고 싶었다
- "생각 → 설계 → 구현 → 검증 → 학습" 흐름을 강제하고 싶었다
- Claude만으로는 놓치는 관점을 Codex, Gemini로 보완하고 싶었다
파이프라인
/brainstorm → /specify → /plan → /review-plan → /implement → /review-code → /learn
탐색 정의 설계 계획 리뷰 구현 코드 리뷰 회고
| 단계 | 명령어 | 하는 일 | 결과물 |
|---|
| 1 | /brainstorm <name> | 소크라틱 Q&A로 아이디어 탐색 | idea.md |
| 2 | /specify <name> | 인터뷰 기반 스펙 작성 | spec.md |
| 3 | /plan <name> | 태스크 분해 + 기술 계획 | plan.md |
| 4 | /review-plan <name> | 3-model 계획 리뷰 + Draft PR 생성 | plan-review.md |
| 5 | /implement <name> | Orchestrator-Worker 패턴으로 구현 | 코드 커밋 |
| 6 | /review-code <name> | 3-model 코드 리뷰 + PR Ready | code-review.md |
| 7 | /learn <name> | 회고 분석 + 학습 기록 | learnings/*.md |
각 단계가 끝나면 다음 단계를 자동으로 안내한다.
설치
요구사항
선택 사항
codex CLI — Codex 모델 사용 (없으면 Claude만으로 동작)gemini CLI — Gemini 모델 사용 (없으면 스킵)gh CLI — GitHub PR 자동 생성docker — 구현 단계 격리 실행
플러그인 설치
마켓플레이스에서 설치:
/plugin marketplace add mildsalmon/taco-harness
/plugin install taco@mildsalmon
설치 후 Claude Code를 재시작하면 플러그인이 로드된다.
taco CLI 설치 (선택)
터미널에서 바로 taco 명령어를 쓸 수 있다:
~/source_code/harness/taco-harness/scripts/install-taco.sh
기본으로 ~/.local/bin/taco에 심볼릭 링크를 생성한다.
다른 경로를 원하면 인자로 전달:
~/source_code/harness/taco-harness/scripts/install-taco.sh /usr/local/bin
~/.local/bin이 PATH에 없으면 셸 설정에 추가:
export PATH="$HOME/.local/bin:$PATH"
빠른 시작
단계별 실행 (Claude Code에서)
/brainstorm user-auth # 1. 아이디어 탐색
/specify user-auth # 2. 스펙 작성
/plan user-auth # 3. 기술 계획
/review-plan user-auth # 4. 계획 리뷰 (3-model)
/implement user-auth # 5. 구현
/review-code user-auth # 6. 코드 리뷰 (3-model)
/learn user-auth # 7. 회고 + 학습
오토파일럿 (한방에 실행)
/run user-auth # 전체 파이프라인 실행 (게이트마다 체크포인트)
/run user-auth --auto # 완전 자동 (게이트 실패 시만 정지)
/run user-auth --from plan # 특정 단계부터 재개
taco CLI (터미널에서)
taco # 인터랙티브 모드 (feature 선택 메뉴)
taco init # 현재 프로젝트에 .dev/ 초기화
taco new user-auth # feature 생성
taco list # feature 목록
taco status # 파이프라인 상태
taco gate G1 user-auth # gate 검증
taco events # 최근 이벤트 로그
taco run user-auth # 오토파일럿 안내
taco pack list # 도메인 팩 목록
taco model check # 외부 모델 CLI 가용성 확인
순서를 건너뛰면 경고가 뜬다:
/implement user-auth
→ "WARNING: G2 not passed — plan not approved. Run /review-plan first."
Gate (관문)
이전 단계가 완료되지 않으면 경고를 표시한다.
| Gate | 시점 | 검증 내용 |
|---|
| G1 | /plan 진입 | spec.md에 5개 필수 섹션이 있는가 |
| G2 | /implement 진입 | plan-review에서 SHIP 판정을 받았는가 |
| G3 | /learn 진입 | code-review에서 SHIP 판정을 받았는가 |
3-Model 리뷰
review-plan과 review-code에서 세 모델의 관점을 합성한다:
- Claude — 논리적 일관성, 완전성, 보안
- Codex — 구현 실현성, 코드 품질
- Gemini — 대안 접근, 엣지케이스
Codex나 Gemini가 없으면 Claude만으로 진행한다 (graceful degradation).
보안
단계별 파일 접근 제어
guard.sh가 단계에 따라 쓰기를 제한한다:
| 단계 | 쓰기 허용 범위 |
|---|
| brainstorm, specify, plan | .dev/ 내부만 |
| review-plan, review-code | 읽기만 가능 |
| implement | 프로젝트 디렉토리 (worktree) |
| learn | docs/learnings/, CLAUDE.md, templates/ |
.env, .ssh, credentials 등 민감 파일은 어떤 단계에서든 차단된다.
Docker 샌드박스
implement 단계에서 Docker 격리 실행을 지원한다:
- 네트워크 차단 (
network_mode: none)
- 읽기 전용 루트 파일시스템
- 비루트 사용자 (uid 10001)
- 모든 커널 권한 제거
CLI
taco 명령어 (권장)
프로젝트 디렉토리에서 바로 실행. 프로젝트 루트를 자동 감지한다 (.dev/ 또는 .git/ 탐색).
인자 없이 실행하면 인터랙티브 모드로 진입한다:
taco # 인터랙티브 모드 (feature 선택/생성)
taco init # 현재 프로젝트에 .dev/ 초기화
taco new <이름> # feature 생성
taco list # feature 목록
taco status # 파이프라인 상태
taco gate <G1|G2|G3> <이름> # gate 검증
taco events [개수] # 이벤트 로그 (기본 20개)
taco run <이름> # 오토파일럿 안내
taco pack list # 도메인 팩 목록
taco pack enable <이름> # 팩 활성화
taco pack disable <이름> # 팩 비활성화
taco model check # 외부 모델 CLI 가용성 확인
taco.sh (저수준)
프로젝트 경로를 명시적으로 전달:
./scripts/taco.sh init <프로젝트경로> # 초기화
./scripts/taco.sh feature new <프로젝트경로> <이름> # feature 생성
./scripts/taco.sh feature list <프로젝트경로> # feature 목록
./scripts/taco.sh gate check G1 <프로젝트경로> <이름> # gate 검증
./scripts/taco.sh state show <프로젝트경로> # 파이프라인 상태
./scripts/taco.sh events <프로젝트경로> [개수] # 이벤트 로그
./scripts/taco.sh pack list <프로젝트경로> # 팩 목록
./scripts/taco.sh model check # 모델 CLI 확인
알림 설정
/setup-notify
nikhilsitaram
bdfinst
xiaobei930
rohitg00
VeryGoodOpenSource
piercelamb