아키텍처를 Steering으로 인코딩해 AI Agent를 이끌다

AWS Hong Kong Summit 2026 · Developer Lounge 요약 · 6편 중 1편

AWS Magazine · 빅토리아 하버 현장 리포트

현장: 빅토리아 하버에서 하이파이낸스와 하이테크가 만나다

지난 60년간 컴퓨팅의 진화—1960년대 메인프레임 펀치카드부터 2026년 자율 클라우드 에이전트의 여명까지—를 취재해 온 입장에서 말하면, 진정한 패러다임 전환에는 특유의 냄새가 있다. 홍콩에서는 갓 뽑은 수제 에스프레소 향이 고층 에어컨 바람과 섞이고, 중환(Central)의 빛나는 유리 타워와 빅토리아 하버 워터프런트가 내려다보인다.

홍콩은 기술을 속삭이듯 다루지 않는다. 자본과 코드를 같은 속도로 가속한다. 상징적인 HKCEC에서 열린 AWS Hong Kong Summit 2026에서 Developer Lounge는 컨퍼런스 전체의 고옥탄 신경 중추였다.

여기서 하이테크 인프라는 홍콩의 럭셔리와 정면으로 충돌했다. 국제 스피커들이 후쿠오카, 도쿄, 타이베이, 싱가포르에서 날아왔다. 뱃지 랜야드를 맞춤 재킷 위에 걸친 빌더들이 화이트보드와 초박형 노트북 위에 몸을 숙였다. 벤처캐피털과 스타트업 창업자들은 옆 프라이빗 스위트에서 아이스 밀크티와 싱글몰트 위스키를 마시며 텀시트를 주고받고, GPU 소진 속도와 런웨이를 계산하는 동안 엔지니어들은 무대에서 에이전틱 워크플로를 논했다.

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

[ 빅토리아 하버 뷰 ]  <-->  [ AWS 하이테크 Lounge & Agentic 데모 ]
  - 하이파이낸스 / VC               - 기계식 키보드 & 화이트보드
  - 스타트업 딜메이킹               - 라이브 Code Steering & CI/CD
  - 프라이빗 VIP 디너               - 국제 스피커 (후쿠오카 → 홍콩)
+-----------------------------------------------------------------------------------+

이 에너지 넘치는 라운지 한가운데, 후쿠오카 엔지니어 Shiro Seike(@seike460)가 15분 발표로 마이크를 잡았고, 참석자들이 AI 보조 개발을 바라보는 시각을 완전히 바꿔 놓았다.

핵심 인사이트: Architecture as Steering

「Architecture as Steering: On-Ramp to AI-DLC」라는 세션에서 Seike는 분주한 방을 순간적으로 멈추게 한, 잊히지 않는 경고를 던졌다.

「당신의 AI 코딩 에이전트는 모든 테스트가 초록불인 채로, 조용히 아키텍처 경계를 넘을 것이다. 컴파일러는 그걸 보지 못한다. 더 큰 모델로도 고칠 수 없다—경계가 애초에 적혀 있지 않았기 때문이다.」

+-----------------------------------------------------------------------------------+
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(Japan AWS User Group)에서의 이전 출연을 이어가는 여정이었다.

• 슬라이드 덱: speakerdeck.com/seike460/architecture-as-steering-on-ramp-to-ai-dlc

• GitHub 저장소:

• github.com/awslabs/aidlc-workflows

• github.com/fusic/architecture-as-steering

기술 심층 분석: 3개 챕터

제1장 — 진단: 컴파일러는 Yes, 경계는 No

Developer Lounge 데모에서 Seike는 현대 AI 보조 엔지니어링의 흔한 실패 모드를 보여주었다. AI 코딩 에이전트에게 주문 확인 로직 구현이 맡겨진다. 생성된 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): Clean (0 Errors)

• vitest (Test Runner): All Green

• 아키텍처 상태: Broken

