| name | portal-implementation |
| description | Fluxo de trabalho para implementações no portal. Use esta skill quando o usuário pedir para implementar, adicionar, criar ou corrigir algo no projeto portal. Aciona em pedidos como "implementa", "adiciona", "cria uma feature", "corrige o bug", "muda o componente", "desenvolve", "faz a tela de", ou qualquer tarefa de desenvolvimento no repositório portal. |
| version | 1.0.0 |
Portal — Fluxo de Implementação
Sempre que o usuário solicitar uma implementação no portal, siga estas etapas na ordem indicada.
1. Verificar e criar branch
Antes de qualquer alteração de código:
-
Verifique a branch atual com git branch --show-current.
-
Se estiver em development (ou main), crie uma branch descritiva para a tarefa:
git checkout -b feature/<nome-curto-descritivo>
Use os prefixos do projeto:
feature/ — nova funcionalidadefix/ — correção de bugrefactor/ — refatoração sem mudança de comportamentochore/ — tarefas de manutenção (deps, config, etc.)
-
Se já estiver em uma branch de trabalho (não development/main), continue nela sem criar outra.
2. Analisar componentes existentes antes de criar novos
Quando a implementação envolver interface ou componentes:
- Antes de criar qualquer arquivo novo, use Grep e Glob para buscar componentes relacionados em
src/components/ e src/app/.
- Verifique se já existe:
- Um componente shadcn/ui (
src/components/ui/) que atenda à necessidade.
- Um componente de negócio (
src/components/) reutilizável.
- Um padrão de layout já usado em outra página do
src/app/(public)/.
- Prefira editar um componente existente a criar um novo.
- Só crie um novo componente se não houver nenhum adequado — e justifique brevemente.
3. Implementar seguindo as convenções do projeto
- Server Components por padrão nas páginas; use
'use client' apenas quando necessário (interatividade, hooks de estado/efeito).
- Padrão
Result<T> para todas as server actions em actions.ts.
- Tipagem com os tipos de
src/types/ (ex.: ArticleRow).
- Estilos via Tailwind CSS 4; cores institucionais definidas em
globals.css (--government-blue, --government-red, etc.).
- Imports na ordem: React/Next → libs externas → componentes internos → utilitários/tipos.
- Nomes: componentes em PascalCase, utilitários em camelCase, classes CSS em kebab-case.
4. Finalizar com oferta de commit e PR
Após concluir a implementação, sempre perguntar ao usuário:
Implementação concluída. Deseja que eu faça o commit e abra um Pull Request para a branch development?
Se o usuário confirmar:
- Rode
pnpm lint e corrija eventuais erros antes de commitar.
- Faça o commit seguindo a convenção do projeto:
<prefixo>: <descrição concisa em português>
- <detalhe 1>
- <detalhe 2>
Prefixos: feature:, fix:, refactor:, docs:, chore:.
Nunca incluir Co-Authored-By na mensagem.
- Faça push da branch:
git push -u origin <branch>.
- Abra o PR com
gh pr create apontando para development, com título e descrição resumindo o que foi implementado.
