implementation
mobile/ と server/ の実装コードを書く・直す・足すときの判断順序。
SKILL.md.claude/skills/implementation/SKILL.md
GitHub実装の判断順序
要求と、それが触れる既存コードを読み、実際の流れを辿る。その後に次を上から評価し、最初に成立した段で止める。理解を省いて得た小さな差分は、効率ではなく2つ目の不具合である。
- 作らずに済むか。要求に含まれない先回りの機能は作らない
- このリポジトリに既にあるか
- 標準ライブラリで足りるか
- プラットフォームの機能で足りるか。DB の制約・索引、zod の検証、Flutter の標準ウィジェットを、アプリケーションコードで代替しない
- 既に入っている依存で足りるか
- 1行で書けるか
- 動く最小のコードを書く
同じ大きさの選択肢が2つあるなら、境界値で正しいほうを採る。最小化の対象はコード量であり、アルゴリズムの正しさではない。
不具合の修正では、触る関数の呼び出し元をすべて grep し、共有点を1箇所で直す。報告された経路にだけ条件を足すと、同じ関数を呼ぶ他の経路が壊れたまま残る。
短さを理由に削らないもの: 信頼境界での入力検証、記録を失わせないエラー処理、アクセシビリティ、明示的に要求されたもの。
分岐・解析・金額計算を含むロジックは、それが壊れたときに落ちる検査を1つ残す。
説明はコードの後に、省いたものと、それを足す条件を最大3行で書く。説明がコードより長いなら説明を削る。