@su-record/vibe 3.2.1 → 3.2.3

package/dist/tests/curated-release-notes.test.js

@@ -0,0 +1,106 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { classifyCommits, createReleaseNotes, selectPreviousSemanticTag, } from '../tools/release/releaseNotes.js';
+const CLASSIFICATION_CASES = [
+    ['feat: add packets', 'Added'],
+    ['fix(parser): reject drift', 'Fixed'],
+    ['docs: explain packets', 'Documentation'],
+    ['refactor: split compiler', 'Internal'],
+    ['chore: refresh fixtures', 'Internal'],
+    ['perf: cache parsing', 'Changed'],
+];
+describe('selectPreviousSemanticTag', () => {
+    it('REQ-release-notes-001 uses the previous semantic version and ignores log tags', () => {
+        const tags = ['log-20260720', 'v3.1.9', 'v3.2.0', 'v3.2.1'];
+        expect(selectPreviousSemanticTag(tags, 'v3.2.1')).toBe('v3.2.0');
+    });
+});
+describe('REQ-release-notes-003 classifyCommits', () => {
+    it.each(CLASSIFICATION_CASES)('REQ-release-notes-003 places %s in %s', (subject, section) => {
+        const result = classifyCommits([{ subject, body: '' }]);
+        expect(result[section]).toEqual([subject.replace(/^[^:]+:\s*/, '')]);
+    });
+    it('puts breaking changes first and excludes merge and version commits', () => {
+        const result = classifyCommits([
+            { subject: 'feat!: replace packet schema', body: '' },
+            { subject: 'Merge pull request #45', body: '' },
+            { subject: '3.2.1', body: '' },
+        ]);
+        expect(result.Breaking).toEqual(['replace packet schema']);
+        expect(Object.values(result).flat()).not.toContain('Merge pull request #45');
+        expect(Object.values(result).flat()).not.toContain('3.2.1');
+    });
+});
+describe('createReleaseNotes', () => {
+    it('REQ-release-notes-002 includes the SPEC overview and every requirement', () => {
+        const spec = `# SPEC: Execution Packets
+
+## 1. Overview / Goal
+
+Compile canonical specifications into deterministic execution packets.
+
+## 2. Requirements
+
+| ID | Requirement | Done Criteria |
+|----|-------------|---------------|
+| REQ-packet-001 | Preserve every requirement | D1 |
+| REQ-packet-002 | Reject stale packets | D2 |
+`;
+        const notes = createReleaseNotes({
+            currentTag: 'v3.2.1',
+            previousTag: 'v3.2.0',
+            specs: [{ path: '.vibe/specs/execution-packet-compiler.md', content: spec }],
+            commits: [
+                { subject: 'feat: compile execution packets', body: '' },
+                { subject: 'fix: reject tampered evidence', body: '' },
+            ],
+        });
+        expect(notes).toContain('## Highlights');
+        expect(notes).toContain('Compile canonical specifications into deterministic execution packets.');
+        expect(notes).toContain('Preserve every requirement');
+        expect(notes).toContain('Reject stale packets');
+        expect(notes).toContain('## Added');
+        expect(notes).toContain('## Fixed');
+        expect(notes).toContain('## Verification');
+        expect(notes).toContain('`v3.2.0..v3.2.1`');
+    });
+});
+describe('release workflow', () => {
+    it('REQ-release-notes-004 checks out full history and publishes a generated notes file', () => {
+        const workflow = readFileSync(resolve('.github/workflows/release.yml'), 'utf8');
+        expect(workflow).toMatch(/fetch-depth:\s*0/);
+        expect(workflow).toContain('generate-release-notes');
+        expect(workflow).toContain('--notes-file');
+        expect(workflow).not.toContain('--generate-notes');
+    });
+    it('REQ-release-notes-006 preserves the build and full test gates', () => {
+        const workflow = readFileSync(resolve('.github/workflows/release.yml'), 'utf8');
+        expect(workflow).toContain('pnpm build');
+        expect(workflow).toContain('pnpm test -- --reporter=default');
+    });
+});
+describe('published release contract', () => {
+    it('REQ-release-notes-005 renders the required public sections', () => {
+        const notes = createReleaseNotes({
+            currentTag: 'v3.2.1',
+            previousTag: 'v3.2.0',
+            specs: [{ path: 'feature.md', content: '# SPEC: Feature\n\n## Overview\nUseful change.' }],
+            commits: [
+                { subject: 'feat: add capability', body: '' },
+                { subject: 'fix: correct behavior', body: '' },
+            ],
+        });
+        expect(notes).toContain('## Highlights');
+        expect(notes).toContain('## Added');
+        expect(notes).toContain('## Fixed');
+        expect(notes).toContain('## Verification');
+    });
+});
+describe('release notes CLI', () => {
+    it('excludes deleted specifications from the current tag lookup', () => {
+        const cli = readFileSync(resolve('src/cli/generate-release-notes.ts'), 'utf8');
+        expect(cli).toContain("'--diff-filter=AMR'");
+    });
+});
+//# sourceMappingURL=curated-release-notes.test.js.map

