Skip to main content
Technical Design covers how the app is built and runs. Two pages live inside Specifications; two more are sidebar cross-links to dedicated areas of Backend.

Strategy

Technical strategy with Mermaid diagrams — system overview, architectural principles, data architecture, and more.

Data Model

The high-level data model summary; full editor lives in Backend → Data Model.

Custom Functions

Cross-link. Custom server logic lives under Backend, not Specifications.

Integrations

Cross-link. Third-party connections live under Backend, not Specifications.

​
What’s actually a spec

Strategy and Data Model are the technical specifications proper. Custom Functions and Integrations appear in the Technical Design sidebar group for navigation convenience, but their content is configured under Backend — that’s where credentials, code, and deployment live. When you change a custom function or an integration, you don’t re-run spec generation; you edit it in place and the change applies on the next deployment.

​
How technical specs feed generation

Strategy describes the architecture in prose and diagrams — the build agents read it when making structural decisions about the codebase (modular monolith vs. service split, REST vs. GraphQL emphasis, where caching should live). Data Model defines the tables, relationships, and types the backend exposes. Both feed code generation directly. The Strategy page also stores the Mermaid diagrams Archie’s agents reference and humans can read when onboarding to the project.

​
FAQ

For navigation. They’re closely related to the technical strategy and data model, so the product surfaces them together. The actual configuration and code lives under Backend.
Archie always generates a strategy from your plan. You can edit or simplify it; you can’t skip it. The strategy is what the build agents use to make architecture-level decisions.
Yes. The Data Model spec page is a synchronized view of the actual data model — edits in either place reflect in both.