Merge pull request #26 from baskduf/fix/release-blocking-findings

fix: resolve release-blocking Artic findings

Author: baskduf

README.ja.md

@@ -117,9 +117,9 @@ Artic が呼び出されると、エージェントは次を行います:
 
 1. ホームページ/デザイン依頼が曖昧な場合、実装前に立ち止まります。
 2. `@artic init` で product、audience、goal、vibe、constraints、references を収集します。
-3. Search multiple professional/OSS design resources instead of relying on one style.
-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.
+3. 1つのスタイルに頼らず、複数のプロフェッショナル/OSSデザインリソースを検索します。
+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` をレンダリングし、アプリのソースファイルは変更しません。
 8. `@artic review` で実装を `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` と比較し、生成されたデザイン文書を検証します。
@@ -128,10 +128,10 @@ Artic が呼び出されると、エージェントは次を行います:
 
 使う場面:
 
-- Homepages, landing pages, product pages, and website redesigns.
-- Projects with weak or missing design docs.
-- AI-native design documentation before coding.
-- Reference-driven design direction without exact brand copying.
+- ホームページ、ランディングページ、プロダクトページ、Webサイトリデザイン。
+- デザインドキュメントが弱い、または存在しないプロジェクト。
+- 実装前に作るAI-nativeなデザインドキュメント。
+- ブランドを正確にコピーしない、レファレンス駆動のデザインディレクション。
 
 使わない場面:
 
@@ -157,7 +157,7 @@ Artic が呼び出されると、エージェントは次を行います:
 
 ## Output Policy
 
-Artic writes durable files instead of dumping long design prose into chat:
+Artic は長いデザイン説明をチャットに流すのではなく、永続的なファイルを書き出します:
 
 ```text
 .artic/init-session.json   # draft interview state from @artic init
@@ -194,7 +194,7 @@ python3 -m pip install pytest pyyaml
 python3 -m pytest -q
 ```
 
-CI validates Python scripts, JSON manifests, README translation structure, skill-copy sync, smoke scaffolding, warning-free DESIGN.md lint, and marketplace plugin layout.
+CI は Python スクリプト、JSON マニフェスト、README 翻訳構造、skill copy 同期、smoke scaffold、警告なしの DESIGN.md lint、marketplace plugin layout を検証します。
 
 Distribution note: the wheel is metadata-only; marketplace packages, release tarballs, and sdists carry the skill/plugin payload.
 

README.zh-CN.md

@@ -117,9 +117,9 @@ Artic 被调用后，Agent 会：
 
 1. 当首页/设计请求很模糊时，先暂停而不是直接实现。
 2. 运行 `@artic init` 收集 product、audience、goal、vibe、constraints 和 references。
-3. Search multiple professional/OSS design resources instead of relying on one style.
-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.
+3. 搜索多个专业/OSS 设计资源，而不是依赖单一风格。
+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。
 8. 运行 `@artic review`，把实现与 `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` 对比，并验证生成的设计文档。
@@ -128,10 +128,10 @@ Artic 被调用后，Agent 会：
 
 适合用于：
 
-- Homepages, landing pages, product pages, and website redesigns.
-- Projects with weak or missing design docs.
-- AI-native design documentation before coding.
-- Reference-driven design direction without exact brand copying.
+- 主页、落地页、产品页和网站改版。
+- 设计文档薄弱或缺失的项目。
+- 编码前的 AI-native 设计文档。
+- 不精确复制品牌的参考驱动设计方向。
 
 不适合用于：
 
@@ -157,7 +157,7 @@ Artic 被调用后，Agent 会：
 
 ## Output Policy
 
-Artic writes durable files instead of dumping long design prose into chat:
+Artic 会写入持久文件，而不是把大段设计说明直接倾倒到聊天里：
 
 ```text
 .artic/init-session.json   # draft interview state from @artic init
