diff --git a/.claude/agents-en/acceptance-test-generator.md b/.claude/agents-en/acceptance-test-generator.md index 507c782..84d001f 100644 --- a/.claude/agents-en/acceptance-test-generator.md +++ b/.claude/agents-en/acceptance-test-generator.md @@ -43,17 +43,20 @@ Before starting work, you MUST read and strictly follow these rule files: ## Out of Scope -**Security Requirements**: -- SQL injection, XSS attack resistance testing -- Detailed authentication/authorization security verification -- Encryption and token verification specialized testing +**External Dependencies** (Test contracts/interfaces instead): +- Real API calls to third-party services +- External authentication providers +- Payment/email/SMS delivery -**Performance Requirements**: -- Load testing, stress testing -- Detailed response time measurement -- Concurrent connections and throughput verification +**Non-Deterministic in CI**: +- Performance metrics, response time measurements +- Load/stress testing -**Reason for Exclusion**: These are specialized domains beyond integration/E2E test scope +**Implementation Details** (Not user-observable): +- Internal function calls, class structure +- Specific rendering details (test information presence, not layout) + +**Action**: When AC contains excluded items, transform to verifiable behavior or generate it.skip() with manual test reference ## Execution Strategy @@ -300,16 +303,6 @@ Response in the following format upon execution completion: 3. **Medium**: Domain-specific business knowledge required → Present options 4. **Low**: Multiple interpretations possible but minor impact → Adopt interpretation + note -### Security and Performance Requirements Processing -**Detection Patterns**: -- "secure", "encrypt", "authenticate", "authorize" -- "fast", "performance", "load", "response time", "throughput" - -**Processing Method**: -1. Identify and separate relevant ACs -2. Document exclusion reason: "Specialized domain beyond integration test scope" -3. Continue normal processing with remaining ACs - ## Technical Specifications **Project Adaptation**: diff --git a/.claude/agents-en/technical-designer.md b/.claude/agents-en/technical-designer.md index a72f341..ed9d695 100644 --- a/.claude/agents-en/technical-designer.md +++ b/.claude/agents-en/technical-designer.md @@ -315,6 +315,22 @@ Implementation sample creation checklist: 4. **Priority**: Place important acceptance criteria at the top +### AC Scoping for Autonomous Implementation + +**Include** (High automation ROI): +- Business logic correctness (calculations, state transitions, data transformations) +- Data integrity and persistence behavior +- User-visible functionality completeness +- Error handling behavior (what user sees/experiences) + +**Exclude** (Low ROI in LLM/CI/CD environment): +- External service real connections → Use contract/interface verification instead +- Performance metrics → Non-deterministic in CI, defer to load testing +- Implementation details → Focus on observable behavior +- UI layout specifics → Focus on information availability, not presentation + +**Principle**: AC = User-observable behavior verifiable in isolated CI environment + *Note: Non-functional requirements (performance, reliability, etc.) are defined in the "Non-functional Requirements" section and automatically verified by tools like quality-fixer ## Latest Information Research Guidelines diff --git a/.claude/agents-ja/acceptance-test-generator.md b/.claude/agents-ja/acceptance-test-generator.md index 5c05ba6..6c99c8a 100644 --- a/.claude/agents-ja/acceptance-test-generator.md +++ b/.claude/agents-ja/acceptance-test-generator.md @@ -42,19 +42,22 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、 - **生成ファイル**: `*.e2e.test.ts` - **実装タイミング**: 全実装完了後の最終フェーズで実行 -## 対象外(専門エージェント準備まで除外) +## 対象外 -**セキュリティ要件**: -- SQL injection、XSS等の攻撃耐性テスト -- 認証・認可の詳細セキュリティ検証 -- 暗号化・トークン検証の専門的テスト +**外部依存** (契約/インターフェース検証で代替): +- サードパーティサービスへの実際のAPI呼び出し +- 外部認証プロバイダー +- 決済/メール/SMS配信 -**パフォーマンス要件**: -- 負荷テスト、ストレステスト -- レスポンスタイム詳細計測 -- 同時接続数・スループット検証 +**CI環境で非決定的**: +- パフォーマンス指標、レスポンスタイム測定 +- 負荷/ストレステスト -**対象外理由**: 統合テスト・E2Eテストスコープを超える専門領域のため +**実装詳細** (ユーザーから観測不可): +- 内部関数呼び出し、クラス構造 +- 具体的なレンダリング詳細(情報の存在確認、レイアウトではない) + +**アクション**: ACに除外項目が含まれる場合、検証可能な振る舞いに変換するか、手動テスト参照付きでit.skip()を生成 ## 実行戦略 @@ -299,16 +302,6 @@ describe('会話ログ永続化 E2Eテスト', () => { 3. **Medium**: ドメイン特有業務知識必要 → 選択肢提示 4. **Low**: 複数解釈可能だが影響軽微 → 解釈採用 + 注記 -### セキュリティ・パフォーマンス要件の処理 -**検出パターン**: -- 「安全」「セキュア」「暗号化」「認証」「認可」 -- 「高速」「パフォーマンス」「負荷」「レスポンス時間」「スループット」 - -**処理方法**: -1. 該当AC識別・分離 -2. 対象外理由明記: "統合テスト・E2Eテストスコープを超える専門領域のため" -3. 残りACで通常処理継続 - ## 技術仕様 **プロジェクト適応**: diff --git a/.claude/agents-ja/technical-designer.md b/.claude/agents-ja/technical-designer.md index 851f46f..c37bbb9 100644 --- a/.claude/agents-ja/technical-designer.md +++ b/.claude/agents-ja/technical-designer.md @@ -309,6 +309,22 @@ ADRに含まない:スケジュール、実装手順、具体的コード **例**: 「ログインが動作する」→「正しい認証情報で認証後、ダッシュボード画面に遷移」 **網羅性**: 正常系・異常系・エッジケースをカバー。非機能要件は別セクションで定義。 +### 自律実装のためのACスコーピング + +**含めるべき** (自動化ROI高): +- ビジネスロジックの正確性(計算、状態遷移、データ変換) +- データ整合性と永続化の振る舞い +- ユーザーから見える機能の完全性 +- エラーハンドリングの振る舞い(ユーザーに見える/体験する内容) + +**除外すべき** (LLM/CI/CD環境でROI低): +- 外部サービスの実接続 → 契約/インターフェース検証で代替 +- パフォーマンス指標 → CI環境で非決定的、負荷テストに委ねる +- 実装詳細 → 観測可能な振る舞いに集中 +- UIレイアウト詳細 → 情報の有無に集中、表現方法ではない + +**原則**: AC = 独立したCI環境で検証可能なユーザー観測可能な振る舞い + ## 最新情報調査のガイドライン **必須調査タイミング**: 新技術導入、パフォーマンス最適化、セキュリティ設計、大幅バージョンアップ時 diff --git a/package-lock.json b/package-lock.json index 51a61af..981a570 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "ai-coding-project-boilerplate", - "version": "1.7.13", + "version": "1.7.14", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "ai-coding-project-boilerplate", - "version": "1.7.13", + "version": "1.7.14", "hasInstallScript": true, "license": "MIT", "bin": { diff --git a/package.json b/package.json index ada38a3..478e672 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "ai-coding-project-boilerplate", - "version": "1.7.13", + "version": "1.7.14", "description": "TypeScript project boilerplate optimized for Claude Code development with comprehensive development rules, architecture patterns, and quality assurance tools", "main": "dist/index.js", "keywords": [