把架構寫成 Steering，引導 AI Agent

AWS Hong Kong Summit 2026 · Developer Lounge 精華回顧 · 第 1 / 6 篇

AWS Magazine · 維多利亞港現場報導

現場：維多利亞港上，高金融遇見高科技

過去六十年，我見證了運算從 1960 年代的大型主機打卡紙，一路走到 2026 年的自主雲端 Agent。真正的典範轉移往往有一種氣味——在香港，那是手工義式咖啡香氣混著中央空調，再配上中環玻璃帷幕與維多利亞港天際線。

香港從不低聲細語談科技；資本與程式碼在這裡以同樣速度加速。AWS Hong Kong Summit 2026 於香港會議展覽中心（HKCEC）登場，整場大會的高轉速神經中樞，正是 Developer Lounge（開發者休憩區）。

在這裡，高科技基礎設施與香港奢華氣息正面碰撞。國際講者從福岡、東京、台北、新加坡飛來；掛著識別證、穿著訂製外套的工程師俯身在白板與筆電前。創投與新創創辦人在隔壁私人廂房，一邊喝凍奶茶與單一麥芽威士忌，一邊交換 term sheet，一邊算 GPU 燒錢速度與 runway，工程師則在台上辯論 agentic workflow。

+-----------------------------------------------------------------------------------+
AWS HONG KONG SUMMIT 2026: DEVELOPER LOUNGE

[ 維多利亞港景觀 ]  <-->  [ AWS 高科技 Lounge 與 Agentic 展示 ]
  - 高金融 / 創投                   - 機械鍵盤與白板
  - 新創交易談合作                   - 即時 Steering 與 CI/CD
  - 私人 VIP 晚宴                   - 國際講者（福岡到香港）
+-----------------------------------------------------------------------------------+

在這座充滿能量的 Lounge 中央，福岡工程師 Shiro Seike（@seike460）用 15 分鐘演講，徹底改寫了現場聽眾對 AI 輔助開發的想像。

關鍵洞見：Architecture as Steering

這場演講標題是 「Architecture as Steering: On-Ramp to AI-DLC」。Seike 丟出一句讓全場瞬間安靜的警告：

「你的 AI coding agent 會在所有測試都綠燈的情況下，悄悄穿越架構邊界。編譯器看不見。換更大模型也救不了——因為那條邊界從來沒有被寫下來。」

+-----------------------------------------------------------------------------------+
THE AI CODING AGENT PARADOX

1. [ Prompt / 需求 ] --> [ AI Agent（Bedrock / Claude Code）]
2. Agent 產生 TypeScript 程式碼
3. [ 自動化單元測試 ] --> 狀態：GREEN（PASS）編譯器很高興
4. 網域架構 --> BROKEN（基礎設施滲入核心網域）
+-----------------------------------------------------------------------------------+

講者簡介：社群養成的領導力

Shiro Seike 再度來到香港，對本地社群充滿感激；他延續先前在 AWS Community Day 與 JAWS-UG（日本 AWS 使用者社團）的參與。

欄位	講者資訊
姓名	Shiro Seike（`@seike460`）
公司	Fusic Co., Ltd.（日本福岡）
職稱	Principal Engineer / Evangelist
社群領導	JAWS DAYS 2026 Chair；JAWS-UG Fukuoka Leader
Builder 軌跡	AWS Community Builder（Serverless）
榮譽	AWS Ambassador；2026 與 2025 Japan AWS Top Engineer
認證	Cloud Practitioner、Solutions Architect Associate、Security Specialty、Solutions Architect Professional、DevOps Engineer Professional
公司標語	OSEKKAI × TECHNOLOGY （體貼出手 × 鋒利工程）

簡報： speakerdeck.com/seike460/architecture-as-steering-on-ramp-to-ai-dlc
GitHub 儲存庫：
github.com/awslabs/aidlc-workflows
github.com/fusic/architecture-as-steering

技術深拆：三個章節

第一章 — 診斷：編譯器說可以，邊界說不行

