專案結構

my-project/
├── docs/                          筆記資料夾，view／serve／build 的參數
│   ├── hello.md                   筆記，.md 與 .mdx 都可以
│   ├── guides/
│   │   └── oauth-flow.mdx         子資料夾對到網址 /notes/guides/oauth-flow
│   └── api/
│       └── orders.openapi.json    資料檔，交給 Plugin 渲染成 /view/api/orders.openapi
├── .notecraft/
│   ├── components/
│   │   ├── request-flow.tsx       @ai-visualize 生成的元件，一個標記一個檔
│   │   └── oauth-flow.deck.tsx    筆記轉成的簡報
│   ├── plugins/
│   │   ├── _types.d.ts            install-plugin 產生的型別宣告，給渲染器用
│   │   └── openapi-renderer/      一個 Plugin 一個資料夾
│   │       ├── notecraft-plugin.json   Plugin 的身分：id、名稱、版本
│   │       ├── renderer.tsx       渲染器入口
│   │       ├── schema.json        資料檔要符合的 JSON Schema
│   │       └── …                  Plugin 自帶的其他模組與範例
│   ├── ignore.json                不想讓 NoteCraftApp 讀的檔案與資料夾
│   ├── plugins.json               哪些資料檔交給哪個 Plugin
│   └── series.json                系列：多篇筆記的閱讀順序
└── .claude/
    ├── skills/
    │   ├── content-visualize/     處理 @ai-visualize 標記
    │   ├── content-present/       筆記轉簡報
    │   └── trendlink-design/      前兩者共用的設計系統
    └── agents/                    6 個 Subagent 設定（.md）