資料來源#
摘要#
這是 AI 建構的程式碼庫中一種特定的失敗模式，出自 The Founder's Playbook: Building an AI-Native Startup：技術債以複利方式增長而非線性累積，因為每次 agentic engineering 編碼 session 在沒有持久性規格或上下文檔案的情況下從頭重新推導基礎架構決策。結果是一個局部功能正常但「背後沒有一致心智模型的程式碼庫——不是因為任何單一部分寫得差，而是因為這些部分從未被設計為彼此契合。」這個問題往往很晚才浮現——程式碼庫運作正常，直到迭代或規模迫使全面重寫。
為何這與一般技術債不同#
一般技術債逐漸累積，可以在一個專門的衝刺中清除。工程師知道自己在哪裡走了捷徑；工作量是有界的。
Agentic Technical Debt 具有三個結構性的新特性：
- 漂移，而非僅是捷徑。 每次 session 的「第一性原理」推理落在略有不同的位置。程式碼庫不只包含妥協；它包含妥協之間的不一致。
- 在暴露之前不可見。 一個能運作的功能不會宣告它是基於什麼架構前提建構的。這種漂移只有在閱讀整個程式碼庫時才能觀察到，而創辦人通常不會這樣做，因為他們忙著出貨。
- 沒有自然的回饋迴路。 傳統工程團隊有共同的設計討論、程式碼審查、ADRs——這些都會建立「為什麼這樣做」的人類記憶。獨立創辦人加上 agent 兩者皆無，因此每次 session 在意圖上真正從零開始。
機制#
「如果沒有將規格和架構約束寫在 AI 能讀取的地方，每次 session 都會從頭重新推導基礎決策，而這些決策會漂移。」
每次 agentic session 開始時，agent 會從當前程式碼狀態推斷自己的結構性假設。兩次 session 讀取相同程式碼可能推斷出兩種不同的意圖（這個模式是刻意的嗎？那個抽象是約束還是巧合？）。然後 agent 基於其推斷的意圖建構下一個功能。經過數月重複，程式碼庫包含了多個交錯的「隱式架構」。
解方：持久性上下文#
該手冊的處方是將架構意圖編碼在 CLAUDE.md markdown 檔案中，Claude Code 會在每次 session 開始時自動讀取這些檔案。這些檔案作為專案層級的指令——功能上是專案的持久性「記憶」。紀律如下：
- 在開啟 Claude Code 之前， 先開啟 Claude（聊天）並定義你要建構的東西：核心問題、使用者、六個月規模、架構原則、要避免的依賴、有意識接受的取捨。儲存為 CLAUDE.md。
- 每次 Claude Code session 開始時，(1) 重新檢視範圍文件，(2) 提供模型 CLAUDE.md 上下文文件。
- 每次 session 結束時，用該 session 浮現的任何決策更新 CLAUDE.md。
該手冊的主張：「每次 session 五分鐘的文件記錄，是對抗架構漂移複利化為不可管理程式碼庫的廉價保險。」
債務到期時#
該手冊標記了兩個時刻，此時一般的 AI 建構債務會變成結構性負債：
- MVP → 上線轉換。 生產流量、新功能和日益增長的複雜度暴露了捷徑。「那些債務開始產生利息，拖得越久不處理，修復成本就越高。」
- 企業審計前。 企業合約浮現合規要求（SOC 2、GDPR、HIPAA），這些在原型階段並不適用。AI 掃描有幫助，但明確不能替代合格的合規審查。
上線階段的解方是系統性架構審計（Claude Code 找出結構性弱點、測試覆蓋率缺口、重構候選項）→ Claude 分類並排序修復工作 → CLAUDE.md 更新那些在 MVP 期間只存在於創辦人腦中的架構決策。
「從頭重建」的失敗模式#
「讓 Claude Code 在沒有護欄的情況下建構，會產生一個功能正常但結構不連貫的程式碼庫，而在不連貫的程式碼庫上迭代和擴展最終是浪費時間和 token。遲早會有一個程式碼不可避免地崩潰的時刻，迫使你從頭重建。」
經濟論點：在不連貫的程式碼上迭代比從一開始維護連貫的程式碼庫花費更多 token（更長的 context window、更多重新閱讀、更多澄清）。成本主要不是人類時間——而是算力。追求零成本迭代的創辦人是在用當下的分鐘換取未來的重寫成本。
相關連結#
- AI-Native Startup Lifecycle — 主要的 MVP 和上線階段風險
- Deep Modules for Agents — Ousterhout 風格的深模組加上持久性上下文紀律是架構反壓力；Matt Pocock 的 Sandcastle 模式是一個具體實例
- Claude Code Best Practices — Anthropic 官方關於 CLAUDE.md 的指引；該手冊將同樣的紀律框架為創辦人的生存之道，而非最佳實踐
- Claude Code — 這種債務累積的工具
- Zero-Friction Scope Creep — 伴隨的失敗模式；範圍蔓延加速債務累積
- Harness Shrinkage as Models Improve — 反壓力：如果 harness（包括 session 上下文管道）縮小，CLAUDE.md 可能也需要演進
- Context Window Smart Zone — CLAUDE.md 必須放在 smart zone 內；過長的上下文檔案本身會成為問題
- Design Concept Grilling — Matt Pocock 的 grill-me 模式在寫程式碼之前達到 Brooks 的「設計概念」，與 CLAUDE.md 作為架構上下文互補
- Founder as Agent Orchestrator — 非技術創辦人的管線提高了風險：最能識別問題的創辦人最缺乏撰寫防止此債務的架構上下文的能力
- Problem-Solution Fit Discipline — MVP 階段的孿生風險；認知紀律（建構前驗證）和架構紀律（建構前持久化上下文）都是承重的
開放問題#
- 隨著程式碼庫演進，CLAUDE.md 能保持準確多久？該手冊提到逐 session 更新；沒有關於腐化速率的數據。
- 該解方假設創辦人能夠用白話表達架構。非技術創辦人（該手冊的主要受益群體）可能既缺乏詞彙也缺乏直覺來做好這件事——一個該手冊未處理的遞迴失敗。
- Anthropic 的 harness-shrinkage 論點暗示 CLAUDE.md 最終可能由模型自行推斷。在那之前，這個紀律是承重的。
相關連結#
- Code as Source of Truth — Fiona Fung 對抗此債務的正面方案：將規格/技能簽入版本庫，使上下文保持最新，Claude 可以驗證規格漂移，而非每次 session 重新推導
- Harness Shrinkage as Models Improve — CLAUDE.md 是一個 harness 資產，最終可能被推斷；在那之前，持久性上下文是對抗複利債務的解藥
- Founder as Agent Orchestrator — 遞迴問題：非技術創辦人可能缺乏撰寫有效 CLAUDE.md 的詞彙
資料來源#
- The Founder's Playbook: Building an AI-Native Startup — MVP Stage and Launch Stage chapters
Cited by 26
- Acceleration Whiplash
Faros 2026: AI floods a human-paced SDLC with output it can't absorb — throughput up (tasks +34%, epics +66%), quality…
- Addy Osmani
Engineering leader at Google (Chrome) and prolific author/educator; in 2026 writes a widely-read blog series on AI-assi…
- Agentic Work Systematization
OpenAI Codex study's 'systematization' margin: the shift from ad-hoc agent use (describe task → agent does it → done) t…
- AI as Primary Author
Faros 2026: the assistant→author threshold crossed without a deliberate decision, marked by AI-code acceptance rising 2…
- AI-Native Startup Lifecycle
Anthropic's May 2026 reframing of Idea/MVP/Launch/Scale assuming AI infrastructure: each stage's headcount/capital/skil…
- How AI-Native Startups Avoid Speed Becoming Strategic Debt
AI-native startup speed becomes strategic debt unless bounded by validated problem, written scope, persistent architect…
- Anthropic
AI safety company / vendor of Claude; mission-as-tiebreaker culture; ~30–40 PMs across teams; Mike Krieger leads Labs r…
- Claude Code
Anthropic's agentic coding product; created by Boris Cherny late 2024; TypeScript/React; CLI/desktop/web/mobile/IDE sur…
- Claude Code Best Practices
Anthropic's guide to effective Claude Code usage: context management, verification-driven development, explore→plan→cod…
- Code as Source of Truth
Docs go stale at high coding throughput; check specs/skills into the repo; onboard via Claude; spec-drift verification
- Context Window Smart Zone
Smart zone vs dumb zone (Dex Hardy / Matt Pocock): quadratic attention scaling, ~100K marker independent of advertised…
- Deep Modules for Agents
Ousterhout deep-vs-shallow modules applied to agent-friendly codebases; push-vs-pull instruction delivery; reviewer in…
- Design Concept Grilling
Matt Pocock's `grill-me` skill; reach Brooks "design concept" before any plan; counter to specs-to-code; PRD as destina…
- Founder as Agent Orchestrator
Founder role shift: less individual contributor, more orchestrator of specialized AI assistants; non-technical founders…
- Harness Shrinkage as Models Improve
Prompt scaffolding shrinks each model release; Cat Wu's pruning discipline; Boris Cherny "100 lines of code a year from…
- Loop Engineering
Replacing yourself as the agent's prompter by designing the system that prompts it: a recursive-goal loop built from fi…
- Matt Pocock
Independent AI-coding educator; built Sandcastle library; smart-zone/grill-me/tracer-bullets pedagogical framing; "bad…
- Startup & Founder
Map of Content for the startup-founder domain — 14 concepts. Curated entry point; see Home for all domains.
- Open Questions Backlog
_396 actionable open questions across 155 pages · 79 predictions · 9 notes · 21 in progress · 59 watching (entities), a…
- Orchestration vs Employee Framing: Reconciling the Founder's Playbook with HBR's Accountability Evidence
Reconciles the Founder's Playbook orchestration framings with HBR Kropp et al.'s accountability evidence; "orchestratio…
- Outsource Your Thinking, Not Your Understanding
"You can outsource your thinking but not your understanding"; understanding as the non-delegable human bottleneck; know…
- Problem-Solution Fit Discipline
Idea-stage thesis: three defenses against premature building (time, resources, belief friction) all eroded; AI as devil…
- Review as the Control Point
Agarwal et al. (CMU, arXiv 2607.07980): a 26-construct/67-relationship causal theory synthesized from 3,100 coded pract…
- Unknowns as the Agentic Bottleneck
Thariq Shihipar's map-vs-territory thesis: the gap between what you told the agent and what the work actually requires…
- Vibe Coding vs. Agentic Engineering
Vibe coding raises the floor (anyone builds); agentic engineering preserves the quality bar while going faster; ">10x a…
- Zero-Friction Scope Creep
MVP failure mode when agentic coding removes the cost-based forcing function against scope creep; antidote is written s…
Related articles
- Claude Code
Anthropic's agentic coding product; created by Boris Cherny late 2024; TypeScript/React; CLI/desktop/web/mobile/IDE sur…
- Harness Shrinkage as Models Improve
Prompt scaffolding shrinks each model release; Cat Wu's pruning discipline; Boris Cherny "100 lines of code a year from…
- Verification as the New Bottleneck
Fiona Fung: coding is no longer the bottleneck — verification, review, maintenance are; shift-left; TDD loses its tax;…
- AI Brain Fry
Kropp et al. 2026/03: mental fatigue from excessive AI oversight increases minor errors +11%, major errors +39%; cognit…
- Open Questions Backlog
_396 actionable open questions across 155 pages · 79 predictions · 9 notes · 21 in progress · 59 watching (entities), a…