Skip to content

feat: add nfe-io SDK skill#26

Merged
andrekutianski merged 5 commits intomasterfrom
feat/skills
Apr 13, 2026
Merged

feat: add nfe-io SDK skill#26
andrekutianski merged 5 commits intomasterfrom
feat/skills

Conversation

@andrekutianski
Copy link
Copy Markdown
Collaborator

Resumo

Este PR adiciona o recurso de "skill" nfeio-sdk ao repositório. A skill contém orientação completa e referências para desenvolvedores e agentes que trabalham com o SDK Node.js nfe-io (NFE.io), cobrindo padrões de uso, fluxos assíncronos de emissão de notas, manuseio de erros, download de arquivos, certificados e integrações de consulta (CNPJ/CPF/CEP).

O que foi alterado

  • skills/nfeio-sdk/SKILL.md (novo/atualizado) — descrição completa da skill e gatilhos.
  • skills/nfeio-sdk/references/* — arquivos de referência de suporte (data services, product invoices, error handling).
  • Outros arquivos de limpeza/coordenação (documentação): CLAUDE.md, AGENTS.md.

Arquivos alterados (commits no branch):

  • AGENTS.md (removido)
  • CLAUDE.md (adicionado/atualizado)
  • FILE_CONFIGURATION.md (removido)
  • RELEASE_COMMANDS.ps1 (removido)
  • RELEASE_SCRIPTS_COMPARISON.md (removido)
  • package.json (atualizado)
  • skills/nfeio-sdk/SKILL.md (adicionado)
  • skills/nfeio-sdk/references/data-services-and-lookups.md (adicionado)
  • skills/nfeio-sdk/references/error-handling-and-patterns.md (adicionado)
  • skills/nfeio-sdk/references/product-invoices-and-taxes.md (adicionado)

Motivação

Ter uma skill dedicada melhora a consistência das respostas automatizadas e fornece um guia único para desenvolvedores que trabalham com o ecossistema de documentos fiscais brasileiros via nfe-io. Isso reduz retrabalho, centraliza boas práticas (por exemplo, tratamento de createAndWait() vs create()), e documenta armadilhas comuns (tipo de federalTaxNumber, diferenciação de paginação, comportamento de arquivos PDF/XML, etc.).

Critérios de Aceitação

  • skills/nfeio-sdk/SKILL.md presente e legível.
  • Referências de suporte adicionadas em skills/nfeio-sdk/references/.
  • Commit(s) no branch feat/skills prontos para revisão.
  • PR criado apontando para master (branch padrão do repositório).

Testes / Verificação

Este PR é predominantemente documental.

  • A leitura de skills/nfeio-sdk/SKILL.md para cobertura de cenários.
  • Links internos para os arquivos em skills/nfeio-sdk/references/.
  • Coerência do package.json caso tenha sido atualizado.

Notas adicionais

O conteúdo do SKILL está desenhado para uso por agentes e por desenvolvedores humanos — contém exemplos de código, padrões de erro e decisões arquiteturais.

@andrekutianski andrekutianski self-assigned this Apr 13, 2026
@andrekutianski andrekutianski merged commit ff49f72 into master Apr 13, 2026
8 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant