aka-recht

AKA Recht

Uma multa, uma rescisão, uma conta de custos acessórios, uma notificação do órgão público, denúncia criminal, recurso: em algum momento, todo mundo tem um caso jurídico, e então cartas, fotos, e-mails e prazos ficam espalhados por toda parte. AKA Recht é a pasta onde tudo isso encontra seu lugar, e o manual com o qual sua IA ajuda você a organizar, revisar e redigir.

AKA Recht ajuda você a organizar casos jurídicos como rescisões, multas, denúncias criminais, recursos ou disputas de aluguel por conta própria. Seus arquivos ficam localmente no seu computador, sem armazenamento em nuvem. Cada caso tem um identificador único e uma estrutura fixa para documentos, partes envolvidas, prazos e histórico. Impressões digitais digitais (somas de verificação) tornam alterações em arquivos detectáveis.

O fim do prazo é calculado conforme §§ 187, 188 e 193 BGB, considerando finais de semana e os feriados estaduais do estado federado relevante (conforme § 193 BGB, o do local de declaração ou prestação). Qual prazo se aplica e quando ele começa, você mesmo precisa esclarecer.

Através da interface de IA MCP, é possível pesquisar arquivos, avaliar documentos e redigir correspondências. Nesse processo, tudo o que o assistente de IA lê do arquivo é transmitido ao respectivo provedor de IA. Alterações no arquivo ocorrem somente após sua confirmação expressa.

AKA Recht não substitui aconselhamento jurídico.

• Cada assunto é um caso com identificador fixo, pastas fixas, dados de ordenação em akte.json e um diário. Originais nunca são alterados.
• Prazos com cálculo: Cada prazo mostra o gatilho, a base legal e o caminho de cálculo conforme §§ 187, 188, 193 BGB, com os feriados do seu estado federado.
• Cronologia que outros também podem seguir: um caminho do tempo com o tempo no centro, à esquerda os outros órgãos, à direita seus próprios passos. Eventos centrais com um clique, cor por grupo, motivo e reação com distância ("7 dias depois"), e cada referência abre o documento.
• Sua IA trabalha junto: Claude Code, Claude Desktop, Codex ou qualquer outra que possa executar MCP (Model Context Protocol) ou comandos. 7 instruções a guiam desde o registro do caso até o rascunho revisado; 36 ferramentas permitem que ela leia no arquivo e, após sua confirmação, escreva.
• Tudo fica com você: sem IA no aplicativo, sem conta, sem chave, sem rede. O serviço roda apenas no seu computador.

Produto Versão 0.4 de 18.09.2026, estado mais recente de 04.10.2026 · Formato de dados akte.json Schema 1 · Protocolo MCP 2026-07-28 e 2025-11-25 · testado com Python 3.14.7 no macOS 26.7.1, Ubuntu 24.04 (Python 3.12) e Windows 11 (Python 3.14) · Autor: Hasan Tepegöz

Novo desde a versão 0.4

Estes pontos estão no estado mais recente de 04.10.2026, ainda não na versão fixa 0.4. Quem baixa a versão fixa da página de releases recebe-os com a próxima versão. Testado com o teste funcional (77 pontos de verificação) e na interface no macOS, Linux e Windows.

• Cronologia como caminho do tempo: à esquerda os outros órgãos, à direita os próprios passos, o tempo no centro; eventos centrais, cor por grupo, referência "resposta a" com distância, tipo próprio de evento ao lado da lista dos usuais.
• Partes envolvidas com papel e função: O papel atribui ao grupo e determina lado e cor na cronologia; a função diz em palavras livres quem alguém é, por exemplo "advogado da parte contrária".
• Rascunhos: O número da versão segue o texto: texto inalterado mantém o número quando seu status muda; texto alterado recebe um novo. Um rascunho pode ser renomeado (entwurf_setzen).
• Inventário: Ferramentas que criam um arquivo por conta própria atribuem identificador apenas a ele; outros arquivos novos permanecem não registrados até você chamar bestand_abgleichen.
• Backup: O teste de restauração informa separadamente se o arquivo está completo e se cada caso atende a todas as regras do modelo de dados.
• Início de sessão: A mensagem do hook informa seu horário; links na caixa de entrada não contam como correspondência.
• Conteúdos jurídicos: Uma execução de verificação garante que todas as referências das fichas informativas, do catálogo de fontes e dos modelos apontem para órgãos oficiais.

