Skip to content

Conversation

shinpr
Copy link
Owner

@shinpr shinpr commented Aug 20, 2025

Summary

  • Added Pattern 5 (Insufficient Existing Code Investigation) to prevent duplicate implementations
  • Enhanced pre-implementation code investigation requirements across all documentation
  • Improved AI execution accuracy through clearer existing codebase analysis guidelines

Changes

  • Japanese rules: Clarified existing code investigation process and added Pattern 5
  • English rules: Translated and synchronized all improvements to maintain parity
  • Agent definitions: Updated to emphasize pre-implementation code investigation
  • Rules index: Added relevant tags for better discoverability

Impact

This change ensures AI agents properly investigate existing code before implementing new features,
reducing duplicate implementations and maintaining architectural consistency.

shinpr and others added 2 commits August 20, 2025 10:20
## 変更内容
- ai-development-guide.md: パターン5(既存コード調査不足)の表現を明確化
  - 曖昧な「検討」「視野に」を「使用する」「行わない」等の明確な動詞に変更
  - 判断と行動を明確に分離(if-then形式)

- technical-designer.md: 類似機能調査プロセスを強化
  - ルールとの関連を明示(パターン5対策)
  - Design Docへの記載義務を明確化

- task-executor.md: 実装前確認を追加
  - Design Docとの連携強化
  - パターン5準拠の明記

- code-reviewer.md: 検証項目を追加
  - 重複実装チェックの追加

- work-planner.md: タスク定義に既存調査を含める

- rules-index.yaml: typical-useを「実装時のベストプラクティス」に更新

## 改善効果
- AIの判断迷いを排除(明確な行動指示)
- ルールとエージェントの連携強化(明示的参照)
- responseMimeType問題のような見落としを構造的に防止

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
…ish rules

- Added Pattern 5 to ai-development-guide.md for preventing duplicate implementations
- Updated all agent descriptions to reference pre-implementation code investigation process
- Enhanced technical-designer.md with similar functionality search and decision workflow
- Added pre-implementation verification steps to task-executor.md
- Strengthened architecture validation checklist in code-reviewer.md
- Added 'code-reading' and 'best-practices' tags to rules-index.yaml

This ensures English documentation maintains parity with Japanese improvements for AI execution accuracy.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@shinpr shinpr self-assigned this Aug 20, 2025
🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@shinpr shinpr marked this pull request as ready for review August 20, 2025 01:40
@shinpr shinpr merged commit fd857bd into main Aug 20, 2025
1 check passed
@shinpr shinpr deleted the fix/code-reading-clarity branch August 20, 2025 01:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant