엔지니어링 실천

결정은 기록으로 남습니다

25개 저장소에 걸친 337건의 아키텍처 결정 기록. 각각 영어와 중국어로 작성되며 맥락, 결정, 결과, 그리고 받아들인 트레이드오프를 명시합니다. 모든 제품이 이를 갖추고 있습니다. 어떤 시스템이 왜 그렇게 동작하는지 물으면, 답은 날짜가 찍힌 문서로 존재합니다.

대부분은 비공개 제품 저장소에 있습니다. 아래 세 인용은 링크가 아니라 원문 그대로입니다.

하나의 답, 한 곳에서만 계산

워커가 하나의 추천을 만들고, 요청 경로가 조금 다른 것을 다시 계산하고, 프런트엔드가 원시 필드에서 세 번째를 추론할 수 있습니다. 그렇게 되면 제품은 디버깅하기 어렵고 신뢰하기 쉽지 않습니다.

ADR-012 결정 캐시 경계 — Invest AI, 2026-05-20

그래서 정한 규칙: 결정 계산은 워커에서만 일어납니다. API는 캐시된 결정을 노출하고 오래됐다고 알릴 수 있지만, 요청 경로에서 만들거나 바꾸거나 고칠 수 없습니다. 어느 화면을 열었느냐에 따라 달라지는 투자 추천은 표시 버그가 아닙니다.

스스로 한계를 밝히는 방어

에이전트 방화벽의 성능은 가로채기 지점이 결정합니다. 에이전트가 정책 계층을 거치지 않고 셸, 파일시스템, 네트워크에 닿을 수 있다면 그 방화벽은 장식입니다.

ADR-001 가로채기 지점 — Agent Firewall, 2026-07-05

세 가지 아키텍처를 실제 제약과 견주어 비교하고 하나를 선택한 뒤, 빈틈은 고객이 발견하도록 두지 않고 문서에 적었습니다. v1은 속은 에이전트를 막지, 악의적인 로컬 사용자를 막지 않습니다. 이 문장은 ADR뿐 아니라 README에도 있습니다.

초록불이 뜻하지 않는 것을 밝히기

그 지표가 적절한지, 데이터셋이 대표성이 있는지, 표본이 차이를 성립시킬 만큼 큰지는 알려주지 못합니다.

Eval Registry — 자체 회귀 게이트에 대하여

릴리스를 막을 수 있는 평가 게이트의 신뢰도는 그 뒤의 지표를 넘지 못합니다. 이를 기능 바로 옆에 분명히 적는 것이, 벤치마크와 구매 심사에서 되돌아와 인용될 숫자 사이의 차이입니다.

전문을 읽을 수 있는 것

제품 저장소는 비공개지만, 우리를 평가하는 데 중요한 엔지니어링 표면은 공개되어 있습니다:

• xingai-eval-registry — 평가 레지스트리와 회귀 게이트, 위에 인용한 한계 설명 포함
• xingai-enterprise-ai-pocs — 엔터프라이즈 PoC — MCP 게이트웨이, 가드레일 모니터링, 클레임 워크플로 재설계
• xingai-enterprise-ai-design — 에이전트 거버넌스, 프로덕션 MCP, 루프 엔지니어링에 대한 18편의 글

이 수준이 필요하다면

유용한 대화는 대개 구체적입니다. 곧 고객 앞에 내놓을 에이전트, 아무도 감사하지 않은 MCP 표면, 화면마다 다른 답을 주는 결정 경로. 요구사항 문서 말고 그것을 가져오세요.

기술 대화 시작하기