architecture

5 posts

你的架構圖早已是謊言

架構文件從你存檔的那一刻起就開始腐敗。以下說明如何透過程式碼產生的圖表、ADR 與自動化架構測試,讓文件保持誠實。

我在 wiki 裡看過的每一張架構圖都是錯的。不是明顯的錯,而是安靜地、漸進地錯。標示為「Auth」的服務在六個月前就被拆成三個微服務。標示為「sync call」的箭頭現在已經透過 queue 變成 async。標示為「PostgreSQL」的資料庫在某次火災演練中被遷移到別的東西,但沒人更新那個方框。…

為什麼在 Cursor 裡用 NativeWind 做 Vibe coding,會在規模上拖垮你的 React Native app

你用 Cursor 一個週末就交付了 MVP,但現在只改一個 brand color 就會波及 47 個檔案。這套 styling contract 可以止血。

你打開 Cursor,輸入一段 prompt,看著 Claude Code 在幾秒內生成一整套 React Native UI。Flex layout、圓角 button、color theme,全都一次就跑起來。你把它送上 TestFlight。使用者開始下載。這是第一週。 到了第六週,你只是想改一個 brand…

為什麼不該讓 Claude Code 審你的程式碼(以及該改用什麼)

LLM code review 既不確定、又慢,還會漏掉架構違規。這套 O(1) guard stack 才真的能讓你的程式碼保持乾淨。

我認識的一位開發者,把 Claude Code 設成 CI 裡的程式碼 reviewer。「就讓 Claude 幫我看 PR,」他對我說,「它會抓到一些我可能漏掉的東西。」我請他把同一個 PR 丟給 Claude 跑兩次。 第一次 review 說 error handling 看起來很完整。第二次 review…

刪掉,不要遷移:Vibe-coded React Native app 的重構策略

重構 AI 生成程式碼,等於去逆向推斷一個你從來沒有擁有過的意圖。這個以介面為中心的 replacement pattern,能讓刪除變得安全。

在生物學裡,autotomy 指的是動物主動捨棄已經不再有用的身體部位。蜥蜴會斷尾來逃離掠食者。那條尾巴曾經有用,但想活下來,就得放手。之後還會再長出一條新的。 這就是你應該如何看待 Vibe-coded React Native app 的重構。 在 AI-coded 的早期 MVP 裡,第一版 auth flow…

Cursor 和 Claude Code 如何毀掉你的 React Native 架構(以及如何修好它)

AI 生成的 auth 在新 feature 把手伸進錯誤 service 之前,看起來都沒問題。這套 interface-driven 架構能避免 vendor swap 和功能迭代一起打壞 login。

Vibe-coded React Native app 裡一個反覆出現的 failure mode 是:新 feature 直接 import 現有 service,伸手去改不屬於自己的 state,然後把無關的 flow 一起打壞。auth 很容易成為受害者,因為它往往會變成所有人的 shared…