developer-profile

開発者プロフィール

コードの実装、リファクタリング、修正、レビュー、拡張を行う際に使用してください。特に、新機能、動作変更、リファクタリング、バグ修正、コンポーネント／サービス／ユーティリティ／型／テストの追加や、詳しくないプロジェクト領域での作業に使用してください。

譲れない原則

1. コードの追加は最後に行ってください。まず機能の全体的な流れを調べ、そのうえで新しいものを作る前に、既存のコードを再利用、リファクタリング、簡素化、または削除してください。
2. 古いコードの上に新しいコードを積み重ねないでください。動作が重複する場合は、既存の処理経路に統合または拡張し、不要になった重複を削除してください。
3. 機能の差分は、ファイルを追加するだけでなく、機能全体を改善するものであるべきです。変更の大半が追加なら、いったん止めて、再利用、削除、リファクタリングの余地を見直してください。
4. ファイル／関数／コンポーネント／サービス／状態／型／ヘルパーを追加する前に、既存のものを再利用または拡張するほうが総コード量を減らせないことを確認してください。
5. コード量を減らすことを優先してください。総合的な複雑さを明確に軽減できる場合を除き、ラッパー、ヘルパー、抽象化、依存関係、設定、レイヤーを追加しないでください。
6. ドメインに合わせた構成にしてください。フォルダーやファイルは機能／ライブラリ／状態などの単位で整理し、ファイル名はフォルダーの文脈を反映させてください。例：Feature/Library/State/LibraryState.ts。
7. 責務を分離してください。UI、状態、ビジネスロジック、データアクセス、フォーマット、サイドエフェクトを分け、それぞれを再利用／テスト／置き換え可能にしてください。
8. プロジェクトの慣例に従ってください。既存の命名、インポート、フォーマット、状態／データのパターン、テスト、アーキテクチャに合わせてください。

必須ワークフロー

1. まず調査してください。機能の流れ、類似の実装、フォルダー構成、共有コンポーネント／サービス／ユーティリティ／型／状態／スタイル、エラー処理、テストを確認してください。
2. まず再利用／リファクタリング／削除してください。重複したコードや未使用／不要になったコードを削除し、適切な抽象化を拡張してください。並行するコンポーネント、サービス、型、状態、ユーティリティ、スタイル、アーキテクチャを作らないでください。
3. 残った必要なものだけを追加してください。最小限ですっきりした解決策にし、差分を絞り、無関係な書き換えは行わないでください。差し引きで簡素化できる根拠がない限り、新しい依存関係やアーキテクチャを追加しないでください。
4. モジュール性、型、安全性、読みやすさを保ってください。明確な名前を付け、有用な場合は明示的な型を指定し、any を避け、複数の責務を混在させず、隠れたサイドエフェクトを作らないでください。
5. プロジェクトの構成に厳密に従ってください。適切な配置、既存のファイル命名、インポート形式、フォーマット、慣例、テスト構成に合わせてください。
6. 最終的な概要には、再利用／拡張したもの、削除／簡素化したもの、新しいコードが避けられなかった理由を記載してください。