@@ -194,7 +194,7 @@ python3 -m pip install pytest pyyaml
 python3 -m pytest -q
 ```
 
-CI validates Python scripts, JSON manifests, README translation structure, skill-copy sync, smoke scaffolding, warning-free DESIGN.md lint, and marketplace plugin layout.
+CI 会验证 Python 脚本、JSON 清单、README 翻译结构、skill copy 同步、smoke scaffold、无警告 DESIGN.md lint，以及 marketplace plugin layout。
 
 Distribution note: the wheel is metadata-only; marketplace packages, release tarballs, and sdists carry the skill/plugin payload.
 

README.zh-TW.md

@@ -51,18 +51,18 @@ Agent 會在內部處理使用者訪談、把 brief 正規化為搜索 facets、
 也可以用自然語言請求：
 
 ```text
-在建置这个首页之前，用 Artic 创建 AI-native 设计文件。
+在建置這個首頁之前，用 Artic 建立 AI-native 設計文件。
 ```
 
 ### Codex marketplace
 
-从目前預設分支新增 marketplace：
+從目前預設分支新增 marketplace：
 
 ```bash
 codex plugin marketplace add baskduf/artic
 ```
 
-需要稳定安裝时固定到发布标签：
+需要穩定安裝時固定到發布標籤：
 
 ```bash
 codex plugin marketplace add baskduf/artic@v0.3.0
@@ -117,9 +117,9 @@ Artic 被呼叫後，Agent 會：
 
 1. 當首頁/設計請求很模糊時，先暫停而不是直接實作。
 2. 執行 `@artic init` 收集 product、audience、goal、vibe、constraints 和 references。
-3. Search multiple professional/OSS design resources instead of relying on one style.
-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.
+3. 搜尋多個專業/OSS 設計資源，而不是依賴單一風格。
+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。
 8. 執行 `@artic review`，把實作與 `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` 對比，並驗證生成的設計文件。
@@ -128,10 +128,10 @@ Artic 被呼叫後，Agent 會：
 
 適合用於：
 
-- Homepages, landing pages, product pages, and website redesigns.
-- Projects with weak or missing design docs.
-- AI-native design documentation before coding.
-- Reference-driven design direction without exact brand copying.
+- 首頁、登陸頁、產品頁和網站改版。
+- 設計文件薄弱或缺失的專案。
+- 編碼前的 AI-native 設計文件。
+- 不精確複製品牌的參考驅動設計方向。
 
 不適合用於：
 
@@ -157,7 +157,7 @@ Artic 被呼叫後，Agent 會：
 
 ## Output Policy
 
-Artic writes durable files instead of dumping long design prose into chat:
+Artic 會寫入持久文件，而不是把大段設計說明直接倒進聊天裡：
 
 ```text
 .artic/init-session.json   # draft interview state from @artic init
@@ -194,7 +194,7 @@ python3 -m pip install pytest pyyaml
 python3 -m pytest -q
 ```
 
-CI validates Python scripts, JSON manifests, README translation structure, skill-copy sync, smoke scaffolding, warning-free DESIGN.md lint, and marketplace plugin layout.
+CI 會驗證 Python 腳本、JSON 清單、README 翻譯結構、skill copy 同步、smoke scaffold、無警告 DESIGN.md lint，以及 marketplace plugin layout。
 
 Distribution note: the wheel is metadata-only; marketplace packages, release tarballs, and sdists carry the skill/plugin payload.
 

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

@@ -286,8 +286,8 @@ Use presets only as search/synthesis starting points:
 ## Validation
 
 ```bash
-python3 ~/.hermes/skills/creative/artic/scripts/validate_artic_outputs.py --root <project-root>
-python3 ~/.hermes/skills/creative/artic/scripts/search_reference_catalog.py --query "ai product developer saas premium" --limit 3
+python3 <artic-skill>/scripts/validate_artic_outputs.py --root <project-root>
+python3 <artic-skill>/scripts/search_reference_catalog.py --query "ai product developer saas premium" --limit 3
 ```
 
 Validation, compilation, and rendering scripts enforce and materialize the contract. They are not a design judgment source; `@artic start` must provide that judgment through `.artic/strategy.json`.

plugins/claude-artic/skills/artic/scripts/artic_init_session.py

@@ -67,6 +67,30 @@
 }
 
 _STYLE_HINT_RE = re.compile(r"토스|신뢰|고급|깔끔|스타트업|모바일|saas|premium|trust|clean|mobile|startup", re.IGNORECASE)
