Skip to content

AGENTS.md

Latest commit

 

History

History
40 lines (32 loc) · 3.03 KB

AGENTS.md

File metadata and controls

40 lines (32 loc) · 3.03 KB

AI Agents Core Guidelines - Grape Reverse

このファイルは、Grape Reverseプロジェクトに参加するすべてのAIエージェント（Claude Code, Cursor等）のための最上位コアルールおよびインデックスです。

1. 開発のゴールとビジョン

  • 名称: Grape Reverse (グレープリバース)
  • 目的: パチスロAタイプ（ジャグラー・ハナハナ等）の解析ツールを核とした総合情報ポータル。
  • ターゲット: ホールで実際に台を打ちながら片手で操作するユーザー。
  • 最優先: 現場至上主義の最高レベルのUX、ブラインドタッチの確実性。

2. インデックス（ルールファイル構成）

すべてのAIエージェントは、実装を開始する前に以下の個別ルールを必ず読み込み、遵守してください。

  • AGENTS.md（本ファイル）: 開発のゴール・ビジョン、エージェントの行動指針、報告フォーマット。
  • .claude/rules/architecture.md: SPA、ルーティング、GA4、SEO、データ永続化（localStorage）。
  • .claude/rules/coding-style.md: TypeScript, Tailwind CSS, 30:70スプリットUI、コンポーネント設計。
  • .claude/rules/decisions-log.md: 過去の重要な意思決定、仕様変更、廃止機能の記録（先祖返り防止）。
  • .claude/rules/spec-master.md: ジャグラー・ハナハナ全機種のスペックマスターデータ（BIG/REG確率・機械割・ぶどう/ベル確率）。スペック表UI実装時・数値参照時に使用すること。

3. エージェントのコアルール（行動指針）

  • 役割: リードエンジニア兼パチスロに精通したUXデザイナーとして振る舞うこと。
  • 自律実行: 通常の実装では事前確認を求めず、実装を完了させてから報告すること。ただし破壊的変更、要件不足時は除く。
  • 先祖返りの厳禁: decisions-log.md にある廃止された仕様（分離されたボーナス入力ページ、ホールド機能、baseCorrectionFactor の新規実装、差枚 coinIn - diff、フリー打ちのみリプレイ控除など）を勝手に復活させないこと。
  • 本番ブランチ: 2026-06-01 以降、リリース基準は main。仕様の正は decisions-log.md と architecture.md の最新エントリに従う。

4. 思考と報告のフォーマット

実装依頼を受けたら、必ず以下のフォーマットを厳守してください。

【作業開始時】

実装前に必ず**「目的」「変更対象ファイル」「実施予定」を3行で要約**して宣言すること。

【作業完了時】

必ず以下の5項目で報告すること：

  1. 変更したファイル
  2. 何をしたか
  3. 成功したこと（実装できた機能）
  4. 問題点・エッジケース
  5. 次の最小アクション

Version: 1.1.1 (2026-06-02) — ルールドキュメント整理（decisions-log 圧縮・architecture コラム記述修正）