feat: add asset-first Artic show preview bundle

README.ja.md

@@ -21,7 +21,7 @@ Artic は、実装前にホームページのデザイン方向を契約とし
 ```text
 @artic init      # 意図と参照を収集
 @artic start     # strategy artifacts を作成し DESIGN.md 文書をコンパイル
-@artic show      # 安全な静的 preview をレンダリング
+@artic show      # provenance を記録した asset-first preview bundle をレンダリング
 @artic review    # 実装を文書に照らして確認
 ```
 
@@ -121,7 +121,7 @@ Artic が呼び出されると、エージェントは次を行います:
 4. 色の役割、タイプ階層、余白リズム、コンポーネント、モーション、アクセシビリティなど、再利用可能なルールを抽出します。
 5. ユーザーのプロジェクト目標に基づいて、レファレンス間の衝突を解決します。
 6. `@artic start` で public agent workflow が `.artic/strategy.json` を作成し、`docs/artic-strategy.md` を保存してから compiler を実行し、`DESIGN.md` と補助文書を生成します。
-7. `@artic show` で strategy artifacts に基づく安全な静的 preview `.artic/show/index.html` をレンダリングし、アプリのソースファイルは変更しません。
+7. `@artic show` で strategy artifacts に基づく asset-first visual draft bundle を `.artic/show/` にレンダリングし、アプリのソースファイルは変更しません。
 8. `@artic review` で実装を `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` と比較し、生成されたデザイン文書を検証します。
 
 ## When To Use It
@@ -146,7 +146,7 @@ Artic が呼び出されると、エージェントは次を行います:
 | デザインヒアリング開始 | `@artic init` |
 | 高速ヒアリング実行 | `@artic init quick` |
 | strategy 作成と文書コンパイル | `@artic start` |
-| strategy artifacts から安全な静的 preview をレンダリング | `@artic show` |
+| strategy artifacts から asset-first preview bundle をレンダリング | `@artic show` |
 | strategy + `DESIGN.md` に対して実装をレビュー | `@artic review the homepage against DESIGN.md` |
 | インストール済み/最新バージョン確認 | `@artic version` |
 | 安全な更新コマンド表示 | `@artic update` |
@@ -172,7 +172,14 @@ DESIGN.md
 docs/design-rules.md
 docs/design-qa-checklist.md
 docs/homepage-design-prompt.md
-.artic/show/index.html     # strategy artifacts から @artic show が生成する preview 専用ファイル。デフォルトではアプリファイルを変更しません
+.artic/show/index.html
+.artic/show/styles.css
+.artic/show/tokens.json
+.artic/show/assets/manifest.json  # asset provenance; 未検証 asset は preview-only で production-cleared ではありません
+.artic/show/report.json
+.artic/show/critique.md
+.artic/show/selected.json
+.artic/show/iterations/<NNN>/...  # @artic show が生成。アプリファイルは変更しません
 ```
 
 ## Repository Layout

README.ko.md

@@ -21,7 +21,7 @@ Artic은 구현 전에 홈페이지 디자인 방향을 계약으로 고정하
 ```text
 @artic init      # 의도와 레퍼런스 수집
 @artic start     # strategy artifacts를 작성한 뒤 DESIGN.md 문서 컴파일
