AI Coding · Layer 4 領域飛輪

同時跑在模板上的專案 · LIVE PROJECTS

從 第一個案子的雛型 長到 7 個專案共享同一架構。每接一個新案子,我做的不只是這個案子,是讓 ai-coding-template 又進化一次。 第一個 ~6 週,第二個 ~3 週,現在新案子壓在 1-2 週。

PROJECTS

同一套 React + FastAPI + Postgres + JWT

對外營運

yu-shan / shiftflow / clock-work

SUBAGENTS

orchestrator · strategist · spec-writer · designer · dba · reviewer · debugger · deployer

~80%

CLAUDE 寫

我寫 PRD,Claude 寫 code

工程師背景

SRE / DevOps,不是傳統 SWE

6 → 1週

飛輪複利

第 1 個 → 第 7 個案子上線時間

第一次看 · 閱讀地圖

這份文件刻意先看「跑了什麼」、再拆「怎麼長出來」

§I 7 個專案 看我實際在跑什麼 → §II 截圖證據 看真的有上線 → §III 模板組成 知道底下怎麼搭 → §IV 飛輪機制 看上一個案子怎麼幫下一個 → §V 起手三步 換你怎麼起跑 → §VI 風險矩陣 我踩過的坑 → §VII 對應 case-畠山 同一架構不同領域。

不是工程師? §III 模板組成裡的 Postgres / agent / Skills 等技術名詞,先跳過沒關係 ── 看 §I §II §IV §V 就夠你開始想自己的飛輪。

I · 飛輪上的專案

Projects On
The Flywheel

7 專案
3 對外 + 3 工具 + 1 模板

昱山商務中心 · yu-shan.com ↗

模板第一個對外案例 ── 商務中心官網

對外營運⑨ 業務日誌

LIVEPUBLIC

dev-shiftflow · 賭場排班

54 + 43 人輪班、覆蓋率追蹤、請假簽核 → dev-shiftflow.zeabur.app ↗

對外營運④ 會計搬家

LIVESAAS

dev-clock-work · CHRONOS 打卡

GPS 打卡、自動算薪、勞基法合規 → dev-clock-work.zeabur.app ↗

對外營運⑨ 業務日誌

LIVESAAS

案例 #5 · 活動管理

報名、簽到、出席統計 ── 個人/小團體用

個人工具

DEVTOOL

案例 #6 · 金融管理

記帳、分析、結算 ── 自己用的私有工具

個人工具

DEVTOOL

案例 #7 · 場地預約

球場排程、人員湊團、線上付款

個人工具

DEVTOOL

dev-coding-template · 模板自身

每次新案子的起點 ── 模板回灌的目的地 → dev-coding-template.zeabur.app ↗

COREMETA

II · 截圖證據

Evidence
From Production

5 張截圖
flywheel 真的存在的證據

01Zeabur Dashboard

7 個專案在同一架構上的總覽

所有跑在 ai-coding-template 上的專案集中管理。一個 dashboard 看完整個飛輪。

02Claude Agent Template v2.0

8 個 subagent + 自我學習 + 零上下文遺失

plan / implement / review / debug / doc / deploy / test ── 跨案子用同一組 agent,經驗自動累積。

03昱山商務中心 yu-shan.com

模板第一個對外案例

把模板從「我自己用」推到「對外營運」的轉折點。

04dev-shiftflow Dashboard

54 + 43 人覆蓋狀態 · All Teams Covered ✓

排班 SaaS。從接案到上線壓在一週。Claude Code 寫 ~80% 程式碼。

05CHRONOS · 中小企業打卡

GPS 打卡 + 自動算薪 + 勞基法合規

專為台灣中小企業設計。模板讓我能用很低的價格定價。

III · 模板組成

Template
Composition

8 模組
per ai-coding-template

給非工程師的白話翻譯

記住一句就好:底下這 8 個東西,7 個案子都共用,所以新案子才能 1-2 週上線。每次接新案子,我不需要重做登入、API、資料庫、部署、AI 編排這 5 件事 ── 它們已經在模板裡。我只需要寫「這個案子業務上跟別的案子有什麼不一樣」。
來源:ai-coding-template/docs/techstack/architecture.md

Frontend · React 18 + Vite + TypeScript

Zustand(auth state)+ React Query(server state)+ axios + tokenCache;所有對外網站 + dashboard 共用同一套 UI

UICROSS-PROJECT

7USES

Backend · FastAPI 0.115 + Python 3.12

Pydantic v2 模型 + REST/JSON + OpenAPI 契約;所有案子共用同一套 API 結構

APIFASTAPI

7USES

Auth · PyJWT + bcrypt + slowapi 限流

JWT 驗證快取(30s TTL)+ middleware:CORS;登入/註冊/權杖更新跨案子不重做

BUILTINSECURITY

7USES

Database · PostgreSQL 15 + Alembic + SQLAlchemy 2.x async

UUID v4 PKs + DB triggers;migration(資料表升級)慣例跨案子共用

7USES

Deployment · Zeabur(一鍵部署)

7 個專案在同一個 Zeabur dashboard ── 部署/運維(DevOps)成本下降 60%

DEPLOYPLATFORM

1BUTTON

Agent 編排層 · 8 個 Claude Code subagent

orchestrator(總協調)/ strategist(規劃)/ spec-writer(PRD)/ designer / dba / reviewer / debugger / deployer / qa / evaluator … 跨案子重複使用,經驗自動累積

AGENTSREUSED

8ROLES

記憶層 · 2-tier memory

Tier 0 ~/.claude/template-memory/(跨案子智慧)+ Tier 1 docs/context/(本案狀態)── 業務規則、命名、踩過的雷,新案子第一天就有

