Contribuicao

Obrigado pelo interesse em contribuir com o advpl-specialist! Este guia explica como participar do projeto.

Como contribuir

Reportar bugs

1. Verifique se o bug ja nao foi reportado em Issues
2. Crie uma nova issue usando o template Bug Report
3. Inclua: versao do plugin, versao do Claude Code, passos para reproduzir, comportamento esperado vs atual

Sugerir melhorias

1. Crie uma issue usando o template Feature Request
2. Descreva o caso de uso e o beneficio para a comunidade ADVPL/TLPP

Enviar codigo

1. Fork o repositorio
2. Crie uma branch a partir de main: git checkout -b feat/minha-feature
3. Faca suas alteracoes seguindo as convencoes abaixo
4. Commit com mensagens Conventional Commits:
   • feat: para novas funcionalidades
   • fix: para correcoes
   • docs: para documentacao
   • chore: para tarefas de manutencao
5. Abra um Pull Request usando o template disponivel

Convencoes do projeto

Estrutura de arquivos

Exemplos de codigo ADVPL/TLPP

• Arquivos .prw usam #Include "TOTVS.CH" (nunca Protheus.ch — esta obsoleto)
• Arquivos .tlpp usam includes .th (tlpp-core.th, tlpp-rest.th, etc.)
• Nenhum using namespace tlpp.* nos exemplos — sempre usar includes .th
• using namespace e valido apenas para namespaces custom (ex: custom.vendas)
• Variaveis sempre Local (nunca Private/Public em codigo novo)
• Notacao Hungara em todas as variaveis (cNome, nValor, lOk, etc.)

Markdown

• Frontmatter YAML em commands, skills e agents
• Tabelas para referencia rapida
• Blocos de codigo com linguagem especificada (```c ou ```tlpp)

Ambiente de desenvolvimento

# Clone o repositorio
git clone https://github.com/thalysjuvenal/advpl-specialist.git

# Teste localmente com Claude Code
claude --plugin-dir ./advpl-specialist

Licenca

Ao contribuir, voce concorda que suas contribuicoes serao licenciadas sob a MIT License.