📚 すべての記事
全 84 件 ／ 2 ページ目（全 7 ページ）
Red テストは verifier 家族の資産 — テスト改ざんガード・レビュー漏れの機械クローズ・自己評価遮蔽【クロスファミリー検証 第4回】
クロスファミリー検証の威力を底上げする、見落とされがちな層 — ハーネスとステアリング。TDD の Red テストを Claude（verifier 家族）の資産として Codex から checksum で機械保護し、レビュー漏れを三層ゲートで構造的に塞ぎ、handoff から実装者の自己評価を遮蔽する設計を詳解する。
Atomic Design リファクタ編 — 47 page を「新規移植アプローチ」で 5 日で分離し、負債 43,500 行を消すまで【実践編 第5章】
動いているフロントエンド 45+ page を Smart/Dumb 分離へ移行した実録。「既存をリファクタしない。退避 → generator → 写経で新規に作る」アプローチで工数 40% 削減、legacy 約 43,500 行削除・正味 −12,000 行。完了基準を grep 機械検証 9 ゲートで固定し、State 二重保持や as unknown as キャストなど移植で得た教訓まで全て公開する。
DDD/SOLID/BC 編 — god class 1,545 行の解体と「allowlist で逃がすな」【実践編 第3章】
本番前の .NET バックエンド総リファクタの実録。互換コードを一切残さない決断、god class 5 件を「200 行物理ゲート + Coordinator/Strategy」で解体、旧テスト 4,564 行の削除、BC 越境を Read 専用 Port で断ち切り default-deny の越境テストで固定するまで。オーナーの一言「allowlist で逃がすな」が設計を変えた瞬間と、第I部全体を貫く 4 つの型を宣言する。
パフォーマンス編 — 「数えるだけ」が 52.7 秒かかり SAGA を止めた。そして最適化が障害の元凶になった【実践編 第9章】
件数カウントが全件マテリアライズで statement_timeout を踏み、リトライ経由で SAGA 全体を止めた障害の解剖（COUNT 化で 500 倍改善）。5 属性完全一致キャッシュをコサイン類似度キャッシュ（閾値 0.95・pgvector）へ刷新した設計と、その最適化が後に「Create Chunk 重量化の元凶」と名指しされ契約 C-1/C-8 で正しい置き場所に戻されるまで — 性能改善も、アーキテクチャ契約の中でやる。
Python ジョブ群編 — 握り潰された except は 3 箇所ではなく 8 箇所あった。スタブ・enum 三重定義の一掃【実践編 第8章】
AI が量産しがちな Python の「静かな負債」を一掃した実録。NotImplementedError スタブの二世代併存を実態調査でまとめて削除、LLM レスポンス parse の except-pass 握り潰しをゼロベースライン確認で 3 → 8 箇所に拡張検出、振る舞いが微妙に違う enum 三重定義の統合、複数行 grep やコメント誤検出と戦う機械ガードの細部まで。
リファクタリング総点検ガイド — 7 つの観点と進め方【実践編 第2章】
「リファクタリングをするに当たって、どこを見ればいいのか」に答える第I部の扉。CTS-EC が本番前の総点検で実際に使った 7 つの観点（DDD/SOLID/BC・フロントエンド構造・Python ジョブ・テスト品質・パフォーマンス・セキュリティ・a11y）を、典型負債・機械ガード・拠り所とする開発手法・実録章への対応つきの地図として整理し、安全網 → 定量棚卸し → 1 観点 1 ステアリング → 機械ガード固定という進め方の型を示す。
SAGA 編 — Fix 率 44% の発散を「同型性契約」で止め、再発を常設機械ガードで封じる【実践編 第4章】
分散処理 SAGA という新アーキテクチャに挑戦し、後発 SAGA が 29 日で Fix 率 44% と発散した実録。障害 6 連発の解剖から同型性契約 C-1〜C-10 を帰納し、検査スクリプトと例外台帳で固定。DefaultTenant/OCC の default-deny アーキテクチャテスト（allowlist 64 件）、「database-per-worker 計画を実態調査で捨てて 1 行で根治」した flaky 対策、そして機械検出不能な残余 3 経路をクロスファミリーレビューに配線するまで。
セキュリティ編 — token をログに書かせない arch-test、YAGNI で消す勇気、「ローカル緑でも本番 400」の罠【実践編 第10章】
第I部最終章。トークン平文ログを grep ベースのアーキテクチャテストで構造禁止し、呼び出しゼロの認可コードを YAGNI で削除し、CORS の localhost を本番だけ閉じる — その過程で踏んだ「.NET 10 は record の検証属性を param target で要求し、[property:] だと 400 を返す」という実挙動の罠と、design-reviewer の SHOULD 指摘が的中した CORS 訂正劇。セキュリティ負債の返済も、機械ガードと実挙動検証で。
Storybook × a11y 実機編 — 「テストは緑、でも無スタイル DOM を検査していた」を実機で暴くまで【実践編 第6章】
WCAG 準拠を test-storybook で機械ゲート化した実録。SB9+ では axe-playwright が不要になっていた公式仕様の裏取り、build-storybook の styles 欠落で axe が無スタイル DOM を検査していた実機発見、styled 再検査で露出した color-contrast 52 件、zoneless Angular の aria-invalid 罠まで — 「テスト緑 ≠ 検査できている」の教科書的事例。