+_LABELED_ANSWER_RE = re.compile(
+    r"(?:^|[.;\n]\s*)(project|product|service|audience|target user|target users|goal|conversion goal|vibe|impression|style|stack|tech stack|references?|avoid|accessibility|asset policy)\s*:\s*(.*?)(?=(?:[.;\n]\s*)(?:project|product|service|audience|target user|target users|goal|conversion goal|vibe|impression|style|stack|tech stack|references?|avoid|accessibility|asset policy)\s*:|$)",
+    re.IGNORECASE | re.DOTALL,
+)
+_LABELED_FIELD_MAP = {
+    "project": "project",
+    "product": "project",
+    "service": "project",
+    "audience": "audience",
+    "target user": "audience",
+    "target users": "audience",
+    "goal": "goal",
+    "conversion goal": "goal",
+    "vibe": "vibe",
+    "impression": "vibe",
+    "style": "vibe",
+    "stack": "stack",
+    "tech stack": "stack",
+    "reference": "references",
+    "references": "references",
+    "avoid": "avoid",
+    "accessibility": "accessibility",
+    "asset policy": "asset_policy",
+}
 
 
 def write(path: Path, content: str) -> None:
@@ -97,16 +121,22 @@ def write_session(root: Path, session: dict[str, Any]) -> None:
 
 def extract_answers_from_text(text: str) -> dict[str, str]:
     answers: dict[str, str] = {}
+    for match in _LABELED_ANSWER_RE.finditer(text):
+        raw_key = match.group(1).lower().strip()
+        field = _LABELED_FIELD_MAP.get(raw_key)
+        value = match.group(2).strip(" .;\n\t")
+        if field and value:
+            answers[field] = value
     lowered = text.lower()
     if "ai 회의록" in lowered or "회의록" in text:
-        answers["project"] = "AI 회의록 서비스"
+        answers.setdefault("project", "AI 회의록 서비스")
     if "데모" in text:
-        answers["goal"] = "데모 요청"
+        answers.setdefault("goal", "데모 요청")
     elif "가입" in text:
-        answers["goal"] = "가입"
+        answers.setdefault("goal", "가입")
     elif "문의" in text:
-        answers["goal"] = "문의"
-    if _STYLE_HINT_RE.search(text):
+        answers.setdefault("goal", "문의")
+    if _STYLE_HINT_RE.search(text) and "vibe" not in answers:
         answers["vibe"] = text.strip()
     return answers
 
@@ -206,7 +236,8 @@ def render_ready_summary(session: dict[str, Any]) -> str:
             f"- 목표: {answers.get('goal', '')}",
             f"- 무드: {answers.get('vibe', '')}",
             "",
-            "더 다듬고 싶으면 레퍼런스, 피해야 할 스타일, 브랜드 제약을 추가로 알려주세요.",
+            "더 다듬고 싶으면 레퍼런스, 피해야 할 스타일, 브랜드/에셋 제약을 추가로 알려주세요.",
+            "에셋 사용을 명시적으로 허용하지 않으면 외부 소스는 원칙 참고로만 사용합니다.",
             "문서 생성을 시작하려면 `@artic start`를 실행하세요.",
         ]
     else:
@@ -219,7 +250,8 @@ def render_ready_summary(session: dict[str, Any]) -> str:
             f"- Goal: {answers.get('goal', '')}",
             f"- Vibe: {answers.get('vibe', '')}",
             "",
-            "Add references, avoided styles, or brand constraints if you want to refine the brief.",
+            "Add references, avoided styles, brand constraints, or asset policy if you want to refine the brief.",
+            "If you do not explicitly allow asset usage, external sources stay reference-principles only.",
             "To generate Artic design docs, run `@artic start`.",
         ]
     return "\n".join(lines)

plugins/claude-artic/skills/artic/scripts/artic_show.py

@@ -15,6 +15,7 @@
     "docs/homepage-design-prompt.md",
     ".artic/brief.json",
     ".artic/references.json",
+    ".artic/strategy.json",
 ]
 POLICY_FALLBACK = "Reference policy: extract reusable principles only; do not copy logos, trademarks, proprietary illustrations, or exact layouts."
 POLICY_BY_LOCALE = {