Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions .ai/guidelines/workflow/05-pull-requests.blade.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
@php
/** @var \Laravel\Boost\Install\GuidelineAssist $assist */
@endphp

# Pull Requests

When creating or updating a GitHub pull request, agents should consider the repository PR template at `.github/pull_request_template.md` as a helpful reference for structuring the PR body.

## Guidance

- Prefer using the template sections `Contexto`, `Alterações`, `Plano de Testes`, `Evidências` and `Issues Relacionadas` when they fit the change.
- Keep the structure clear and review-friendly, rather than writing a completely free-form PR description.
- Populate the checklist in `Plano de Testes` with the validation steps that were actually run, including relevant commands such as `make check` and `make test` when applicable.
- Add issue references in the `Issues Relacionadas` section using the repository's expected format (for example: `Closes #123`) when there is a related issue to link.
- If the change has no visible UI impact, keep the `Evidências` section concise or leave it empty rather than inventing screenshots.

## Expectations for agents

- It is fine to draft a PR body without the template; the absence of the template does not block the PR.
- Adapt the content to the specific change and prefer clear, concise Portuguese when the repository and existing templates are written in Portuguese.
- If the PR is for a change that affects behavior, include enough detail for reviewers to understand the impact, the validation performed, and the related issues.
67 changes: 67 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
## Contexto

<!--
Descreva o contexto deste PR respondendo às seguintes perguntas:

- Qual é o problema ou necessidade?
- Como esta alteração resolve o problema?
- Qual é o impacto esperado para o usuário ou sistema?
-->

### Alterações

<!--
Liste as principais alterações realizadas neste PR.
Se possível, informe os arquivos, componentes ou funcionalidades impactadas.
-->

- ...
- ...
- ...
Comment thread
fernanduandrade marked this conversation as resolved.

---

## Plano de Testes

<!--
Liste, em formato de checklist, todos os passos executados para validar esta alteração.
O objetivo é permitir que qualquer revisor consiga reproduzir a validação realizada.
-->

- [ ] Executar `make check`
- [ ] Executar `make test`
- [ ] ...
- [ ] ...
- [ ] ...

---

## Evidências

<!--
Adicione prints de tela, GIFs ou vídeos que demonstrem o comportamento da aplicação.
Caso a alteração não possua impacto visual, esta seção pode ser removida.
-->

### Antes

<!-- Prints, GIFs ou vídeos do comportamento anterior. -->

### Depois

<!-- Prints, GIFs ou vídeos do comportamento após a alteração. -->

---

## Issues Relacionadas

<!--
Utilize uma das opções abaixo conforme necessário.

Closes #123
Fixes #123
Resolves #123
Related to #123

Exemplo: Closes #123
-->