Baixar

Depois continue com Configurar: pré-requisitos, primeiro início por sistema, conectar a IA. Para compartilhar, divulgue o link do GitHub e não recompacte a pasta você mesmo (o porquê está em Configurar).

Na internet

No Glama, é possível experimentar as ferramentas no navegador. Isso roda em um ambiente de teste externo, mostra apenas as respostas das ferramentas sem a interface e não se destina a documentos reais.

Como se parece

Clique para ampliar. Todas as imagens mostram o caso de exemplo fictício ("Max Muster" contra "Muster Logistik GmbH"), nenhuma pessoa real.

Central: todos os casos, próximos prazos, caixa de entrada	Arquivo do caso: papel, objetivo, procedimento, prazos, tarefas
Documentos: pré-visualização, identificador, número do anexo, arquivamento	Prazos: base legal, caminho de cálculo, status de verificação
Cronologia: caminho do tempo com eventos centrais, distâncias e referências

A interface tem uma Central (visão geral, todos os casos, caixa de entrada, prazos de todos os casos, fontes jurídicas, inventário e backup, configurações, manual) e, por caso, um Arquivo do caso (visão geral, documentos com pré-visualização, partes envolvidas, procedimento, cronologia, prazos com calculadora, tarefas, rascunhos, provas e anexos, diário). É HTML, CSS e JavaScript puros, sem framework, e não precisa de acesso externo.

_{↑ para cima, para as abas}

Pré-requisitos

• Python 3.12 ou mais recente (python3 --version). Testado com 3.12.3 no Ubuntu e 3.14.7 no macOS e Windows; versões mais antigas não foram testadas. Nenhum pacote adicional.
• Testado em 02.10.2026 no macOS, Linux e Windows: teste funcional com 77 pontos de verificação e a interface.
• Testado em 18.09.2026 no macOS 26.7, no Ubuntu 24.04 (Python 3.12) e no Windows 11 (Python 3.14.7), na época com 61 pontos de verificação: serviço via script de início, servidor MCP, caso de exemplo em uma pasta com espaços e caracteres especiais, reconhecimento de texto com foto e digitalização frente e verso. A conexão dos assistentes, o reconhecimento de texto e o backup não foram retestados no Linux e Windows desde então.
• Para extratos de texto de PDF, opcionalmente o programa pdftotext (pacote poppler).
• Para fotos e digitalizações sem camada de texto, opcionalmente o reconhecimento de texto (OCR) tesseract com idioma alemão; digitalizações de PDF precisam de pdftoppm (também pacote poppler). Sem esses programas, tudo continua como antes; a pasta apenas informa que nenhum texto foi lido.

Primeiro início

1. Obter: git clone https://github.com/Cehha79/aka-recht ou no GitHub "Code", "Download ZIP" e descompactar; colocar a pasta em um local de sua escolha. Para compartilhar, compartilhe o link do GitHub, não recompacte a pasta você mesmo (veja macOS acima).
2. Iniciar: macOS Start.command, Linux Start.sh, Windows Start.bat. O serviço roda apenas em 127.0.0.1, o navegador padrão abre a interface. No primeiro início, é criado zentrale.json.
3. Em "Configurações", inserir seu remetente (nome, endereço, contato); ele fica em zentrale.json no seu computador e preenche depois "De:" e assinatura em rascunhos a partir dos modelos.
4. Na interface, criar "Novo caso", colocar correspondência em 01 Eingang ou adicionar em "Documentos", organizar, calcular prazos, manter o diário.
5. Ler a página "Instruções" na interface; lá também está como conectar uma IA.

Conectar a IA

Ferramentas de escrita só funcionam se você confirmar a chamada. Ferramentas para envio, exclusão ou alteração de originais não existem.

O que realmente funciona em cada assistente

Três coisas devem ser distinguidas: preparado significa que a pasta de trabalho traz a configuração; verificado aqui significa que testamos no nosso próprio computador; aberto significa que não sabemos.

Importante para clientes MCP puros (Claude Desktop e similares): Eles recebem as ferramentas, mas nem o perfil de trabalho nem os fluxos de verificação. As regras desta pasta de trabalho valem lá apenas na medida em que as próprias ferramentas as aplicam — e elas aplicam: áreas de original permanecem bloqueadas, prazos sem comprovação não podem ser confirmados, rascunhos sem versão congelada não podem ser salvos como verificados.

