Config Project

Config Project

Overview

Executar um script determinístico e idempotente para bootstrap web+backend no padrão do monorepo. O fluxo usa npx create-turbo@latest para gerar a base padrão do TurboRepo (incluindo configs compartilhadas e .gitignore) e reconcilia apenas o que estiver faltando na pasta atual. Se .git já existir no diretório atual, o scaffold é executado com --no-git para evitar recriação de repositório git. Depois cria frontend/backend apenas quando necessário, aplica namespace do skills.config.json nos pacotes e atualiza somente os arquivos pendentes. As configurações padrão são lidas de skills.config.json (em .agents/skills/.env, .cloud/skills/.env ou .env/ no repositório de skills).

Workflow

1. Ler defaults de namespace, frontendAppPath, backendAppPath, frontendPort, backendPort e env vars no skills.config.json.
2. Detectar gaps da estrutura Turbo na pasta atual; quando necessário, executar npx create-turbo@latest e reconciliar somente os arquivos/pastas ausentes (packages/eslint-config, packages/typescript-config, .gitignore, .npmrc, configs base).
3. Antes de criar apps customizados, remover os projetos padrão do Turbo (apps/docs, apps/web e packages/ui) quando detectados como template original.
4. Criar app frontend com create-next-app --src-dir somente se frontendAppPath ainda não existir como app Next.js, garantindo estrutura src/ no frontend.
5. Criar app backend com nest new --skip-git somente se backendAppPath ainda não existir como app NestJS.
6. Garantir namespace em todos os projetos do workspace (apps/* e packages/*), incluindo frontend/backend, usando namespace do config (ou --scope).
7. Instalar apenas dependências faltantes (turbo, ts-node e prettier no root, dotenv no backend).
8. Atualizar package.json root, garantir .prettierrc no root e atualizar turbo.json de forma incremental.
9. Ajustar next.config.ts|js|mjs do frontend para garantir images.remotePatterns liberando imagens remotas em http e https com hostname: "**" (idempotente).
10. Atualizar .env e .env.example de frontend/backend via upsert (sem apagar chaves extras existentes).
11. Ajustar main.ts do backend de forma incremental (dotenv/config, app.enableCors(), porta via backendPortEnvVar).
12. Scaffold E2E idempotente via ensure-e2e-scaffold.mjs:
    • backend: test/jest-e2e.json, test/app.e2e-spec.ts, supertest, script test:e2e
    • root: playwright.config.ts, e2e/smoke.spec.ts, scripts test:e2e e test:e2e:web
13. Registrar execução em .log/skills.log com título da skill e lista simples dos comandos/ações relevantes (sem timestamps e sem status), garantindo .log/ no .gitignore.

Commands

Fluxo padrão:

node .agents/skills/config-project/scripts/project-init.mjs

Se o repositório estiver instalado em .cloud/skills, ajuste o caminho dos comandos.

Pular instalação global do Nest CLI (forçar npx):

node .agents/skills/config-project/scripts/project-init.mjs --skip-global-nest

Customizar paths e portas:

node .agents/skills/config-project/scripts/project-init.mjs \
  --frontend-path apps/frontend \
  --backend-path apps/api \
  --frontend-port 3000 \
  --backend-port 4000

Customizar nomes das env vars de porta/url:

node .agents/skills/config-project/scripts/project-init.mjs \
  --frontend-api-env-var NEXT_PUBLIC_API_URL \
  --backend-port-env-var PORT

Sobrescrever namespace por CLI:

node .agents/skills/config-project/scripts/project-init.mjs --scope @namespace

Scaffold E2E standalone (Angular/Vue ou reaplicar após bootstrap):

node .agents/skills/config-project/scripts/ensure-e2e-scaffold.mjs \
  --backend-path apps/backend \
  --frontend-path apps/web-angular \
  --frontend-port 4200 \
  --backend-port 4000

Resources

• scripts/project-init.mjs: script principal de bootstrap.
• scripts/ensure-e2e-scaffold.mjs: scaffold idempotente de Supertest + Playwright.
• assets/e2e-scaffold/: templates de jest-e2e.json, app.e2e-spec.ts, Playwright.
• references/bootstrap-contract.md: contrato dos arquivos e alterações que o bootstrap aplica.
• Log local de execução: .log/skills.log (não versionado; .log/ é adicionado ao .gitignore automaticamente, sem metadados extras).

Risk Logging Guardrails

• Registrar fatos de execucao em .log/skills.log com marcador no inicio da linha.
• Marcadores minimos esperados: [CMD], [FILE_CREATE], [FILE_UPDATE], [FILE_DELETE], [DIR_CREATE], [RISK], [FAIL], [AI].
• Sempre registrar [RISK] quando houver sobrescrita, exclusao, rename/move, ou fallback forcado em arquivos/pastas.
• Toda falha inesperada deve gerar [FAIL] com descricao factual curta do evento.
• Operacoes de terminal e alteracoes de arquivos devem passar pelos utilitarios compartilhados em ../utils para manter rastreabilidade consistente.

Global Standards

• Consultar ../skills-standards.md para padroes globais de nomenclatura e convencoes gerais entre skills.