João Henrique
5cc50f00a4
- tornado obrigatório registrar uma linha de resumo para cada implementação concluída - corrigido o Scanner e o Retakes no painel usando o Python do venv (3.14) em vez do /usr/bin/python3 3.9 e injetado o caminho da engine no executar_retakes.py Resumo: - 7 arquivos alterados - 0 novos - 7 modificados - 0 removidos 7 files changed, 57 insertions(+), 8 deletions(-) Arquivos: - .gitignore - AGENTS.md - CLAUDE.md - admin/DEV-NOTES.md - admin/deploy.command - code/cep-plugin/main.js - code/engine/executar_retakes.py
64 lines
4.4 KiB
Markdown
64 lines
4.4 KiB
Markdown
# AGENTS.md
|
|
|
|
## Project Skills
|
|
|
|
## Resumo obrigatório para commits
|
|
|
|
Toda pessoa, agente ou IA que implementar qualquer alteração neste projeto
|
|
deve, antes de finalizar o trabalho, acrescentar **uma única linha** ao final
|
|
de `admin/COMMIT-DETAILS.md`, em PT-BR, resumindo o que foi feito. Nunca
|
|
substituir nem apagar as linhas já registradas durante o lote. A linha deve
|
|
ser curta, sem credenciais, tokens ou dados sensíveis; por exemplo:
|
|
`- corrigido o carregamento do Scanner quando executado pelo painel CEP`.
|
|
|
|
O script `admin/deploy.command` incorpora todas as linhas na mensagem do
|
|
commit e limpa o arquivo somente após o commit ser concluído com sucesso. Se
|
|
o commit falhar, os resumos devem ser preservados para nova tentativa.
|
|
|
|
## Convenções obrigatórias de Python / OO
|
|
|
|
Todo código Python em `code/engine/` deve seguir a skill **`.agents/skills/boas-praticas-oo/SKILL.md`** (boas práticas de programação orientada a objetos) — obrigatória, aplicada automaticamente, não apenas quando solicitada. Leia-a antes de criar, modificar, corrigir, revisar, refatorar ou ampliar qualquer sistema Python.
|
|
|
|
Resumo das regras vinculantes:
|
|
|
|
- **PT-BR obrigatório** em todos os identificadores internos (classes, métodos, variáveis, atributos, parâmetros, constantes, arquivos, pastas, módulos), docstrings, comentários, logs, mensagens de erro e documentação. Identificadores externos (bibliotecas, APIs, contratos) são preservados e isolados em adaptadores/integrações.
|
|
- **Nomenclatura**: classes `PascalCase`; métodos, funções, variáveis e arquivos `snake_case`; constantes `MAIÚSCULAS_COM_SUBLINHADO`. Evitar nomes genéricos (`Util`, `Helper`, `Manager`, `Data`).
|
|
- **Documentação obrigatória**: docstring no topo de todo módulo, classe e método público, mantida coerente com o comportamento real (documentação viva).
|
|
- **Arquitetura**: responsabilidade única, alta coesão, baixo acoplamento, composição antes de herança, herança só com especialização real, encapsulamento, interfaces pequenas, injeção de dependências, métodos pequenos e objetivos.
|
|
- **Domínio**: regras de negócio ficam no domínio/aplicação, nunca misturadas com interface, SQL, HTTP ou apresentação. Integrações externas isoladas em módulos próprios.
|
|
- **Erros e segurança**: tratar erros com exceções específicas (nunca `except Exception: pass`), validar toda entrada externa, não registrar credenciais, não duplicar regras, retornos previsíveis.
|
|
- **Testes**: toda funcionalidade relevante deve ter testes (unitário, integração, regressão); criar/atualizar teste ao corrigir bug.
|
|
- Seguir o **checklist obrigatório** (seção 41 da skill) antes de finalizar qualquer implementação.
|
|
|
|
## Interface do painel
|
|
|
|
Quando o usuário pedir uma implementação “na tela”, “no painel” ou “na interface do MCP”, use o painel CEP em `code/cep-plugin/`, identificado por **MCP for Adobe Premiere Pro** e pelas abas **Editar vídeo**, **Scanner**, **Conexão**, **Modelos** e **Ajustes**. Essa é a interface de produto; não criar fluxos de interface alternativos em `code/uxp-plugin/`.
|
|
|
|
Este projeto usa skills do mattpocock/skills para manter integridade e organização do código.
|
|
|
|
### Skills disponíveis
|
|
|
|
| Skill | Trigger | Descrição |
|
|
|-------|---------|-----------|
|
|
| `improve-codebase-architecture` | `/improve-codebase-architecture` | Escaneia oportunidades de melhoria no codebase |
|
|
| `codebase-design` | `/codebase-design` | Projetar módulos profundos (muita funcionalidade, interface simples) |
|
|
| `domain-modeling` | `/domain-modeling` | Constrói vocabulário compartilhado no projeto |
|
|
| `tdd` | `/tdd` | Test-driven development - garante que código funciona antes de commitar |
|
|
| `code-review` | `/code-review` | Revisão automática de diffs (Standards + Spec) |
|
|
| `diagnosing-bugs` | `/diagnosing-bugs` | Loop disciplinado para debugar bugs complexos |
|
|
| `resolving-merge-conflicts` | `/resolving-merge-conflicts` | Resolve conflitos git hunk por hunk |
|
|
|
|
### Uso
|
|
|
|
- Para escanear melhorias: `/improve-codebase-architecture`
|
|
- Para projetar módulos: `/codebase-design`
|
|
- Para modelar domínio: `/domain-modeling`
|
|
- Para TDD: `/tdd`
|
|
- Para revisão de código: `/code-review`
|
|
- Para debugar bugs: `/diagnosing-bugs`
|
|
- Para resolver conflitos: `/resolving-merge-conflicts`
|
|
|
|
### Skills globais
|
|
|
|
Skills adicionais estão disponíveis globalmente em `~/.agents/skills/` (outras 29 skills)...
|