Skip to content

docs: instruções de ambiente de desenvolvimento (Cursor Cloud) - #7

Draft
felippepestana wants to merge 1 commit into
mainfrom
cursor/env-setup-4547
Draft

docs: instruções de ambiente de desenvolvimento (Cursor Cloud)#7
felippepestana wants to merge 1 commit into
mainfrom
cursor/env-setup-4547

Conversation

@felippepestana

@felippepestana felippepestana commented Jun 2, 2026

Copy link
Copy Markdown
Owner

Adiciona AGENTS.md com instruções para agentes na nuvem: venv Python, flags --no-auth, portas, secrets (ANTHROPIC_API_KEY), e como rodar o AdvLabIA no repo irmão legal-ai-flow-hub.

Sem alterações de código de runtime.

Open in Web Open in Cursor 

Summary by Sourcery

Adicionar documentação do developer-agent para execução deste projeto e de seus repositórios relacionados em ambientes Cursor Cloud.

Documentação:

  • Adicionar AGENTS.md com instruções para configurar o venv do Python, executar a UI local e a CLI, configurar segredos e realizar verificações básicas de sintaxe para este repositório no Cursor Cloud.
  • Documentar como executar e validar o frontend irmão legal-ai-flow-hub (AdvLabIA), incluindo as expectativas de ambiente do Supabase.
  • Adicionar notas sobre o uso de sessões tmux em servidores de desenvolvimento e a configuração opcional da stack JurisBotIA.
Original summary in English

Summary by Sourcery

Add developer-agent documentation for running this project and its related repositories in Cursor Cloud environments.

Documentation:

  • Add AGENTS.md with instructions for setting up Python venv, running the local UI and CLI, configuring secrets, and basic syntax checks for this repository in Cursor Cloud.
  • Document how to run and validate the sibling legal-ai-flow-hub (AdvLabIA) frontend, including Supabase environment expectations.
  • Add notes on using tmux sessions on dev servers and optional JurisBotIA stack setup.

Co-authored-by: FelippePestana <felippepestana@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Jun 2, 2026

Copy link
Copy Markdown

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: f82f4095-7841-4cc6-bb0c-fdbb2ac8fc33

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/env-setup-4547

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@sourcery-ai

sourcery-ai Bot commented Jun 2, 2026

Copy link
Copy Markdown

Guia do Revisor

Adiciona AGENTS.md com instruções de ambiente e runtime para executar este repositório e repositórios relacionados no Cursor Cloud, incluindo configuração de venv, flags do servidor de desenvolvimento local, segredos necessários e referências a projetos irmãos e uso de tmux; sem alterações em código de runtime.

Alterações por Arquivo

Alteração Detalhes Arquivos
Documentar a configuração e o uso de desenvolvimento específicos do Cursor Cloud para este repositório e repositórios relacionados.
  • Descrever o layout do workspace multi-repositório e fazer referência ao CLAUDE.md existente para contexto adicional.
  • Fornecer etapas para criação de ambiente virtual Python e instalação de dependências, incluindo pacote de sistema alternativo para suporte a venv.
  • Documentar como executar a UI de desenvolvimento local sem autenticação, incluindo configuração de host/porta e segredos de ambiente necessários.
  • Listar comandos CLI disponíveis, um comando simples de smoke test de sintaxe e restrições de uso do script de deploy em produção.
  • Adicionar instruções de quickstart para executar o frontend Vite do repositório irmão legal-ai-flow-hub (AdvLabIA), incluindo dev, build, lint e detalhes de ambiente do Supabase.
  • Recomendar o uso de sessões tmux para servidores de desenvolvimento de longa duração com uma configuração tmux compartilhada.
  • Descrever brevemente o JurisBotIA como um fork pesado opcional do Supabase com configuração baseada em Docker que não deve ser iniciado automaticamente por scripts de atualização da VM.
AGENTS.md

Dicas e comandos

