buildcrew 1.5.0 → 1.5.2

package/README.ko.md

@@ -118,7 +118,7 @@ echo "# 메모" > .claude/harness/내메모.md  # 직접 생성도 가능
 | 에이전트 | 모델 | 역할 |
 |---------|------|------|
 | **planner** | opus | 6가지 강제 질문 + 4관점 자체 리뷰 (CEO, 엔지니어링, 디자인, QA). 관점별 1-10점. |
-| **designer** | opus | 웹에서 UI/UX 레퍼런스 수집 → Playwright 스크린샷 → Figma MCP → 프로덕션 컴포넌트. AI 슬롭 블랙리스트. |
+| **designer** | opus | UI/UX 레퍼런스 수집 + 모션 엔지니어링 → Playwright 스크린샷 → Figma MCP → 애니메이션, 스크롤 이펙트, 제스처가 포함된 프로덕션 컴포넌트. AI 슬롭 블랙리스트. |
 | **developer** | sonnet | 기획서 + 디자인 + 하네스 규칙에 따라 구현. |
 
 ### 품질 팀
@@ -162,6 +162,14 @@ echo "# 메모" > .claude/harness/내메모.md  # 직접 생성도 가능
 | **Review** | "코드 리뷰해줘" | 멀티 전문가 + 적대적 + 자동 수정 |
 | **Ship** | "배포해줘" | 테스트 → 버전 → 체인지로그 → PR |
 
+### 반복 (Iterations)
+
+매 반복마다 **전체 파이프라인**을 처음부터 다시 실행 — 기획자가 이전 결과를 리뷰하고 계획을 수정합니다:
+
+```
+@buildcrew 유저 대시보드 추가해줘, 5 iterations
+```
+
 ### 모드 체이닝
 
 Feature 완료 → Ship → Canary. Canary CRITICAL → Debug.
@@ -188,7 +196,7 @@ Feature 완료 → Ship → Canary. Canary CRITICAL → Debug.
 
 | 명령어 | 설명 |
 |--------|------|
-| `npx buildcrew` | 11개 에이전트 설치 |
+| `npx buildcrew` | 에이전트 설치 (11 + 오케스트레이터) |
 | `npx buildcrew init` | 하네스 자동 생성 (질문 없음) |
 | `npx buildcrew init --force` | 하네스 재생성 |
 | `npx buildcrew add` | 템플릿 목록 |
