@einja/dev-cli 0.1.9 → 0.1.11

package/scaffolds/steering/commit-rules.md

@@ -1,6 +1,7 @@
+<!-- @einja:managed:start -->
 # コミットルール
 
-## 重要：コミット分割ルールの厳守について
+## 重要:コミット分割ルールの厳守について
 
 - コミット分割ルールに違反した場合、重大なレビュープロセス阻害・履歴管理上の問題となるため、**絶対に違反しないこと**
 - 万一違反が発生した場合は、必ず即座に報告し、再発防止策（作業前の分割計画明示・コミット粒度の事前確認など）を徹底すること
@@ -215,3 +216,13 @@ git push
 ## まとめ
 
 コミットルールの遵守は、プロジェクトの履歴管理とレビュープロセスの効率化に直結します。全ての開発者・AIアシスタントは、これらのルールを例外なく厳守してください。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="commit-rules-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/db-schema-design.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # スキーマ設計
 
 TODO
@@ -607,3 +608,13 @@ pnpm db:seed
 5. **スケーラビリティ**: PostgreSQLとPrismaの組み合わせによる高いスケーラビリティ
 
 すべてのスキーマ変更は、このガイドラインに従って実装してください。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="db-schema-design-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

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

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # API開発ガイド
 
 ## 概要
@@ -41,8 +42,8 @@ apps/admin/app/api/[[...route]]/route.ts # Admin API
 
 **ルート定義の配置**:
 ```
-apps/web/server/routes/          # Webアプリ用ルート定義
-apps/admin/server/routes/        # 管理画面用ルート定義
+apps/web/server/presentation/routes/   # Webアプリ用ルート定義（Presentation層）
+apps/admin/server/presentation/routes/ # 管理画面用ルート定義（Presentation層）
 ```
 
 ### メソッドチェーンパターン
@@ -102,7 +103,7 @@ apiClient.posts.$get()      // ❌ NG（型エラー）
 **使用例**:
 
 ```typescript
-// apps/web/server/routes/postRoutes.ts
+// apps/web/server/presentation/routes/postRoutes.ts
 import { Hono } from 'hono'
 import { zValidator } from '@hono/zod-validator'
 import { createPostSchema } from '@repo/server-core/domain/validators/post'
@@ -701,7 +702,7 @@ Worktreeごとに異なるポートを使用するため、MD5ハッシュベー
 **ルート定義**:
 
 ```typescript
-// apps/web/server/routes/postRoutes.ts
+// apps/web/server/presentation/routes/postRoutes.ts
 import { Hono } from 'hono'
 import { zValidator } from '@hono/zod-validator'
 import { createPostSchema } from '@repo/server-core/domain/validators/post'
@@ -781,3 +782,13 @@ export type AppType = typeof app
 4. **柔軟性**: Server ActionsとHono Client + Tanstack Queryの使い分け
 
 すべてのAPI実装は、このガイドラインに従って実装してください。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="api-development-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

package/scaffolds/steering/development/backend-architecture.md

@@ -1,3 +1,4 @@
+<!-- @einja:managed:start -->
 # バックエンドアーキテクチャ
 
 ## タスク: Turborepo Next.js モノレポ構築 (20251104)
@@ -729,3 +730,13 @@ if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma
 ✅ **index.ts不使用**: シンプルで拡張しやすいモジュール管理
 
 すべての開発者は、この設計原則に従ってバックエンド開発を行ってください。
+<!-- @einja:managed:end -->
+
+---
+
+<!-- @einja:seed:start id="backend-architecture-project" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:seed:end -->

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 -->