Add architecture documentation

Author: jontyhuang

ARCHITECTURE.md

@@ -0,0 +1,65 @@
+# Architecture Documentation for `create-t3-app`
+
+## Overview
+
+The `create-t3-app` repository is a CLI tool designed to scaffold a new T3 application using modern web technologies such as **Next.js**, **TRPC**, and **Prisma**. It provides a streamlined way to initialize a project with preconfigured best practices and dependencies.
+
+## Folder Structure
+
+```
+├── packages/
+│   └── create-t3-app/
+│       ├── index.ts                # Main entry point for the CLI
+│       ├── cli/
+│       │   ├── commands/
+│       │   │   ├── create.ts       # Logic for creating a new T3 app
+│       │   │   └── utils.ts        # Utility functions for CLI commands
+│       │   └── cli.ts              # Command-line interface setup
+│       ├── templates/
+│       │   ├── nextjs/             # Templates for Next.js configuration
+│       │   ├── trpc/               # Templates for TRPC setup
+│       │   └── prisma/             # Templates for Prisma ORM initialization
+│       ├── utils/
+│       │   ├── fs.ts               # File system utilities
+│       │   └── prompts.ts          # Prompting utilities for user interaction
+│       └── package.json            # Package definition for the CLI
+└── README.md                     # Project overview and usage guide
+```
+
+## Core Components
+
+### CLI Interface
+
+The CLI is built using standard Node.js and command-line libraries. It provides an intuitive interface for users to interact with the scaffolding logic.
+
+### Scaffolding Logic
+
+The `index.ts` file serves as the central orchestrator for the scaffolding process. It coordinates the creation of files, directories, and configurations based on user inputs and predefined templates.
+
+### Template System
+
+Templates for **Next.js**, **TRPC**, and **Prisma** are stored in the `templates/` directory. These templates are dynamically populated with user-specific values during the scaffolding process.
+
+### Utilities
+
+The `utils/` directory contains helper functions for file operations, prompt handling, and template rendering.
+
+## Integration with Technologies
+
+### Next.js
+
+Next.js is used as the framework for building the application. The scaffolding logic includes Next.js configuration files and boilerplate code for routing, API routes, and static generation.
+
+### TRPC
+
+TRPC is integrated for backend API communication. It enables strong typing and efficient communication between the frontend and backend layers of the application.
+
+### Prisma
+
+Prisma is used as the ORM for database interactions. The scaffolding logic includes Prisma schema files and CLI commands for database migrations and model generation.
+
+## Evolution and Development
+
+The project has seen continuous improvement through regular commits addressing security, bug fixes, and feature enhancements. Notable commits include updates to dependencies, scaffolding logic refinements, and integration improvements.
+
+This architecture allows for flexibility and scalability while maintaining clean separation of concerns and leveraging the strengths of each technology.