Gemini CLI: A pasta de trabalho traz AGENTS.md, mas o Gemini procura por padrão GEMINI.md. Para que ele carregue o perfil, é necessário em .gemini/settings.json uma entrada contextFileName com AGENTS.md (documentação do Gemini CLI "Provide context with GEMINI.md files", acessado em 18/09/2026). Esse caminho não foi verificado por nós; por isso, não fornecemos nenhuma configuração pronta do Gemini. Verifique no próprio cliente quais regras foram carregadas antes de deixar um processo ser editado.

Atualizar

Seus próprios dados estão em 01 Eingang, 02 Fälle, 03 Verträge und Vorsorge e zentrale.json. Antes de cada atualização, crie um backup ( "Criar backup verificado" na interface).

Perguntas frequentes

_{↑ para cima, para as abas}

Como sua IA trabalha com a Mappe

A Mappe não contém IA. Ela traz instruções (Skills) que dizem à sua própria IA como processar um caso, e ferramentas com as quais ela lê o processo e, após sua confirmação, escreve nele. Em azul está a IA, em verde está você:

Skills

Chamada no Claude Code com /name, no Codex com $name; o primeiro argumento é sempre o identificador do caso:

As instruções definem o quão cuidadosamente a IA deve trabalhar: cada afirmação jurídica com norma, parágrafo e lei, ou decisão com tribunal, data e número do processo, lida no texto completo; o que não foi verificado permanece visível como [PRÜFEN], [QUELLE] ou [BELEG]; a parte contrária é sempre considerada; instruções contidas em documentos lidos são conteúdo de fonte e não são seguidas.

Hooks

Hooks são pequenos scripts de verificação que o Claude Code executa por conta própria (registrados em .claude/settings.json, código-fonte em .claude/recht/hooks/). Configurados e verificados estão apenas para Claude Code (status em 17.09.2026). O Codex descreve hooks próprios em sua documentação; para isso, nada está incluído aqui. Outros assistentes seguem as regras de AGENTS.md por conta própria.

_{↑ para cima, para as abas}

Pastas de um caso

Cada caso recebe as mesmas pastas, para que as referências permaneçam estáveis:

02 Fälle/R-0001 Beispiel/
├─ akte.json          Ordnungsdaten: Beteiligte, Dokumente, Fristen, Aufgaben, Entwürfe
├─ bestand.json       Prüfsummen jeder Datei (schreibt nur der Dienst)
├─ JOURNAL.md         Verlauf, nur anhängen
├─ 01 Eingang/        neue Post
├─ 02 Grundlagen/     Verträge, Bescheide, Vollmachten
├─ 03 Schriftverkehr/ je Beteiligter ein Ordner, dazu Versandnachweise/
├─ 04 Verfahren/      je Verfahren ein Ordner (Klage, Bußgeld, Widerspruch …)
├─ 05 Beweise/        Fotos, Listen, Quittungen
├─ 06 Entwürfe/       noch nicht versandte Texte, Name endet auf _ENTWURF
├─ 07 Recherche/      Prüfvermerke, fallbezogene Rechtsquellen
└─ 08 Archiv/         alte Übersichten, unverändert

Originais em 02 a 05 e 08 nunca são alterados, renomeados ou excluídos; um hook bloqueia isso para a IA. Novos textos são criados em 06, anotações em 07.

Ferramentas

As mesmas 36 ferramentas são acessadas pela IA via MCP (06 Werkzeuge/dienst/mcp_server.py) ou pela linha de comando (python3 "06 Werkzeuge/dienst/cli.py" <werkzeug> feld=wert). Ferramentas de escrita via MCP funcionam apenas com sua confirmação (vale apenas o valor JSON true); pela linha de comando, a IA deve perguntar antes. Ferramentas de leitura não alteram nenhum arquivo: um arquivo novo ou movido no gerenciador de arquivos é apenas relatado; seu identificador só é atribuído por bestand_abgleichen; a interface faz isso ao abrir um caso automaticamente. Cada alteração em akte.json é verificada contra o modelo de dados e salva com revisão.

Modelos

Modelos em 05 Vorlagen/Schreiben/: no topo, instruções internas (prazo, formato, destinatário), abaixo da linha divisória, o texto de envio com placeholders 【 】. O gerador de Word .claude/recht/werkzeuge/docx_erzeugen.py transforma isso em um .docx e avisa sobre placeholders e marcadores abertos.

