yodogawa 2.1.0 → 2.1.3

package/skills/a-007-define-tech-stack/SKILL.md

@@ -1,102 +1,99 @@
----
-name: a-007-define-tech-stack
-description: 要件とドメインモデルを踏まえて推奨技術スタックを提案し、対話で最終確定する。ドメイン設計完了後、実装技術を選定する際に使用。
-disable-model-invocation: true
-allowed-tools: Read, Write, Edit, Bash, Grep, Glob
----
-
-# DefineTechStack (a-007)
-
-## 目的
-
-- 既存の要件ドキュメント（システム概要、非機能要件、ドメインモデル）を分析し、適合する技術スタックを推奨する。
-- 推奨案を提示した上で、ユーザーと詳細なインタビューを行い、すべての技術選定を明確化する。
-- 技術選定の理由、バージョン、選定タイミング（初期/中期/後期/随時）を明確に記録する。
-
-## 前提
-
-- `docs/project/requirements/` 配下のドキュメントが作成されていること。
-- `docs/project/domain/` 配下のドキュメントが作成されていること。
-- `docs/project/design/` ディレクトリが存在すること（未作成なら `/a-001-setup-doc-structure`）。
-
-## 手順
-
-### 1. ドキュメントと前提条件の確認
-
-```bash
-ls -la docs/project/design/ 2>/dev/null || echo "ディレクトリが存在しません"
-```
-
-要件ドキュメント（`01-system-overview.md`, `03-features-planned.md`, `04-non-functional-requirements.md`）とドメインモデル（`01-domain-model.md`）を読み込む。
-
-### 2. テンプレートの準備
-
-```bash
-SCRIPT_DIR=$(for d in .agent .cursor .claude .codex; do [ -d "$d" ] && echo "$d" && break; done)
-cp "$SCRIPT_DIR/templates/project/04-design/01-tech-stack.md" "docs/project/design/01-tech-stack.md"
-```
-
-### 3. 要件分析と推奨技術スタックの生成
-
-- **システム特性の分析**: アプリケーションタイプ（SPA/SSR 等）、非機能要件、ドメイン複雑度
-- **レイヤー別推奨**: フロントエンド / バックエンド / データベース / インフラ・CI/CD / 監視・テスト
-- **提示形式**: 各技術に「推奨理由」と「代替案」を付ける
-
-提案フォーマットと各層の候補一覧は [examples/stack-interview.md](examples/stack-interview.md#推奨案提示フォーマット) を参照。
-
-### 4. 詳細インタビューと選定
-
-フィードバックを受けてレイヤーごとに詳細確認する。各レイヤーの具体的な質問項目は [examples/stack-interview.md](examples/stack-interview.md#レイヤー別インタビュー項目) を参照。
-
-- フロントエンド: フレームワーク、TypeScript、状態管理、スタイリング
-- バックエンド: 言語、フレームワーク、API スタイル
-- データベース: RDBMS/NoSQL、ORM、マイグレーション
-- インフラ: クラウド、コンテナ、IaC
-- 開発ツール: リンター、テスト、CI/CD
-
-### 5. ドキュメント作成
-
-ヒアリング結果を `docs/project/design/01-tech-stack.md` に記入する。必須項目:
-
-- 技術名、バージョン
-- 選定理由（要件とのマッピング）
-- 選定タイミング（初期/中期/後期/随時）
-
-記入例は [examples/stack-interview.md](examples/stack-interview.md#記入例表形式) を参照。
-
-### 6. 構造チェック
-
-```bash
-grep "### フロントエンド" docs/project/design/01-tech-stack.md \
-  && grep "### バックエンド" docs/project/design/01-tech-stack.md \
-  && echo "OK" || echo "MISSING SECTION"
-```
-
-詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
-
-### 7. Git への追加（任意）
-
-```bash
-git add docs/project/design/01-tech-stack.md
-git commit -m "docs: 技術スタック選定ドキュメントの作成"
-```
-
-詳細は [reference/structure-check.md](reference/structure-check.md#git-への追加任意) を参照。
-
-## 完了条件
-
-- `docs/project/design/01-tech-stack.md` が作成されている。
-- すべてのレイヤーについて技術選定が完了している（または「保留」として記録されている）。
-- 選定理由とバージョンが明確になっている。
-- ユーザーが内容を承認している。
-
-## エスカレーション
-
-- **ユーザーが決められない**: 「要件に基づき、最も標準的でリスクの少ない [技術名] を仮採用とし、実装フェーズで再評価しませんか？」
-- **コスト・学習コストの懸念**: 「初期フェーズは慣れた技術（[技術名]）を採用し、複雑要件が出てから移行検討しましょう。」
-- 詳細応答例は [reference/structure-check.md](reference/structure-check.md#エスカレーション時の推奨応答) を参照。
-
-## 参考
-
-- [examples/stack-interview.md](examples/stack-interview.md) — 推奨案フォーマット、レイヤー別インタビュー項目、選定タイミング区分、記入例
-- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、レビュー質問、Git 追加例
+---
+name: a-007-define-tech-stack
+description: 要件とドメインモデルを踏まえて推奨技術スタックを提案し、対話で最終確定する。ドメイン設計完了後、実装技術を選定する際に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# DefineTechStack (a-007)
+
+## 目的
+
+- 既存の要件ドキュメント（システム概要、非機能要件、ドメインモデル）を分析し、適合する技術スタックを推奨する。
+- 推奨案を提示した上で、ユーザーと詳細なインタビューを行い、すべての技術選定を明確化する。
+- 技術選定の理由、バージョン、選定タイミング（初期/中期/後期/随時）を明確に記録する。
+
+## 前提
+
+- `docs/project/01-requirements/` 配下のドキュメントが作成されていること。
+- `docs/project/03-domain/` 配下のドキュメントが作成されていること。
+- `docs/project/04-design/` ディレクトリが存在すること（未作成なら `/a-001-setup-doc-structure`）。
+
+## 手順
+
+### 1. ドキュメントと前提条件の確認
+
+```bash
+ls -la docs/project/04-design/ 2>/dev/null || echo "ディレクトリが存在しません"
+```
+
+要件ドキュメント（`01-system-overview.md`, `03-features-planned.md`, `04-non-functional-requirements.md`）とドメインモデル（`01-domain-model.md`）を読み込む。
+
+### 2. テンプレートの準備
+
+このスキルの配置ディレクトリ（`skills/a-007-define-tech-stack/`）を起点に、相対パス `../../templates/project/04-design/01-tech-stack.md` を Read で読み込み、その内容を `docs/project/04-design/01-tech-stack.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する（冪等）。出力先ディレクトリ（`docs/project/04-design/`）が無ければ作成する。
+
+### 3. 要件分析と推奨技術スタックの生成
+
+- **システム特性の分析**: アプリケーションタイプ（SPA/SSR 等）、非機能要件、ドメイン複雑度
+- **レイヤー別推奨**: フロントエンド / バックエンド / データベース / インフラ・CI/CD / 監視・テスト
+- **提示形式**: 各技術に「推奨理由」と「代替案」を付ける
+
+提案フォーマットと各層の候補一覧は [examples/stack-interview.md](examples/stack-interview.md#推奨案提示フォーマット) を参照。
+
+### 4. 詳細インタビューと選定
+
+フィードバックを受けてレイヤーごとに詳細確認する。各レイヤーの具体的な質問項目は [examples/stack-interview.md](examples/stack-interview.md#レイヤー別インタビュー項目) を参照。
+
+- フロントエンド: フレームワーク、TypeScript、状態管理、スタイリング
+- バックエンド: 言語、フレームワーク、API スタイル
+- データベース: RDBMS/NoSQL、ORM、マイグレーション
+- インフラ: クラウド、コンテナ、IaC
+- 開発ツール: リンター、テスト、CI/CD
+
+### 5. ドキュメント作成
+
+ヒアリング結果を `docs/project/04-design/01-tech-stack.md` に記入する。必須項目:
+
+- 技術名、バージョン
+- 選定理由（要件とのマッピング）
+- 選定タイミング（初期/中期/後期/随時）
+
+記入例は [examples/stack-interview.md](examples/stack-interview.md#記入例表形式) を参照。
+
+### 6. 構造チェック
+
+```bash
+grep "### フロントエンド" docs/project/04-design/01-tech-stack.md \
+  && grep "### バックエンド" docs/project/04-design/01-tech-stack.md \
+  && echo "OK" || echo "MISSING SECTION"
+```
+
+詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
+
+### 7. Git への追加（任意）
+
+```bash
+git add docs/project/04-design/01-tech-stack.md
+git commit -m "docs: 技術スタック選定ドキュメントの作成"
+```
+
+詳細は [reference/structure-check.md](reference/structure-check.md#git-への追加任意) を参照。
+
+## 完了条件
+
+- `docs/project/04-design/01-tech-stack.md` が作成されている。
+- すべてのレイヤーについて技術選定が完了している（または「保留」として記録されている）。
+- 選定理由とバージョンが明確になっている。
+- ユーザーが内容を承認している。
+
+## エスカレーション
+
+- **ユーザーが決められない**: 「要件に基づき、最も標準的でリスクの少ない [技術名] を仮採用とし、実装フェーズで再評価しませんか？」
+- **コスト・学習コストの懸念**: 「初期フェーズは慣れた技術（[技術名]）を採用し、複雑要件が出てから移行検討しましょう。」
+- 詳細応答例は [reference/structure-check.md](reference/structure-check.md#エスカレーション時の推奨応答) を参照。
+
+## 参考
+
+- [examples/stack-interview.md](examples/stack-interview.md) — 推奨案フォーマット、レイヤー別インタビュー項目、選定タイミング区分、記入例
+- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、レビュー質問、Git 追加例

package/skills/a-007-define-tech-stack/reference/structure-check.md

@@ -6,16 +6,16 @@ SKILL.md 手順6〜7 で使う確認コマンドとレビュー観点。
 
 ```bash
 # フロントエンドセクションの確認
-grep "### フロントエンド" docs/project/design/01-tech-stack.md && echo "OK" || echo "MISSING: Frontend section"
+grep "### フロントエンド" docs/project/04-design/01-tech-stack.md && echo "OK" || echo "MISSING: Frontend section"
 # バックエンドセクションの確認
-grep "### バックエンド" docs/project/design/01-tech-stack.md && echo "OK" || echo "MISSING: Backend section"
+grep "### バックエンド" docs/project/04-design/01-tech-stack.md && echo "OK" || echo "MISSING: Backend section"
 # 技術選定理由の確認（表形式）
-grep "|" docs/project/design/01-tech-stack.md | head -n 5
+grep "|" docs/project/04-design/01-tech-stack.md | head -n 5
 ```
 
 ## チェックリスト
 
-- [ ] `docs/project/design/01-tech-stack.md` が作成されている
+- [ ] `docs/project/04-design/01-tech-stack.md` が作成されている
 - [ ] 主要レイヤー（FE, BE, DB, Infra, 監視/テスト）の技術が選定されている
 - [ ] 各技術にバージョンが記載されている
 - [ ] 選定理由が要件とマッピングされている
@@ -37,7 +37,7 @@ grep "|" docs/project/design/01-tech-stack.md | head -n 5
 ## Git への追加（任意）
 
 ```bash
-git add docs/project/design/01-tech-stack.md
+git add docs/project/04-design/01-tech-stack.md
 git status
 ```
 

package/skills/a-008-define-repository-structure/SKILL.md

@@ -1,99 +1,96 @@
----
-name: a-008-define-repository-structure
-description: 技術スタックに基づきディレクトリ構造・アーキテクチャパターン・命名規則を定義する。技術選定後、コードの配置方針を決める際に使用。
-disable-model-invocation: true
-allowed-tools: Read, Write, Edit, Bash, Grep, Glob
----
-
-# DefineRepositoryStructure (a-008)
-
-## 目的
-
-- 決定された技術スタックに基づいて、最適なリポジトリ構造を定義する。
-- アーキテクチャパターン（レイヤード、機能ベース、クリーンアーキテクチャなど）を選定する。
-- ディレクトリの責務、命名規則、依存関係ルールを明確化する。
-
-## 前提
-
-- `docs/project/design/01-tech-stack.md` が作成されていること（`/a-007-define-tech-stack` 実行済み）。
-- `docs/project/domain/01-domain-model.md` が作成されていること（推奨）。
-- `docs/project/design/` ディレクトリが存在すること。
-
-## 手順
-
-### 1. ドキュメントと前提条件の確認
-
-```bash
-ls -la docs/project/design/01-tech-stack.md 2>/dev/null || echo "ファイルが存在しません"
-```
-
-`01-tech-stack.md` を読み込み、技術スタックを把握する。
-
-### 2. テンプレートの準備
-
-```bash
-SCRIPT_DIR=$(for d in .agent .cursor .claude .codex; do [ -d "$d" ] && echo "$d" && break; done)
-cp "$SCRIPT_DIR/templates/project/04-design/02-repository-structure.md" "docs/project/design/02-repository-structure.md"
-```
-
-### 3. アーキテクチャパターンの提案
-
-技術スタックと要件に基づき、最適なパターンを提案する。選定ガイドは [reference/structure-check.md](reference/structure-check.md#アーキテクチャパターン選定ガイド) を参照。
-
-- レイヤード / 機能ベース / クリーンアーキテクチャ / Atomic Design / FSD
-- 「推奨: [パターン名]」「理由: [技術スタックとの適合性、保守性]」
-
-### 4. ディレクトリ構造の詳細定義
-
-フィードバックを受けて以下を確定する。具体的なツリー例は [examples/structure-templates.md](examples/structure-templates.md#アーキテクチャパターン別の構成例) を参照。
-
-- **ディレクトリ構成**: ソースルート（`src/` vs `app/`）、テスト配置、機能モジュール構成
-- **命名規則**: ファイル名（PascalCase / camelCase / kebab-case）、識別子規則
-- **依存関係ルール**: 上位層から下位層への依存のみ等
-- **コロケーション戦略**: 関連ファイルをまとめるか分離するか
-
-命名規則と依存ルールの具体例は [examples/structure-templates.md](examples/structure-templates.md#命名規則のサンプル) を参照。
-
-### 5. ドキュメント作成
-
-`docs/project/design/02-repository-structure.md` に以下を記入する:
-
-- ディレクトリツリー図（`tree` 形式）
-- 各ディレクトリの役割説明
-- 採用したアーキテクチャパターンと理由
-- 命名規則と依存ルール
-
-### 6. 構造チェック
-
-```bash
-grep "project-root/" docs/project/design/02-repository-structure.md \
-  && grep "## アーキテクチャパターン" docs/project/design/02-repository-structure.md \
-  && grep "## 命名規則" docs/project/design/02-repository-structure.md \
-  && echo "OK" || echo "MISSING SECTION"
-```
-
-詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
-
-### 7. Git への追加（任意）
-
-```bash
-git add docs/project/design/02-repository-structure.md
-git commit -m "docs: リポジトリ構造とアーキテクチャ定義の作成"
-```
-
-## 完了条件
-
-- `docs/project/design/02-repository-structure.md` が作成されている。
-- プロジェクトのディレクトリ構造が明確に定義されている。
-- チーム開発に必要なルール（命名、配置、依存）が文書化されている。
-- ユーザーが内容を承認している。
-
-## エスカレーション
-
-- **技術スタックと構造の不一致**: 「選択されたフレームワーク（[名前]）の標準構成と異なります。標準に従うか、独自構造を採用するか確認しましょう。」
-- **構造が過度に複雑**: 「初期段階では複雑すぎる可能性があります。まずはフラットな構成から始め、必要に応じて分割することを推奨します。」
-
-## 参考
-
-- [examples/structure-templates.md](examples/structure-templates.md) — パターン別ディレクトリツリー例、命名規則、依存関係ルール、コロケーション戦略
-- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、パターン選定ガイド、レビュー質問
+---
+name: a-008-define-repository-structure
+description: 技術スタックに基づきディレクトリ構造・アーキテクチャパターン・命名規則を定義する。技術選定後、コードの配置方針を決める際に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# DefineRepositoryStructure (a-008)
+
+## 目的
+
+- 決定された技術スタックに基づいて、最適なリポジトリ構造を定義する。
+- アーキテクチャパターン（レイヤード、機能ベース、クリーンアーキテクチャなど）を選定する。
+- ディレクトリの責務、命名規則、依存関係ルールを明確化する。
+
+## 前提
+
+- `docs/project/04-design/01-tech-stack.md` が作成されていること（`/a-007-define-tech-stack` 実行済み）。
+- `docs/project/03-domain/01-domain-model.md` が作成されていること（推奨）。
+- `docs/project/04-design/` ディレクトリが存在すること。
+
+## 手順
+
+### 1. ドキュメントと前提条件の確認
+
+```bash
+ls -la docs/project/04-design/01-tech-stack.md 2>/dev/null || echo "ファイルが存在しません"
+```
+
+`01-tech-stack.md` を読み込み、技術スタックを把握する。
+
+### 2. テンプレートの準備
+
+このスキルの配置ディレクトリ（`skills/a-008-define-repository-structure/`）を起点に、相対パス `../../templates/project/04-design/02-repository-structure.md` を Read で読み込み、その内容を `docs/project/04-design/02-repository-structure.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する（冪等）。出力先ディレクトリ（`docs/project/04-design/`）が無ければ作成する。
+
+### 3. アーキテクチャパターンの提案
+
+技術スタックと要件に基づき、最適なパターンを提案する。選定ガイドは [reference/structure-check.md](reference/structure-check.md#アーキテクチャパターン選定ガイド) を参照。
+
+- レイヤード / 機能ベース / クリーンアーキテクチャ / Atomic Design / FSD
+- 「推奨: [パターン名]」「理由: [技術スタックとの適合性、保守性]」
+
+### 4. ディレクトリ構造の詳細定義
+
+フィードバックを受けて以下を確定する。具体的なツリー例は [examples/structure-templates.md](examples/structure-templates.md#アーキテクチャパターン別の構成例) を参照。
+
+- **ディレクトリ構成**: ソースルート（`src/` vs `app/`）、テスト配置、機能モジュール構成
+- **命名規則**: ファイル名（PascalCase / camelCase / kebab-case）、識別子規則
+- **依存関係ルール**: 上位層から下位層への依存のみ等
+- **コロケーション戦略**: 関連ファイルをまとめるか分離するか
+
+命名規則と依存ルールの具体例は [examples/structure-templates.md](examples/structure-templates.md#命名規則のサンプル) を参照。
+
+### 5. ドキュメント作成
+
+`docs/project/04-design/02-repository-structure.md` に以下を記入する:
+
+- ディレクトリツリー図（`tree` 形式）
+- 各ディレクトリの役割説明
+- 採用したアーキテクチャパターンと理由
+- 命名規則と依存ルール
+
+### 6. 構造チェック
+
+```bash
+grep "project-root/" docs/project/04-design/02-repository-structure.md \
+  && grep "## アーキテクチャパターン" docs/project/04-design/02-repository-structure.md \
+  && grep "## 命名規則" docs/project/04-design/02-repository-structure.md \
+  && echo "OK" || echo "MISSING SECTION"
+```
+
+詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
+
+### 7. Git への追加（任意）
+
+```bash
+git add docs/project/04-design/02-repository-structure.md
+git commit -m "docs: リポジトリ構造とアーキテクチャ定義の作成"
+```
+
+## 完了条件
+
+- `docs/project/04-design/02-repository-structure.md` が作成されている。
+- プロジェクトのディレクトリ構造が明確に定義されている。
+- チーム開発に必要なルール（命名、配置、依存）が文書化されている。
+- ユーザーが内容を承認している。
+
+## エスカレーション
+
+- **技術スタックと構造の不一致**: 「選択されたフレームワーク（[名前]）の標準構成と異なります。標準に従うか、独自構造を採用するか確認しましょう。」
+- **構造が過度に複雑**: 「初期段階では複雑すぎる可能性があります。まずはフラットな構成から始め、必要に応じて分割することを推奨します。」
+
+## 参考
+
+- [examples/structure-templates.md](examples/structure-templates.md) — パターン別ディレクトリツリー例、命名規則、依存関係ルール、コロケーション戦略
+- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、パターン選定ガイド、レビュー質問

package/skills/a-008-define-repository-structure/reference/structure-check.md

@@ -6,16 +6,16 @@ SKILL.md 手順6〜7 で使う確認コマンドとレビュー観点。
 
 ```bash
 # ディレクトリ構造図の確認
-grep "project-root/" docs/project/design/02-repository-structure.md && echo "OK" || echo "MISSING: Directory tree"
+grep "project-root/" docs/project/04-design/02-repository-structure.md && echo "OK" || echo "MISSING: Directory tree"
 # アーキテクチャパターンセクションの確認
-grep "## アーキテクチャパターン" docs/project/design/02-repository-structure.md && echo "OK" || echo "MISSING: Architecture section"
+grep "## アーキテクチャパターン" docs/project/04-design/02-repository-structure.md && echo "OK" || echo "MISSING: Architecture section"
 # 命名規則セクションの確認
-grep "## 命名規則" docs/project/design/02-repository-structure.md && echo "OK" || echo "MISSING: Naming convention section"
+grep "## 命名規則" docs/project/04-design/02-repository-structure.md && echo "OK" || echo "MISSING: Naming convention section"
 ```
 
 ## チェックリスト
 
-- [ ] `docs/project/design/02-repository-structure.md` が作成されている
+- [ ] `docs/project/04-design/02-repository-structure.md` が作成されている
 - [ ] ディレクトリツリーが技術スタックと整合している
 - [ ] 各ディレクトリの責務が定義されている
 - [ ] 採用アーキテクチャパターンの理由が記載されている
@@ -41,7 +41,7 @@ grep "## 命名規則" docs/project/design/02-repository-structure.md && echo "O
 ## Git への追加（任意）
 
 ```bash
-git add docs/project/design/02-repository-structure.md
+git add docs/project/04-design/02-repository-structure.md
 git status
 ```