@@ -204,6 +212,22 @@ Feature 완료 → Ship → Canary. Canary CRITICAL → Debug.
 - **선택**: [Playwright MCP](https://github.com/anthropics/anthropic-quickstarts/tree/main/mcp-servers/playwright) — browser-qa, canary-monitor, designer
 - **선택**: [Figma MCP](https://github.com/anthropics/anthropic-quickstarts/tree/main/mcp-servers/figma) — designer
 
+## 실시간 상태 로그
+
+모든 에이전트가 이모지 태그된 진행 로그를 출력합니다:
+
+```
+📋 PLANNER — "유저 대시보드" 요구사항 분석 시작
+🔎 4관점 자체 리뷰...
+   🏢 CEO: 8/10  ⚙️ 엔지니어링: 9/10
+✅ PLANNER — 완료
+
+🎨 DESIGNER — UI/UX 디자인 시작...
+💻 DEVELOPER — 구현 시작...
+🧪 QA TESTER — 11/12 통과, 1건 발견
+🔬 REVIEWER — 승인
+```
+
 ## 라이선스
 
 MIT

package/README.md

@@ -118,7 +118,7 @@ echo "# Notes" > .claude/harness/my-notes.md  # Or create your own
 | Agent | Model | Role |
 |-------|-------|------|
 | **planner** | opus | 6 Forcing Questions + 4-Lens Self-Review (CEO, Engineering, Design, QA). Plans scored 1-10 per lens. |
-| **designer** | opus | Web research for UI/UX references → Playwright screenshots → Figma MCP → production components. AI slop blacklist. |
+| **designer** | opus | UI/UX research + motion engineering → Playwright screenshots → Figma MCP → production components with animations, scroll effects, gestures. AI slop blacklist. |
 | **developer** | sonnet | Implements features following plan + design + harness conventions. |
 
 ### Quality Team
@@ -162,6 +162,14 @@ Talk to `@buildcrew` naturally. It auto-detects the mode.
 | **Review** | "code review" | Multi-specialist analysis + auto-fix |
 | **Ship** | "ship" | Test → version → changelog → PR |
 
+### Iterations
+
+Each iteration runs the **full end-to-end pipeline** — planner re-evaluates, designer refines, developer fixes, QA re-verifies:
+
+```
+@buildcrew Add user dashboard, 5 iterations
+```
+
 ### Mode chaining
 
 Auto-suggests the next mode:
@@ -192,7 +200,7 @@ Each feature generates a full document chain:
 
 | Command | Description |
 |---------|-------------|
-| `npx buildcrew` | Install 11 agents |
+| `npx buildcrew` | Install agents (11 + orchestrator) |
 | `npx buildcrew init` | Auto-generate harness (zero questions) |
 | `npx buildcrew init --force` | Regenerate harness |
 | `npx buildcrew add` | List harness templates |
@@ -222,6 +230,25 @@ claude mcp add playwright -- npx @anthropic-ai/mcp-server-playwright
 .claude/pipeline/    Output documents — auto-generated per feature
 ```
 
+## Real-time Status
+
+Every agent outputs emoji-tagged progress logs so you can track what's happening:
+
+```
+📋 PLANNER — Starting requirements analysis for "user dashboard"
+🔍 Reading project harness...
+🧠 Phase 1: Asking 6 Forcing Questions...
+🔎 Phase 3: 4-Lens Self-Review...
+   🏢 CEO Review: 8/10
+   ⚙️ Engineering Review: 9/10
+✅ PLANNER — Complete (avg score: 8.5/10)
+
+🎨 DESIGNER — Starting UI/UX design...
+💻 DEVELOPER — Starting implementation...
+🧪 QA TESTER — 11/12 passed, 1 issue found
+🔬 REVIEWER — APPROVE
+```
+
 ## Architecture
 
 ```
@@ -230,7 +257,7 @@ claude mcp add playwright -- npx @anthropic-ai/mcp-server-playwright
     ├─ reads .claude/harness/*.md
     ├─ detects mode from user message
     ├─ dispatches agents with harness context
-    └─ enforces quality gates + iteration
+    └─ enforces quality gates + full end-to-end iteration
          │
          ├── Build:    planner → designer → developer
          ├── Quality:  qa-tester → browser-qa → reviewer

package/bin/setup.js

@@ -150,12 +150,25 @@ async function detectProject() {
 async function runInit(force) {
   log(`\n  ${BOLD}buildcrew init${RESET} v${VERSION}\n`);
 
-  if ((await exists(join(HARNESS_DIR, "project.md"))) && !force) {
+  const harnessExists = await exists(join(HARNESS_DIR, "project.md"));
+
+  if (harnessExists && !force) {
     log(`  ${YELLOW}Harness already exists at .claude/harness/${RESET}`);
     log(`  ${DIM}Use ${BOLD}--force${RESET}${DIM} to regenerate. Or just edit the files directly.${RESET}\n`);
     return;
   }
 
+  // Backup existing harness before overwriting
+  if (harnessExists && force) {
+    const backupDir = join(process.cwd(), ".claude", "harness-backup");
+    await mkdir(backupDir, { recursive: true });
+    const harnessFiles = (await readdir(HARNESS_DIR)).filter(f => f.endsWith(".md"));
+    for (const file of harnessFiles) {
+      await copyFile(join(HARNESS_DIR, file), join(backupDir, file));
+    }
+    log(`  ${CYAN}Backed up ${harnessFiles.length} harness files → .claude/harness-backup/${RESET}\n`);
+  }
+
   log(`  ${DIM}Scanning project...${RESET}\n`);
   const d = await detectProject();
 
@@ -329,11 +342,20 @@ async function runAdd(type, force) {
   }
 
   const target = join(HARNESS_DIR, `${type}.md`);
-  if ((await exists(target)) && !force) {
+  const targetExists = await exists(target);
+  if (targetExists && !force) {
     log(`\n  ${YELLOW}${type}.md already exists.${RESET} Use ${BOLD}--force${RESET} to overwrite.\n`);
     return;
   }
 
+  // Backup before overwriting
+  if (targetExists && force) {
+    const backupDir = join(process.cwd(), ".claude", "harness-backup");
+    await mkdir(backupDir, { recursive: true });
+    await copyFile(target, join(backupDir, `${type}.md`));
+    log(`\n  ${CYAN}Backed up ${type}.md → .claude/harness-backup/${RESET}`);
+  }
+
   await mkdir(HARNESS_DIR, { recursive: true });
   await copyFile(join(TEMPLATES_SRC, template.file), target);
   log(`\n  ${GREEN} + ${RESET} .claude/harness/${type}.md`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buildcrew",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "11 AI agents for Claude Code — auto-orchestrated dev team with 9 operating modes",
   "homepage": "https://buildcrew-landing.vercel.app",
   "author": "z1nun",