القائمة
README.mdとblueprint.mdの役割分担と更新義務を定義するドキュメント管理ポリシー。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | documentation_policy |
| description | README.mdとblueprint.mdの役割分担と更新義務を定義するドキュメント管理ポリシー。 |
README.md と blueprint.md は、あらゆる機能追加・変更・リファクタリング時に必ず両方を更新する。 片方だけの更新は禁止。
主な読者: プロジェクトオーナー（ユーザー）、外部の開発者、コントリビューター
記載すべき内容:
.env.local の設定、npm install 等）記載スタイル:
主な読者: AIエージェント（新規セッション含む）、開発チーム内部
記載すべき内容:
.agents/skills/ 配下のスキル一覧と概要記載スタイル:
| イベント | README | blueprint |
|---|---|---|
| 新機能の追加 | ✅ 機能仕様を追記 | ✅ 設計意図と実装詳細を追記 |
| 既存機能の変更 | ✅ 変更された仕様を反映 | ✅ 変更理由と影響範囲を記録 |
| リファクタリング | ✅ アーキテクチャ変更があれば反映 | ✅ 構造変更の詳細を記録 |
| 規約・プロセス変更 | ✅ 開発手順に影響あれば反映 | ✅ スキル一覧・ルール変更を反映 |
| バグ修正 | − 通常は不要 | ✅ 既知の制約に影響あれば更新 |
README.md と blueprint.md の更新漏れがないかセルフチェックするwalkthrough.md に「README/blueprintの更新有無」を必ず記載するAI開発チームの役割定義。各エージェントの責務・行動指針・実行ステップを規定する。
AI同士のバトンタッチ（タスク委譲）とチェック体制。セッション開始時のPR確認から終了時のIssue作成までのルールを定義する。
バグ修正時のリグレッションテスト作成義務と、グローバル状態共有の禁止ルール。
コーディング規約。ESLint/TypeScript/React/Next.jsの品質基準と、AIエージェントがコミット前に守るべきルールを定義する。
Defines the standard format and rules for git commit messages in this project.
ロジックの変更とUIの変更に対するテスト戦略と基準を定義する。