AIエージェント
AIのコーディングエージェントに、@k8ordo/uiの正しい使い方を読ませる設定です。設計のガイドとリファレンスはnpmパッケージに同梱され、StorybookはMCPで参照できます。
エージェントの設定
コードをコピー
Use `@k8ordo/ui` for UI. Before writing or changing UI, read
`node_modules/@k8ordo/ui/docs/GUIDE.md`, then follow only the
`docs/references/*.md` links it lists that the task actually needs.
Colors, spacing, radii and font weights go through semantic tokens —
never raw values such as `bg-teal-500` or `font-semibold`.
Look up component props in `docs/references/components.md` (the AI chat
components in `docs/references/ai-chat.md`, the generative UI adapters in
`docs/references/generative-ui.md`) instead of recalling them;
a component that is listed in none of them does not exist.プロジェクトのCLAUDE.mdかAGENTS.mdにこの文を貼ります。ドキュメントはnpmパッケージに入っているので、エージェントはインストールしたバージョンのものを読みます。記憶に頼って存在しないpropsや古い書き方を書くのを防ぐための設定です。
読めるドキュメント
docs/GUIDE.md- 最初に読む設計のガイドです
docs/references/*.md- コンポーネント、型、デザインの規則のリファレンスです
docs/llms.txt- LLM向けのドキュメントの索引です
design.md- デザイントークンの仕様です
@k8ordo/ui/props.json- すべてのコンポーネントのpropsをJSONにしたものです
https://main--687a213c85e2e4589d8db1bb.chromatic.com/mcp- 公開しているStorybookのMCPエンドポイントです
GUIDE.mdとリファレンスは、node_modulesの中とこのサイトの両方にあります。design.mdはこのサイトだけに、props.jsonはパッケージの中だけにあります。パッケージのdocs/llms.txtは@k8ordo/uiの索引で、サイトの/llms.txtはすべてのパッケージの索引です。
StorybookのMCP
コードをコピー
{
"mcpServers": {
"k8ordo": {
"type": "http",
"url": "https://main--687a213c85e2e4589d8db1bb.chromatic.com/mcp"
}
}
}MCPクライアントの設定に足します。エージェントは、コンポーネントのドキュメントとprops、ストーリーを参照できるようになります。
propsとトークンの生成
props.jsonとコンポーネントのリファレンスのpropsは型から、design.mdのトークンはCSSから生成しています。実装とずれるとCIが失敗するので、ドキュメントだけが古くなることはありません。