# Architecture Specification ## 1. Single Non-Negotiable Tech Stack - **Language:** TypeScript (strict mode) - **Backend Framework:** Node.js / Express - **Frontend Framework:** React / Next.js - **Database:** PostgreSQL - **ORM:** Prisma ## 2. Directory Structure Tree ``` . ├── src/ │ ├── controllers/ │ ├── routes/ │ ├── services/ │ └── models/ ├── tests/ ├── .ai_agency/ ├── Dockerfile ├── docker-compose.yml └── .env.example ``` ## 3. State Management Strategy - Centralized JSON-based persistence via .ai_agency/memory/state.json with atomic checkpointing and resume mode. ## 4. Deployment / Docker Architecture - Multi-stage Docker builds with non-root user execution and isolated container networking.