package/dist/tests/curated-release-notes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated-release-notes.test.js","sourceRoot":"","sources":["../../src/tests/curated-release-notes.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/release/releaseNotes.d.ts

@@ -0,0 +1,21 @@
+export interface ReleaseCommit {
+    subject: string;
+    body: string;
+}
+export interface ReleaseSpec {
+    path: string;
+    content: string;
+}
+export interface ReleaseNotesInput {
+    currentTag: string;
+    previousTag: string;
+    specs: ReleaseSpec[];
+    commits: ReleaseCommit[];
+}
+type ReleaseSection = 'Breaking' | 'Added' | 'Fixed' | 'Changed' | 'Documentation' | 'Internal';
+export type ClassifiedCommits = Record<ReleaseSection, string[]>;
+export declare function selectPreviousSemanticTag(tags: string[], currentTag: string): string;
+export declare function classifyCommits(commits: ReleaseCommit[]): ClassifiedCommits;
+export declare function createReleaseNotes(input: ReleaseNotesInput): string;
+export {};
+//# sourceMappingURL=releaseNotes.d.ts.map

package/dist/tools/release/releaseNotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releaseNotes.d.ts","sourceRoot":"","sources":["../../../src/tools/release/releaseNotes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,KAAK,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,CAAC;AAChG,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;AAmCjE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAWpF;AAMD,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAa3E;AA4BD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAkBnE"}

package/dist/tools/release/releaseNotes.js

