Changelog

說明

記錄 AI Playbook 專案的重要變更。

Why

讓人類與 AI Agent 能追蹤專案演進，不需要從 Git diff 或對話紀錄重建上下文。

Do

使用日期記錄重要變更。
說明變更目的。
保持條目簡短、可掃讀。

Don’t

不要記錄無意義的雜訊。
不要把敏感資訊寫入 changelog。
不要用 changelog 取代正式文件。

Checklist

記錄初始化
記錄技術選型
記錄第一版網站實作

Prompt Example

請根據目前 Git diff，產生一段適合放入 AI Playbook Changelog 的繁體中文條目。

2026-07-04

初始化 AI Playbook 專案文件骨架。
補齊 README、AGENTS、Codex 接續備忘與專案駕駛艙。
建立 Brand、Design System、Components、Layouts、Prompt Library、Workflow、Examples、Resources 入口文件。
決定第一版技術選型：Astro + Starlight。
決定部署目標：Cloudflare Pages。

2026-07-05

建立 Astro + Starlight 專案骨架。
將公開 Playbook 文件移到 src/content/docs/，作為 Starlight 的內容來源。
完成 npm run check 與 npm run build 驗證。
確認 Cloudflare Pages 第一版採純靜態部署，不使用 Astro Cloudflare adapter。
補齊 Brand 與 Design System 第一版內容。
建立 public/llms.txt 與 AI 讀取入口文件。
補齊 Components 與 Layouts 第一版內容。
補齊 Prompt Library 與 Workflow 第一版內容。
建立 public/llms-full.txt，作為公開 Playbook 內容的單檔讀取入口。
補齊 Cloudflare Pages Git integration 部署流程，並新增 npm run verify。
設定 GitHub remote 並推送 main branch。
建立 Cloudflare Pages project 並完成 Direct Upload 部署。
設定 Astro site 為 https://ai-playbook-4k0.pages.dev。
完成 live smoke test 與 sitemap 驗證。
建立享哥個人品牌、跨載體設計系統與課程內容產品系統文件。
重新盤點 IDEA Academy 課程網站，納入四階段學習地圖與課程網站資訊架構。
建立 KISS 版 Notion 工具箱講義模板，聚焦工具分類、可複製提示詞、課堂實作區與安全提示。
建立互動式教學網站模板，固化流程 rail、提示詞生成器、工作台、localStorage、匯出、README 與 QA 規則。
建立品牌識別系統，補齊 CIS、Logo、色彩、字體、圖像風格與跨載體視覺規範。
依新增 ref/ 圖片校正品牌識別：補上 IDEA Academy Logo 參考、享哥個人 Logo 概念方向、人物基準圖使用情境與 IDEA 橘色票系統。
建立享哥 Logo 設計簡報，收斂 Route A / B / C，定義主標、輔助 icon、色彩比例、交付檔案與禁用規則。
為品牌識別系統加入人類閱讀用視覺層：色票卡、品牌卡、標注區塊、Do / Don’t 區塊與表格樣式。
將同一套視覺閱讀層套用到享哥 Logo 設計簡報、享哥個人品牌、Notion 講義模板與互動式教學網站模板。
重寫首頁第一屏，新增 AI Agent、Coding Agent 與 Human 三個 CTA，並修正首頁重複 H1。
新增 AI Agent 修改規則頁，定義讀取順序、修改邊界、驗證與回報規則。
將 Prompt Library 拆成可擴充子頁架構，新增 Content Spec、Coding Task、Review、Design Brief 四個 prompt 子頁。
在專案駕駛艙新增「最近決策」區塊。