Interagindo com o Sourcery

  • Acionar uma nova revisão: Comente @sourcery-ai review no pull request.
  • Continuar discussões: Responda diretamente aos comentários de revisão do Sourcery.
  • Gerar uma issue do GitHub a partir de um comentário de revisão: Peça ao Sourcery para criar uma issue a partir de um comentário de revisão respondendo a ele. Você também pode responder a um comentário de revisão com @sourcery-ai issue para criar uma issue a partir dele.
  • Gerar um título de pull request: Escreva @sourcery-ai em qualquer lugar no título do pull request para gerar um título a qualquer momento. Você também pode comentar @sourcery-ai title no pull request para (re)gerar o título a qualquer momento.
  • Gerar um resumo do pull request: Escreva @sourcery-ai summary em qualquer lugar no corpo do pull request para gerar um resumo do PR a qualquer momento exatamente onde você quiser. Você também pode comentar @sourcery-ai summary no pull request para (re)gerar o resumo a qualquer momento.
  • Gerar o guia do revisor: Comente @sourcery-ai guide no pull request para (re)gerar o guia do revisor a qualquer momento.
  • Resolver todos os comentários do Sourcery: Comente @sourcery-ai resolve no pull request para resolver todos os comentários do Sourcery. Útil se você já tratou todos os comentários e não quer mais vê-los.
  • Dispensar todas as revisões do Sourcery: Comente @sourcery-ai dismiss no pull request para dispensar todas as revisões existentes do Sourcery. Especialmente útil se você quiser começar do zero com uma nova revisão — não esqueça de comentar @sourcery-ai review para acionar uma nova revisão!

Personalizando sua Experiência

Acesse seu dashboard para:

  • Habilitar ou desabilitar recursos de revisão, como o resumo de pull request gerado pelo Sourcery, o guia do revisor e outros.
  • Alterar o idioma da revisão.
  • Adicionar, remover ou editar instruções de revisão personalizadas.
  • Ajustar outras configurações de revisão.

Obtendo Ajuda

Original review guide in English

Reviewer's Guide

Adds AGENTS.md with environment and runtime instructions for running this repo and related repos in Cursor Cloud, including venv setup, local dev server flags, required secrets, and references to sibling projects and tmux usage; no runtime code changes.

File-Level Changes

Change Details Files
Document Cursor Cloud-specific development setup and usage for this repo and related repos.
  • Describe multi-repo workspace layout and reference existing CLAUDE.md for additional context.
  • Provide Python virtual environment creation and dependency installation steps, including fallback system package for venv support.
  • Document how to run the local dev UI without authentication, including host/port configuration and required environment secrets.
  • List available CLI commands, a simple syntax smoke test command, and production deploy script usage constraints.
  • Add quickstart instructions for running the sibling legal-ai-flow-hub (AdvLabIA) Vite frontend, including dev, build, lint, and Supabase env details.
  • Recommend using tmux sessions for long-running dev servers with a shared tmux config.
  • Briefly describe JurisBotIA as an optional heavy Supabase fork with docker-based setup that should not be auto-started by VM update scripts.
AGENTS.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new documentation file AGENTS.md containing workspace instructions, local development setups, and environment configurations for Cursor Cloud. The review feedback suggests improving the setup instructions by using the generic python3-venv package instead of a hardcoded version to prevent compatibility issues, and consistently referencing the virtual environment's Python executable (.venv/bin/python) for CLI commands and syntax smoke tests.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread AGENTS.md

- **Venv:** `.venv` na raiz (`python3 -m venv .venv` na primeira vez).
- **Instalar:** `.venv/bin/pip install -r requirements.txt`
- **Se venv falhar:** instalar pacote de sistema `python3.12-venv` (uma vez por VM).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Usar um pacote de versão fixa como python3.12-venv pode falhar se a VM do Cursor Cloud utilizar uma versão diferente do Python como padrão (por exemplo, Python 3.11, que é o especificado no deploy/setup.sh). Recomenda-se utilizar o pacote genérico python3-venv, que instala automaticamente a dependência correta para a versão padrão do Python do sistema.

Suggested change
- **Se venv falhar:** instalar pacote de sistema `python3.12-venv` (uma vez por VM).
- **Se venv falhar:** instalar pacote de sistema python3-venv (uma vez por VM).

Comment thread AGENTS.md
Comment on lines +16 to +17
- **CLI:** `nova`, `listar`, `info`, `analisar`, `consultar` — `python -m analista_processual --help`.
- **Smoke de sintaxe:** `python -m py_compile analista_processual/*.py` (não há pytest no repo).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Para garantir que os comandos CLI e o smoke test de sintaxe rodem no ambiente virtual correto (com todas as dependências instaladas), é recomendável utilizar o caminho do executável do venv (.venv/bin/python) de forma consistente com as instruções anteriores, ou indicar a ativação do ambiente virtual.

Suggested change
- **CLI:** `nova`, `listar`, `info`, `analisar`, `consultar``python -m analista_processual --help`.
- **Smoke de sintaxe:** `python -m py_compile analista_processual/*.py` (não há pytest no repo).
- **CLI:** nova, listar, info, analisar, consultar — .venv/bin/python -m analista_processual --help.
- **Smoke de sintaxe:** .venv/bin/python -m py_compile analista_processual/*.py (não há pytest no repo).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants