docs: add AGENTS.md with Cursor Cloud setup/run notes

[sraphaz]

📋 Descrição

Configuração do ambiente de desenvolvimento para Cloud Agents e adição de AGENTS.md com instruções não óbvias de setup/execução. Nenhum código de aplicação foi alterado.

Ambiente provisionado nesta sessão (persiste no snapshot da VM):

• .NET 8 SDK (8.0.422) em /usr/local/dotnet
• Flutter 3.27.4 + Dart em /usr/local/flutter
• Node 22 / npm já presentes no ambiente

Update script (refresh de dependências no boot) registrado: dotnet tool restore, dotnet restore Arah.sln, npm install em frontend/{wiki,portal,devportal}, e flutter pub get em frontend/arah.app.

🔄 Tipo de Mudança

• Mudança em documentação
• Mudança em configuração

🧪 Testes

Validei cada serviço end-to-end neste ambiente:

Serviço	Lint / Análise	Testes	Build / Run
Backend API (Arah.sln)	—	dotnet test Arah.Tests (1887 passed; 2 perf/SLA flaky), Arah.Tests.Bff (130 passed)	dotnet build -c Release ✅; API em :5178 ✅; BFF em :5005 ✅
Wiki (frontend/wiki)	type-check ✅ (next lint quebrado no Next 16)	npm test (15) ✅	npm run dev :3001/wiki ✅
Portal (frontend/portal)	next lint quebrado no Next 16	—	npm run dev :3000 ✅
DevPortal (frontend/devportal)	—	npm test (48) ✅	estático
App (frontend/arah.app)	flutter analyze --no-fatal-infos ✅	flutter test (26) ✅	flutter pub get ✅

Hello-world (API, provider InMemory): POST /api/v1/auth/signup → JWT, POST /api/v1/territories/suggestions → 201, GET /api/v1/territories → 200.

📝 Lista de Documentos Atualizados

• AGENTS.md (novo) - notas Cursor Cloud: usar Arah.sln, exigência de JWT__SIGNINGKEY, provider InMemory padrão, portas (API 5178 / BFF 5005 / wiki 3001 sob /wiki / portal 3000), next lint quebrado no Next 16, testes de performance flaky.

📸 Screenshots

Demonstração dos frontends Next.js (portal e wiki) rodando localmente.

  

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 342f2e1b-a036-4eb2-80b1-34dd8ce521a8

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/setup-dev-environment-1c6f

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}