@k8ordo/ui

AIエージェント

AIのコーディングエージェントに、@k8ordo/uiの正しい使い方を読ませる設定です。設計のガイドとリファレンスはnpmパッケージに同梱され、StorybookはMCPで参照できます。

エージェントの設定

md
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

json
{
  "mcpServers": {
    "k8ordo": {
      "type": "http",
      "url": "https://main--687a213c85e2e4589d8db1bb.chromatic.com/mcp"
    }
  }
}

MCPクライアントの設定に足します。エージェントは、コンポーネントのドキュメントとprops、ストーリーを参照できるようになります。

propsとトークンの生成

props.jsonとコンポーネントのリファレンスのpropsは型から、design.mdのトークンはCSSから生成しています。実装とずれるとCIが失敗するので、ドキュメントだけが古くなることはありません。

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。