Skip to content

AGENTS.md ​

目的 ​

本リポジトリはサークル「ユメマクラ」のゲーム制作を支援する開発ハンドブックである。知識を保存すること自体ではなく、次の制作で実際に使えることを重視する。

  • guides/:新規ゲーム立ち上げ、試作、AI開発、テスト、公開などの手順書
  • resources/:素材サイト、ツール、参考資料などのリファレンス

必要になるまでページやディレクトリを増やさない。

共通ルール ​

  • ドキュメント、Issue、PRは原則日本語で記述する。
  • 変更は原則PR経由で行い、Draft PRは作成しない。
  • 簡潔で読みやすく、実際の作業で使える内容を優先する。
  • 記録のための記録はしない。独立した振り返りや判断記録を必須にしない。
  • 作品固有の仕様・実装・経緯は原則として各作品のリポジトリに残す。

手順書 ​

  • 「いつ使うか」「何を確認するか」「次に何をするか」を明確にする。
  • ゲーム開発に唯一の正解があるとは限らない。特定の手法を強制せず、判断基準と選択肢を示す。
  • 検証済みの手順と、提案・仮説を区別する。
  • 実際に使って困った点は、関連する手順書に反映する。
  • 過度なチェックリストや運用負担を増やさない。

リファレンス ​

  • 公式リンク、用途、特徴、利用時の注意点を簡潔に記載する。
  • 素材の成人向け・商用利用、クレジット表記などは必要に応じて確認する。
  • 規約は変更され得るため、利用時は必ず公式の最新情報を確認する。
  • 未確認の情報を推測で埋めない。

根拠と更新 ​

  • 事実、考察、仮説、改善案を混同しない。
  • 必要に応じて根拠となるIssue、PR、コミット、公式資料へのリンクを残す。
  • 既存の内容は実際の経験や新たな根拠に基づいて更新する。
  • ユーザーの経験や評価をAIが捏造しない。
  • 古い手順が使えなくなった場合は現在の手順に更新し、重要な変更理由を残す。

他プロジェクトとの関係 ​

MechaSico、Nakime、ハカセ、tsukiyo、maなどの経験から、他作品でも役立つ内容を取り込む。

新しい作品の開始時や関連する作業の前に本リポジトリを参照し、使った結果を改善につなげる。ただし、記載された手順は作品固有の事情より優先される絶対的なルールではない。