Folhetos informativos

Folhetos informativos em 04 Rechtsquellen/Verfahren/ descrevem, para cada recurso legal, prazo, formato, conteúdo obrigatório, destinatário e efeito, cada informação com norma e data de verificação. /fallaufnahme identifica o recurso legal a partir deles, /entwurf verifica o conteúdo obrigatório contra eles.

Comandos

_{↑ voltar ao topo para as abas}

No que você pode confiar

Um processo jurídico precisa de mais do que pastas. A pasta de arquivos impõe essas regras tecnicamente e as verifica no teste funcional:

• Originais permanecem originais. Documentos em 02 Grundlagen, 03 Schriftverkehr, 04 Verfahren, 05 Beweise e 08 Archiv são bloqueados por um hook antes que a IA toque no arquivo — verificado pelo caminho resolvido, inclusive por caminhos indiretos como .. ou atalhos, e independentemente de como os caracteres especiais estão escritos no caminho. O hook vale para o Claude Code e, lá, para suas ferramentas de arquivo (Write, Edit, MultiEdit, NotebookEdit). Novas versões pertencem a 06 Entwürfe, anotações a 07 Recherche. Limites: ele não cobre comandos arbitrários de um shell — quem permite que a IA execute comandos o contorna. Para Codex e outros assistentes, não há esse hook configurado; lá, as próprias ferramentas da pasta protegem, pois não escrevem nas áreas originais.
• Ler continua sendo ler. Nenhuma ferramenta de leitura toca em akte.json, bestand.json ou zentrale.json. Novos arquivos são registrados apenas pela sincronização.
• Identificadores nunca se repetem. Um contador por tipo de identificador lembra o maior número já atribuído; uma entrada removida nunca é substituída por uma nova com o mesmo identificador, e as referências do diário permanecem únicas.
• Versões verificadas e enviadas ficam congeladas. No status "verificado" ou "enviado", a pasta cria uma cópia somente leitura em 06 Entwürfe/Fassungen/, com soma de verificação e identificador próprio. O arquivo de trabalho pode mudar, a cópia nunca.
• Prazos são recalculados. §§ 187, 188, 193 BGB com cálculo visível; fim do mês, ano bissexto e prazos anuais são testados com 20 casos limite. O calculador não decide se um prazo se aplica.
• Confirmado significa verificado. Um prazo só é "confirmado" quando o cálculo indica o fim do prazo, há comprovante e gatilho, e nenhum marcador [PRÜFEN], [QUELLE] ou [BELEG] está aberto; a confirmação traz data e verificador, e um compromisso exige a intimação como fonte.
• Anexos externos não executam nada. "Abrir" chama o programa do sistema apenas para formatos de documento conhecidos (PDF, texto, Office, imagens, e-mail, áudio, vídeo); scripts, programas, páginas da web, arquivos compactados e desconhecidos são apenas exibidos no gerenciador de arquivos, com aviso.
• O incerto permanece visível. Um evento pode ser "aproximado", "período" ou "desconhecido", em vez de carregar um dia inventado; um prazo indica seu procedimento e seu evento gatilho, e não é confirmado sobre um evento incerto.
• As entregas contêm apenas o que deve ir. O pacote é construído para um destinatário nomeado, mostra cada arquivo antes, interrompe em identificadores desconhecidos e é relido contra seu manifesto.
• Os backups são comprovadamente utilizáveis. Cada ZIP é relido após a gravação; "verificar restauração" o extrai em uma pasta intermediária e verifica processos e somas de verificação.
• Os dados permanecem onde você os coloca. Sem IA na pasta, sem rede no serviço. O que é salvo em uma pasta na nuvem é enviado pelo seu sistema; o que sua IA lê é processado pelo provedor dela.

Backup

"Criar backup verificado" na interface grava um ZIP fora da pasta e o relê. O destino e o segundo destino estão nas configurações e são exibidos antes do primeiro backup. "Verificar restauração" extrai o último backup em uma pasta intermediária, verifica processos e somas de verificação e a remove novamente. Restauração real sempre em uma nova pasta, nunca sobre a pasta em uso: python3 "06 Werkzeuge/dienst/server.py" --restore <ZIP> <neuer Ordner>. Sem interface: --check verifica o inventário, --backup faz o backup, --probe verifica o último backup.

