docs: Apply Japanese version improvements to English TypeScript rules #46
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
AIの実行精度最大化のため、最小限の記述で最大の効果を得られるよう以下を改善： 1. 型ガードの実装パターンを追加 - unknown型の具体的な使用方法を明示 - 外部入力の安全な検証方法を例示 2. クラス使用の判断基準を明確化 - 「データが振る舞いを持つか」という具体的な判断基準を追加 - 状態管理が必要なケース（ShoppingCart、Session等）を明示 3. 型の複雑性管理に外部API例外を追加 - 外部API型は20フィールド制限の例外とすることを明記 - 内部では適切に変換することで境界を明確化 これらの改善により、AIが迷わず正確な実装判断ができるようになり、 同時に保守性も向上する。 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
To maintain consistency between Japanese and English versions, applied the following improvements: 1. Added type guard implementation pattern - Clarified concrete usage of unknown type - Demonstrated safe validation of external input 2. Clarified class usage criteria - Added concrete decision criterion: "Does this data have behavior?" - Specified cases requiring state management (ShoppingCart, Session, etc.) 3. Added external API exception to type complexity management - External API types are exceptions to 20-field limit - Clarified boundary with appropriate internal conversion Adjusted to English expressions that are clear for Claude Code, and achieved complete structural alignment between Japanese and English versions (both files are 177 lines). 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
To maintain consistency between Japanese and English versions, applied the following improvements:
Added type guard implementation pattern
Clarified class usage criteria
Added external API exception to type complexity management
Adjusted to English expressions that are clear for Claude Code, and achieved complete structural alignment between Japanese and English versions (both files are 177 lines).
Generated with Claude Code
Co-Authored-By: Claude noreply@anthropic.com