@@ -0,0 +1,105 @@
+const SEMANTIC_TAG = /^v(\d+)\.(\d+)\.(\d+)$/;
+const VERSION_COMMIT = /^(?:v?\d+\.\d+\.\d+|chore(?:\(release\))?:\s*v?\d+\.\d+\.\d+)$/i;
+const CONVENTIONAL_SUBJECT = /^([a-z]+)(?:\([^)]+\))?(!)?:\s*(.+)$/i;
+const SECTION_ORDER = [
+    'Breaking', 'Added', 'Fixed', 'Changed', 'Documentation', 'Internal',
+];
+const TYPE_TO_SECTION = {
+    feat: 'Added',
+    fix: 'Fixed',
+    docs: 'Documentation',
+    refactor: 'Internal',
+    chore: 'Internal',
+    test: 'Internal',
+    ci: 'Internal',
+    build: 'Internal',
+    perf: 'Changed',
+    style: 'Changed',
+};
+function parseTag(tag) {
+    const match = SEMANTIC_TAG.exec(tag);
+    if (!match)
+        return undefined;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compareVersions(left, right) {
+    for (let index = 0; index < left.length; index += 1) {
+        const difference = left[index] - right[index];
+        if (difference !== 0)
+            return difference;
+    }
+    return 0;
+}
+export function selectPreviousSemanticTag(tags, currentTag) {
+    const current = parseTag(currentTag);
+    if (!current)
+        throw new Error(`Invalid release tag: ${currentTag}`);
+    const candidates = tags
+        .map((tag) => ({ tag, version: parseTag(tag) }))
+        .filter((item) => item.version !== undefined && compareVersions(item.version, current) < 0)
+        .sort((left, right) => compareVersions(right.version, left.version));
+    if (!candidates[0])
+        throw new Error(`No previous semantic tag found for ${currentTag}`);
+    return candidates[0].tag;
+}
+function emptySections() {
+    return { Breaking: [], Added: [], Fixed: [], Changed: [], Documentation: [], Internal: [] };
+}
+export function classifyCommits(commits) {
+    return commits.reduce((sections, commit) => {
+        if (commit.subject.startsWith('Merge ') || VERSION_COMMIT.test(commit.subject))
+            return sections;
+        const match = CONVENTIONAL_SUBJECT.exec(commit.subject);
+        if (!match) {
+            sections.Changed.push(commit.subject);
+            return sections;
+        }
+        const isBreaking = match[2] === '!' || /BREAKING[ -]CHANGE:/i.test(commit.body);
+        const section = isBreaking ? 'Breaking' : (TYPE_TO_SECTION[match[1].toLowerCase()] ?? 'Changed');
+        sections[section].push(match[3]);
+        return sections;
+    }, emptySections());
+}
+function extractSection(content, heading) {
+    const pattern = new RegExp(`^##\\s+[^\\n]*${heading}[^\\n]*\\n([\\s\\S]*?)(?=^##\\s+|(?![\\s\\S]))`, 'im');
+    return pattern.exec(content)?.[1]?.trim() ?? '';
+}
+function extractSpecHighlights(spec) {
+    const title = /^#\s+(?:SPEC:\s*)?(.+)$/m.exec(spec.content)?.[1] ?? spec.path;
+    const overview = extractSection(spec.content, 'Overview').split(/^###\s+/m)[0].trim();
+    const requirements = extractSection(spec.content, 'Requirements')
+        .split('\n')
+        .filter((line) => /^\|\s*REQ-[^|]+\|/.test(line))
+        .map((line) => line.split('|')[2]?.trim())
+        .filter((value) => Boolean(value));
+    return [`### ${title}`, overview, ...requirements.map((requirement) => `- ${requirement}`)]
+        .filter((value) => Boolean(value));
+}
+function renderCommitSections(sections) {
+    return SECTION_ORDER.flatMap((section) => {
+        const entries = sections[section];
+        return entries.length > 0
+            ? [`## ${section}`, ...entries.map((entry) => `- ${entry}`)]
+            : [];
+    });
+}
+export function createReleaseNotes(input) {
+    const sections = classifyCommits(input.commits);
+    const highlights = input.specs.flatMap(extractSpecHighlights);
+    const commitSections = renderCommitSections(sections);
+    if (highlights.length === 0 && commitSections.length === 0) {
+        throw new Error(`No release changes found in ${input.previousTag}..${input.currentTag}`);
+    }
+    return [
+        `# ${input.currentTag}`,
+        '## Highlights',
+        ...highlights,
+        ...commitSections,
+        '## Verification',
+        `- Release range: \`${input.previousTag}..${input.currentTag}\``,
+        `- Included commits: ${input.commits.length}`,
+        '- Generated deterministically from repository history and specifications.',
+        '',
+    ].join('\n\n');
+}
+//# sourceMappingURL=releaseNotes.js.map

package/dist/tools/release/releaseNotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releaseNotes.js","sourceRoot":"","sources":["../../../src/tools/release/releaseNotes.ts"],"names":[],"mappings":"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"}

package/hooks/scripts/__tests__/.vibe/command-log.txt

@@ -1,3 +1,3 @@
-[2026-07-20T10:31:25.089Z] rm -rf /
-[2026-07-20T10:31:25.205Z] ls -la
-[2026-07-20T10:31:25.322Z] rm -rf src/infra/lib/evolution/
+[2026-07-22T17:14:22.091Z] rm -rf /
+[2026-07-22T17:14:22.167Z] ls -la
+[2026-07-22T17:14:22.264Z] rm -rf src/infra/lib/evolution/

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@su-record/vibe",
-  "version": "3.2.1",
-  "description": "AI Coding Framework for Claude Code — 7+ agents, 60 skills, multi-LLM orchestration",
+  "version": "3.2.3",
+  "description": "AI Coding Framework for Claude Code — 7+ agents, 51 skills, multi-LLM orchestration",
   "type": "module",
   "main": "dist/cli/index.js",
   "exports": {

package/skills/vibe/SKILL.md

@@ -75,6 +75,19 @@ user-invocable: true
 
 복수 의도면 우선순위: resume > figma-driven > new feature > 기타.
 
+### Phase 1-b: Stakes 분류 (태스크 무게)
+
+의도와 별개로 태스크의 **무게(stakes)** 를 분류한다 — 매핑 SSOT: `vibe/rules/loop-contract.md`의 Stakes 표.
+
+| stakes | 판정 신호 | 적용 프로파일 |
+|---|---|---|
+| `demo` | 명시 키워드(데모·일회성·실험·테스트용·throwaway·토이), 기존 프로젝트 코드와 무관한 신규 폴더, `.vibe/config.json` 없는 임시 디렉토리 | `--max-iter 1` + 리뷰 1패스 + **검증 스크립트 신규 생성 금지** |
+| `prototype` | 검증용 초기 버전 명시, 배포 대상 아님 | demo 와 동일 프로파일 |
+| `production` | 기본값 — 신호 없음 | 기존 기본 동작 (수렴 루프, 기본 리뷰어 셋) |
+
+- **불확실하면 상향한다** (production). 신호가 상충하면 SPEC 승인 메시지에 stakes 확인 질문 1개를 편승시킨다 — 별도 확인 왕복을 만들지 않는다.
+- 판정 결과는 Phase 3 실행 계획에 `Stakes:` 줄로 명시하고 spec/run/review 체인에 전달한다.
+
 > **⚠️ 위 표는 닫힌 화이트리스트가 아니라 "흔한 케이스 빠른 경로"다.** 표에 없는 요구사항이라도 막지 말고 **Catch-all 라우팅**(아래)으로 처리한다.
 
 ### Catch-all 라우팅 (표에 없는 의도)
@@ -125,6 +138,7 @@ user-invocable: true
 Input: 자연어 ("패럴랙스 웹사이트 만들어줘")
 Resume: 없음 (신규)
 Keywords: 없음
+Stakes: production (신호 없음 — 기본 상향)
 
 Phase 1: /vibe.spec → 단일 패스 SPEC + 승인 (유일한 의무 게이트)
 Phase 2: /vibe.figma → UI 디자인 트랙 (type=website 감지)

package/skills/{agents-md → vibe.agents-md}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: agents-md
+name: vibe.agents-md
 user-invocable: false
 invocation: [auto, chain]
 tier: standard

package/skills/{brand-assets → vibe.brand-assets}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brand-assets
+name: vibe.brand-assets
 invocation: [auto]
 tier: standard
 description: "Auto-generate app icons (iOS/Android/PWA), favicons, and OG images from SPEC brand information using the Antigravity image backend. Use when the project needs visual brand assets, when user mentions 'icon', 'favicon', 'logo', or 'brand assets', or when a SPEC defines brand colors/identity but no assets exist yet. Outputs multiple sizes and formats ready for deployment. Not for complex illustration or marketing graphics — focused on app identity assets."

package/skills/{capability-loop → vibe.capability-loop}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: capability-loop
+name: vibe.capability-loop
 user-invocable: false
 invocation: [auto]
 tier: standard

package/skills/{chub-usage → vibe.chub-usage}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: chub-usage
+name: vibe.chub-usage
 invocation: [auto]
 tier: optional
 description: "Context Hub (chub) — fetch vetted, up-to-date API documentation. Write accurate code based on the latest docs instead of training data when working with external APIs/SDKs."

package/skills/vibe.clone/SKILL.md

@@ -49,14 +49,14 @@ Step 2.5) --sub URL 확장
   - 포함: 같은 origin + 같은 locale prefix의 하위 메뉴 URL
   - 제외: 외부 링크, 언어 전환, 검색, TOP, 푸터 정책/문의/파트너/뉴스룸 링크
 
-Step 3) 스킬 진입
-  → clone 스킬 Phase 0부터 순차 실행
+Step 3) 실행 진입
+  → 아래 Execution Plan Phase 0부터 순차 실행
   → URL 다중 입력 시 각 URL마다 별도 feature 디렉토리 (URL path 기반 suffix)
 ```
 
 ## Execution Plan
 
-`clone` 스킬을 로드한 뒤 다음을 순차 실행한다. **Phase 단계 건너뛰기 금지**.
+다음을 순차 실행한다. **Phase 단계 건너뛰기 금지**.
 
 ```
 Phase 0: Setup
@@ -157,3 +157,295 @@ Claude 기본 행동:
   - robots.txt 차단 경로 → 명시적 --ignore-robots 없으면 거부
   - 사용자 의도가 사칭/기만이면 즉시 거부
 ```
+
+## Bundled implementation
+
+
+# vibe.clone — Markup-Level Website Clone
+
+## Core Principles
+
+```
+The rendered DOM is the source of truth for markup. Screenshots are for pixel verification only.
+
+✅ Puppeteer-rendered DOM (post-JS) → HTML structural mapping
+✅ Computed CSS → SCSS direct conversion (no guessing)
+✅ All remote assets (images, fonts) → downloaded locally and rewritten to project paths
+✅ Claude handles semantic decisions only: tag selection, component splitting, interactions
+✅ Screenshots are used for verification only, not generation
+```
+
+## Immutable Rules
+
+```
+1. Do NOT generate CSS values by guessing or eyeballing screenshots.
+   ✅ clone-to-scss.js output is a DRAFT (skeleton), not a frozen artifact. You MAY
+      rewrite SCSS values/selectors — but ONLY with evidence cited from computed.json /
+      states.json / behaviors.json (value correction, dedupe, selector restructuring).
+   ✅ clone-validate.js PASS is the sole judge of value correctness — not self-report.
+   ❌ Do NOT invent values with no extraction evidence ("looks like 18px" is forbidden).
+   ❌ Do NOT write CSS values directly inside scoped <style> blocks — style LOCATION
+      rule: all values live in styles/{feature}/ SCSS (value authority and style
+      location are separate rules; both hold).
+
+2. Do NOT hotlink remote assets. All images/fonts must be downloaded and rewritten.
+
+3. Do NOT skip the pixel verification loop (Phase 5). The clone is incomplete without it.
+
+4. Do NOT copy textual content verbatim from copyrighted sources for production use.
+   This skill is for layout/markup learning ("클론 코딩"). Replace text with placeholders
+   or user-provided copy when shipping a real product.
+   Exception: `--real-content` — the user confirms (once, explicitly) they own the site
+   or have permission. Then keep text verbatim; clone-spec.js is invoked with
+   `--real-content` so specs mark copy as verbatim.
+
+5. Do NOT build a section without confirming its interaction model. The model in
+   sections.json is a static-DOM heuristic — verify scroll-driven vs click-driven vs
+   time-driven vs hover against the live site. Misidentifying it is the #1 clone failure mode.
+
+6. Do NOT ship default-state-only. Implement every harvested state (hover/focus/active/open/
+   tab-switch) from states.json / the section spec.
+
+7. Do NOT ignore behaviors.json. The ACTIVE interaction sweep (scroll-state diffs,
+   click-driven tab content-swap detection, hover diffs, in-view entrance animations,
+   time-driven mutation candidates, smooth-scroll-lib detection) catches JS-set state
+   that static CSS harvesting is blind to. When the spec's "Dynamic behaviors" block
+   conflicts with the static interaction heuristic, the active capture wins.
+```
+
+## Full Flow
+
+```
+Input: a URL (or multiple URLs for multi-page clones)
+
+→ Phase 0: Setup (stack detection, feature naming, working dir)
+→ Phase 1: Capture (Puppeteer → rendered HTML + computed CSS + screenshots + assets)
+→ Phase 2: Refine (DOM → sections.json per breakpoint; + interaction model + states)
+→ Phase 2.5: Foundation (fonts / favicon / OG / SVG icons — sequential, before any section)
+→ Phase 3: Scaffold (spec gate → SCSS draft + builder dispatch, parallel per section)
+→ Phase 3C: Responsive merge (clone-merge-responsive.js — mobile-first @media)
+→ Phase 4: Compile gate
+→ Phase 5: Pixel verification loop (BOTH viewports after merge)
+```
+
+> Read `references/setup-and-layout.md` for the working-directory layout and code-output paths.
+
+---
+
+## Phase 0: Setup
+
+> Read `references/setup-and-layout.md` for the full Phase 0 setup steps (stack detection, feature naming, directories, component indexing, design token scan).
+
+---
+
+## Phase 1: Capture ← Headless browser (parallel MO/PC)
+
+**Coordinator pattern: run MO/PC capture as parallel workers.**
+
+### BLOCKING Command — Use only clone-extract.js for capture
+
+```bash
+# [CLONE_SCRIPT] = {{VIBE_PATH}}/hooks/scripts/clone-extract.js
+
+# Mobile (375×812)
+node {{VIBE_PATH}}/hooks/scripts/clone-extract.js capture <URL> \
+  --out=/tmp/{feature}/mo/ \
+  --viewport=375x812 \
+  --bp=mo
+
+# Desktop (1440×900)
+node {{VIBE_PATH}}/hooks/scripts/clone-extract.js capture <URL> \
+  --out=/tmp/{feature}/pc/ \
+  --viewport=1440x900 \
+  --bp=pc
+```
+
+⛔ **Writing custom capture scripts (puppeteer-fetch.mjs, etc.) is forbidden.**
+⛔ **Do NOT use WebFetch or curl** — they cannot render JS-driven SPAs.
+✅ Use clone-extract.js. If output is unsatisfactory, modify the script.
+
+> Read `references/capture-rules.md` for the full per-breakpoint output directory listing and the deterministic capture rule set (networkidle wait, asset resolution, states/behaviors harvesting, SEO asset harvest).
+
+---
+
+## Phase 2: Refine ← DOM → sections.json (independent per BP)
+
+### BLOCKING Command — Writing custom refine scripts is forbidden
+
+```bash
+# MO  (--states is optional — auto-resolved as states.json next to computed.json)
+node {{VIBE_PATH}}/hooks/scripts/clone-refine.js \
+  /tmp/{feature}/mo/rendered.html \
+  /tmp/{feature}/mo/computed.json \
+  --out=/tmp/{feature}/mo/sections.json \
+  --states=/tmp/{feature}/mo/states.json \
+  --bp=mo
+
+# PC
+node {{VIBE_PATH}}/hooks/scripts/clone-refine.js \
+  /tmp/{feature}/pc/rendered.html \
+  /tmp/{feature}/pc/computed.json \
+  --out=/tmp/{feature}/pc/sections.json \
+  --states=/tmp/{feature}/pc/states.json \
+  --bp=pc
+```
+
+⛔ **Phase 3 is blocked until refine completes for all required BPs.**
+⛔ **Do NOT parse rendered.html with custom Python/Node scripts.**
+✅ Use clone-refine.js output as-is. If unsatisfactory, modify the script.
+
+> Read `references/refine-rules.md` for the full refinement rule set and the sections.json output schema.
+
+---
+
+## Phase 2.5: Foundation ← sequential, BEFORE any section build
+
+Nothing renders right until the foundation exists. Do this yourself (not delegated) — it
+touches shared files:
+
+```
+1. Fonts: verify _base.scss @font-face srcs point at downloaded assets/fonts/ files.
+   Next.js stack → wire via next/font/local in the layout instead of raw @font-face.
+2. Favicon / OG / manifest: copy assets/seo/* → public/ (project convention path),
+   wire metadata (layout.tsx metadata / <head>) to the local files.
+3. SVG icons: collect inline <svg> from rendered.html, dedupe by path data,
+   emit one stack-appropriate icon module (e.g. components/{feature}/icons.tsx).
+   Name by visual function (SearchIcon, ArrowRightIcon, LogoIcon).
+4. Global behaviors from behaviors.json: scrollLib detected → install/wire page-level
+   (Lenis etc.); global keyframes/scroll-snap → styles/{feature}/_shared.scss.
+5. Verify: compile passes before moving on.
+```
+
+---
+
+## Phase 3: Scaffold ← stack-specific code generation
+
+**⛔ Implement MO fully first → pass verification → then PC. No responsive conversion in this phase.**
+**⛔ CSS values must use computed.json output as-is. No vw/clamp/@media in this phase.**
+
+### BLOCKING Command — SCSS must only use script output
+
+```bash
+# Step 0: Generate per-section build-contract specs (run once per BP)
+node {{VIBE_PATH}}/hooks/scripts/clone-spec.js \
+  /tmp/{feature}/{bp}/sections.json \
+  --out=/path/to/project/components/{feature}/_specs/{bp}/ \
+  --feature={feature} [--real-content]
+
+# Step A: Auto-generate SCSS draft (run once per BP — note the per-BP out dir)
+node {{VIBE_PATH}}/hooks/scripts/clone-to-scss.js \
+  /tmp/{feature}/{bp}/sections.json \
+  --out=/path/to/project/styles/{feature}/{bp}/ \
+  --token-file=/tmp/{feature}/project-tokens.json
+
+# Step B: Per-section validation (after writing each section's component code)
+node {{VIBE_PATH}}/hooks/scripts/clone-validate.js \
+  /path/to/project/styles/{feature}/{bp}/ \
+  /tmp/{feature}/{bp}/sections.json \
+  --section={SectionName}
+```
+
+⛔ **No section is built without a completed spec.** Step 0 emits `_specs/{Section}.spec.md`
+   (interaction model + **active-capture Dynamic behaviors** (scroll/tab/hover/in-view/
+   time-driven/scroll-lib) + states + computed CSS + assets + text + checklist).
+   clone-spec.js auto-loads `behaviors.json` from the sections.json dir and attaches matching
+   behaviors per section. Before dispatching a section's builder, Claude reviews its spec and
+   resolves every `TODO` (confirm interaction model, list states to implement, choose tags,
+   replace copyrighted text — skipped with --real-content). The spec is the contract AND the
+   audit trail — it forces extraction rigor before any code is written.
+⛔ **clone-to-scss.js must run first (Step A) — its output is the DRAFT every section starts
+   from.** After that, SCSS edits are allowed per Immutable Rule 1 (evidence-cited only);
+   clone-validate.js PASS is the judge.
+⛔ **Do NOT write custom SCSS / spec generation scripts.**
+⛔ **Do NOT proceed past a section without a clone-validate.js PASS for it.**
+
+Phase 3A: MO Scaffold — parallel builder dispatch
+  Input: /tmp/{feature}/mo/sections.json
+  → Phase 4 (MO compile) → Phase 5 (MO pixel verification)
+
+Phase 3B: PC Scaffold
+  Same process as MO, input /tmp/{feature}/pc/sections.json → styles/{feature}/pc/
+  → Phase 4 (PC compile) → Phase 5 (PC pixel verification)
+
+Phase 3C: Responsive Integration (after both MO+PC pass Phase 5)
+  1. node {{VIBE_PATH}}/hooks/scripts/clone-merge-responsive.js \
+       --mo=/path/to/project/styles/{feature}/mo/ \
+       --pc=/path/to/project/styles/{feature}/pc/ \
+       --out=/path/to/project/styles/{feature}/ \
+       [--breakpoint=1024]
+     → mobile-first merge: MO declarations = base, PC diffs → @media (min-width) block
+  → Phase 4 (compile) → Phase 5 at BOTH viewports against each BP's screenshot.
+     ⛔ The clone is NOT complete until the MERGED build passes Phase 5 at both.
+```
+
+> Read `references/scaffold-phases.md` for the full Phase 3A prep/dispatch/merge builder contract (framework mapping, 150-line split rule, clone-validate.js PASS/FAIL loop detail), Phase 3C steps 2–3 (import switch, pc-only/mo-only selector review), and Claude's role checklist.
+
+---
+
+## Phase 4: Compile Gate
+
+```
+No round cap. Loop until compile succeeds (or stuck → ask user).
+
+0. Capture baseline (before Phase 3): record existing tsc + build errors
+   → Phase 4 only fixes NEW errors
+
+1. TypeScript: vue-tsc / svelte-check / tsc --noEmit
+2. Build: npm run build (120s timeout)
+3. Dev server: npm run dev → detect port → polling
+
+On error: parse → auto-fix → re-check
+Termination:
+  ✅ Success: all checks pass → enter Phase 5
+  ⚠️ Stuck: same errors as previous round → ask user
+     1. Direct fix instructions → retry
+     2. "proceed" — record remaining errors as TODO, proceed to Phase 5
+     3. "abort" — halt
+  ultrawork mode: on stuck, record TODO without prompting and proceed
+
+⛔ Must enter Phase 5 after Phase 4 passes. Do NOT output a "completion summary".
+```
+
+---
+
+## Phase 5: Pixel Verification Loop ← MANDATORY
+
+**⛔ Phase 5 is mandatory, not optional. Enter automatically after Phase 4.**
+**⛔ Skipping Phase 5 makes the entire clone "incomplete".**
+
+```
+No round cap. Loop until P1=0 (or stuck → ask user).
+Infrastructure: src/infra/lib/browser/ (Puppeteer + CDP) — same as figma Phase 6.
+
+1. Render scaffolded page in dev server at matching viewport
+2. Capture screenshot → pixelmatch comparison against /tmp/{feature}/{bp}/screenshot.png
+   diffRatio > 0.05 (clone target is tighter than figma) → P1
+3. CSS comparison: live computed CSS vs /tmp/{feature}/{bp}/computed.json
+   delta > 2px → P1, ≤ 2px → P2
+4. Asset audit: every <img>/background-image resolves to local public/images/ path → else P1
+5. Fix P1 first (refer to computed.json, no guessing) → revalidate compile → reload
+
+Narrowing scope:
+  Round 1: P1+P2+P3
+  Round 2: P1+P2
+  Round 3+: P1 only
+
+Termination:
+  ✅ P1=0 AND no new findings → complete
+  ⚠️ Stuck: same findings → ask user (resolve / proceed / abort)
+  ultrawork mode: on stuck, record TODO without prompting and complete
+
+Responsive: after MO verification → change viewport → repeat against PC screenshot
+Post-merge (Phase 3C): re-run at BOTH viewports (375×812 vs mo/screenshot.png,
+  1440×900 vs pc/screenshot.png) — either failing means the merge regressed; fix the
+  merged SCSS (evidence: the per-BP sections.json), never by re-guessing values
+Cleanup: shut down browser + dev server
+
+⛔ "Completion summary" output only allowed after Phase 5 completes.
+```
+
+---
+
+## Legal, Ethical & Error Recovery Reference
+
+> Read `references/legal-and-error-recovery.md` for the full legal/ethical usage notes (intended use, prohibited use, --real-content flow) and the Error Recovery troubleshooting table.

package/skills/{commerce-patterns → vibe.commerce-patterns}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: commerce-patterns
+name: vibe.commerce-patterns
 invocation: [auto]
 tier: core
 description: "E-commerce domain patterns — cart management, payment processing (Toss/Stripe/PG), inventory tracking, and order state machines with transaction safety. Use when implementing any shopping cart, checkout flow, payment integration, stock management, or order lifecycle. Covers idempotency keys, double-charge prevention, stock reservation, and refund flows. Must use this skill when the codebase involves e-commerce — even for seemingly simple 'add to cart' features."