surfup

CursorとClaude Codeのプロジェクトルール12選

リポジトリのコンテキスト、SEO、安全性、検証可能な変更に関する12の実践ルール。

以下のルールを作業用チェックリストとして使い、プロジェクトで確認できた根拠、対象範囲、制約に合わせて調整してください。

背景と対象範囲

  • このツールに適用されるプロジェクト指示(例:.cursor/rules や CLAUDE.md)があれば読み、README と manifest も確認します。
  • 編集を始める前に現状の構成を要約し、この変更に必要なファイルだけを挙げます。
  • 検証できる成果を1つ定義し、理由がない限り作業範囲を広げません。
  • APIを変更する前に、利用者、リクエスト/レスポンス形式、互換性要件を確認します。

品質と安全性

  • ユーザー入力ごとに、形式、長さ、安全でない値の検証方法を明確に定めます。
  • 秘密情報をコード、ログ、テストデータ、サンプル、フロントエンドから配信される資産に含めません。
  • 検索ページでは title、description、canonical、robots、見出し、リンク、初期HTMLを確認します。
  • 各言語でその言語に合った文面と連絡先の例を使い、URL同士が対応していることを確認します。
  • 操作要素をキーボードで使えるようにし、支援技術が識別できる名前と明確なフォーカス表示を付けます。

検証と報告

  • 今回の変更の動作を確認できるチェックだけを実行し、実行していないコマンドの結果を報告しません。
  • 受け入れ条件と照らして結果を確認し、エラー経路とモバイル表示も調べます。
  • 変更点、実際に実行したコマンドと結果、既知の制約、元に戻す方法を報告します。