Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.
Specifications is coming soon. This documentation previews what the section will look like at launch.
Editing a specification is the same as editing the plan: in plain language, with structural awareness, in a surface designed for non-developers. You do not write code. You write the spec.
Three ways to edit
Each section of a spec offers three editing modes, the same as the plan:
Direct edit — click into a screen, flow, or rule and change it inline. Useful for small tweaks, copy changes, and adding rules.
Spec chat — describe the change in plain language. Useful for multi-step changes (“split the orders list into two views, active and archived, and move the cancel action to the detail page”).
AI suggestions — Archie surfaces gaps it noticed (missing edge cases, unspecified copy, conflicting rules). You accept, modify, or dismiss each suggestion.
Adding constraints and rules
Validation, business rules, and edge cases live in each spec’s “Validation and edge cases” section. To add a rule:
Open the relevant feature’s spec
Click Add rule in the Validation section
Describe the rule in plain language: “Users can only have one active subscription at a time.” or “Orders cannot be canceled after they have shipped.”
Archie translates the rule into structured form (which field, which operator, which user type) and validates it against the rest of the spec for conflicts.
Refining flows
Flows are step-by-step. Each step is a user action or a system response. To refine a flow, click into it and:
Add a step (e.g., “show a confirmation modal before deleting”)
Change a step’s action (“auto-save” instead of “save when the user clicks Save”)
Branch a step into success and error paths
Add a precondition or a postcondition
If you make changes that affect the data model or user types, Archie surfaces the implications: “This requires a confirmed_at field on Orders. Add it?” You confirm and the data model updates.
Editing copy
Copy lives in each screen’s element list. Click any text to edit. Archie tracks copy across the project so the same string is consistent everywhere — change the cancel button’s text once and it updates in all the places it appears.For multi-locale projects, the copy view shows all locales side by side. Archie can also auto-translate when you mark a string ready for localization.
Marking edge cases
Edge cases are first-class in specifications. Click Add edge case in any feature’s spec to describe one in plain language: “What happens when the user disconnects mid-checkout?” Archie suggests handling — show a recovery prompt, save progress, retry on reconnect — and adds the appropriate flow steps.For complex edge cases, mark them as needs review and a human teammate can sign off before the spec drives code generation.
Versioning
Specifications are versioned automatically. Every edit creates a checkpoint. The version history shows what changed, when, and by whom. Roll back to any previous version from the version panel. See Specifications and code generation for how spec versions interact with code generation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Archie Documentation","description":"Official docs for Archie, the AI full-stack app builder that generates a plan before code, then builds a production app with database, APIs, and auth.","colors":{"primary":"#D83F37","light":"#E5564E","dark":"#D83F37"},"logo":{"light":"https://mintcdn.com/archie-e998dbf6/GqLKywMFdSdVW_pv/logo/light.svg?fit=max\u0026auto=format\u0026n=GqLKywMFdSdVW_pv\u0026q=85\u0026s=49b1cf2b436e3a5eff7c748509d1917d","dark":"https://mintcdn.com/archie-e998dbf6/GqLKywMFdSdVW_pv/logo/dark.svg?fit=max\u0026auto=format\u0026n=GqLKywMFdSdVW_pv\u0026q=85\u0026s=9523970431196f662bbf2683848a003c","href":"https://archie.com"},"favicon":"https://mintcdn.com/archie-e998dbf6/RPVhI0P2wHtDBThL/favicon.svg?fit=max\u0026auto=format\u0026n=RPVhI0P2wHtDBThL\u0026q=85\u0026s=f8e10796de983605886f4b3849e52906","appearance":{"default":"system"},"background":{"color":{"light":"#FFFFFF","dark":"#0B1222"}},"navbar":{"links":[],"primary":{"type":"button","label":"Try Archie","href":"https://app.archie.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/archie","discord":"https://discord.gg/EwKqQH5TQU","x":"https://x.com/archieforall"}},"seo":{"metatags":{"canonical":"https://www.archie.com/docs","google-site-verification":"_ZBDHd_5eIme25_0XMw5WgvMBWZuxl0Q7uK8JlKHjtU","msapplication-TileImage":"/favicon.png","author":"Archie","robots":"index, follow","googlebot":"index, follow","theme-color":"#000000","color-scheme":"dark light","og:site_name":"Archie","og:type":"website","og:locale":"en_US","application-name":"Archie","apple-mobile-web-app-title":"Archie","msapplication-TileColor":"#000000","twitter:card":"summary_large_image"},"indexing":"all"},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"integrations":{"ga4":{"measurementId":"G-KV3V08P4B3"},"gtm":{"tagId":"GT-MBNKS363"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"background":"https://mintcdn.com/archie-e998dbf6/jqktZCSfULHmVt_E/images/background.svg?fit=max\u0026auto=format\u0026n=jqktZCSfULHmVt_E\u0026q=85\u0026s=70c7e97571adf55d031d7660d5b24e6e","fonts":{"family":"Geist"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"archie-e998dbf6","hasAudioNarration":false,"actualSubdomain":"archie-e998dbf6","customDomains":["archie.com"],"gitSource":{"type":"github","owner":"8base-archie","repo":"archie.com-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b008a4ad380267e8a2d3e59","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":172},{"language":"default","tag":"Build","count":147},{"language":"default","tag":"Backend","count":104},{"language":"default","tag":"App services","count":33},{"language":"default","tag":"Frontend","count":33},{"language":"default","tag":"Data","count":21},{"language":"default","tag":"Specifications","count":20},{"language":"default","tag":"Prototype","count":14},{"language":"default","tag":"Authentication Providers","count":11},{"language":"default","tag":"Fields","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":"site-roles","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},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"html:root{--gray-50: 240 242 245;--gray-100: 232 234 238;--gray-200: 223 226 231;--gray-300: 198 203 210;--gray-400: 154 161 172;--gray-500: 104 111 125;--gray-600: 74 82 94;--gray-700: 49 55 63;--gray-800: 34 42 52;--gray-900: 27 33 45;--gray-950: 11 18 34}[data-testid=\"theme-preference-menu-trigger\"]{display:none!important}.archie-theme-toggle{display:inline-flex;align-items:center;justify-content:center;width:2rem;height:2rem;border-radius:0.375rem;color:#222a34;cursor:pointer;transition:background-color 0.2s, color 0.2s}.archie-theme-toggle:hover{background-color:#f2f4f7}.archie-theme-toggle:focus-visible{outline:2px solid #d83f37;outline-offset:2px}.archie-theme-toggle svg{width:18px;height:18px;transition:transform 0.3s}.archie-theme-toggle:hover svg{transform:rotate(-15deg)}.archie-theme-toggle__sun,html.dark .archie-theme-toggle__moon{display:none}html.dark .archie-theme-toggle__sun{display:block}html.dark .archie-theme-toggle{color:#f3f4f6}html.dark .archie-theme-toggle:hover{background-color:#1a2333}"}]}
{"page":{"pagePath":"features/specifications/editing-specifications","slug":"/features/specifications/editing-specifications","pageMetadata":{"title":"Editing specifications","description":"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.","href":"/features/specifications/editing-specifications","hidden":true},"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: \"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.\"\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`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:`Specifications is coming soon. This documentation previews what the section will look like at launch.`}),`\n`,_jsx(_components.p,{children:`Editing a specification is the same as editing the plan: in plain language, with structural awareness, in a surface designed for non-developers. You do not write code. You write the spec.`}),`\n`,_jsx(Heading,{level:`2`,id:`three-ways-to-edit`,children:`Three ways to edit`}),`\n`,_jsx(_components.p,{children:`Each section of a spec offers three editing modes, the same as the plan:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Direct edit`}),` — click into a screen, flow, or rule and change it inline. Useful for small tweaks, copy changes, and adding rules.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Spec chat`}),` — describe the change in plain language. Useful for multi-step changes (“split the orders list into two views, active and archived, and move the cancel action to the detail page”).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AI suggestions`}),` — Archie surfaces gaps it noticed (missing edge cases, unspecified copy, conflicting rules). You accept, modify, or dismiss each suggestion.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`adding-constraints-and-rules`,children:`Adding constraints and rules`}),`\n`,_jsx(_components.p,{children:`Validation, business rules, and edge cases live in each spec’s “Validation and edge cases” section. To add a rule:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Open the relevant feature’s spec`}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Add rule`}),` in the Validation section`]}),`\n`,_jsx(_components.li,{children:`Describe the rule in plain language: “Users can only have one active subscription at a time.” or “Orders cannot be canceled after they have shipped.”`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Archie translates the rule into structured form (which field, which operator, which user type) and validates it against the rest of the spec for conflicts.`}),`\n`,_jsx(Heading,{level:`2`,id:`refining-flows`,children:`Refining flows`}),`\n`,_jsx(_components.p,{children:`Flows are step-by-step. Each step is a user action or a system response. To refine a flow, click into it and:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Add a step (e.g., “show a confirmation modal before deleting”)`}),`\n`,_jsx(_components.li,{children:`Change a step’s action (“auto-save” instead of “save when the user clicks Save”)`}),`\n`,_jsx(_components.li,{children:`Branch a step into success and error paths`}),`\n`,_jsx(_components.li,{children:`Add a precondition or a postcondition`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If you make changes that affect the data model or user types, Archie surfaces the implications: “This requires a `,_jsx(_components.code,{children:`confirmed_at`}),` field on Orders. Add it?” You confirm and the data model updates.`]}),`\n`,_jsx(Heading,{level:`2`,id:`editing-copy`,children:`Editing copy`}),`\n`,_jsx(_components.p,{children:`Copy lives in each screen’s element list. Click any text to edit. Archie tracks copy across the project so the same string is consistent everywhere — change the cancel button’s text once and it updates in all the places it appears.`}),`\n`,_jsx(_components.p,{children:`For multi-locale projects, the copy view shows all locales side by side. Archie can also auto-translate when you mark a string ready for localization.`}),`\n`,_jsx(Heading,{level:`2`,id:`marking-edge-cases`,children:`Marking edge cases`}),`\n`,_jsxs(_components.p,{children:[`Edge cases are first-class in specifications. Click `,_jsx(_components.strong,{children:`Add edge case`}),` in any feature’s spec to describe one in plain language: “What happens when the user disconnects mid-checkout?” Archie suggests handling — show a recovery prompt, save progress, retry on reconnect — and adds the appropriate flow steps.`]}),`\n`,_jsxs(_components.p,{children:[`For complex edge cases, mark them as `,_jsx(_components.strong,{children:`needs review`}),` and a human teammate can sign off before the spec drives code generation.`]}),`\n`,_jsx(Heading,{level:`2`,id:`versioning`,children:`Versioning`}),`\n`,_jsxs(_components.p,{children:[`Specifications are versioned automatically. Every edit creates a checkpoint. The version history shows what changed, when, and by whom. Roll back to any previous version from the version panel. See `,_jsx(_components.a,{href:`/features/specifications/specifications-and-code-generation`,children:`Specifications and code generation`}),` for how spec versions interact with code generation.`]})]})}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":"Editing specifications","description":"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.","href":"/features/specifications/editing-specifications","hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Three ways to edit","slug":"three-ways-to-edit","depth":2,"children":[]},{"title":"Adding constraints and rules","slug":"adding-constraints-and-rules","depth":2,"children":[]},{"title":"Refining flows","slug":"refining-flows","depth":2,"children":[]},{"title":"Editing copy","slug":"editing-copy","depth":2,"children":[]},{"title":"Marking edge cases","slug":"marking-edge-cases","depth":2,"children":[]},{"title":"Versioning","slug":"versioning","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/archie-e998dbf6/229d292c895cde91/theme-toggle.js"],"subdomain":"archie-e998dbf6","siteName":"Archie Documentation","title":"Editing specifications - Archie Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T05:03:09.875Z","originalFileLocation":"features/specifications/editing-specifications.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=\"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Archie Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_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=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Editing specifications - Archie Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Archie\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.archie.com/docs/features/specifications/editing-specifications\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://archie-e998dbf6.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Editing+specifications\u0026amp;description=Refine+specifications+in+plain+language+%E2%80%94+add+constraints%2C+refine+behavior%2C+mark+edge+cases%2C+and+edit+copy+directly.\u0026amp;theme=d61ee96343317418f7859b8d\u0026amp;signature=e642bcf1e4471886ab73fc66f99023075316de4cc08cae92370cb9899acd4147\">\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=\"Editing specifications - Archie Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://archie-e998dbf6.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Editing+specifications\u0026amp;description=Refine+specifications+in+plain+language+%E2%80%94+add+constraints%2C+refine+behavior%2C+mark+edge+cases%2C+and+edit+copy+directly.\u0026amp;theme=d61ee96343317418f7859b8d\u0026amp;signature=e642bcf1e4471886ab73fc66f99023075316de4cc08cae92370cb9899acd4147\">\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=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Archie\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"_ZBDHd_5eIme25_0XMw5WgvMBWZuxl0Q7uK8JlKHjtU\">\u003cmeta data-mint-head name=\"msapplication-TileImage\" content=\"/favicon.png\">\u003cmeta data-mint-head name=\"author\" content=\"Archie\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#000000\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"dark light\">\u003cmeta data-mint-head name=\"application-name\" content=\"Archie\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.archie.com/docs/features/specifications/editing-specifications\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/features/specifications/editing-specifications.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.archie.com/#organization\",\"name\":\"Archie Documentation\",\"url\":\"https://www.archie.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/archie-e998dbf6/GqLKywMFdSdVW_pv/logo/light.svg?fit=max\u0026auto=format\u0026n=GqLKywMFdSdVW_pv\u0026q=85\u0026s=49b1cf2b436e3a5eff7c748509d1917d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.archie.com/docs#website\",\"name\":\"Archie Documentation\",\"url\":\"https://www.archie.com/docs\",\"publisher\":{\"@id\":\"https://www.archie.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.archie.com/docs/features/specifications/editing-specifications#webpage\",\"url\":\"https://www.archie.com/docs/features/specifications/editing-specifications\",\"name\":\"Editing specifications\",\"description\":\"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.\",\"dateModified\":\"2026-09-23T05:03:09.875Z\",\"isPartOf\":{\"@id\":\"https://www.archie.com/docs#website\"}},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.archie.com/docs/features/specifications/editing-specifications#article\",\"headline\":\"Editing specifications\",\"name\":\"Editing specifications\",\"description\":\"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.\",\"url\":\"https://www.archie.com/docs/features/specifications/editing-specifications\",\"mainEntityOfPage\":{\"@id\":\"https://www.archie.com/docs/features/specifications/editing-specifications#webpage\"},\"dateModified\":\"2026-09-23T05:03:09.875Z\",\"publisher\":{\"@id\":\"https://www.archie.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.archie.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Archie Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Archie Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/features/specifications/editing-specifications.md","siteName":"Archie Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq/getting-started"}]},{"tab":"Alternatives","pages":[{"title":"Alternatives","href":"/alternatives"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026-11-17"}]},{"tab":"Specifications","icon":"list-tree","hidden":true,"pages":[{"title":"Overview","description":"Specifications are the detailed documents Archie generates from your plan — three design groups that the build agents read before writing any code.","href":"/features/specifications/overview"},{"title":"What are specifications","description":"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.","href":"/features/specifications/what-are-specifications"},{"title":"Generating specifications","description":"How Archie generates detailed specifications from your approved plan — the workflow from plan to per-feature spec.","href":"/features/specifications/generating-specifications"},{"title":"Editing specifications","href":"/features/specifications/editing-specifications"},{"title":"Specifications and code generation","description":"How specifications drive code generation — the whole spec set feeds Frontend-Only, Backend-Only, or Full-Stack generation in one pass.","href":"/features/specifications/specifications-and-code-generation"},{"title":"Best practices for specifications","description":"How to write specifications that produce good code — what to include, what to leave out, when to be precise vs. vague.","href":"/features/specifications/best-practices"},{"group":"Functional Design","pages":[{"title":"Overview","description":"Functional Design defines what the app does and who does it — archetype, user types, features, system services, and system requirements.","href":"/features/specifications/functional-design/overview"},{"title":"Archetype","description":"The foundational shape of your app — solution type, commercialization strategy, and the details of how it generates revenue.","href":"/features/specifications/functional-design/archetype"},{"title":"User Types","description":"The personas who use your app and the use cases each one performs — the source of truth for permissions and feature access.","href":"/features/specifications/functional-design/user-types"},{"title":"Features","description":"Modules and the features inside them — each feature has user stories, business rules, and acceptance criteria that drive code generation.","href":"/features/specifications/functional-design/features"},{"title":"System Services","description":"Foundational capabilities your app needs — auth, payments, notifications, file storage, audit logs, and multi-language support.","href":"/features/specifications/functional-design/system-services"},{"title":"System Requirements","description":"Non-functional requirements your app needs to meet — regional, compliance, security, performance, and accessibility.","href":"/features/specifications/functional-design/system-requirements"}]},{"group":"Visual Design","pages":[{"title":"Overview","description":"Visual Design defines how your app looks and behaves on screen — brand, design principles, styling, and reusable layout templates.","href":"/features/specifications/visual-design/overview"},{"title":"General","description":"Brand identity and form factors — logos, favicons, and which device sizes the app needs to support.","href":"/features/specifications/visual-design/general"},{"title":"Design Principles","description":"The visual and interaction principles your design and engineering teams should follow when extending or customizing the generated UI.","href":"/features/specifications/visual-design/design-principles"},{"title":"Styling","description":"Theme, typography, UI framework, and iconography — the concrete style tokens Archie applies across the generated frontend.","href":"/features/specifications/visual-design/styling"},{"title":"Layout","description":"Reusable page templates for the major sections of your app — main navigation, authentication, public landing, onboarding, minimal, and custom.","href":"/features/specifications/visual-design/layout"}]},{"group":"Technical Design","pages":[{"title":"Overview","description":"Technical Design covers the engineering plan — strategy, data model, custom functions, and integrations.","href":"/features/specifications/technical-design/overview"},{"title":"Strategy","description":"The Technical Strategy spec — architecture sections plus Mermaid diagrams that document and drive the generated codebase.","href":"/features/specifications/technical-design/strategy"},{"title":"Data Model","description":"The data-model spec — a synchronized view of the tables, relationships, and types defined in your Backend → Data Model.","href":"/features/specifications/technical-design/data-model"}]}]}]},"basePath":"","title":"Editing specifications - Archie Documentation","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":[],"chunks":[]}