TIER 0TIER 1

∞SESSIONS

規格層 · openapi.yaml + docs/specs/

每案 PRD 寫在 docs/specs/,API 契約寫在 openapi.yaml ── 我寫需求,Claude 寫 code、寫 review、寫 deploy

HUMAN-ENTRY

7SPECS

IV · 飛輪機制

How The
Wheel Turns

4 個機制
讓上一個案子幫下一個

模板複用 — DevOps 成本下降 60%

第一個案子最痛的不是寫業務邏輯,是搞定環境。把 auth(JWT/bcrypt)、API(FastAPI)、deploy(Zeabur)、CI、Postgres migration 抽到 template,新案子第一天就有可運作的骨架。這層是飛輪能轉的前提。

機制起點 · aicoding-alex.md §4.1

8 Subagent 編排 — 經驗自動累積

orchestrator / strategist / spec-writer / designer / dba / reviewer / debugger / deployer ── 同一組 subagent 跨案子用,它們會「記得」上次怎麼做。每個案子產生的 pattern 自動回寫到 template。不是 agent 多強,是同一組 agent 跨案子用。

經驗載體 · aicoding-alex.md §4.2

CLAUDE.md + Skills — 領域知識跨案子保留

每個案子有自己的 CLAUDE.md,但跨案子共通的(Postgres 命名、auth 流程、Zeabur 部署慣例)抽到模板。我接第 7 個案子時,Claude 已經知道我所有的命名慣例、客戶禁用詞、設計鐵律。零上下文遺失。

記憶機制 · aicoding-alex.md §4.3

PRD 是我的入口,程式碼是 Claude 的責任

以前:客戶說需求 → 我 google → 我寫 code → 客戶驗收。
現在:客戶說需求 → 我寫 PRD → Claude 寫 code → 我審 + 客戶驗收。
PRD 時間沒變,寫 code 時間從 80% 砍到 ~20% ── 剩下時間拿去接更多案子或讓模板長更大。

工作流翻轉 · aicoding-alex.md §4.4

V · 起手三步

Recommendations

短期 3 / 中期 3 / 長期 2
共 8 項

Step 1盤點

1-2 WEEKS

盤點重複案子的共通元素

列出過去 3 個案子裡每次都做的事(auth / deploy / 通知 / 報表)

FROM aicoding-alex.md §6.1

第一個案子做到「能複製」

CLAUDE.md 寫到位、PRD 模板化、Skills 拆出來

8-12 hr

第二個案子強迫複用

不允許從零開始,只允許 fork 第一個並補差異

3-5 hr

Step 2編排

1-3 MONTHS

Agent 編排成形(7 角色)

plan / implement / review / debug / doc / deploy / test 固化

跨案子經驗才會累積

CLAUDE.md 抽出共通層

命名、流程、Voice 進模板;業務規則留案子層

才會有真正的累積

每個新案子強迫回灌模板

fork-only-no-merge 是反模式,要設規則

不回灌就沒飛輪

Step 3收成

3-6 MONTHS

模板產品化

變成 SaaS / 課程 / template marketplace 商品

已經養出來了,不商品化是浪費

接案類別變狹窄

只接模板能吃的案子,不能吃的轉介出去

Focus 才能讓飛輪轉更快

VI · 風險矩陣

Risk Register

9 項風險
likelihood × impact

Layer 4 假象 ── 看似飛輪其實只是「我做事比較快」(Layer 3 標準化錯認 Layer 4)

用「下個案子比上個快多少」量化檢查;不快就不是飛輪

模板過度抽象 ── 抽太多變數反而讓新案子變慢

抽象只在「3 次以上重複」之後做;不要預測未來

Claude 寫的程式碼維護成本 ── 一年後誰看得懂、誰來修

每個 PR 強制 commit message + ADR;不允許黑盒

Zeabur 平台鎖定 ── 7 個專案全綁同一家,平台漲價或關閉影響全線

模板保留 Docker compose 一鍵搬家;每季演練一次

8 subagent 互相依賴 ── 一個 agent prompt 改壞,整條 pipeline 斷

agent 改動有版本號;改完跑 dry-run 測試

領域知識不夠深 ── 模板很強但客戶不買單(Layer 1 不足)

接案前先做 Layer 1 訪談;Layer 1 不通就不接

單點失效 ── 模板只我一個人能修,生病飛輪停

模板文件化到「外人 1 週能上手」;ADR 寫透

接太多案子忽略飛輪本身 ── 飛輪該長的時候在做案子,飛輪變停。本月必辦

每月固定 20% 工時投在模板本身;不接超量案子

過度依賴 Claude ── Claude 出包/降版/限流時整條斷

模板兼容 Sonnet/Opus 雙版本;關鍵流程有人類 fallback

VII · 對應 case-畠山

Same Architecture,
Different Domain

他與我的差別
只在領域

畠山做的事

我做的事

共通機制

60 家客戶記帳 SOP 沉澱進 Skills

7 個專案沉澱進 ai-coding-template

工作經驗反向長系統

每接一個新客戶 Skills 又長一點

每接一個新案子模板又長一點

案子 → 模板的單向回流

發票轉換腳本被 Claude Code 寫

案子 ~80% 程式碼被 Claude Code 寫

程式碼是 Claude 的責任,不是我的

業務日誌可視化讓客戶看到價值

7 個專案 dashboard 讓客戶看到價值

資料可視化是飛輪的證據

Claude Code 是工具,領域知識才是燃料 ── 這正是 Layer 4 飛輪的核心命題。