-@artic show      # 안전한 정적 preview 렌더링
+@artic show      # 출처가 기록된 asset-first preview bundle 렌더링
 @artic review    # 구현 결과를 문서 기준으로 검토
 ```
 
@@ -121,7 +121,7 @@ Artic이 호출되면 에이전트는 다음을 수행합니다:
 4. 색상 역할, 타이포그래피, spacing, 컴포넌트, 모션, 접근성 규칙을 추출합니다.
 5. 사용자 목표를 기준으로 레퍼런스 간 충돌을 해결합니다.
 6. `@artic start`에서 public agent workflow가 `.artic/strategy.json`을 작성하고 `docs/artic-strategy.md`를 저장한 뒤 compiler를 실행해 `DESIGN.md`와 보조 문서를 생성합니다.
-7. `@artic show`로 strategy artifacts 기반의 안전한 정적 preview인 `.artic/show/index.html`을 렌더링하며 앱 소스 파일은 바꾸지 않습니다.
+7. `@artic show`로 strategy artifacts 기반의 asset-first 시각 초안 bundle을 `.artic/show/` 아래 렌더링하며 앱 소스 파일은 바꾸지 않습니다.
 8. `@artic review`로 구현을 `.artic/strategy.json`, `docs/artic-strategy.md`, `DESIGN.md`와 비교하고 생성 문서를 검증합니다.
 
 ## When To Use It
@@ -146,7 +146,7 @@ Artic이 호출되면 에이전트는 다음을 수행합니다:
 | 디자인 인터뷰 시작 | `@artic init` |
 | 빠른 인터뷰 실행 | `@artic init quick` |
 | strategy 작성 및 문서 컴파일 | `@artic start` |
-| strategy artifacts 기반 안전한 정적 preview 렌더링 | `@artic show` |
+| strategy artifacts 기반 asset-first preview bundle 렌더링 | `@artic show` |
 | strategy + `DESIGN.md` 기준 구현 결과 검토 | `@artic review the homepage against DESIGN.md` |
 | 설치/최신 버전 확인 | `@artic version` |
 | 안전한 업데이트 명령 출력 | `@artic update` |
@@ -174,7 +174,14 @@ DESIGN.md
 docs/design-rules.md
 docs/design-qa-checklist.md
 docs/homepage-design-prompt.md
-.artic/show/index.html     # strategy artifacts에서 @artic show가 생성하는 preview 전용 파일; 기본적으로 앱 파일은 변경하지 않음
+.artic/show/index.html
+.artic/show/styles.css
+.artic/show/tokens.json
+.artic/show/assets/manifest.json  # asset 출처 기록; 미검증 asset은 preview-only이며 production-cleared가 아님
+.artic/show/report.json
+.artic/show/critique.md
+.artic/show/selected.json
+.artic/show/iterations/<NNN>/...  # @artic show가 생성; 앱 파일은 변경하지 않음
 ```
 
 ## Repository Layout

README.md

@@ -21,7 +21,7 @@ It keeps the public workflow small:
 ```text
 @artic init      # collect intent and references
 @artic start     # author strategy artifacts, then compile DESIGN.md docs
-@artic show      # render a safe static preview
+@artic show      # render a provenance-recorded asset-first preview bundle
 @artic review    # check implementation against the docs
 ```
 
@@ -121,7 +121,7 @@ When invoked, Artic asks the agent to:
 4. Extract reusable rules: color roles, type hierarchy, spacing rhythm, components, motion, accessibility.
 5. Resolve conflicts between references based on the user's project goal.
 6. Run `@artic start` so the public agent workflow authors `.artic/strategy.json`, writes `docs/artic-strategy.md`, then runs the compiler for `DESIGN.md` and supporting docs.
-7. Run `@artic show` to render `.artic/show/index.html` from strategy artifacts as a safe static preview without changing app source files.
+7. Run `@artic show` to render a provenance-recorded asset-first visual draft bundle under `.artic/show/` without changing app source files.
 8. Run `@artic review` to compare implementation against `.artic/strategy.json`, `docs/artic-strategy.md`, and `DESIGN.md`, then validate the generated design docs before implementation.
 
 ## When To Use It
@@ -146,7 +146,7 @@ Skip it for:
 | Start the design interview | `@artic init` |
 | Run the fast interview | `@artic init quick` |
 | Author strategy and compile docs | `@artic start` |
-| Render a safe static preview from strategy artifacts | `@artic show` |
+| Render an asset-first preview bundle from strategy artifacts | `@artic show` |
 | Review implementation against strategy + `DESIGN.md` | `@artic review the homepage against DESIGN.md` |
 | Check installed/latest version | `@artic version` |
 | Print safe update commands | `@artic update` |
