feat: generate ARCHITECTURE.md documenting the project structure

packages/cli/src/ui.ts

@@ -0,0 +1,24 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+
+// Prompt wrappers
+export async function prompt(questions: inquirer.QuestionCollection) {
+  return inquirer.prompt(questions);
+}
+
+// Logging helpers
+export function logSuccess(message: string) {
+  console.log(chalk.green('✔ ' + message));
+}
+
+export function logError(message: string) {
+  console.error(chalk.red('✖ ' + message));
+}
+
+export function logInfo(message: string) {
+  console.log(chalk.blue('ℹ ' + message));
+}
+
+export function logWarning(message: string) {
+  console.warn(chalk.yellow('⚠ ' + message));
+}

packages/core/src/templates/node-ts/ARCHITECTURE.md

@@ -0,0 +1,25 @@
+# Arquitetura do Projeto
+
+Este documento descreve a arquitetura escolhida durante a configuração do projeto.
+
+## Estrutura de Pastas
+
+- `src/`: Contém o código-fonte principal da aplicação.
+- `test/`: Inclui os testes automatizados.
+- `docs/`: Documentação adicional do projeto.
+- `config/`: Arquivos de configuração e ambientes.
+- `public/`: Recursos públicos, como imagens e arquivos estáticos.
+
+## Finalidade de Cada Pasta
+
+- **src/**: Onde toda a lógica de negócio e componentes principais residem.
+- **test/**: Testes unitários, de integração e end-to-end.
+- **docs/**: Documentação técnica, ADRs e guias de uso.
+- **config/**: Configurações de ambiente, variáveis e scripts de inicialização.
+- **public/**: Arquivos acessíveis diretamente pelo servidor web.
+
+## Melhores Práticas e Referências
+
+- [12 Factor App](https://12factor.net/pt_br/)
+- [Node.js Best Practices](https://github.com/goldbergyoni/nodebestpractices)
+- [Clean Architecture](https://dev.to/eduardomoroni/clean-architecture-na-pratica-4e1b)