コントリビューションに興味をお持ちいただきありがとうございます！
- GitHub Issues を使用してください
- 影響を受けるガイドラインファイルとルールを明記してください
- リポジトリをフォーク
- フィーチャーブランチを作成
- 変更を実施
- 説明的なコミットメッセージでコミット
- Pull Request を作成
| ディレクトリ | 求めている内容 | ガイドライン |
|---|---|---|
01_philosophy/ |
サンプルコンテンツの改善 | 母国語で書き直してください。抽象的に保ち、ツール/フレームワーク名は含めないでください |
02_decision-criteria/ |
新しい判断軸、改善された閾値 | 母国語で書き直してください。フレームワーク固有の詳細は含めないでください |
03_guidelines/common/ |
ルールの改善、新しい Before/After 例、新しいルール | クロスリポジトリ同期が必要 — 変更は ai-dev-os-rules-typescript にもコピーする必要があります。下記参照 |
03_guidelines/frameworks/ |
フレームワーク固有のパターン、新しいフレームワークのサポート | 責務分離に従ってください: common/ = 「何をすべきか」、frameworks/ = 「どう実装するか」 |
templates/ |
テンプレートの改善、新しいフレームワークテンプレート | 新規プロジェクト向けのみ。既存プロジェクトには自動適用しないでください |
03_guidelines/common/ ディレクトリは rules リポジトリ間で共有されています。ファイルを更新する際は:
- まずこのリポジトリで変更を行う
- 更新したファイルを
ai-dev-os-rules-typescriptにコピー - 各リポジトリで同じメッセージでコミット
- 例外:
code.mdは言語固有の例を含む場合があります — ルールは同期し、例は調整してください
差分の簡易チェック:
diff -rq 03_guidelines/common/ ../ai-dev-os-rules-typescript/03_guidelines/common/03_guidelines/frameworks/{name}/overview.mdとproject-structure.mdを作成common/との重複なし — フレームワーク固有のパターンのみtemplates/{name}/に CLAUDE.md.template を作成- README.md のディレクトリ構造を更新
- MINOR バージョン以上としてリリース
| 変更種別 | バージョン |
|---|---|
| Philosophy/decision-criteria の変更 | MAJOR |
| 新しいガイドライン、フレームワークの追加 | MINOR |
| 誤字修正、例の改善 | PATCH |
- 翻訳は
docs/i18n/{lang}/に配置 - 対応言語:
ja,zh-CN,ko,es 03_guidelines/のガイドラインは英語で記述（AI 互換性のため）01_philosophy/と02_decision-criteria/は任意の言語で記述可能
敬意を持ち、建設的で、包括的であること。