在 Developer Lounge 示範中，Seike 展示現代 AI 輔助工程常見失敗模式：AI coding agent 被要求實作訂單確認邏輯。產生的 TypeScript 編譯乾淨、測試全過，但核心網域模型已經被徹底破壞：

// packages/core/src/order/ConfirmOrder.ts
// THE DOMAIN LAYER
import { DynamoDBClient } from "@aws-sdk/client-dynamodb"; // X Infrastructure leaking into pure domain
import { Pool } from "pg";

export class ConfirmOrder {
  async run(id: string) {
    const order = await new Pool().query(/* ... */); // X Domain layer directly querying the Database
    if (!order) throw new Error("not found");        // X Raw exception throwing inside core domain

    order.status = "CONFIRMED"; // X Direct mutation of the aggregate state
  }
}

診斷清單

tsc（TypeScript Compiler）：乾淨（0 Errors）
vitest（測試執行器）：全綠
架構狀態：已毀損

動手現場檢查： 換成更大、更貴的模型（例如在 Amazon Bedrock 砸更多 token 預算）解決不了這題。AI agent 會為了綠燈測試與語法完成度而優化。若結構性架構規則沒有被明確寫下，agent 一定會越界。

第二章 — 處方：從痛點到可驗證，靠 Steering

什麼是 Steering？

Steering = AI agent 自己推不出來、必須明確寫下且可執行的架構規則。

與其依賴龐雜、無組織的 prompt，工程團隊應把嚴格邊界拆進區域化的 steering 檔案（例如根目錄 CLAUDE.md 與各關注點設定）：

核心保護： packages/core 不得包含 Node、HTTP、Database 或 AWS SDK 相依。
相依方向向內： 外層 adapter 依賴內層 core port；core 永不匯入外層。
乾淨介面合約： 公開 API 只透過 index.ts barrel file 暴露。

+-----------------------------------------------------------------------------------+
HEXAGONAL ARCHITECTURE DIRECTION

1. [ Outer Adapters: Web/HTTP, AWS SDK, PostgreSQL ]
      depends inward（相依向內）
2. [ Ports / Interfaces: Contract Definitions ]
      depends inward（相依向內）
3. [ Pure Core Domain: Zero NPM Runtime Dependencies ]
+-----------------------------------------------------------------------------------+

支柱 1：用 `dependency-cruiser` 在 CI 強制 Clean Architecture

// .dependency-cruiser.cjs
// Runs automatically in CI on every Pull Request
module.exports = {
  forbidden: [
    {
      name: "core-no-runtime-deps", // Core must not import npm modules or built-in runtimes
      severity: "error",
      from: { path: "^packages/core/src" },
      to: { dependencyTypesNot: ["local", "core"] }
    },
    {
      name: "core-no-workspace-import", // Core must not import outer workspace modules
      severity: "error",
      from: { path: "^packages/core/src" },
      to: { path: "^packages/(?!core/)" }
    }
  ]
};

支柱 2：六邊形 Port 與零 runtime 相依護欄

// Architectural Guardrail Test
it("core package.json has empty runtime dependencies", () => {
  const manifest = JSON.parse(read("packages/core/package.json"));
  expect(manifest.dependencies).toEqual({}); // PASS - Strictly enforced by design
});

支柱 3：用屬性測試守護 DDD 不變量

與其寫 agent 容易「應付過關」的靜態單元測試，屬性測試（property-based testing）可用 fast-check 自動產生數百種排列組合：

import * as fc from "fast-check";

const statusArb = fc.constantFrom(...ORDER_STATUSES);
const terminals = [OrderStatus.confirmed(), OrderStatus.cancelled()];

test("terminal orders cannot transition to any other status", () => {
  fc.assert(fc.property(statusArb, (n) =>
    terminals.every((s) => !s.canTransitionTo(OrderStatus.of(n)))
  ));
}); // Executes 100 random state checks per test run automatically

強制矩陣

