diff --git a/.claude/agents-en/acceptance-test-generator.md b/.claude/agents-en/acceptance-test-generator.md index cf2384a..507c782 100644 --- a/.claude/agents-en/acceptance-test-generator.md +++ b/.claude/agents-en/acceptance-test-generator.md @@ -281,6 +281,12 @@ Response in the following format upon execution completion: - **Post-execution**: Complete AC→test case correspondence, dependency validity - **Output requirements**: Integration tests and E2E tests MUST be generated in separate files +## LLM Generation Test Design Notice + +**Exclude from testing**: +- Output reproducibility (LLM outputs vary normally) +- Long-term operations (infrastructure responsibility) + ## Exception Handling and Escalation ### Auto-processable diff --git a/.claude/agents-ja/acceptance-test-generator.md b/.claude/agents-ja/acceptance-test-generator.md index e9186a0..5c05ba6 100644 --- a/.claude/agents-ja/acceptance-test-generator.md +++ b/.claude/agents-ja/acceptance-test-generator.md @@ -280,6 +280,12 @@ describe('会話ログ永続化 E2Eテスト', () => { - **実行中**: 解釈一貫性、論理整合性の維持、テスト種別の適切な分離 - **実行後**: AC→テストケース完全対応、依存関係妥当性、統合/E2E分離確認 +## LLM生成機能のテスト設計注意 + +**テスト対象外**: +- 出力の再現性(LLMは毎回異なる結果が正常) +- 長時間運用(インフラ層の責務) + ## 例外処理・エスカレーション ### 自動処理可能 diff --git a/docs/rules-en/architecture/implementation-approach.md b/docs/rules-en/architecture/implementation-approach.md index f4e2f82..16457ed 100644 --- a/docs/rules-en/architecture/implementation-approach.md +++ b/docs/rules-en/architecture/implementation-approach.md @@ -139,7 +139,6 @@ Resource Constraints: Business Constraints: - Market launch timing requirements - - Operational continuity necessity - Customer impact minimization requirements - Regulatory/industry standard compliance ``` diff --git a/docs/rules-en/rules-index.yaml b/docs/rules-en/rules-index.yaml index 4093a74..65ade00 100644 --- a/docs/rules-en/rules-index.yaml +++ b/docs/rules-en/rules-index.yaml @@ -45,6 +45,7 @@ rules: - "Test Implementation Conventions" - "Test Granularity Principles" - "Mock Type Safety Enforcement" + - "Continuity Test Scope" - "Basic Vitest Example" ai-development-guide: @@ -81,6 +82,7 @@ rules: - "Basic Technology Stack Policy" - "Environment Variable Management and Security" - "Architecture Design" + - "Architecture Patterns" - "Unified Data Flow Principles" - "Build and Testing" diff --git a/docs/rules-en/technical-spec.md b/docs/rules-en/technical-spec.md index 2d95373..fdd901a 100644 --- a/docs/rules-en/technical-spec.md +++ b/docs/rules-en/technical-spec.md @@ -21,10 +21,7 @@ TypeScript-based application implementation. Architecture patterns should be sel ## Architecture Design ### Architecture Patterns -Select appropriate architecture patterns according to project requirements and scale: -- **Vertical Slice Architecture**: LLM-optimized, one-feature-one-file principle -- **Hybrid Progressive Architecture**: Progressive evolution from small to large scale -- **Architecture Consistency**: Strictly follow the selected pattern +Select and strictly follow project-specific patterns. Note: This refers to design/implementation consistency, not runtime data consistency (e.g., LLM outputs). ## Unified Data Flow Principles diff --git a/docs/rules-en/typescript-testing.md b/docs/rules-en/typescript-testing.md index 96822c1..ed245b1 100644 --- a/docs/rules-en/typescript-testing.md +++ b/docs/rules-en/typescript-testing.md @@ -169,6 +169,10 @@ const sdkMock = { } as unknown as ExternalSDK // Complex external SDK type structure ``` +## Continuity Test Scope + +Limited to verifying existing feature impact when adding new features. Long-term operations and load testing are infrastructure responsibilities, not test scope. + ## Basic Vitest Example ```typescript diff --git a/docs/rules-ja/architecture/implementation-approach.md b/docs/rules-ja/architecture/implementation-approach.md index 14a3cf6..a89bcc9 100644 --- a/docs/rules-ja/architecture/implementation-approach.md +++ b/docs/rules-ja/architecture/implementation-approach.md @@ -139,7 +139,6 @@ ビジネス制約: - 市場投入時期の要求 - - 運用継続性の必要性 - 顧客影響の最小化要求 - 法規制・業界標準への適合 ``` diff --git a/docs/rules-ja/rules-index.yaml b/docs/rules-ja/rules-index.yaml index 8aa3299..3bf041c 100644 --- a/docs/rules-ja/rules-index.yaml +++ b/docs/rules-ja/rules-index.yaml @@ -45,6 +45,7 @@ rules: - "テストの実装規約" - "テストの粒度" - "モックの型安全性" + - "継続性テストの範囲" - "Vitestの基本例" ai-development-guide: @@ -81,6 +82,7 @@ rules: - "技術スタックの基本方針" - "環境変数管理とセキュリティ" - "アーキテクチャ設計" + - "パターン適用の一貫性" - "データフロー統一原則" - "ビルドとテスト" diff --git a/docs/rules-ja/technical-spec.md b/docs/rules-ja/technical-spec.md index cf3acbf..8f52525 100644 --- a/docs/rules-ja/technical-spec.md +++ b/docs/rules-ja/technical-spec.md @@ -24,9 +24,12 @@ TypeScriptをベースとしたアプリケーション実装。アーキテク プロジェクトごとに適切なアーキテクチャを選択し、明確に定義すること: - **明確な定義**: プロジェクトのアーキテクチャは`docs/rules/architecture/`配下に専用ファイルで定義 -- **一貫性の維持**: 一度選択したアーキテクチャパターンに厳密に従うこと - **責務の分離**: 各層やモジュールの責務を明確に定義し、境界を守ること +## パターン適用の一貫性 + +選択したアーキテクチャパターンに厳密に従うこと。ただし、これは設計・実装の一貫性であり、LLM出力のような実行時データの一貫性とは異なる。 + プロジェクト固有のアーキテクチャ詳細は該当するアーキテクチャルールファイルを参照。 ## データフロー統一原則 diff --git a/docs/rules-ja/typescript-testing.md b/docs/rules-ja/typescript-testing.md index 041b2ab..4ed9a7a 100644 --- a/docs/rules-ja/typescript-testing.md +++ b/docs/rules-ja/typescript-testing.md @@ -169,6 +169,10 @@ const sdkMock = { } as unknown as ExternalSDK // 外部SDKの複雑な型のため ``` +## 継続性テストの範囲 + +新機能追加時の既存機能への影響確認に限定。長時間運用・負荷テストはインフラ層の責務のため対象外。 + ## Vitestの基本例 ```typescript diff --git a/package-lock.json b/package-lock.json index a96eb72..c38ac42 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "ai-coding-project-boilerplate", - "version": "1.7.10", + "version": "1.7.11", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "ai-coding-project-boilerplate", - "version": "1.7.10", + "version": "1.7.11", "hasInstallScript": true, "license": "MIT", "bin": { diff --git a/package.json b/package.json index 2c0c41e..5ca9260 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "ai-coding-project-boilerplate", - "version": "1.7.10", + "version": "1.7.11", "description": "TypeScript project boilerplate optimized for Claude Code development with comprehensive development rules, architecture patterns, and quality assurance tools", "main": "dist/index.js", "keywords": [