Pular para o conteúdo
Fincraft

Projetos

Código que a gente abriu.

Ferramentas que nasceram resolvendo problema fiscal e financeiro de verdade e hoje estão públicas, com licença MIT. Baixe o .zip da versão ou clone o repositório — o código é o produto, não uma demonstração atrás de cadastro.

Cada projeto traz dado de exemplo fictício, instrução de execução local e as regras à vista no código. São prévias para desenvolvedor: servem para estudar o fluxo, adaptar à sua operação e conferir como a Fincraft trata evidência — não substituem a conferência de quem responde pela obrigação.

01

Wavern Skills

Skills para investigar registro fiscal e financeiro com um agente de código.

Três skills que organizam documento, evento e transação em um caso que uma pessoa consegue revisar: emissão de NF-e, pagamento repetido e tarifa de cartão. Cada uma traz a instrução do agente, dados de exemplo e um motor em Python que roda só com a biblioteca padrão.

Linguagem
Python
Versão
v0.1.0
Licença
MIT
Requer
Python 3 — sem dependência externa
Publicado
28 de out. de 2026

Do que é feito

  • Skillnfe-incident-investigator

    Instala no agente de código e guia a investigação de emissão de NF-e

  • Skillduplicate-payment-investigator

    Liquidação repetida, extrato exportado duas vezes e devolução

  • Skillpayment-fee-auditor

    MDR, taxa fixa e divergência em relação à taxa contratada

  • CLIscripts/investigate.py

    Motor de cada skill. Roda direto, sem agente e sem dependência

O que entrega

  • NF-e: linha do tempo de transmissão, recibo, resposta cStat e conflito de protocolo
  • Pagamento duplicado: liquidação repetida, extrato exportado duas vezes e devolução
  • Tarifa: MDR, taxa fixa e divergência em relação ao combinado
  • Relatório em JSON e em Markdown, com o que ficou faltando investigar

Para rodar o exemplo

npx skills@latest add fincraft-solutions/wavern-skills

Os exemplos usam registros fictícios. Investigação real depende de entrada confiável e de conferência nos seus próprios sistemas.

02

Pente-Fino

Diagnóstico de cenários de DAS por regras que dá para ler no código.

Examina cenários de DAS de MEI e Simples Nacional e aponta os itens que merecem conferência. Cada apontamento diz qual regra o levantou, então um especialista consegue refazer o caminho do cálculo.

Linguagem
TypeScript
Versão
v0.1.0
Licença
MIT
Requer
Node.js 22.20 ou superior
Publicado
28 de out. de 2026

Do que é feito

  • Regrassrc/regras/

    As verificações do DAS, em código — sem modelo no caminho

  • CLInpm run diagnosticar

    Recebe o cenário em JSON e devolve o relatório em Markdown

  • Agentesrc/resumo-ia.ts

    Opcional e isolado: só resume o que as regras já apontaram

O que entrega

  • Verificações abertas, em `src/regras/` — nada escondido atrás de modelo
  • Apontamento com o motivo da sinalização, não só o resultado
  • Cenários de comércio, de serviços e de MEI para comparar lado a lado
  • Resumo por IA é opcional e isolado: o exemplo roda sem provedor nenhum

Para rodar o exemplo

npm ci && npm run diagnosticar -- exemplos/simples-comercio.json

São cenários para exploração técnica. Tabela e classificação precisam ser conferidas na competência certa antes de uso profissional.

03

Em Dia

Carteira de empresas virando fila de obrigação revisável.

Transforma uma carteira de empresas em uma fila de prazos para acompanhar. Confere datas, prepara o lembrete para alguém revisar e redige a mensagem — sem enviar nada por padrão.

Linguagem
TypeScript
Versão
v0.1.0
Licença
MIT
Requer
Node.js 22.20 ou superior
Publicado
28 de out. de 2026

Do que é feito

  • Regrassrc/regras.ts

    Decide o que está pendente, por parâmetro local

  • CLInpm run rodar

    Monta a fila do dia e o registro da simulação de envio

  • Agenteredação da mensagem

    Opcional: `--sem-ia` desliga e o fluxo segue inteiro

O que entrega

  • Fila em Markdown e registro da simulação de envio em JSON
  • Regras de pendência por parâmetro local, em `src/regras.ts`
  • Exemplo de agendamento por GitHub Actions já no repositório
  • Envio real exige configurar remetente e habilitar a etapa de propósito

Para rodar o exemplo

npm ci && npm run rodar -- exemplos/carteira.json --sem-ia

O exemplo usa empresas fictícias e não dispara e-mail. Calendário, destinatário e credencial são configuração de cada operação.

04

Dona Norma

Assistente de dúvida fiscal que mostra de onde tirou a resposta.

Responde dúvidas frequentes de MEI e Simples Nacional a partir de uma base legal versionada no próprio repositório, com a citação anexada à resposta. Quando a pergunta passa do material, o caso é encaminhado para revisão profissional.

Linguagem
TypeScript
Versão
v0.1.0
Licença
MIT
Requer
Node.js 22.20 ou superior · chave de provedor só para perguntar
Publicado
28 de out. de 2026

Do que é feito

  • Agentenpm run perguntar

    Responde com citação da base legal. Exige chave de provedor

  • Skillskill/SKILL.md

    Versão portátil, para levar a assistente para dentro do seu agente

  • CLInpm run verificar-base

    Confere a base legal local. Roda sem provedor e sem custo

O que entrega

  • Base legal em `base-legal/`, versionada e aberta para inspeção
  • Prompt do sistema no repositório, em `prompts/sistema.md`
  • Conferência da base roda local, sem provedor e sem custo
  • Traz uma skill portátil e um comando que empacota ela

Para rodar o exemplo

npm ci && npm run verificar-base

É uma prévia para explorar resposta com fonte. Decisão tributária específica tem de ser verificada na orientação oficial vigente.

Issue, pull request e fork são bem-vindos. A organização no GitHub reúne tudo, inclusive o que ainda não tem versão publicada.

Próximo passo

Conta qual processo está custando caro.

Descreva a rotina que trava a operação. A gente responde com uma leitura do problema — se não for caso para automação, falamos isso também.

Rio de Janeiro · RJ — atendimento remoto em todo o Brasil