@@ -174,7 +174,14 @@ DESIGN.md
 docs/design-rules.md
 docs/design-qa-checklist.md
 docs/homepage-design-prompt.md
-.artic/show/index.html     # generated by @artic show from strategy artifacts; preview only, app files unchanged by default
+.artic/show/index.html
+.artic/show/styles.css
+.artic/show/tokens.json
+.artic/show/assets/manifest.json  # asset provenance; unverified assets are preview-only, not production-cleared
+.artic/show/report.json
+.artic/show/critique.md
+.artic/show/selected.json
+.artic/show/iterations/<NNN>/...  # generated by @artic show; app files unchanged
 ```
 
 ## Repository Layout

README.zh-CN.md

@@ -21,7 +21,7 @@ Artic 是一个兼容 Claude/Codex 的 agent design-direction protocol，也是
 ```text
 @artic init      # 收集意图和参考
 @artic start     # 编写 strategy artifacts，再编译 DESIGN.md 文档
-@artic show      # 渲染安全的静态 preview
+@artic show      # 渲染记录来源的 asset-first preview bundle
 @artic review    # 按文档检查实现
 ```
 
@@ -121,7 +121,7 @@ Artic 被调用后，Agent 会：
 4. 提取可复用规则：颜色角色、字体层级、间距节奏、组件、动效与可访问性。
 5. 根据用户的项目目标解决不同参考之间的冲突。
 6. 运行 `@artic start`，让 public agent workflow 编写 `.artic/strategy.json`、保存 `docs/artic-strategy.md`，再运行 compiler 生成 `DESIGN.md` 和辅助文档。
-7. 运行 `@artic show`，基于 strategy artifacts 渲染 `.artic/show/index.html`，作为不会修改应用源码的安全静态 preview。
+7. 运行 `@artic show`，基于 strategy artifacts 在 `.artic/show/` 下渲染 asset-first visual draft bundle，且不会修改应用源码。
 8. 运行 `@artic review`，把实现与 `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` 对比，并验证生成的设计文档。
 
 ## When To Use It
@@ -146,7 +146,7 @@ Artic 被调用后，Agent 会：
 | 开始设计访谈 | `@artic init` |
 | 运行快速访谈 | `@artic init quick` |
 | 编写 strategy 并编译文档 | `@artic start` |
-| 基于 strategy artifacts 渲染安全静态 preview | `@artic show` |
+| 基于 strategy artifacts 渲染 asset-first preview bundle | `@artic show` |
 | 按 strategy + `DESIGN.md` 审查实现 | `@artic review the homepage against DESIGN.md` |
 | 检查已安装/最新版本 | `@artic version` |
 | 输出安全更新命令 | `@artic update` |
@@ -172,7 +172,14 @@ DESIGN.md
 docs/design-rules.md
 docs/design-qa-checklist.md
 docs/homepage-design-prompt.md
-.artic/show/index.html     # 由 @artic show 基于 strategy artifacts 生成的 preview 文件；默认不修改应用文件
+.artic/show/index.html
+.artic/show/styles.css
+.artic/show/tokens.json
+.artic/show/assets/manifest.json  # asset provenance；未验证 asset 仅限 preview-only，不代表 production-cleared
+.artic/show/report.json
+.artic/show/critique.md
+.artic/show/selected.json
+.artic/show/iterations/<NNN>/...  # 由 @artic show 生成；不修改应用文件
 ```
 
 ## Repository Layout

README.zh-TW.md

@@ -21,7 +21,7 @@ Artic 是一個相容 Claude/Codex 的 agent design-direction protocol，也是
 ```text
 @artic init      # 收集意圖和參考
 @artic start     # 編寫 strategy artifacts，再編譯 DESIGN.md 文件
-@artic show      # 渲染安全的靜態 preview
+@artic show      # 渲染記錄來源的 asset-first preview bundle
 @artic review    # 依文件檢查實作
 ```
 
