Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
# 基本
- 日本語で応答すること
- 必要に応じて、ユーザに質問を行い、要求を明確にすること
- 作業後、作業内容とユーザが次に取れる行動を説明すること
- 作業項目が多い場合は、段階に区切り、git commit を行いながら進めること
- semantic commit を使用する
- コマンドの出力が確認できない場合、 get last command / check background terminal を使用して確認すること
- ユーザが特定の技術スタックを使用している場合、そのスタックに適したソリューションを提供すること
# Copilot 規範層(全タスク共通で短く強い指示)
- 仕様の入口は `.github/copilot/00-index.md`。参照順に従い、設計→実装の2段階ループを厳守する。
- コード/ドキュメントは **完全実装**で提出し、擬似コード・未完成サンプルは禁止。出力は必要最小限の差分にとどめる。
- **PRタイトルは必ず日本語で記述すること。**(例: `feat: 新しい認証処理の追加` のように、日本語で目的を明示する。)
- コミットメッセージは `.github/instructions/commit-messages.instructions.md` に従い、日本語・`fix:`/`hotfix:`/`feat:` のプレフィックス付きで3行以上の構造を守ること(Copilot 生成分も含む)。
- Secrets・個人情報をコード/ログ/ドキュメントに出さない。ログは構造化し、例外は握り潰さず意味のあるメッセージで扱う。
- 互換性を壊さない方針がデフォルト。破壊的変更が必要なときは移行策を plan に明記する。
- 実装前に `.github/copilot/80-templates/implementation-plan.md` を満たす plan を作成・確認する(設計Issue)。実装Issueでは plan から逸脱しない。
- 型・例外・入力検証・テスト追加を必須とし、`.github/instructions/**/*.instructions.md` の実務ルールを守る。
- Done 定義: lint / typecheck / test / security など CI 品質ゲートが全て緑、受入条件をテストで担保、関連ドキュメントを更新すること。
24 changes: 24 additions & 0 deletions .github/copilot/00-index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# 00 Index — Copilot 仕様の入口(SSOT)

このディレクトリは Copilot / 自動エージェント向けの **仕様の単一情報源(SSOT)** です。必須ルールは `.github/copilot-instructions.md` に集約します。`.github/instructions/**/*.instructions.md` は設計書・背景資料・適用範囲のメタ情報を置く場所であり、GitHub Copilot によって**公式機能として自動的に解釈・適用される実務ルール**です。必ず以下の順で参照してください。

## 参照順(優先度順)
※ 構成定義レイヤはリポジトリ全体の前提となるため最初に参照してください。番号は通常の昇順で付与しています。

1. [構成定義レイヤ](05-structure/monorepo.md) — モノレポ運用ルール
2. [copilot-instructions.md](../copilot-instructions.md) — 規範層(短く強いルール)
3. [.github/instructions/**/*.instructions.md](../instructions) — 補助的な設計/背景資料レイヤ(`applyTo` は適用範囲を示すメタ情報)
4. [10-requirements.md](10-requirements.md) — 要件とスコープ/受入条件
5. [20-architecture.md](20-architecture.md) — 設計方針・責務分担
6. [30-coding-standards.md](30-coding-standards.md) — コーディング規約
7. [40-testing-strategy.md](40-testing-strategy.md) — テスト戦略
8. [50-security.md](50-security.md) — セキュリティ要求
9. [60-ci-quality-gates.md](60-ci-quality-gates.md) — CI 品質ゲート
10. [70-adr/](70-adr/) — 重要判断の履歴
11. [80-templates/](80-templates/) — plan / PR / review のテンプレート
12. [90-research/](90-research/) — RESEARCH フェーズの成果物。DESIGN、IMPLEMENT フェーズのインプット資料でもあります。

## 使い方
- **設計フェーズ (Phase A)**: `80-templates/implementation-plan.md` に沿って plan を作成し、`10-60` の仕様を満たすこと。
- **実装フェーズ (Phase B)**: 確定 plan の範囲内で実装し、`60-ci-quality-gates.md` の品質ゲートを通過させること。
- 仕様変更・追記は本ディレクトリに集約し、重複や分散を避ける。
17 changes: 17 additions & 0 deletions .github/copilot/05-structure/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# 05 Structure — 構成定義レイヤ

このレイヤはリポジトリ構成(モノレポ / ポリレポ)の運用ルールを集約し、`.github/copilot/00-index.md` から選択的に参照できるようにするためのものです。

## 目的

- 構成モードごとのルールを分離し、他リポジトリへの移植時にリンク整合性を保つ。
- CI やテスト実行の前提を構成モードごとに明示し、運用差異を吸収する。

## 切り替え方法

1. 本レイヤ内の対象ファイル(例: `05-structure/monorepo.md` や `05-structure/polyrepo.md`)を選択する。
2. `.github/copilot/00-index.md` の参照順リストにある
`[構成定義レイヤ](05-structure/monorepo.md)` などの Markdown リンクを、利用する構成モードのファイルに差し替える。
3. 切り替え後、必要に応じて CI・テストの設定やドキュメント内リンクを構成モードに合わせて更新する。

初期状態ではモノレポ構成(`monorepo.md`)を参照します。ポリレポ構成(`polyrepo.md`)は将来切り替え用として保持し、未実装状態でも削除しないでください。
Loading