Claude Code で技術的負債を3ヶ月で半減させた実践記録 — どこから手をつけ、どう効果を測るか
積み上がった技術的負債にClaude Codeで取り組んだ3ヶ月の記録です。負債の地図を数値で作る方法、緊急度×影響範囲での優先順位づけ、サブエージェントを使った安全な重複コード削減、循環依存の解消、週次ヘルスチェックの自動化、うまくいかなかった3つのことまで公開します。
Claude Code に大規模リファクタを任せたら本番だけ挙動が変わったとき — 暗黙の契約ドリフトを差分で計測する運用メモ
Claude Code に大きなリファクタを任せると、テストは緑なのに本番の挙動だけが静かにずれることがあります。例外経路・ログ形状・初期化順序・戻り値の形を署名として録り、コミットごとに差分で捕まえる契約ドリフト検出ハーネスの設計と実装をまとめました。
新型 iPhone で壁紙がぼやける問題を Claude Code で直す — 端末別解像度の振り分けを安全に増やす
新しい iPhone が出るたびに壁紙アプリで画像がぼやけたり余白が出たりする原因と、散らばった端末分岐を一枚のテーブルに集約して安全に拡張する方法を、Claude Code を使った実際のリファクタリング工程として共有します。
Claude Code の大規模リファクタを 1 コミット単位で巻き戻せる状態に保つ — チェックポイント設計とロールバック検知の実装メモ
Claude Code に大規模リファクタを任せると速さの裏でレビュー不能な巨大 diff が積み上がります。チェックポイントをマニフェストで管理し、コミット粒度を pre-push で機械的に強制し、ロールバック判断を Observability に紐づける——個人開発と受託で固めてきた実装メモです。
Xcode の警告を Claude Code で4週間かけてゼロにした個人開発の所感
長年の個人開発で累積したXcode警告を、Claude Codeと一緒に4週間かけてゼロにした記録です。スプリント前に決めたこと、機械的に潰せる警告から削る週ごとの方針、AIに任せた領域と人間が判断を残した境界、つまずきと回避策、数値で振り返る効果までを具体的に共有します。
Claude Code でテスト駆動リファクタリング — レガシーコードを安全に現代化する
Claude Code を使ってレガシーコードにテストを追加しながら安全にリファクタリングする手法を解説。TDD の原則とAIの組み合わせで、品質を落とさず技術的負債を解消する実践的ワークフローを紹介します。