架構關注點	`dependency-cruiser`	屬性 / Fitness 測試	AI 自動審查
Clean Architecture	✓ CI 閘道（主動錯誤）	部分（型別檢查 / Lint）	—
六邊形隔離	相依方向檢查	`deps: {}` 護欄測試	Guard Hook 整合
DDD 不變量	超出範圍	`fast-check` 屬性驗證	語意規則審查

程式輸出對照：Steering OFF vs. Steering ON

沒有 Steering（Steering OFF）：

// Mutates domain object directly and couples to database driver
import { Pool } from "pg";
order.status = "CONFIRMED";

啟用 Steering（Steering ON）：

// Returns an immutable Result object and persists strictly via domain ports
const r = order.confirm() // Returns immutable Result
  .asyncAndThen((o) => this.orders.save(o)); // Handled safely through abstract port

第三章 — 上坡道：與 AWS AI-DLC v2、Kiro 交會

AWS 已透過 AWS AI-DLC v2（AI Development Life Cycle）以及 Kiro IDE、Claude Code 等工具，對齊這套方法論。

// .kiro/.../tools/process-checker.js
// AWS AI-DLC v2 (MIT-0 License)
// Deterministically verifies artifact existence on disk rather than trusting LLM output

process.exit(failures.length === 0 ? 0 : 1);
// Exit Code 0: PASS
// Exit Code 1: FAIL (Missing required artifacts or unauthorized file modifications)

AI-DLC 實作階段

生命週期階段	目前狀態	說明
INCEPTION	活躍開發分支	初始階段建模與邊界定義（`main` 為穩定版）。
CONSTRUCTION	活躍扇出	將任務拆解成由 steering 規則治理的局部單元。
OPERATIONS	規劃中的未來階段	生產監控、執行期遙測與回饋迴路。

給開發者的三步驟行動計畫

今天（5 分鐘）： 在 CLAUDE.md 寫下第一條關鍵邊界，作為明確 Steering Rule。
本週： 把 dependency-cruiser 接進 CI pipeline，攔截非法匯入。
正式採用： Clone fusic/architecture-as-steering，並導入 awslabs/aidlc-workflows。

Developer Lounge 文化：錢、資本與程式碼

正式議程之外，Developer Lounge 也映照香港作為頂級國際創新樞紐的角色。

+-----------------------------------------------------------------------------------+
HONG KONG DEVELOPER LOUNGE & ECOSYSTEM VIBE

[ Global Builders ]  -->  福岡、東京、台北、香港在地科技人才
[ Tech Stack ]       -->  Amazon Bedrock、Kiro IDE、Claude Code、Serverless
[ Business Capital ] -->  新創提案、VC term sheet、私人聚會
[ Luxury Experience] -->  維港天際線、espresso bar、VIP lounge
+-----------------------------------------------------------------------------------+

資本速度： 新創創辦人與全球創投在咖啡旁碰面，直接從技術架構討論切到種子輪與 Series A。
私人技術聚會： 從銅鑼灣到中環的私人會議室裡，工程師深挖 Bedrock token 成本優化與 agentic workflow 護欄。
高科技彈性： 現場體驗 AWS 對自主軟體開發的願景——低摩擦開發，搭配可判定的安全檢查。

執行摘要與快速複製參考表

方便貼到內部開發入口或公司儀表板的摘要如下：

+-----------------------------------------------------------------------------------+
AWS SUMMIT HONG KONG 2026 - LOUNGE RECAP SUMMARY

活動               AWS Summit Hong Kong 2026（HKCEC）
焦點場次           Architecture as Steering: On-Ramp to AI-DLC
講者               Shiro Seike（@seike460）- AWS Ambassador / Fusic Co., Ltd.
核心問題           AI agent 測試全過，卻悄悄破壞網域邊界
解法               Steering = 以 CI 與屬性測試強制執行的可執行規則
關鍵工具           dependency-cruiser、fast-check、AWS AI-DLC v2、Kiro IDE
主要儲存庫         github.com/fusic/architecture-as-steering
                   github.com/awslabs/aidlc-workflows
+-----------------------------------------------------------------------------------+