表示テーマ
AGENTS.md
目的
本リポジトリはサークル「ユメマクラ」のゲーム制作を支援する開発ハンドブックである。知識を保存すること自体ではなく、次の制作で実際に使えることを重視する。
guides/:新規ゲーム立ち上げ、試作、AI開発、テスト、公開などの手順書resources/:素材サイト、ツール、参考資料などのリファレンス
必要になるまでページやディレクトリを増やさない。
共通ルール
- ドキュメント、Issue、PRは原則日本語で記述する。
- 変更は原則PR経由で行い、Draft PRは作成しない。
- 簡潔で読みやすく、実際の作業で使える内容を優先する。
- 記録のための記録はしない。独立した振り返りや判断記録を必須にしない。
- 作品固有の仕様・実装・経緯は原則として各作品のリポジトリに残す。
手順書
- 「いつ使うか」「何を確認するか」「次に何をするか」を明確にする。
- ゲーム開発に唯一の正解があるとは限らない。特定の手法を強制せず、判断基準と選択肢を示す。
- 検証済みの手順と、提案・仮説を区別する。
- 実際に使って困った点は、関連する手順書に反映する。
- 過度なチェックリストや運用負担を増やさない。
リファレンス
- 公式リンク、用途、特徴、利用時の注意点を簡潔に記載する。
- 素材の成人向け・商用利用、クレジット表記などは必要に応じて確認する。
- 規約は変更され得るため、利用時は必ず公式の最新情報を確認する。
- 未確認の情報を推測で埋めない。
根拠と更新
- 事実、考察、仮説、改善案を混同しない。
- 必要に応じて根拠となるIssue、PR、コミット、公式資料へのリンクを残す。
- 既存の内容は実際の経験や新たな根拠に基づいて更新する。
- ユーザーの経験や評価をAIが捏造しない。
- 古い手順が使えなくなった場合は現在の手順に更新し、重要な変更理由を残す。
他プロジェクトとの関係
MechaSico、Nakime、ハカセ、tsukiyo、maなどの経験から、他作品でも役立つ内容を取り込む。
新しい作品の開始時や関連する作業の前に本リポジトリを参照し、使った結果を改善につなげる。ただし、記載された手順は作品固有の事情より優先される絶対的なルールではない。