Design what each person needs to see and do throughout an Elementum process.
Limited Release. The EDK is currently in limited release and is not available to all customers. Commands, generated file layouts, and package APIs may change before general availability. Confirm you’re on the latest EDK version before starting new projects.
Record-experience design defines what people need from Elementum at each stage of a process. It connects the process map to the information, decisions, and actions that should shape the eventual solution.This is a design activity for process owners and subject-matter experts. You do not need to write TypeScript or configure Elementum. Use the /elementum-design playbook to lead the workshop and capture the result.Complete Design with EDK first so the business outcome, personas, stages, and handoffs are clear.
Define Each Stage
For every materially different stage, describe:
Persona: Who owns the work now, and who else needs visibility?
Primary job: What single outcome must that person produce?
Decision: What must the person understand, approve, reject, or resolve?
Required inputs: What do they need to see, enter, or update?
Evidence: What documents, relationships, history, or prior decisions support the work?
Primary action: What should they do next, and what is the consequence?
Failure path: What blocks, returns, escalates, or cancels the work?
Create a distinct experience only when the person’s job changes. A new status alone does not require a different experience if the same person is making the same decision with the same information.
Shape the Record Experience
Describe the experience in layers:
Orientation: Identity, ownership, stage, urgency, and the few facts needed to understand the record.
Work area: Information the current person must review or change.
Decision and action: The primary outcome, action label, confirmation, and possible failure.
Evidence: Attachments, relationships, findings, approvals, and source material.
History: Activity and audit detail that should remain available without dominating the work.
The first view should answer three questions: What is this record? What matters now? What should I do next?Do not design around every available field. Include information because it supports the current job, decision, evidence, or handoff.Do not repeat information or actions already supplied by the record header. Prefer one clearly labeled primary action for each stage, and never communicate state through color alone.
Design How People Find Work
Record pages support one item at a time. Also define how each person finds and prioritizes multiple records.For each useful list or queue, identify:
The person and repeatable task it supports.
The records that belong in the view.
The fields needed to recognize and prioritize work.
The default order and useful filters.
The empty state and next action.
A focused view usually needs an identifier, stage or status, owner, urgency or risk, and one or two process-specific facts. It should support scanning rather than reproduce the entire record.
Account for Different States
Describe how the experience should behave when:
Information is missing, sparse, unusually long, or high risk.
A person can view but not edit particular information.
An action is unavailable, requires confirmation, succeeds, or fails.
Work is reassigned, returned, rejected, cancelled, escalated, or completed.
Related records or evidence are empty, loading, or extensive.
These scenarios become design requirements and later acceptance tests.
Work with a Coding Agent
Give the agent the process material and a clear design-only request:
Use elementum-design to design the record experiences for [process].Do not write code or configure Elementum.For each persona and stage, define the outcome, decision, requiredinformation, evidence, primary action, exceptions, and list-view needs.Identify open questions and assumptions, then produce a design brieffor the delivery team.
Review the agent’s recommendations with the people who perform and own the process. The agent should expose missing decisions and conflicting requirements rather than fill them in without evidence.
Create the Design Brief
The final brief should include:
The business outcome and process boundaries.
Personas, responsibilities, and handoffs.
A stage matrix with primary jobs, decisions, actions, and exceptions.
The record experience and information hierarchy for each distinct stage.
List or queue requirements for each persona.
Required information, evidence, relationships, and history.
Access, governance, reporting, and Automation considerations.
Assumptions, open questions, and platform capabilities that need confirmation.
Representative scenarios for design validation.
Describe the intended behavior without prescribing implementation details. The delivery team should decide how to realize the approved design and confirm what the platform supports.Continue with Design Validation to review the brief before implementation.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Elementum Documentation","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/elementum/zEtDA8cEluOX9_Yd/logo/light.svg?fit=max\u0026auto=format\u0026n=zEtDA8cEluOX9_Yd\u0026q=85\u0026s=6f2a0a929de00ded269314ca98595339","dark":"https://mintcdn.com/elementum/zEtDA8cEluOX9_Yd/logo/dark.svg?fit=max\u0026auto=format\u0026n=zEtDA8cEluOX9_Yd\u0026q=85\u0026s=d6be9d3c273193977ee10bd4e34e7c69"},"favicon":"https://mintcdn.com/elementum/HFcyqoOHMh59mvyA/favicon.ico?fit=max\u0026auto=format\u0026n=HFcyqoOHMh59mvyA\u0026q=85\u0026s=e813105031a6caa3ee74fd5f49883eb4","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[],"primary":{"type":"button","label":"Open Elementum","href":"https://elementum.io"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/elementum-ai"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"elementum","hasAudioNarration":false,"actualSubdomain":"elementum","customDomains":["docs.elementum.io"],"gitSource":{"type":"github","owner":"elementumltd","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcb8d0eb98bc45a9fcdf42","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Administration","count":31},{"language":"default","tag":"Workflows","count":31},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"AI \u0026 Agents","count":28},{"language":"default","tag":"Overview","count":21},{"language":"default","tag":"EDK","count":13},{"language":"default","tag":"Record Management","count":12},{"language":"default","tag":"Platform Administration","count":11},{"language":"default","tag":"Support","count":11},{"language":"default","tag":"Connections","count":10}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@elementum.elementum.io","showHelpButton":false}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"#topbar-cta-button span{border-radius:.5rem}button{border-radius:.5rem!important}a.card{border-color:rgba(59, 130, 246, 0.4)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease}a.card:hover{border-color:#3B82F6!important;box-shadow:0 2px 8px rgba(59, 130, 246, 0.2)}.dark a.card{border-color:rgba(96, 165, 250, 0.4)!important}.dark a.card:hover{border-color:#60A5FA!important;box-shadow:0 2px 8px rgba(96, 165, 250, 0.2)}.inline-ui-icon{display:inline!important;width:1em;height:1em;vertical-align:middle;margin:0}.dark .inline-ui-icon[src$=\".png\"]{background-color:#e5e7eb;border-radius:3px;box-shadow:0 0 0 2px #e5e7eb}p .inline-ui-icon,li .inline-ui-icon,td .inline-ui-icon{display:inline!important}p span:has(>svg),li span:has(>svg),td span:has(>svg){display:inline!important;vertical-align:middle}p span:has(>svg) svg,li span:has(>svg) svg,td span:has(>svg) svg{display:inline-block!important;vertical-align:middle;width:1em;height:1em}.update:has(h3)>div:first-child{display:none!important}.update:has(h3)>div:last-child{width:100%!important;max-width:100%!important}@media (min-width: 1024px){.update:not(:has(h3))>div:first-child{flex:0 0 260px!important;width:260px!important;max-width:260px!important}}.deprecation-schedule table,.deprecation-schedule th,.deprecation-schedule td{font-size:1rem!important}.deprecation-schedule th,.deprecation-schedule td{padding-top:0.65rem!important;padding-bottom:0.65rem!important}.deprecation-schedule td code,.deprecation-schedule th code{font-size:0.9375rem!important}.email-form input{color:rgb(24 24 27);caret-color:rgb(24 24 27)}.email-form input:-webkit-autofill,.email-form input:-webkit-autofill:hover,.email-form input:-webkit-autofill:focus,.email-form input:-webkit-autofill:active{-webkit-text-fill-color:rgb(24 24 27)!important;-webkit-box-shadow:0 0 0 1000px #ffffff inset!important;caret-color:rgb(24 24 27)!important;transition:background-color 5000s ease-in-out 0s}.dark .email-form input{color:rgb(244 244 245);caret-color:rgb(244 244 245)}.dark .email-form input:-webkit-autofill,.dark .email-form input:-webkit-autofill:hover,.dark .email-form input:-webkit-autofill:focus,.dark .email-form input:-webkit-autofill:active{-webkit-text-fill-color:rgb(244 244 245)!important;-webkit-box-shadow:0 0 0 1000px rgb(24 24 27) inset!important;caret-color:rgb(244 244 245)!important;transition:background-color 5000s ease-in-out 0s}"}],"page":{"pagePath":"edk/guides/design","slug":"/edk/guides/design","pageMetadata":{"title":"Record Experiences","description":"Design what each person needs to see and do throughout an Elementum process.","href":"/edk/guides/design"},"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: \"Design what each person needs to see and do throughout an Elementum process.\"\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={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Limited Release.`}),` The EDK is currently in limited release and is not available to all customers. Commands, generated file layouts, and package APIs may change before general availability. Confirm you’re on the latest EDK version before starting new projects.`]})}),`\n`,_jsx(_components.p,{children:`Record-experience design defines what people need from Elementum at each stage of a process. It connects the process map to the information, decisions, and actions that should shape the eventual solution.`}),`\n`,_jsxs(_components.p,{children:[`This is a design activity for process owners and subject-matter experts. You do not need to write TypeScript or configure Elementum. Use the `,_jsx(_components.code,{children:`/elementum-design`}),` playbook to lead the workshop and capture the result.`]}),`\n`,_jsxs(_components.p,{children:[`Complete `,_jsx(_components.a,{href:`/edk/design/overview`,children:`Design with EDK`}),` first so the business outcome, personas, stages, and handoffs are clear.`]}),`\n`,_jsx(Heading,{level:`2`,id:`define-each-stage`,children:`Define Each Stage`}),`\n`,_jsx(_components.p,{children:`For every materially different stage, describe:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Persona:`}),` Who owns the work now, and who else needs visibility?`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Primary job:`}),` What single outcome must that person produce?`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Decision:`}),` What must the person understand, approve, reject, or resolve?`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Required inputs:`}),` What do they need to see, enter, or update?`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Evidence:`}),` What documents, relationships, history, or prior decisions support the work?`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Primary action:`}),` What should they do next, and what is the consequence?`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Failure path:`}),` What blocks, returns, escalates, or cancels the work?`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Create a distinct experience only when the person’s job changes. A new status alone does not require a different experience if the same person is making the same decision with the same information.`}),`\n`,_jsx(Heading,{level:`2`,id:`shape-the-record-experience`,children:`Shape the Record Experience`}),`\n`,_jsx(_components.p,{children:`Describe the experience in layers:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Orientation:`}),` Identity, ownership, stage, urgency, and the few facts needed to understand the record.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Work area:`}),` Information the current person must review or change.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Decision and action:`}),` The primary outcome, action label, confirmation, and possible failure.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Evidence:`}),` Attachments, relationships, findings, approvals, and source material.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`History:`}),` Activity and audit detail that should remain available without dominating the work.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The first view should answer three questions: What is this record? What matters now? What should I do next?`}),`\n`,_jsx(_components.p,{children:`Do not design around every available field. Include information because it supports the current job, decision, evidence, or handoff.`}),`\n`,_jsx(_components.p,{children:`Do not repeat information or actions already supplied by the record header. Prefer one clearly labeled primary action for each stage, and never communicate state through color alone.`}),`\n`,_jsx(Heading,{level:`2`,id:`design-how-people-find-work`,children:`Design How People Find Work`}),`\n`,_jsx(_components.p,{children:`Record pages support one item at a time. Also define how each person finds and prioritizes multiple records.`}),`\n`,_jsx(_components.p,{children:`For each useful list or queue, identify:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The person and repeatable task it supports.`}),`\n`,_jsx(_components.li,{children:`The records that belong in the view.`}),`\n`,_jsx(_components.li,{children:`The fields needed to recognize and prioritize work.`}),`\n`,_jsx(_components.li,{children:`The default order and useful filters.`}),`\n`,_jsx(_components.li,{children:`The empty state and next action.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`A focused view usually needs an identifier, stage or status, owner, urgency or risk, and one or two process-specific facts. It should support scanning rather than reproduce the entire record.`}),`\n`,_jsx(Heading,{level:`2`,id:`account-for-different-states`,children:`Account for Different States`}),`\n`,_jsx(_components.p,{children:`Describe how the experience should behave when:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Information is missing, sparse, unusually long, or high risk.`}),`\n`,_jsx(_components.li,{children:`A person can view but not edit particular information.`}),`\n`,_jsx(_components.li,{children:`An action is unavailable, requires confirmation, succeeds, or fails.`}),`\n`,_jsx(_components.li,{children:`Work is reassigned, returned, rejected, cancelled, escalated, or completed.`}),`\n`,_jsx(_components.li,{children:`Related records or evidence are empty, loading, or extensive.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`These scenarios become design requirements and later acceptance tests.`}),`\n`,_jsx(Heading,{level:`2`,id:`work-with-a-coding-agent`,children:`Work with a Coding Agent`}),`\n`,_jsx(_components.p,{children:`Give the agent the process material and a clear design-only request:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use elementum-design to design the record experiences for [process].`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Do not write code or configure Elementum.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`For each persona and stage, define the outcome, decision, required`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`information, evidence, primary action, exceptions, and list-view needs.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Identify open questions and assumptions, then produce a design brief`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`for the delivery team.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Review the agent’s recommendations with the people who perform and own the process. The agent should expose missing decisions and conflicting requirements rather than fill them in without evidence.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-the-design-brief`,children:`Create the Design Brief`}),`\n`,_jsx(_components.p,{children:`The final brief should include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The business outcome and process boundaries.`}),`\n`,_jsx(_components.li,{children:`Personas, responsibilities, and handoffs.`}),`\n`,_jsx(_components.li,{children:`A stage matrix with primary jobs, decisions, actions, and exceptions.`}),`\n`,_jsx(_components.li,{children:`The record experience and information hierarchy for each distinct stage.`}),`\n`,_jsx(_components.li,{children:`List or queue requirements for each persona.`}),`\n`,_jsx(_components.li,{children:`Required information, evidence, relationships, and history.`}),`\n`,_jsx(_components.li,{children:`Access, governance, reporting, and Automation considerations.`}),`\n`,_jsx(_components.li,{children:`Assumptions, open questions, and platform capabilities that need confirmation.`}),`\n`,_jsx(_components.li,{children:`Representative scenarios for design validation.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Describe the intended behavior without prescribing implementation details. The delivery team should decide how to realize the approved design and confirm what the platform supports.`}),`\n`,_jsxs(_components.p,{children:[`Continue with `,_jsx(_components.a,{href:`/edk/design/validation`,children:`Design Validation`}),` to review the brief before implementation.`]})]})}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":"Record Experiences","description":"Design what each person needs to see and do throughout an Elementum process.","href":"/edk/guides/design"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Define Each Stage","slug":"define-each-stage","depth":2,"children":[]},{"title":"Shape the Record Experience","slug":"shape-the-record-experience","depth":2,"children":[]},{"title":"Design How People Find Work","slug":"design-how-people-find-work","depth":2,"children":[]},{"title":"Account for Different States","slug":"account-for-different-states","depth":2,"children":[]},{"title":"Work with a Coding Agent","slug":"work-with-a-coding-agent","depth":2,"children":[]},{"title":"Create the Design Brief","slug":"create-the-design-brief","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"elementum","siteName":"Elementum Documentation","title":"Record Experiences - Elementum Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-21T18:15:45.081Z","originalFileLocation":"edk/guides/design.mdx"},"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=\"Design what each person needs to see and do throughout an Elementum process.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Elementum Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_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/elementum/61PalhAEBeln8LgR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Record Experiences - Elementum Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Design what each person needs to see and do throughout an Elementum process.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Elementum Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.elementum.io/edk/guides/design\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://elementum.mintlify.site/_mintlify/api/og/v2?division=Design\u0026amp;title=Record+Experiences\u0026amp;description=Design+what+each+person+needs+to+see+and+do+throughout+an+Elementum+process.\u0026amp;theme=f2077c0582052f05ca4a5fc0\u0026amp;signature=8f8b9822b90c792bcad9efef2ff0dbc30dfcddf86bcadc2fdd541c671bba4ba2\">\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=\"Record Experiences - Elementum Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Design what each person needs to see and do throughout an Elementum process.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://elementum.mintlify.site/_mintlify/api/og/v2?division=Design\u0026amp;title=Record+Experiences\u0026amp;description=Design+what+each+person+needs+to+see+and+do+throughout+an+Elementum+process.\u0026amp;theme=f2077c0582052f05ca4a5fc0\u0026amp;signature=8f8b9822b90c792bcad9efef2ff0dbc30dfcddf86bcadc2fdd541c671bba4ba2\">\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/elementum/61PalhAEBeln8LgR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Elementum Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.elementum.io/edk/guides/design\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/edk/guides/design.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.elementum.io/#organization\",\"name\":\"Elementum Documentation\",\"url\":\"https://docs.elementum.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/elementum/zEtDA8cEluOX9_Yd/logo/light.svg?fit=max\u0026auto=format\u0026n=zEtDA8cEluOX9_Yd\u0026q=85\u0026s=6f2a0a929de00ded269314ca98595339\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.elementum.io#website\",\"name\":\"Elementum Documentation\",\"url\":\"https://docs.elementum.io\",\"publisher\":{\"@id\":\"https://docs.elementum.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.elementum.io/edk/guides/design#webpage\",\"url\":\"https://docs.elementum.io/edk/guides/design\",\"name\":\"Record Experiences\",\"description\":\"Design what each person needs to see and do throughout an Elementum process.\",\"dateModified\":\"2026-08-21T18:15:45.081Z\",\"isPartOf\":{\"@id\":\"https://docs.elementum.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.elementum.io/edk/guides/design#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.elementum.io/edk/guides/design#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Design\",\"item\":\"https://docs.elementum.io/edk/design/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Record Experiences\",\"item\":\"https://docs.elementum.io/edk/guides/design\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.elementum.io/edk/guides/design#article\",\"headline\":\"Record Experiences\",\"name\":\"Record Experiences\",\"description\":\"Design what each person needs to see and do throughout an Elementum process.\",\"url\":\"https://docs.elementum.io/edk/guides/design\",\"mainEntityOfPage\":{\"@id\":\"https://docs.elementum.io/edk/guides/design#webpage\"},\"dateModified\":\"2026-08-21T18:15:45.081Z\",\"publisher\":{\"@id\":\"https://docs.elementum.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.elementum.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Elementum Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Elementum Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/edk/guides/design.md","siteName":"Elementum Documentation","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/getting-started/welcome-to-elementum"}]},{"tab":"Workflows","pages":[{"title":"Workflows","href":"/getting-started/build-an-app"}]},{"tab":"AI \u0026 Agents","pages":[{"title":"AI \u0026 Agents","href":"/ai-agents/ai-overview"}]},{"tab":"Data \u0026 Analytics","pages":[{"title":"Data \u0026 Analytics","href":"/data/data-best-practices"}]},{"tab":"Administration","pages":[{"title":"Administration","href":"/administration/access-overview"}]},{"tab":"EDK","groups":[{"group":"Get Started","pages":[{"title":"Overview","href":"/edk/getting-started"},{"title":"Quickstart","href":"/edk/quickstart"}]},{"group":"Guides","pages":[{"title":"Installation","href":"/edk/installation"},{"title":"Authentication","href":"/edk/authentication"},{"title":"Playbooks","href":"/edk/playbooks"},{"title":"Authoring","href":"/edk/authoring"},{"title":"Plan and Apply","href":"/edk/plan-and-apply"},{"title":"Acceptance Testing","href":"/edk/guides/acceptance-testing"},{"title":"Troubleshooting","href":"/edk/guides/troubleshooting"}]},{"group":"Design","pages":[{"title":"Design with EDK","description":"Design Elementum processes and record experiences before implementing them.","href":"/edk/design/overview"},{"title":"Record Experiences","href":"/edk/guides/design"},{"title":"Design Validation","description":"Review an Elementum process and record-experience design before implementation.","href":"/edk/design/validation"}]},{"group":"Reference","pages":[{"title":"CLI Reference","href":"/edk/cli-reference"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/api-introduction"}]}]},"basePath":"","title":"Record Experiences - Elementum Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}