@@ -121,7 +121,7 @@ Artic 被呼叫後，Agent 會：
 4. 萃取可重用規則：色彩角色、字體層級、間距節奏、元件、動效與可存取性。
 5. 依據使用者的專案目標解決不同參考之間的衝突。
 6. 執行 `@artic start`，讓 public agent workflow 編寫 `.artic/strategy.json`、儲存 `docs/artic-strategy.md`，再執行 compiler 生成 `DESIGN.md` 和輔助文件。
-7. 執行 `@artic show`，基於 strategy artifacts 渲染 `.artic/show/index.html`，作為不會修改應用程式原始碼的安全靜態 preview。
+7. 執行 `@artic show`，基於 strategy artifacts 在 `.artic/show/` 下渲染 asset-first visual draft bundle，且不會修改應用程式原始碼。
 8. 執行 `@artic review`，把實作與 `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` 對比，並驗證生成的設計文件。
 
 ## When To Use It
@@ -146,7 +146,7 @@ Artic 被呼叫後，Agent 會：
 | 開始設計訪談 | `@artic init` |
 | 執行快速访谈 | `@artic init quick` |
 | 編寫 strategy 並編譯文件 | `@artic start` |
-| 基於 strategy artifacts 渲染安全靜態 preview | `@artic show` |
+| 基於 strategy artifacts 渲染 asset-first preview bundle | `@artic show` |
 | 依 strategy + `DESIGN.md` 審查實作 | `@artic review the homepage against DESIGN.md` |
 | 检查已安裝/最新版本 | `@artic version` |
 | 輸出安全更新命令 | `@artic update` |
@@ -172,7 +172,14 @@ DESIGN.md
 docs/design-rules.md
 docs/design-qa-checklist.md
 docs/homepage-design-prompt.md
