Code, history, PR, CI, Spec, Work Packet, Release Evidence
사람용 설명
Desktop Commander
승인된 개발 서버 직접 감사
장기 프로젝트 기록
Athena
결정 이유와 여러 프로젝트의 이력 검색
현재 실행 상태, 릴리스 검증 결과
Engineering System
공통 engineering/AI 표준
제품별 기능 정의
Engineering System Docs
사람이 읽는 설명서
실제 적용 규칙
시스템 계층
사람이 읽는 홈페이지나 Athena는 이해와 검색을 돕습니다. 하지만 실제 제품 상태나 릴리즈 판정은 GitHub와 실행된 evidence가 우선합니다.
충돌 시 우선순위
이 순서를 정해두면 오래된 채팅이나 로드맵이 현재 제품 상태를 덮어쓰는 일을 막을 수 있습니다.
두 repository의 역할
datarelay-labs/engineering-systemCanonical / machine-consumed repository입니다. 표준, adapter, template, validation, /resume, session continuity rule이 여기에 있습니다.datarelay-labs/engineering-system-docs사람이 읽는 handbook입니다. 왜 이런 구조가 되었는지, 실제로 어떻게 사용하는지, 어떤 문제가 개선되었는지를 설명합니다.
두 문서가 충돌하면 항상 canonical engineering-system repository를 따릅니다.
Project-local Adoption
기본 Engineering System 적용에 필요한 저장소 시작 지점은 다음 네 가지입니다.
AI Work Packet Issue 템플릿은 구현 권한과 continuity의 기본 surface입니다. .cursor/commands/resume.md 같은 Cursor 파일은 managed compatibility adapter로 남을 수 있지만 기본적으로 비활성화되며, 현재 packet의 명시적 opt-in 없이는 실행 권한을 만들지 않습니다.저장소 안에 Engineering System 전체를 복사하지 않고 사용할 버전과 기준 SHA만 고정해 참조합니다.
마지막 수정일 2026년 9월 29일
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DataRelay Engineering","description":"A practical ChatGPT-primary engineering workflow built around GitHub, direct development-server verification, repository-scoped Work Packets, and optional Cursor compatibility.","colors":{"primary":"#C2410C","light":"#FB923C","dark":"#C75A00"},"logo":{"light":"https://mintcdn.com/dr-engineering/aIxcUnNVKBW-uhCs/assets/engineering-system-logo-light.svg?fit=max\u0026auto=format\u0026n=aIxcUnNVKBW-uhCs\u0026q=85\u0026s=4eea847a0de1189aa3d4c130b4b235ac","dark":"https://mintcdn.com/dr-engineering/aIxcUnNVKBW-uhCs/assets/engineering-system-logo-dark.svg?fit=max\u0026auto=format\u0026n=aIxcUnNVKBW-uhCs\u0026q=85\u0026s=a964792dd67aa81592a5b4fcab08b3fa"},"favicon":"https://mintcdn.com/dr-engineering/aIxcUnNVKBW-uhCs/assets/engineering-system-favicon.svg?fit=max\u0026auto=format\u0026n=aIxcUnNVKBW-uhCs\u0026q=85\u0026s=3eb7aeadcf2b3c35d9b19665fd00c160","appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://datarelay.run/","label":"DataRelay"},{"href":"https://link.datarelay.run/","label":"Link"},{"href":"https://control.datarelay.run/","label":"Control"},{"href":"https://grant.datarelay.run/","label":"Grant"},{"href":"https://engineering.datarelay.run/","label":"Engineering"},{"href":"https://github.com/datarelay-labs/engineering-system","type":"github"}]},"search":{"prompt":"Search the Engineering System..."},"seo":{"metatags":{"canonical":"https://engineering.datarelay.run"},"indexing":"navigable"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dr-engineering","hasAudioNarration":false,"actualSubdomain":"dr-engineering","customDomains":["engineering.datarelay.run"],"gitSource":{"type":"github","owner":"datarelay-labs","repo":"engineering-system-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac3a2e7df7cd18a438cdb4e","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"en","tag":"System","count":6},{"language":"ko","tag":"시스템","count":6},{"language":"en","tag":"Start Here","count":4},{"language":"ko","tag":"시작하기","count":4},{"language":"en","tag":"Adoption \u0026 Lessons","count":2},{"language":"ko","tag":"도입 및 개선 과정","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--dr-brand: #C2410C;--dr-brand-hover: #9A3412;--dr-brand-soft: #FFF7ED;--dr-product-accent: #1D4ED8;--dr-bg: #FFFFFF;--dr-surface: #FFFFFF;--dr-surface-subtle: #FAFAF9;--dr-ink: #1C1917;--dr-muted: #57534E;--dr-border: #E7E5E4;--dr-border-strong: #D6D3D1;--dr-shadow-sm: 0 1px 2px rgb(28 25 23 / 0.05);--dr-shadow-md: 0 14px 34px rgb(28 25 23 / 0.09);--dr-radius-sm: 10px;--dr-radius-md: 16px;--dr-radius-lg: 24px}.dark{--dr-brand: #FB923C;--dr-brand-hover: #FDBA74;--dr-brand-soft: #2A160D;--dr-product-accent: #60A5FA;--dr-bg: #0C0A09;--dr-surface: #141210;--dr-surface-subtle: #1C1917;--dr-ink: #FAFAF9;--dr-muted: #C7C2BC;--dr-border: #292524;--dr-border-strong: #44403C;--dr-shadow-sm: 0 1px 2px rgb(0 0 0 / 0.25);--dr-shadow-md: 0 18px 42px rgb(0 0 0 / 0.32)}html{scroll-behavior:smooth}body{color:var(--dr-ink);text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased}#navbar-transition{background:rgb(255 255 255 / 0.9)!important;border-color:rgb(120 113 108 / 0.16)!important;backdrop-filter:blur(16px) saturate(150%);-webkit-backdrop-filter:blur(16px) saturate(150%)}.dark #navbar-transition{background:rgb(12 10 9 / 0.88)!important;border-color:rgb(231 229 228 / 0.1)!important}.nav-logo{height:2rem!important}main h1{color:var(--dr-ink);letter-spacing:-0.038em;font-weight:760;line-height:1.08}main h2{color:var(--dr-ink);letter-spacing:-0.025em;font-weight:700}main h3{letter-spacing:-0.015em}main p,main li{line-height:1.72}main blockquote{border-left:3px solid var(--dr-product-accent)!important;background:var(--dr-surface-subtle);border-radius:0 var(--dr-radius-sm) var(--dr-radius-sm) 0;padding:0.8rem 1rem}main pre{border:1px solid var(--dr-border)!important;border-radius:var(--dr-radius-md)!important;box-shadow:var(--dr-shadow-sm)}main table{border-color:var(--dr-border)!important;border-radius:var(--dr-radius-sm)}.dr-hero-kicker{display:inline-flex;align-items:center;gap:0.5rem;margin:0 0 1rem;padding:0.42rem 0.7rem;border:1px solid #FED7AA;border-radius:999px;background:#FFF7ED;color:#9A3412;font-size:0.72rem;font-weight:760;letter-spacing:0.12em;text-transform:uppercase}.dark .dr-hero-kicker{border-color:#7C2D12;background:#2A160D;color:#FDBA74}.dr-hero-kicker+h1{max-width:950px;margin-top:0!important;font-size:clamp(2.7rem, 6vw, 4.85rem)!important;line-height:0.98!important;letter-spacing:-0.055em!important}.dr-hero-actions{display:flex;flex-wrap:wrap;gap:0.7rem;margin:1.55rem 0 1.35rem}.dr-button{display:inline-flex;min-height:2.75rem;align-items:center;justify-content:center;border-radius:0.72rem;padding:0.68rem 1rem;border:1px solid transparent;font-size:0.9rem;font-weight:680;line-height:1;text-decoration:none!important;transition:transform 150ms ease, border-color 150ms ease, background-color 150ms ease, box-shadow 150ms ease}.dr-button:hover{transform:translateY(-1px)}.dr-button-primary{background:var(--dr-brand);color:#FFFFFF!important;box-shadow:0 6px 18px rgb(194 65 12 / 0.2)}.dr-button-primary:hover{background:var(--dr-brand-hover)}.dark .dr-button-primary{color:#1C1917!important}.dr-button-secondary{background:var(--dr-surface);color:var(--dr-ink)!important;border-color:var(--dr-border-strong);box-shadow:var(--dr-shadow-sm)}.dr-button-secondary:hover{border-color:var(--dr-product-accent)}.dr-family-strip{display:flex;align-items:center;gap:0.35rem;margin:0 0 2rem;padding:0.4rem;width:fit-content;max-width:100%;overflow-x:auto;border:1px solid var(--dr-border);border-radius:0.85rem;background:var(--dr-surface-subtle);scrollbar-width:none}.dr-family-strip::-webkit-scrollbar{display:none}.dr-family-strip a,.dr-family-strip .dr-family-current{display:inline-flex;align-items:center;min-height:2rem;padding:0.42rem 0.68rem;border-radius:0.56rem;white-space:nowrap;color:var(--dr-muted)!important;font-size:0.78rem;font-weight:650;text-decoration:none!important}.dr-family-strip a:hover{color:var(--dr-ink)!important;background:var(--dr-surface)}.dr-family-strip .dr-family-current{color:#FFFFFF!important;background:var(--dr-product-accent);box-shadow:var(--dr-shadow-sm)}.dark .dr-family-strip .dr-family-current{color:#0C0A09!important}.card{border-color:var(--dr-border)!important;border-radius:var(--dr-radius-md)!important;background:var(--dr-surface)!important;box-shadow:var(--dr-shadow-sm);transition:transform 160ms ease, box-shadow 160ms ease, border-color 160ms ease!important}.card:hover{transform:translateY(-2px);border-color:var(--dr-product-accent)!important;box-shadow:var(--dr-shadow-md)}[data-component-part=\"card-title\"]{letter-spacing:-0.012em}[data-component-part=\"card-icon\"]{color:var(--dr-product-accent)!important}.callout{border-radius:var(--dr-radius-md)!important}footer{border-top-color:var(--dr-border)!important}:where(a,button,input,select,textarea):focus-visible{outline:3px solid var(--dr-product-accent)!important;outline-offset:3px!important}@media (max-width: 768px){.dr-hero-kicker+h1{font-size:clamp(2.35rem, 13vw, 3.55rem)!important}.dr-hero-actions{display:grid;grid-template-columns:1fr}.dr-button{width:100%}.dr-family-strip{width:100%}}@media (prefers-reduced-motion: reduce){html{scroll-behavior:auto}.dr-button,.card{transition:none!important}.dr-button:hover,.card:hover{transform:none}}"}],"page":{"pagePath":"ko/architecture","slug":"/ko/architecture","pageMetadata":{"title":"시스템 아키텍처","description":"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.","href":"/ko/architecture"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`시스템-아키텍처`,children:`시스템 아키텍처`}),`\n`,_jsx(_components.p,{children:`핵심은 각 도구에 역할을 분리하는 것입니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`역할-분담`,children:`역할 분담`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`구성요소`}),_jsx(_components.th,{children:`주 역할`}),_jsx(_components.th,{children:`진실로 사용하지 않는 것`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Owner`}),_jsx(_components.td,{children:`제품 요구사항, scope, 최종 결정, release 승인, human UX 판단`}),_jsx(_components.td,{children:`명시적으로 결정하지 않은 구현 세부사항`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`ChatGPT`}),_jsx(_components.td,{children:`요구사항, 아키텍처, 설계, 문서, 기본 코드 구현, affected test, 리뷰, 감사와 조정`}),_jsx(_components.td,{children:`최신 Git 상태는 직접 재확인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cursor`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`IMPLEMENTER=CURSOR`}),`가 명시된 packet의 선택적 호환 구현`]}),_jsx(_components.td,{children:`기본 구현 권한`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Automation / CI`}),_jsx(_components.td,{children:`deterministic validation, security/performance gate, artifact verification`}),_jsx(_components.td,{children:`제품 의도`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GitHub`}),_jsx(_components.td,{children:`Code, history, PR, CI, Spec, Work Packet, Release Evidence`}),_jsx(_components.td,{children:`사람용 설명`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Desktop Commander`}),_jsx(_components.td,{children:`승인된 개발 서버 직접 감사`}),_jsx(_components.td,{children:`장기 프로젝트 기록`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Athena`}),_jsx(_components.td,{children:`결정 이유와 여러 프로젝트의 이력 검색`}),_jsx(_components.td,{children:`현재 실행 상태, 릴리스 검증 결과`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Engineering System`}),_jsx(_components.td,{children:`공통 engineering/AI 표준`}),_jsx(_components.td,{children:`제품별 기능 정의`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Engineering System Docs`}),_jsx(_components.td,{children:`사람이 읽는 설명서`}),_jsx(_components.td,{children:`실제 적용 규칙`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`시스템-계층`,children:`시스템 계층`}),`\n`,_jsx(Mermaid,{chart:`flowchart TB\n H[\"Human Layer\u003cbr/>engineering.datarelay.run\"]\n K[\"Knowledge Layer\u003cbr/>Athena\"]\n C[\"Coordination Layer\u003cbr/>AI Work Packet\"]\n N[\"Normative Layer\u003cbr/>GitHub Code · Spec · Test · CI\"]\n X[\"Execution Layer\u003cbr/>ChatGPT · Dev Server · Runtime\"]\n\n H --> N\n K --> N\n C --> N\n X --> N\n N --> X`}),`\n`,_jsx(_components.p,{children:`사람이 읽는 홈페이지나 Athena는 이해와 검색을 돕습니다. 하지만 실제 제품 상태나 릴리즈 판정은 GitHub와 실행된 evidence가 우선합니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`충돌-시-우선순위`,children:`충돌 시 우선순위`}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[\"1. 실제 Code / Config / Schema / Runtime / Git\"] --> B[\"2. Canonical Product Spec\"]\n B --> C[\"3. Repository Engineering Metadata\"]\n C --> D[\"4. 실행된 Test / CI Evidence\"]\n D --> E[\"5. AI Work Packet\"]\n E --> F[\"6. Athena / Derived Docs\"]\n F --> G[\"7. Conversation History\"]`}),`\n`,_jsx(_components.p,{children:`이 순서를 정해두면 오래된 채팅이나 로드맵이 현재 제품 상태를 덮어쓰는 일을 막을 수 있습니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`두-repository의-역할`,children:`두 repository의 역할`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`datarelay-labs/engineering-system`})}),`\n`,_jsx(_components.p,{children:`Canonical / machine-consumed repository입니다. 표준, adapter, template, validation, /resume, session continuity rule이 여기에 있습니다.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`datarelay-labs/engineering-system-docs`})}),`\n`,_jsx(_components.p,{children:`사람이 읽는 handbook입니다. 왜 이런 구조가 되었는지, 실제로 어떻게 사용하는지, 어떤 문제가 개선되었는지를 설명합니다.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`두 문서가 충돌하면 항상 canonical engineering-system repository를 따릅니다.`})}),`\n`,_jsx(Heading,{level:`2`,id:`project-local-adoption`,children:`Project-local Adoption`}),`\n`,_jsx(_components.p,{children:`기본 Engineering System 적용에 필요한 저장소 시작 지점은 다음 네 가지입니다.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`AGENTS.md`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`.engineering/project.yaml`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`.engineering/tests.yaml`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`.engineering/release.yaml`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`AI Work Packet Issue 템플릿은 구현 권한과 continuity의 기본 surface입니다. `,_jsx(_components.code,{children:`.cursor/commands/resume.md`}),` 같은 Cursor 파일은 managed compatibility adapter로 남을 수 있지만 기본적으로 비활성화되며, 현재 packet의 명시적 opt-in 없이는 실행 권한을 만들지 않습니다.`]}),`\n`,_jsx(_components.p,{children:`저장소 안에 Engineering System 전체를 복사하지 않고 사용할 버전과 기준 SHA만 고정해 참조합니다.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"시스템 아키텍처","description":"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.","href":"/ko/architecture"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"시스템 아키텍처","slug":"시스템-아키텍처","depth":1,"children":[]},{"title":"역할 분담","slug":"역할-분담","depth":2,"children":[]},{"title":"시스템 계층","slug":"시스템-계층","depth":2,"children":[]},{"title":"충돌 시 우선순위","slug":"충돌-시-우선순위","depth":2,"children":[]},{"title":"두 repository의 역할","slug":"두-repository의-역할","depth":2,"children":[]},{"title":"Project-local Adoption","slug":"project-local-adoption","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"dr-engineering","siteName":"DataRelay Engineering","title":"시스템 아키텍처 - DataRelay Engineering","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/architecture","matchLevel":1},"ko":{"href":"/ko/architecture","matchLevel":0}}},"lastModified":"2026-09-30T00:07:43.435Z","gitLastModified":"2026-09-29T23:58:17.000Z","originalFileLocation":"ko/architecture.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DataRelay Engineering\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"시스템 아키텍처 - DataRelay Engineering\">\u003cmeta data-mint-head property=\"og:description\" content=\"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DataRelay Engineering\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://engineering.datarelay.run/ko/architecture\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dr-engineering.mintlify.site/_mintlify/api/og/v2?division=%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0\u0026amp;title=%EC%8B%9C%EC%8A%A4%ED%85%9C+%EC%95%84%ED%82%A4%ED%85%8D%EC%B2%98\u0026amp;description=ChatGPT-primary+%EA%B5%AC%ED%98%84%2C+GitHub%2C+Desktop+Commander%2C+Athena%EC%99%80+%EC%84%A0%ED%83%9D%EC%A0%81+Cursor+%ED%98%B8%ED%99%98+%EA%B2%BD%EB%A1%9C%EC%9D%98+%EC%97%AD%ED%95%A0%EC%9D%84+%EA%B5%AC%EB%B6%84%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=e5244dc5228701890aab1ec2\u0026amp;signature=2b527544c9cdaddaa6b14d4c8488b94390779111b4f1f5f705e10ae93eebd06c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"시스템 아키텍처 - DataRelay Engineering\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dr-engineering.mintlify.site/_mintlify/api/og/v2?division=%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0\u0026amp;title=%EC%8B%9C%EC%8A%A4%ED%85%9C+%EC%95%84%ED%82%A4%ED%85%8D%EC%B2%98\u0026amp;description=ChatGPT-primary+%EA%B5%AC%ED%98%84%2C+GitHub%2C+Desktop+Commander%2C+Athena%EC%99%80+%EC%84%A0%ED%83%9D%EC%A0%81+Cursor+%ED%98%B8%ED%99%98+%EA%B2%BD%EB%A1%9C%EC%9D%98+%EC%97%AD%ED%95%A0%EC%9D%84+%EA%B5%AC%EB%B6%84%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=e5244dc5228701890aab1ec2\u0026amp;signature=2b527544c9cdaddaa6b14d4c8488b94390779111b4f1f5f705e10ae93eebd06c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dr-engineering/TmekWyIEuKr3zVGb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DataRelay Engineering\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C2410C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://engineering.datarelay.run/ko/architecture\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/architecture.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://engineering.datarelay.run/ko/architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://engineering.datarelay.run/architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://engineering.datarelay.run/architecture\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://engineering.datarelay.run/#organization\",\"name\":\"DataRelay Engineering\",\"url\":\"https://engineering.datarelay.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dr-engineering/aIxcUnNVKBW-uhCs/assets/engineering-system-logo-light.svg?fit=max\u0026auto=format\u0026n=aIxcUnNVKBW-uhCs\u0026q=85\u0026s=4eea847a0de1189aa3d4c130b4b235ac\"}},{\"@type\":\"WebSite\",\"@id\":\"https://engineering.datarelay.run#website\",\"name\":\"DataRelay Engineering\",\"url\":\"https://engineering.datarelay.run\",\"publisher\":{\"@id\":\"https://engineering.datarelay.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://engineering.datarelay.run/ko/architecture#webpage\",\"url\":\"https://engineering.datarelay.run/ko/architecture\",\"name\":\"시스템 아키텍처\",\"description\":\"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.\",\"dateModified\":\"2026-09-29T23:58:17.000Z\",\"isPartOf\":{\"@id\":\"https://engineering.datarelay.run#website\"},\"breadcrumb\":{\"@id\":\"https://engineering.datarelay.run/ko/architecture#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://engineering.datarelay.run/ko/architecture#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"시작하기\",\"item\":\"https://engineering.datarelay.run/ko\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"시스템 아키텍처\",\"item\":\"https://engineering.datarelay.run/ko/architecture\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://engineering.datarelay.run/ko/architecture#article\",\"headline\":\"시스템 아키텍처\",\"name\":\"시스템 아키텍처\",\"description\":\"ChatGPT-primary 구현, GitHub, Desktop Commander, Athena와 선택적 Cursor 호환 경로의 역할을 구분합니다.\",\"url\":\"https://engineering.datarelay.run/ko/architecture\",\"mainEntityOfPage\":{\"@id\":\"https://engineering.datarelay.run/ko/architecture#webpage\"},\"dateModified\":\"2026-09-29T23:58:17.000Z\",\"publisher\":{\"@id\":\"https://engineering.datarelay.run/#organization\"},\"isPartOf\":{\"@id\":\"https://engineering.datarelay.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DataRelay Engineering\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DataRelay Engineering\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/architecture.md","siteName":"DataRelay Engineering","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/architecture"}]},{"language":"ko","groups":[{"group":"시작하기","pages":[{"title":"Engineering System","href":"/ko"},{"title":"빠른 시작","description":"일반 저장소에 ChatGPT + GitHub 중심 Engineering System을 최소 구성으로 적용하는 가장 짧은 방법","href":"/ko/quickstart"},{"title":"시스템 아키텍처","href":"/ko/architecture"},{"title":"일상 작업 흐름","description":"ChatGPT가 기본적으로 설계·구현·테스트·감사를 수행하고 Cursor는 명시적 opt-in으로만 사용하는 실제 작업 흐름","href":"/ko/workflow"}]},{"group":"시스템","pages":[{"title":"사용 도구","href":"/ko/tools"},{"title":"지식과 기준 정보","href":"/ko/knowledge"},{"title":"Athena 지식 플랫폼","href":"/ko/athena"},{"title":"Session Continuity","href":"/ko/session-continuity"},{"title":"개발 서버 직접 감사","href":"/ko/remote-audit"},{"title":"모바일 \u0026 원격 작업","href":"/ko/mobile-remote-workflow"}]},{"group":"도입 및 개선 과정","pages":[{"title":"도입 가이드","href":"/ko/adoption"},{"title":"개선 과정과 Lessons","href":"/ko/evolution"}]}]}]},"basePath":"","title":"시스템 아키텍처 - DataRelay Engineering","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}