專案駕駛艙
- 專案名稱：AI Playbook
- 目前階段：Astro + Starlight 文件網站骨架已建立並通過本機驗證
- Source of truth：
PRD.md - 網站框架：Astro + Starlight
- 部署目標：Cloudflare Pages
- Production URL：
https://ai-playbook-4k0.pages.dev - Git 狀態：已推送到 GitHub，
main追蹤origin/main
建立一個給人類與 AI Agent 共同閱讀的 AI 工作手冊網站，作為 AI 專案開工前的規範入口。
- 建立基礎資料夾。
- 補齊
README.md。 - 補齊
AGENTS.md。 - 補齊
.gitignore。 - 建立第一版章節
index.md。 - 建立 Codex 接續備忘。
- 決定第一版技術選型：Astro + Starlight。
- 決定部署目標：Cloudflare Pages。
- 建立 Astro + Starlight 專案骨架。
- 將公開 Playbook 文件移到
src/content/docs/。 - 完成
npm run check，結果為 0 errors、0 warnings、0 hints。 - 完成
npm run build，產生 21 個靜態頁面與 Pagefind 搜尋索引。 - 完成本機 smoke test：首頁、Brand、專案駕駛艙為 200，未知頁為 404。
- 補齊 Brand 第一版內容。
- 補齊 Design System 第一版內容。
- 建立
public/llms.txt。 - 建立 AI 讀取入口文件。
- 補齊 Components 第一版內容。
- 補齊 Layouts 第一版內容。
- 完成 Starlight 導覽 smoke test：Components、Layouts 頁面為 200。
- 完成 Pagefind preview smoke test：
/pagefind/pagefind.js與/pagefind/pagefind-entry.json為 200。 - 補齊 Prompt Library 第一版內容。
- 補齊 Workflow 第一版內容。
- 建立
public/llms-full.txt，提供公開 Playbook 內容的單檔讀取入口。 - 補齊 Cloudflare Pages 部署流程文件。
- 新增
npm run verify，用於部署前執行check與build。 - 設定 GitHub remote：
https://github.com/chengyunm1313/ai-playbook.git。 - 推送
mainbranch 到 GitHub。 - 建立 Cloudflare Pages project：
ai-playbook。 - 完成 Cloudflare Pages Direct Upload 部署。
- Production URL：
https://ai-playbook-4k0.pages.dev。 - 完成 live smoke test：首頁、專案駕駛艙、
llms.txt、llms-full.txt、sitemap-index.xml皆為 200。 - 建立享哥個人品牌文件。
- 建立跨載體設計系統文件。
- 建立課程內容產品系統文件。
- 重新盤點
course.es2idea.com，納入 IDEA Academy 定位與四階段學習地圖。 - 建立 Notion 講義模板文件。
- 建立互動式教學網站模板文件。
- 建立品牌識別系統文件，補齊 CIS、Logo、色彩、字體與圖像規範。
- 依新增
ref/圖片校正 CIS：補上 IDEA Academy Logo 參考、享哥個人 Logo 概念方向與人物基準圖使用情境。 - 建立享哥 Logo 設計簡報，定義 Route A / B / C、優先方向、交付格式與禁用規則。
- 為品牌識別系統加入人類閱讀用視覺層：色票卡、品牌卡、標注區塊、Do / Don’t 區塊與表格樣式。
- 將視覺閱讀層套用到享哥 Logo 設計簡報、享哥個人品牌、Notion 講義模板與互動式教學網站模板。
- 重寫首頁第一屏，建立 AI Agent、Coding Agent 與 Human 三個入口。
- 新增 AI Agent 修改規則頁。
- 將 Prompt Library 拆成可擴充子頁架構。
| Date | Decision | Reason |
|---|---|---|
| 2026-07-05 | 首頁第一屏改成任務入口，而不是一般文件開場。 | 讓人類與 AI Agent 立刻知道本站用途與下一步。 |
| 2026-07-05 | 新增 /docs/agent-rules/ 作為 Agent 修改規則。 |
將修改前讀取順序、文件邊界、驗證與回報規則集中管理。 |
| 2026-07-05 | Prompt Library 採一頁一任務的子頁架構。 | 避免首頁過長，讓 Agent 能精準引用高頻 prompt。 |
| 2026-07-05 | 維持 Astro + Starlight，不改技術架構。 | 符合 PRD 的文件優先、Markdown/MDX、靜態部署與低維護成本。 |
| 2026-07-05 | 文件可加入人類閱讀用視覺層，但必須保留 AI 可讀規格。 | 同時服務人類掃讀與 Agent 精確讀取。 |
- 持續維護 Changelog。
- 視需求在 Cloudflare Pages 連接 Git repository，改用 Git integration 自動部署。
- 目前不能先追求華麗介面，否則會偏離 PRD 的文件優先原則。
- 內容必須保持 Markdown 或 MDX 來源，避免與程式碼耦合。
- 每份正式文件要維持七區塊格式，否則 AI Agent 讀取規範時會不穩定。
- 第一版採用 Astro + Starlight，因為它符合文件優先、Markdown/MDX、靜態部署、內建搜尋與低維護成本。
- 部署採 Cloudflare Pages，因為它適合靜態文件網站，能與後續 Cloudflare 生態整合。
- 目前是純靜態文件站，不使用 Astro Cloudflare adapter；Cloudflare Pages 設定使用
npm run build與dist即可。 site使用 Cloudflare Pages production URL：https://ai-playbook-4k0.pages.dev。- GitHub remote 已設定，可進行 Cloudflare Pages Git integration。
- 本次部署使用 Direct Upload；若後續要自動部署，需再到 Cloudflare Pages 連接 GitHub repository。
- 享哥個人品牌應作為 AI Playbook 的方法論來源，而不是把本站改成個人形象官網。
- Blog、Course、Notion 講義、PDF 講義、互動式教學網站與 AI Playbook 應共用同一套內容模組。
- CIS 層級以品牌識別系統為準；跨載體設計系統負責資訊架構與內容模組。
- IDEA Academy 使用燈泡與 IDEA 橘作為課程品牌識別；享哥個人品牌應使用
享字變形、系統節點或對話提示作為不同主符號。 - 享哥 Logo 優先收斂為 Route C 文字標系統搭配 Route A 簡化
享字節點 icon；Route B 作為 Prompt / 教學情境輔助圖標。 - 文件網站可以加入輔助閱讀的視覺層，但必須保留 Markdown 表格、規則、Checklist 與 Prompt Example，避免犧牲 AI 可讀性。
- 高頻文件的視覺增強應使用共用 CSS class，不在各頁建立互相不一致的局部樣式。
- 首頁、Agent rules 與 Prompt Library 是 AI Agent 開工入口，後續新增流程需優先同步這三處。
- Prompt Library 子頁採一頁一任務，避免把所有 prompt 堆在 index 頁。
- 繼續拆分 Workflow、Components、Layouts 的高頻子頁。
- 視需求在 Cloudflare Pages 連接 GitHub repository，改用 Git integration。