Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 12 additions & 19 deletions .claude/agents-en/acceptance-test-generator.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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**:
Expand Down
16 changes: 16 additions & 0 deletions .claude/agents-en/technical-designer.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
33 changes: 13 additions & 20 deletions .claude/agents-ja/acceptance-test-generator.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,19 +42,22 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
- **生成ファイル**: `*.e2e.test.ts`
- **実装タイミング**: 全実装完了後の最終フェーズで実行

## 対象外(専門エージェント準備まで除外)
## 対象外

**セキュリティ要件**:
- SQL injection、XSS等の攻撃耐性テスト
- 認証・認可の詳細セキュリティ検証
- 暗号化・トークン検証の専門的テスト
**外部依存** (契約/インターフェース検証で代替):
- サードパーティサービスへの実際のAPI呼び出し
- 外部認証プロバイダー
- 決済/メール/SMS配信

**パフォーマンス要件**:
- 負荷テスト、ストレステスト
- レスポンスタイム詳細計測
- 同時接続数・スループット検証
**CI環境で非決定的**:
- パフォーマンス指標、レスポンスタイム測定
- 負荷/ストレステスト

**対象外理由**: 統合テスト・E2Eテストスコープを超える専門領域のため
**実装詳細** (ユーザーから観測不可):
- 内部関数呼び出し、クラス構造
- 具体的なレンダリング詳細(情報の存在確認、レイアウトではない)

**アクション**: ACに除外項目が含まれる場合、検証可能な振る舞いに変換するか、手動テスト参照付きでit.skip()を生成

## 実行戦略

Expand Down Expand Up @@ -299,16 +302,6 @@ describe('会話ログ永続化 E2Eテスト', () => {
3. **Medium**: ドメイン特有業務知識必要 → 選択肢提示
4. **Low**: 複数解釈可能だが影響軽微 → 解釈採用 + 注記

### セキュリティ・パフォーマンス要件の処理
**検出パターン**:
- 「安全」「セキュア」「暗号化」「認証」「認可」
- 「高速」「パフォーマンス」「負荷」「レスポンス時間」「スループット」

**処理方法**:
1. 該当AC識別・分離
2. 対象外理由明記: "統合テスト・E2Eテストスコープを超える専門領域のため"
3. 残りACで通常処理継続

## 技術仕様

**プロジェクト適応**:
Expand Down
16 changes: 16 additions & 0 deletions .claude/agents-ja/technical-designer.md
Original file line number Diff line number Diff line change
Expand Up @@ -309,6 +309,22 @@ ADRに含まない:スケジュール、実装手順、具体的コード
**例**: 「ログインが動作する」→「正しい認証情報で認証後、ダッシュボード画面に遷移」
**網羅性**: 正常系・異常系・エッジケースをカバー。非機能要件は別セクションで定義。

### 自律実装のためのACスコーピング

**含めるべき** (自動化ROI高):
- ビジネスロジックの正確性(計算、状態遷移、データ変換)
- データ整合性と永続化の振る舞い
- ユーザーから見える機能の完全性
- エラーハンドリングの振る舞い(ユーザーに見える/体験する内容)

**除外すべき** (LLM/CI/CD環境でROI低):
- 外部サービスの実接続 → 契約/インターフェース検証で代替
- パフォーマンス指標 → CI環境で非決定的、負荷テストに委ねる
- 実装詳細 → 観測可能な振る舞いに集中
- UIレイアウト詳細 → 情報の有無に集中、表現方法ではない

**原則**: AC = 独立したCI環境で検証可能なユーザー観測可能な振る舞い

## 最新情報調査のガイドライン

**必須調査タイミング**: 新技術導入、パフォーマンス最適化、セキュリティ設計、大幅バージョンアップ時
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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": [
Expand Down