How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.
System architecture
The system gives each tool one primary job instead of asking a single AI tool to do everything.
System layers
The handbook and Athena help people understand and find context. Current product and release state should be checked against GitHub and the results of tests or runtime verification.
Responsibility map
Component
Primary responsibility
Do not use it as the final reference for
Owner
Product requirements, scope, final decisions, release approval, human UX judgment
Code, history, PRs, CI, specs, Work Packets, release evidence
Human-friendly narrative
Desktop Commander Remote MCP
Direct audit of authorized development hosts
Durable project history
Athena
Searchable decision and history layer
Current runtime state or release verification
Engineering System
Shared engineering rules and AI workflow
Product-specific behavior
Engineering System Docs
Human-readable handbook
The rules enforced by the Engineering System repository
Authority order
When information conflicts, use this order:
actual code, config, schema, runtime, and immutable Git state
canonical product/specification artifacts
repository engineering metadata
executed deterministic test and CI evidence
AI Work Packet current coordination state
Athena / derived documentation
conversation history
This order prevents a stale chat, roadmap, or wiki page from silently overriding the current product.
Two repositories, two purposes
datarelay-labs/engineering-systemThis repository contains the rules, adapters, templates, validation logic, /resume, and session-continuity behavior used by projects and agents.datarelay-labs/engineering-system-docsThis site explains why the system exists, how the pieces fit together, how to adopt it, and what problems it solves.
If this site differs from the Engineering System repository, follow the repository.
Project-local adoption
Base Engineering System adoption requires the small repository entrypoint used by agents and CI:
The AI Work Packet Issue template is the continuity/authority surface. Cursor-specific session files such as .cursor/commands/resume.md are compatibility adapters and remain disabled by default unless a packet explicitly opts into Cursor.A product repository should not copy every Engineering System rule into itself. It should pin the Engineering System version and baseline, then reference the relevant standards.
Last modified on September 29, 2026
{"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":"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":"architecture","slug":"/architecture","pageMetadata":{"title":"Architecture","description":"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.","href":"/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: \"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.\"\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`,li:`li`,ol:`ol`,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:`system-architecture`,children:`System architecture`}),`\n`,_jsx(_components.p,{children:`The system gives each tool one primary job instead of asking a single AI tool to do everything.`}),`\n`,_jsx(Heading,{level:`2`,id:`system-layers`,children:`System layers`}),`\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:`The handbook and Athena help people understand and find context. Current product and release state should be checked against GitHub and the results of tests or runtime verification.`}),`\n`,_jsx(Heading,{level:`2`,id:`responsibility-map`,children:`Responsibility map`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Component`}),_jsx(_components.th,{children:`Primary responsibility`}),_jsx(_components.th,{children:`Do not use it as the final reference for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Owner`}),_jsx(_components.td,{children:`Product requirements, scope, final decisions, release approval, human UX judgment`}),_jsx(_components.td,{children:`Implementation detail unless explicitly decided`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`ChatGPT`}),_jsx(_components.td,{children:`Requirements, architecture, repository implementation, affected tests, review, coordination, audit`}),_jsx(_components.td,{children:`Current Git state unless freshly observed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cursor`}),_jsxs(_components.td,{children:[`Optional per-packet compatibility implementation after explicit `,_jsx(_components.code,{children:`IMPLEMENTER=CURSOR`}),` opt-in`]}),_jsx(_components.td,{children:`Default implementation authority`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Automation / CI`}),_jsx(_components.td,{children:`Repeatable validation, security/performance gates, artifact verification`}),_jsx(_components.td,{children:`Product intent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GitHub`}),_jsx(_components.td,{children:`Code, history, PRs, CI, specs, Work Packets, release evidence`}),_jsx(_components.td,{children:`Human-friendly narrative`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Desktop Commander Remote MCP`}),_jsx(_components.td,{children:`Direct audit of authorized development hosts`}),_jsx(_components.td,{children:`Durable project history`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Athena`}),_jsx(_components.td,{children:`Searchable decision and history layer`}),_jsx(_components.td,{children:`Current runtime state or release verification`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Engineering System`}),_jsx(_components.td,{children:`Shared engineering rules and AI workflow`}),_jsx(_components.td,{children:`Product-specific behavior`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Engineering System Docs`}),_jsx(_components.td,{children:`Human-readable handbook`}),_jsx(_components.td,{children:`The rules enforced by the Engineering System repository`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`authority-order`,children:`Authority order`}),`\n`,_jsx(_components.p,{children:`When information conflicts, use this order:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`actual code, config, schema, runtime, and immutable Git state`}),`\n`,_jsx(_components.li,{children:`canonical product/specification artifacts`}),`\n`,_jsx(_components.li,{children:`repository engineering metadata`}),`\n`,_jsx(_components.li,{children:`executed deterministic test and CI evidence`}),`\n`,_jsx(_components.li,{children:`AI Work Packet current coordination state`}),`\n`,_jsx(_components.li,{children:`Athena / derived documentation`}),`\n`,_jsx(_components.li,{children:`conversation history`}),`\n`]}),`\n`,_jsx(_components.p,{children:`This order prevents a stale chat, roadmap, or wiki page from silently overriding the current product.`}),`\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. Executed 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(Heading,{level:`2`,id:`two-repositories-two-purposes`,children:`Two repositories, two purposes`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`datarelay-labs/engineering-system`})}),`\n`,_jsxs(_components.p,{children:[`This repository contains the rules, adapters, templates, validation logic, `,_jsx(_components.code,{children:`/resume`}),`, and session-continuity behavior used by projects and agents.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`datarelay-labs/engineering-system-docs`})}),`\n`,_jsx(_components.p,{children:`This site explains why the system exists, how the pieces fit together, how to adopt it, and what problems it solves.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`If this site differs from the Engineering System repository, follow the repository.`})}),`\n`,_jsx(Heading,{level:`2`,id:`project-local-adoption`,children:`Project-local adoption`}),`\n`,_jsx(_components.p,{children:`Base Engineering System adoption requires the small repository entrypoint used by agents and CI:`}),`\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:[`The AI Work Packet Issue template is the continuity/authority surface. Cursor-specific session files such as `,_jsx(_components.code,{children:`.cursor/commands/resume.md`}),` are compatibility adapters and remain disabled by default unless a packet explicitly opts into Cursor.`]}),`\n`,_jsx(_components.p,{children:`A product repository should not copy every Engineering System rule into itself. It should pin the Engineering System version and baseline, then reference the relevant standards.`})]})}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":"Architecture","description":"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.","href":"/architecture"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"System architecture","slug":"system-architecture","depth":1,"children":[]},{"title":"System layers","slug":"system-layers","depth":2,"children":[]},{"title":"Responsibility map","slug":"responsibility-map","depth":2,"children":[]},{"title":"Authority order","slug":"authority-order","depth":2,"children":[]},{"title":"Two repositories, two purposes","slug":"two-repositories-two-purposes","depth":2,"children":[]},{"title":"Project-local adoption","slug":"project-local-adoption","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"dr-engineering","siteName":"DataRelay Engineering","title":"Architecture - DataRelay Engineering","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/architecture","matchLevel":0},"ko":{"href":"/ko/architecture","matchLevel":1}}},"lastModified":"2026-09-30T00:07:43.442Z","gitLastModified":"2026-09-29T23:43:31.000Z","originalFileLocation":"architecture.mdx","locale":"en"},"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=\"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.\">\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=\"Architecture - DataRelay Engineering\">\u003cmeta data-mint-head property=\"og:description\" content=\"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DataRelay Engineering\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://engineering.datarelay.run/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=Start+Here\u0026amp;title=Architecture\u0026amp;description=How+ChatGPT-primary+implementation%2C+GitHub%2C+Desktop+Commander%2C+optional+Cursor+compatibility%2C+Athena%2C+tests%2C+and+release+records+fit+together.\u0026amp;theme=e5244dc5228701890aab1ec2\u0026amp;signature=bb671b7231445a9f8ee43ac59ee587fb1f3c5bde9a164787a3c95acf730a19d8\">\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=\"Architecture - DataRelay Engineering\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dr-engineering.mintlify.site/_mintlify/api/og/v2?division=Start+Here\u0026amp;title=Architecture\u0026amp;description=How+ChatGPT-primary+implementation%2C+GitHub%2C+Desktop+Commander%2C+optional+Cursor+compatibility%2C+Athena%2C+tests%2C+and+release+records+fit+together.\u0026amp;theme=e5244dc5228701890aab1ec2\u0026amp;signature=bb671b7231445a9f8ee43ac59ee587fb1f3c5bde9a164787a3c95acf730a19d8\">\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/architecture\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/architecture.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://engineering.datarelay.run/architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://engineering.datarelay.run/ko/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/architecture#webpage\",\"url\":\"https://engineering.datarelay.run/architecture\",\"name\":\"Architecture\",\"description\":\"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.\",\"dateModified\":\"2026-09-29T23:43:31.000Z\",\"isPartOf\":{\"@id\":\"https://engineering.datarelay.run#website\"},\"breadcrumb\":{\"@id\":\"https://engineering.datarelay.run/architecture#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://engineering.datarelay.run/architecture#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start Here\",\"item\":\"https://engineering.datarelay.run\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Architecture\",\"item\":\"https://engineering.datarelay.run/architecture\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://engineering.datarelay.run/architecture#article\",\"headline\":\"Architecture\",\"name\":\"Architecture\",\"description\":\"How ChatGPT-primary implementation, GitHub, Desktop Commander, optional Cursor compatibility, Athena, tests, and release records fit together.\",\"url\":\"https://engineering.datarelay.run/architecture\",\"mainEntityOfPage\":{\"@id\":\"https://engineering.datarelay.run/architecture#webpage\"},\"dateModified\":\"2026-09-29T23:43:31.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":"/architecture.md","siteName":"DataRelay Engineering","nav":{"global":null,"languages":[{"language":"en","groups":[{"group":"Start Here","pages":[{"title":"Engineering System","href":""},{"title":"Quick Start","description":"The shortest path for applying the ChatGPT-primary Engineering System.","href":"/quickstart"},{"title":"Architecture","href":"/architecture"},{"title":"Daily Workflow","description":"The practical ChatGPT-first implementation and exact-HEAD verification loop.","href":"/workflow"}]},{"group":"System","pages":[{"title":"Tool Stack","href":"/tools"},{"title":"Knowledge \u0026 Source of Truth","href":"/knowledge"},{"title":"Athena Knowledge Platform","href":"/athena"},{"title":"Session Continuity","href":"/session-continuity"},{"title":"Remote Code Audit","href":"/remote-audit"},{"title":"Mobile \u0026 Remote Workflow","href":"/mobile-remote-workflow"}]},{"group":"Adoption \u0026 Lessons","pages":[{"title":"Adoption Guide","href":"/adoption"},{"title":"Evolution \u0026 Lessons","href":"/evolution"}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/architecture"}]}]},"basePath":"","title":"Architecture - DataRelay Engineering","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}