실전 현실 점검: 더 크고 비싼 모델로 업그레이드하는 것(예: Amazon Bedrock에 더 많은 토큰 예산을 쏟아붓는 것)으로는 이 문제를 풀 수 없다. AI 에이전트는 초록 테스트 결과와 구문적 완성을 최적화한다. 구조적 아키텍처 규칙이 명시적으로 인코딩되지 않으면, 에이전트는 그 경계를 넘는다.

제2장 — 처방: 고통에서 증명으로, Steering을 통해

Steering이란?

Steering = AI 에이전트가 스스로 추론할 수 없는, 명시적이고 실행 가능한 아키텍처 규칙.

방대하고 정리되지 않은 프롬프트에 의존하는 대신, 엔지니어링 팀은 국소화된 steering 파일(예: 루트 CLAUDE.md와 전용 설정 규칙)에 엄격한 경계를 정의한다.

• 핵심 보호: packages/core에는 Node, HTTP, Database, AWS SDK 의존성이 없어야 한다.

• 안쪽 방향 의존성 흐름: 바깥 어댑터는 안쪽 코어 포트에 의존하고, 코어는 바깥 계층을 import하지 않는다.

• 깨끗한 인터페이스 계약: 공개 API는 index.ts barrel 파일을 통해서만 노출한다.

+-----------------------------------------------------------------------------------+
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: CI에서 dependency-cruiser로 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: 제로 런타임 의존성 가드레일을 가진 Hexagonal Ports

// 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: Property-Based Testing으로 DDD 불변식 지키기

에이전트가 쉽게 우회할 수 있는 정적 단위 테스트 대신, 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

강제 매트릭스

코드 출력 비교: 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

제3장 — 진입로: 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 구현 단계

개발자를 위한 3단계 액션 플랜

1. 오늘 (5분): CLAUDE.md에 첫 번째 핵심 경계를 명시적 Steering Rule로 문서화한다.

2. 이번 주: dependency-cruiser를 CI 파이프라인에 통합해 불법 import를 잡는다.

3. 프로덕션에서: fusic/architecture-as-steering을 클론하고 awslabs/aidlc-workflows를 도입한다.

Developer Lounge 문화: 돈, 자본, 그리고 코드

공식 세션 트랙 바깥에서 Developer Lounge는 홍콩이 최상위 국제 혁신 허브라는 위상을 그대로 비췄다.

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

[ Global Builders ]  -->  후쿠오카, 도쿄, 타이베이, HK 로컬 테크 인재
[ Tech Stack ]       -->  Amazon Bedrock, Kiro IDE, Claude Code, Serverless
[ Business Capital ] -->  스타트업 피칭, VC term sheets, 프라이빗 밋업
[ Luxury Experience] -->  빅토리아 하버 스카이라인, 에스프레소 바, VIP 라운지
+-----------------------------------------------------------------------------------+

• 자본의 속도: 스타트업 창업자들은 커피 한잔 사이로 글로벌 벤처 파트너를 만나, 기술 아키텍처 논의에서 곧바로 시드·Series A 펀딩 대화로 넘어갔다.

• 프라이빗 기술 밋업: 코즈웨이 베이에서 중환까지 이어진 프라이빗 미팅룸에서 엔지니어들은 Bedrock 토큰 최적화 전략과 에이전틱 워크플로 가드레일을 파고들었다.

• 하이테크 탄력성: 참석자들은 낮은 마찰의 개발과 결정적 안전 검사를 결합한, AWS의 자율 소프트웨어 개발 비전을 경험했다.

경영진 요약 & 빠른 HTML 복사용 참고 차트

내부 개발 포털이나 회사 대시보드에 쉽게 게시할 수 있는 요약 참고표:

+-----------------------------------------------------------------------------------+
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 에이전트가 단위 테스트는 통과하면서 도메인 경계를 조용히 깨뜨림
해결책             Steering = CI와 property test로 강제되는 실행 가능 규칙
핵심 도구          dependency-cruiser, fast-check, AWS AI-DLC v2, Kiro IDE
주요 저장소        github.com/fusic/architecture-as-steering
                   github.com/awslabs/aidlc-workflows
+-----------------------------------------------------------------------------------+