Files

T

João Henrique ee181360c8 feat: criado repositório jhonny-editor no Gitea

criado repositório jhonny-editor no Gitea
adicionado script admin/deploy.command com commit automático
atualizado admin/DEV-NOTES.md com template limpo

Resumo:
- 32 arquivos alterados
- 16 novos
- 15 modificados
- 0 removidos

 16 files changed, 638 insertions(+), 61 deletions(-)

Arquivos:
  - code/engine/skills/boas-praticas-oo.md -> .agents/skills/boas-praticas-oo/SKILL.md
  - AGENTS.md
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/cep-plugin/styles.css
  - code/engine/integracoes/visual/apple_vision.py
  - code/engine/integracoes/visual/apple_vision_runner.swift
  - code/engine/integracoes/visual/extrator_ffmpeg.py
  - code/engine/scanner/__init__.py
  - code/engine/scanner/configuracao_visual.py
  - code/engine/scanner/coordenacao/__init__.py
  - code/engine/scanner/retakes/adaptador_de_falas.py
  - code/engine/scanner/retakes/agrupador_de_takes.py
  - code/engine/scanner/retakes/detector_de_reinicios.py
  - code/engine/scanner/retakes/modelos_de_retakes.py
  - code/engine/scanner/visual.py
  - .jhonny/
  - .retakes/
  - CODING_STANDARDS.md
  - code/engine/executar_retakes.py
  - code/engine/persistencia/
  - code/engine/scanner/retakes/__init__.py
  - code/engine/scanner/retakes/carregador_de_artefatos.py
  - code/engine/scanner/retakes/classificador_de_retakes.py
  - code/engine/scanner/retakes/coordenador_de_retakes.py
  - code/engine/scanner/retakes/deteccao_de_retakes.py
  - code/engine/scanner/retakes/gerador_de_evidencias.py
  - code/engine/scanner/retakes/repositorio_de_retakes.py
  - code/engine/testes/test_consultas_de_persistencia.py
  - code/engine/testes/test_deteccao_de_retakes.py
  - code/engine/testes/test_persistencia_sqlite.py
  - code/relatorios/audio/arquivos/92f97877259a86a8095b1eecafdefe357212a12247d04b78df60e0c0ae38b2ea/

2026-09-08 17:13:19 -04:00

3.6 KiB

Raw Blame History

AGENTS.md

Project Skills

Convenções obrigatórias de Python / OO

Todo código Python em code/engine/ deve seguir a skill code/engine/skills/boas-praticas-oo.md (boas práticas de programação orientada a objetos). 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)...

3.6 KiB Raw Blame History