Vibe Coding Guidelines

Purpose

把「不懂程式的使用者」的需求，交付成一個可解壓縮後直接點一下就能啟動的專案：

• Windows：雙擊 run_app.bat（它是 scripts/project_launcher.py 生成/維護的 Windows wrapper，不是另一份可自由發明的新主入口）
• macOS：雙擊 run_app.command（若無法執行，請先 chmod +x run_app.command；若首次被系統阻擋，依提示到「系統設定 > 隱私權與安全性」允許後再執行）
• Linux：雙擊或執行 run_app.sh（若無法執行，請先 chmod +x run_app.sh）

同時提供繁體中文介面、狀態持久化、友善錯誤訊息與 logs；若使用者提供 SVG / mockup / 畫面規格，介面方向必須尊重原規格，不能擅自改風格。若是工作台型 UI，嚴格禁止 stacked UI / stacked cards 疊首頁；必須先定義唯一主任務，並讓該功能盡量佔據最大、最中央、最先被看的畫面區域。任何工作台或流程頁都要把 task model、state model、資訊分類與 visibility plan 寫進規格與 AGENTS.md，不能只留一句「請簡潔」。

Scope

In scope