Cursor / Claude Code / Codex / AIツール関連

.cursor/rules/

Cursor がプロジェクト固有の AI 指示を読むディレクトリ。配下の .mdc が個別ルール。

.mdc ファイル

Cursor ルールの拡張子。[frontmatter](#frontmatter) 付き Markdown。

frontmatter

ファイル先頭の YAML メタデータ。Cursor では description / alwaysApply / globs を指定。

例:

---
description: コーディング規約
alwaysApply: true
---

# 本文ここから

alwaysApply

[frontmatter](#frontmatter) のブール値。true なら毎ターンコンテキストに載る。

• true: 常に適用。ドメイン制約など必須事項向け
• 省略 / false: [globs](#globs) 合致時または @rule-name 時のみ
• 注意: 多用するとコスト・性能に効く。本当に必須だけ true に

globs

ルールを適用するファイルパターン。合致ファイル編集時だけコンテキストに含まれる。

• globs: **/*.py → Python 編集時のみ
• globs: tests/** → tests 配下編集時のみ

共有・Claude 系

AGENTS.md

AI エージェント向け指示書。Codex は作業ディレクトリに近い AGENTS.md を優先（Phase 1 Codex）。

CLAUDE.md

Claude Code がセッション開始時に読むファイル。リポジトリ直下は全体方針、サブディレクトリはローカル規約（セットアップ 12 項）。

.claude/skills/

Claude Code の反復手順置き場。長い運用は Skill に分離し CLAUDE.md は短く保つ。

Hooks（Claude Code）

特定イベント後にコマンドを強制実行。lint や危険コマンド検査向け。

Codex 系

.agents/skills/（Codex）

Codex の共有 Skill 置き場。各 Skill は SKILL.md（name / description）と任意の scripts/。

.codex/config.toml（Codex）

Codex のプロジェクト上書き設定。trusted プロジェクトのみ読み込む。

---