@einja/dev-cli 0.1.9 → 0.1.10

package/scaffolds/steering/development/frontend-development.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # フロントエンド開発ガイド
 
 ## 概要
@@ -1535,3 +1536,13 @@ export function PostCreateForm() {
 - バンドルサイズを最小限に抑える
 
 このガイドラインに従うことで、高速で保守性の高いモダンなWebアプリケーションを構築できます。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="frontend-development-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/development/review-guidelines.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # 実装レビューガイドライン
 
 このドキュメントは、task-reviewerエージェントおよび開発者が実装レビューを行う際の観点を定義します。
@@ -363,3 +364,13 @@ task-reviewerエージェントは以下の4観点を**Taskツールで並列に
 - **継続的改善**: 完璧ではなく、システム全体の健全性向上を重視
 - **好みと良し悪しの区別**: 客観的な改善提案と主観的な好みを明確に区別
 - **トレードオフの考慮**: パフォーマンス、可読性、保守性のバランスを考慮
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="review-guidelines-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/development/testing-strategy.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # テスト戦略
 
 ## 概要
@@ -72,6 +73,80 @@ TDD採用が推奨される場合（ビジネスロジック、データ変換
 - **Red-Green-Refactor**: TDDの実施サイクル（どう進めるか）
 - 組み合わせ: 「Red-Green-RefactorサイクルでGiven-When-Then形式のテストを書く」
 
+### テストコードスタイル
+
+テストコードの一貫性と可読性を確保するため、以下のスタイルルールに従ってください。
+
+#### describe構造
+
+```typescript
+describe('対象クラス/関数名', () => {
+  describe('メソッド名', () => {
+    // 正常系テスト
+    it('条件を満たすと、期待する結果になる', () => {})
+  })
+
+  describe('メソッド名 - 異常系', () => {
+    // 異常系テスト
+    it('不正な条件の場合、エラーが発生する', () => {})
+  })
+})
+```
+
+#### describe分類ルール
+
+| レベル | 分類基準 | 例 |
+|--------|---------|-----|
+| 1階層 | 対象クラス/関数名 | `describe('UserRepository', ...)` |
+| 2階層 | メソッド名 or 機能名 | `describe('create', ...)` |
+| 2階層 | 正常系/異常系 | `describe('create - 異常系', ...)` |
+| 3階層 | 着眼点ごと（任意） | `describe('バリデーション', ...)` |
+
+#### it説明文のフォーマット
+
+**必須形式**: 「〜すると、〜になる」（条件 → 結果）
+
+```typescript
+// ✅ 良い例
+it('有効なメールアドレスを渡すと、ユーザーが作成される', () => {})
+it('存在しないIDで検索すると、nullが返る', () => {})
+it('重複したメールアドレスの場合、エラーが返る', () => {})
+
+// ❌ 悪い例
+it('ユーザー作成', () => {})  // 条件・結果が不明
+it('should create user', () => {})  // 英語（日本語プロジェクト）
+it('createが動作する', () => {})  // 結果が曖昧
+```
+
+#### Given-When-Thenコメント
+
+**必須**: テストコード内部は `// Given:` `// When:` `// Then:` コメントで構造化する
+
+```typescript
+it('有効なユーザーデータを渡すと、ユーザーが作成される', async () => {
+  // Given: 有効なユーザーデータ
+  const userData = {
+    email: 'test@example.com',
+    name: 'Test User',
+  }
+
+  // When: createメソッドを呼び出す
+  const result = await userRepository.create(userData)
+
+  // Then: 成功結果が返る
+  expect(result.isSuccess).toBe(true)
+})
+```
+
+#### チェックリスト
+
+新しいテストを書く際の確認事項：
+
+- [ ] describe が適切に階層化されている
+- [ ] it 説明文が「〜すると、〜になる」形式
+- [ ] Given-When-Then コメントで構造化されている
+- [ ] 正常系と異常系が分離されている
+
 ---
 
 ## 2. ユニットテスト
@@ -817,3 +892,13 @@ describe('UserUseCase', () => {
 5. **効率性**: Vitestによる高速なテスト実行
 
 すべてのテストは、このガイドラインに従って実装してください。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="testing-strategy-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/development-workflow.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # 開発ワークフロー
 
 このドキュメントでは、仕様書作成からタスク実行・レビュー・マージまでの開発フロー全体を説明します。
@@ -427,3 +428,13 @@ PRがマージされるとタスクは自動的にDoneになります。
 [後続処理の説明]
 \`\`\`
 ```
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="development-workflow-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/infrastructure/deployment.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # デプロイメント・CI/CD設計方針
 
 ## 概要
@@ -275,3 +276,13 @@ sequenceDiagram
 - [環境変数設計方針](./environment-variables.md)
 - [デプロイセットアップ手順](../../instructions/deployment-setup.md)
 - [環境変数セットアップ手順](../../instructions/environment-setup.md)
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="deployment-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/infrastructure/environment-variables.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # 環境変数設計方針
 
 ## 概要
@@ -296,3 +297,13 @@ dotenvx採用により、GitHub Secretsは**環境ごとに1つの秘密鍵の
 - [デプロイメント・CI/CD設計方針](./deployment.md)
 - [環境変数セットアップ手順](../../instructions/environment-setup.md)
 - [デプロイセットアップ手順](../../instructions/deployment-setup.md)
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="environment-variables-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/product.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # 製品ビジョン
 
 TODO
@@ -538,3 +539,13 @@ describe('UserRepository', () => {
 - ✅ 開発者満足度: **4.5/5以上**
 
 すべての開発活動は、このビジョンと原則に従って実施してください。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="product-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/task-management.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # タスク管理ガイドライン
 
 このドキュメントでは、プロジェクトのタスク管理における階層構造、GitHub Issue管理、用語定義を説明します。
@@ -365,3 +366,13 @@ pnpm task:loop <issue番号> --branch <ブランチ> # ベースブランチ指
 /update-docs-by-task-specs [タスク仕様書ディレクトリパス]
 ```
 - タスク仕様書の内容をfeature仕様書とsteering仕様書に反映
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="task-management-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->