kansu-coding-guidelines

name	kansu-coding-guidelines
description	Kansu 実装時の基本コーディング規約（差分最小、責務尊重、型安全、テスト判断、UI プリミティブのフォーカス/アクティブ）を適用する。実装・リファクタ・レビューで規約確認が必要なときに使う。

Kansu Coding Guidelines

When to use

• 実装・修正・リファクタ時に基本規約を確認したいとき
• 変更差分の方針やテスト追加方針を揃えたいとき
• src/components/ui のフォーカス/アクティブ挙動を合わせたいとき

Core rules

• 複雑な箇所のみコメントで補足し、冗長な説明コメントは避ける。
• 型安全を優先し、any は必要最小限に限定する。

Scope and references

• .cursor 配下の規約参照順は .cursor/rules/kansu-agent-instructions.mdc を起点に辿る。
• 実装規約の正本は .cursor/rules/kansu-agent-conventions.mdc とし、本 Skill では固有のコーディング指針に限定する。

Import / export

• 原則 named export / named import
• フレームワーク都合などで必要な場合のみ default export

UI primitive focus / active

• キーボードフォーカス: focus-visible:* を優先し、クリック時のみの focus リングを避ける。
• ポインタ押下: コンポーネント種別ごとの active:* 方針を揃える。
• 新規プリミティブも同一方針をデフォルトにし、例外は理由を明示する。

クラス指定の詳細（src/components/ui）

インタラクティブなコントロールは次を揃える。

• キーボードフォーカス:
  • outline-none
  • focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50
  • destructive 系は既存どおり ring-destructive 派生
  • focus: 単体の ring は原則使わない
• ポインタ押下（active）:
  • フィールド型（Input / Textarea / SelectTrigger など）は active:border-ring/60 と必要に応じて active:bg-accent/…
  • ボタン型・タブ・バッジ（リンク時）は active:scale-[0.98] と variant ごとの active:bg… / active:opacity…
  • トグル・スイッチは軽い active:scale + active:opacity またはトラック色を一段暗め
• 一貫性: 新規 UI プリミティブも上記をデフォルトにし、例外は理由が明確な場合のみ