Três níveis que não são a mesma coisa: a pasta está no seu computador. Se um destino de backup estiver no iCloud Drive ou em outra pasta na nuvem, o sistema operacional envia o ZIP não criptografado para lá. E o que sua IA lê é processado pelo provedor dela conforme seus termos; um servidor MCP local não muda isso.

Escopo

Esta versão é feita para o direito alemão: calculadora de prazos conforme §§ 187, 188, 193 BGB com os feriados nacionais dos 16 estados federais (escolha o estado nas configurações; feriados regionais de municípios individuais não contam, feriados únicos como em Berlim em 2025 e 2028 estão registrados), catálogo de fontes com ofertas oficiais alemãs, modelos de escrita e fichas informativas para procedimentos alemães.

Outras jurisdições não são previstas. Fora da Alemanha, a pasta pode ser usada para organizar documentos, mas prazos e modelos valem apenas para a Alemanha.

A interface e seu manual estão disponíveis em alemão e inglês (Configurações › Idioma). Modelos, fichas informativas, skills e este README estão apenas em alemão; os valores nos processos também permanecem em alemão.

Limites

_{↑ voltar ao topo para as abas}

Contribuir e Apoiar

A pasta é gratuita e desenvolvida abertamente. Erros, sugestões, traduções, modelos, fichas informativas e, futuramente, pacotes de países inteiros são bem-vindos. Por favor, não envie processos reais, nomes ou números de registro. Contribuições estão sob a mesma licença (AGPL-3.0). Como uma contribuição funciona, veja em CONTRIBUTING.md.

Issues e discussões são apenas para o software e exemplos fictícios. Perguntas sobre um caso real ("O prazo se aplica a mim?") não são respondidas lá: consultoria de casos não é o objetivo deste projeto, e ninguém aqui conhece seu assunto. Para isso, procure um advogado especializado ou um serviço de aconselhamento.

Se a pasta ajudou você e quiser retribuir, o autor agradece apoio voluntário em https://github.com/sponsors/Cehha79. Contato: info@mika-tec.com.

Licença

Copyright 2026 Hasan Tepegöz. Software livre sob a GNU Affero General Public License, versão 3 (AGPL-3.0), texto em LICENSE. Em linguagem clara:

• Você pode usar, copiar, modificar e distribuir a pasta gratuitamente, tanto para uso pessoal quanto profissional.
• Quem a distribuir modificada ou a oferecer como serviço por rede deve fornecer o código-fonte completo sob a mesma licença.
• O texto da licença e os avisos de direitos autorais devem acompanhar toda distribuição.
• Sem garantia, sem responsabilidade, na medida permitida por lei.

Apenas o texto em inglês em LICENSE é vinculante; esta seção apenas o explica.

_{↑ voltar ao topo para as abas}

Impressum

Informações conforme § 5 DDG e § 18 MStV

Hasan Tepegöz, empresa individual MikaTec
Pontoiser Straße 54
71034 Böblingen
Alemanha

Telefone: 0173 5904496
E-mail: info@mika-tec.com
Web: https://www.mika-tec.com

Pequeno empresário conforme § 19 UStG; nenhum imposto sobre vendas é declarado.
Responsável conforme § 18 Abs. 2 MStV: Hasan Tepegöz, endereço acima.

Aviso sobre Inteligência Artificial

AKA Recht não contém IA em si. Serviço, interface, calculadora de prazos e ferramentas executam exclusivamente regras fixas programadas; nada é aprendido ou derivado. A pasta não é, portanto, um sistema de IA no sentido do Art. 3 nº 1 do Regulamento (UE) 2024/1689 (Regulamento de IA).

Quem usa a pasta com seu próprio assistente de IA trabalha com um sistema de IA de terceiros. Suas saídas são rascunhos, não declarações jurídicas verificadas: podem estar erradas, desatualizadas ou inventadas. Por isso, carregam os marcadores [PRÜFEN], [QUELLE] e [BELEG] e devem ser verificadas no texto completo original antes de qualquer uso. Prazos, documentos e declarações são de responsabilidade exclusiva do usuário.

AKA Recht não presta consultoria jurídica nem serviços jurídicos no sentido do § 2 RDG. Em decisões importantes: advogado especializado ou um serviço de aconselhamento reconhecido.