-.artic/show/index.html     # 由 @artic show 基於 strategy artifacts 生成的 preview 檔案；預設不修改應用程式檔案
+.artic/show/index.html
+.artic/show/styles.css
+.artic/show/tokens.json
+.artic/show/assets/manifest.json  # asset provenance；未驗證 asset 僅限 preview-only，不代表 production-cleared
+.artic/show/report.json
+.artic/show/critique.md
+.artic/show/selected.json
+.artic/show/iterations/<NNN>/...  # 由 @artic show 生成；不修改應用程式檔案
 ```
 
 ## Repository Layout

plugins/claude-artic/skills/artic/SKILL.md

@@ -30,8 +30,8 @@ Core flow:
 → validate outputs
 
 @artic show
-→ render the strategy artifacts and generated design docs into a safe static homepage preview
-→ write `.artic/show/index.html` without modifying app source files by default
+→ render the strategy artifacts and sourced/generated assets into a provenance-recorded asset-first visual draft bundle
+→ write `.artic/show/` preview files without modifying app source files
 
 @artic review
 → compare implementation against `.artic/strategy.json`, `docs/artic-strategy.md`, and `DESIGN.md`
@@ -91,8 +91,9 @@ Default interview questions:
 External reference vs external asset boundary:
 - External references are design/runtime sources used for reusable principles, interaction patterns, accessibility/performance constraints, token relationships, and implementation guidance.
 - External assets are concrete media that can appear in the generated site: GLB files, images, models, icons, textures, fonts, illustrations, or similar files.
-- Unless the user explicitly allows asset usage, treat all external sources as reference-principles only.
-- If the user allows asset usage, use only user-owned assets or license-verifiable public assets such as CC0/CC-BY/public-domain/MIT/Apache-2.0 where appropriate, and record source URL, license, and attribution in `docs/artic-brief.md` or implementation docs.
+- `@artic start` still treats external sources as reference-principles unless the user explicitly allows asset usage.
+- `@artic show` may use sourced or generated assets for the preview bundle when doing so improves the first visual draft, but every asset must be recorded in `.artic/show/assets/manifest.json` and `.artic/show/report.json` with source/generation notes, license status when known, and preview-only status when unverified.
+- Unverified assets are allowed only inside the preview bundle as provenance-recorded, preview-only material. Do not claim production license clearance; production/apply review belongs to a future `@artic apply` flow or a separate implementation review.
 
 Fast path: if user says `@artic init quick`, ask only product, audience, goal, vibe, and references.
 
@@ -143,7 +144,7 @@ Lifecycle transition rule: `@artic start` is the only transition that may finali
 
 ### `@artic show`
 
-Purpose: render the current Artic design outputs into a safe static homepage preview.
+Purpose: render the current Artic strategy into a provenance-recorded, asset-first first visual draft bundle. The goal is a stronger strategy-grounded first visual draft by using sourced/generated assets when helpful, while recording where each asset came from and whether it is preview-only.
 
 Executable path for agents/hosts that expose shell-backed commands:
 
@@ -153,11 +154,14 @@ python3 <artic-skill>/scripts/artic_show.py --root <project-root>
 
 Required behavior:
 1. Require `DESIGN.md`, `docs/homepage-design-prompt.md`, `.artic/brief.json`, `.artic/references.json`, and `.artic/strategy.json` from a completed `@artic start` flow.
-2. Generate `.artic/show/index.html` as a static preview of the homepage direction.
-3. Do not modify app/source files by default; downstream files such as `app/page.tsx`, `src/App.tsx`, or `pages/index.tsx` require an explicit future `--apply` or separate apply command.
-4. Include the reference-safety policy in the preview so the preview remains reference-informed, not reference-copied.
-5. If selected reference roles include `3d_runtime`, render a runtime-aware preview structure such as a `model-viewer`/Three.js placeholder, central interaction zone, poster/reduced-motion fallback notes, and asset-license reminders instead of a generic landing-page-only preview.
-6. Return JSON with `preview_file` and `modified_app_files` for verification.
+2. Generate a strategy-grounded first visual draft bundle under `.artic/show/`, not just a minimal static preview.
+3. Prefer asset-first draft quality: use user-provided, sourced, or generated images/models/icons/textures when they improve the first visual draft, and fall back to styled placeholders only when assets are unavailable or inappropriate.
+4. Record provenance for every preview asset in `.artic/show/assets/manifest.json` and summarize asset decisions, gaps, and warnings in `.artic/show/report.json`.
+5. Mark unverified assets as preview-only/provenance-recorded. Do not state or imply production license clearance for unverified sourced/generated assets.
+6. Do not modify app/source files. Downstream files such as `app/page.tsx`, `src/App.tsx`, or `pages/index.tsx` are out of scope for `@artic show`; a future `@artic apply` or separate implementation review would handle production/apply decisions later.
+7. Include the reference-safety policy in the preview so the preview remains reference-informed, not reference-copied.
+8. If selected reference roles include `3d_runtime`, render a runtime-aware preview structure such as a `model-viewer`/Three.js placeholder, central interaction zone, poster/reduced-motion fallback notes, and asset provenance/license reminders instead of a generic landing-page-only preview.
+9. Return JSON with at least `preview_file`, `bundle_dir`, `asset_manifest`, `report_file`, and `modified_app_files` for verification.
 
 ### `@artic review` MVP-light
 
@@ -276,6 +280,21 @@ docs/design-qa-checklist.md
 docs/homepage-design-prompt.md
 ```
 
+`@artic show` creates a provenance-recorded preview bundle:
+
+```text
+.artic/show/index.html
+.artic/show/styles.css
+.artic/show/tokens.json
+.artic/show/assets/manifest.json
+.artic/show/report.json
+.artic/show/critique.md
+.artic/show/selected.json
+.artic/show/iterations/<NNN>/...
+```
+
+Show bundles are preview-only and do not modify app source files. Unverified sourced/generated assets may be included for first-draft visual quality only when marked preview-only and provenance-recorded; production/apply clearance is out of scope for `@artic show` and belongs to future `@artic apply`/implementation review.
+
 Optional exports: `tailwind.theme.json`, `tokens.json`.
 
 ## Presets