# AI Playbook

> 給人類與 AI Agent 共同閱讀的 AI 工作手冊網站。

AI Playbook 是 AI 專案開工前的規範入口。它不是 Blog、官方網站或作品集，而是 AI 與人共同工作的知識中心。

## Source of truth

- Local repository PRD: PRD.md
- Project dashboard: /docs/project-dashboard/
- Agent modification rules: /docs/agent-rules/
- Brand: /brand/
- Xiang personal brand: /brand/xiang-personal-brand/
- Design System: /design/
- Cross-surface design system: /design/cross-surface-design-system/
- Components: /components/
- Layouts: /layouts/
- Prompt Library: /prompts/
- Content Spec Prompt: /prompts/content-spec/
- Coding Task Prompt: /prompts/coding-task/
- Review Prompt: /prompts/review/
- Design Brief Prompt: /prompts/design-brief/
- Workflow: /workflow/
- Examples: /examples/
- Resources: /resources/
- Course content ecosystem: /resources/course-content-ecosystem/
- Antigravity teacher five skills: /resources/antigravity-teacher-five-skills/
- Changelog: /docs/changelog/
- Cloudflare Pages deploy notes: /docs/deploy-cloudflare-pages/
- AI entrypoints: /docs/ai-entrypoints/
- Full context: /llms-full.txt

## Working rules

- Read local PRD and project dashboard before changing the project.
- Read /docs/agent-rules/ before making structural, content, UI, or deployment changes.
- Use /llms-full.txt when a task needs a single-file public context snapshot.
- Keep content in Markdown or MDX.
- Preserve the seven-section document format: 標題, 說明, Why, Do, Don't, Checklist, Prompt Example.
- Prioritize maintainability, searchability, and AI readability.
- Do not turn this project into a marketing site, blog, portfolio, or over-designed interface.
- Prefer Starlight defaults and Markdown/MDX before adding custom UI components.
- Follow the universal workflow: Read, Scope, Plan, Execute, Verify, Record, Commit.
- First version uses Astro + Starlight and deploys to Cloudflare Pages as a static site.

## Build

- Install: npm install
- Check: npm run check
- Build: npm run build
- Dev: npm run dev
- Cloudflare Pages build command: npm run build
- Cloudflare Pages output directory: dist