truthmark 2.2.2 → 2.2.5

package/docs/readmes/README.pl.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Twoi agenci piszą kod. Truthmark utrzymuje dokumentację dla ludzi, możliwą do przeglądu w Git.**
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
+
+![Baner Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Szybki start: lokalne uruchomienie w pięć minut
+
+Uruchom to w repozytorium Git, którym ma zarządzać Truthmark:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Włącz hosta AI, którego faktycznie używasz. Nowe konfiguracje są neutralne wobec hosta, więc przed inicjalizacją dodaj listę najwyższego poziomu `platforms` do `.truthmark/config.yml`:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Następnie zainstaluj lokalne dla repozytorium dokumenty truth, routing i powierzchnie workflow agentów:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Teraz wypróbuj najczęstszą ścieżkę adopcji: udokumentuj jedno istniejące zachowanie na podstawie kodu i testów. W swoim hoście kodowania AI poproś zainstalowany workflow:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+Po tym użytkownicy zwykle nie powinni wywoływać Truth Sync bezpośrednio. Kontynuuj kodowanie przez swojego hosta AI; zainstalowane instrukcje repozytorium mówią agentowi, aby przy zmianach kodu funkcjonalnego uruchomił odpowiednie testy i wykonał przegląd Truth Sync przed przekazaniem pracy. Ty przeglądasz wynikowy diff kodu oraz diff truth-doc.
+
+Jeśli chcesz tylko walidacji CLI i nie potrzebujesz jeszcze workflow AI specyficznych dla hosta, pozostaw `platforms` pominięte i uruchom `truthmark init && truthmark check`; później możesz dodać platformę i ponownie uruchomić `truthmark init`.
+
+## 💡 Problem: luka w dokumentacji AI
+
+Agenci kodujący AI są niezwykle dobrzy w szybkim pisaniu kodu. Ta prędkość tworzy jednak groźny nowy tryb awarii: **historia repozytorium zaczyna rozmijać się z rzeczywistością.**
+
+* Zachowanie ginie w ulotnych historiach czatu.
+* Dokumenty architektoniczne szybko zostają w tyle.
+* Decyzje produktowe znikają po przekazaniu pracy.
+* Recenzenci kodu oglądają surowe diffy kodu bez zrozumienia „dlaczego”.
+* Każda nowa sesja AI musi od zera odkrywać truth repozytorium.
+
+## 🎯 Rozwiązanie: Truthmark
+
+**Truthmark** instaluje w Twoim repozytorium warstwę workflow natywną dla Git. Naprawia tę część rozwoju z AI, która zwykle się psuje: pomaga utrzymać dokumentację w zgodzie z kodem.
+
+Zamiast liczyć, że ludzie i agenci AI będą pamiętać o aktualizowaniu dokumentów, Truthmark zamienia dokumentację w systematyczny, możliwy do przeglądu nawyk wewnątrz repozytorium.
+
+### ✨ Dlaczego Truthmark jest wyjątkowy
+
+Truthmark nie jest tylko kolejnym narzędziem do dokumentacji. Jest głęboko zintegrowany z workflow AI:
+
+* **🚫 Zero zależności od dostawcy:** brak usług hostowanych, ukrytych baz danych i dodatkowych serwerów do utrzymywania.
+* **🌳 100% natywny dla Git:** wszystko mieszka w Twoim repozytorium. Truth porusza się razem z gałęzią.
+* **🤝 Kontrakt należący do ludzi i wykonywany przez agentów:** Opiekunowie posiadają kontrakt repozytorium; agenci podczas kodowania podążają za zainstalowanymi instrukcjami.
+* **✅ Zaufanie przez weryfikację:** pracy AI łatwiej zaufać, ponieważ zmiany wpływające na zachowanie zawierają decyzję lub diff truth-doc możliwy do przeglądu przez człowieka.
+
+## 🔄 Jak to działa
+
+Gdy agent AI modyfikuje Twój kod, praca nie jest skończona. Truthmark instaluje strażnika workflow na zakończenie pracy, którego agenci przestrzegają przed przekazaniem:
+
+1. 💻 **Kod:** agent modyfikuje kod funkcjonalny.
+2. 🧪 **Test:** wykonywane są odpowiednie testy.
+3. 🔍 **Sprawdzenie:** Truthmark sprawdza zmapowaną dokumentację jako część zainstalowanego końcowego przeglądu.
+4. 📝 **Dokumentacja:** agent aktualizuje dokumenty, gdy truth repozytorium się zmieniła.
+5. 👀 **Przegląd:** człowiek przegląda *diff kodu* + *diff truth*.
+
+## 🛠 Jak używasz Truthmark
+
+Truthmark ma jeden lokalny kontrakt repozytorium i dwa sposoby korzystania z niego.
+
+### Ludzie instalują i walidują kontrakt
+
+Opiekunowie i CI używają CLI:
+
+* `truthmark config` - tworzy początkową konfigurację.
+* `truthmark init` - instaluje lub odświeża routing, szkielety truth-doc i instrukcje dla hostów AI.
+* `truthmark check` - waliduje truth repozytorium z terminala.
+
+### Agenci podążają za kontraktem podczas kodowania
+
+Truthmark instaluje lokalne instrukcje repozytorium dla obsługiwanych hostów kodowania AI, takich jak Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity i Cursor.
+
+Normalna pętla jest prosta:
+
+1. Poproś agenta o zmianę kodu albo o udokumentowanie istniejącego zachowania.
+2. Zainstalowane instrukcje mówią agentowi, kiedy testować, kiedy aktualizować truth docs i kiedy zatrzymać się do ludzkiego przeglądu.
+3. Przeglądasz zwykłe diffy Git: kod plus ewentualne zmiany w truth-doc.
+
+Żądania agenta uruchamiane przez użytkownika są celowo nieliczne:
+
+* `/truthmark-document` - dokumentuje istniejące zaimplementowane zachowanie z kodu i testów.
+* `/truthmark-realize` - implementuje kod z istniejących truth docs.
+* `/truthmark-check` - audytuje truth repozytorium.
+
+Truth Sync nie jest zwykłym sposobem rozpoczynania pracy; to końcowy przegląd po funkcjonalnych zmianach kodu.
+Truth Structure nie jest codzienną komendą; naprawia routing lub własność tylko wtedy, gdy blokuje to pracę.
+
+## Co otrzymujesz
+
+| Możliwość | Co robi |
+| --- | --- |
+| Truth natywny dla Git | Utrzymuje truth repozytorium w zatwierdzonych plikach Markdown i konfiguracji. |
+| Dokumentacja w zakresie gałęzi | Truth porusza się z gałęzią zamiast mieszkać w prywatnej sesji. |
+| CLI dla ludzi | Daje opiekunom komendy konfiguracji, odświeżania, walidacji i inspekcji. |
+| Zainstalowana instrukcja agenta | Mówi agentom kodującym, kiedy dokumentować, testować, synchronizować truth, audytować lub zatrzymać się do przeglądu. |
+| Jawny routing | Mapuje obszary kodu na kanoniczne dokumenty truth. |
+| Przekazania możliwe do przeglądu | Tworzy zwykłe diffy Git zarówno dla kodu, jak i dokumentów truth. |
+| Działanie local-first | Nie wymaga hostowanej usługi, demona, bazy danych ani serwera MCP. |
+| Bezpieczniejsze granice zapisu | Rozdziela workflow code-first, doc-first, read-only i doc-only. |
+| Walidacja | Raportuje problemy z routingiem, uprawnieniami, frontmatter, linkami, wygenerowaną powierzchnią, zakresem gałęzi, świeżością i pokryciem. |
+| Opcjonalny Portal | Generuje zatwierdzoną statyczną witrynę prezentacyjną HTML z dokumentów truth w Markdown, gdy jest wyraźnie włączony i zażądany. |
+
+## Przegląd wizualny
+
+![Funkcje Truthmark](../assets/truthmark-features.png)
+
+**Funkcje:** co Truthmark instaluje i jak podzielona jest powierzchnia workflow.
+
+![Pozycja Truthmark](../assets/truthmark-position.png)
+
+**Pozycja:** gdzie Truthmark mieści się względem promptów, pamięci i workflow specyfikacji.
+
+![Przepływ synchronizacji Truthmark](../assets/truthmark-syncflow.png)
+
+**Przepływ synchronizacji:** jak Truth Sync zamyka zwykłe zmiany kodu przed przekazaniem.
+
+## Dlaczego zespoły go przyjmują
+
+Truthmark jest dla zespołów, które już wiedzą, że agenci AI potrafią generować kod.
+
+Następnym problemem jest governance.
+
+Nie governance jako ceremonia. Governance jako proste pytanie:
+
+> Czy po tej zmianie wspieranej przez AI repozytorium nadal mówi truth?
+
+Truthmark pomaga zespołom odpowiedzieć na to pytanie za pomocą zatwierdzonych plików, jawnego routingu i diffów możliwych do przeglądu.
+
+Jest przydatny, gdy potrzebujesz:
+
+- mniejszego rozjazdu dokumentacji
+- lepszych przekazań pracy
+- truth produktu specyficznego dla gałęzi
+- trwałej dokumentacji architektury i API
+- jawnej własności między dokumentami a kodem
+- bezpieczniejszych granic zapisu dla agentów
+- dokumentacji możliwej do przeglądu zamiast ukrytej pamięci
+- instrukcje agenta, które nadal działają z commitowanych plików repozytorium
+
+## Gdzie pasuje Truthmark
+
+Truthmark nie zastępuje promptów, pamięci, specyfikacji, testów ani przeglądu kodu.
+
+Daje tym workflow trwałe miejsce w Git.
+
+| Potrzeba | Lepsze dopasowanie |
+| --- | --- |
+| Lepszy wynik z jednej sesji agenta | Lepszy prompt |
+| Ciągłość osobista lub na poziomie sesji | Narzędzie pamięci |
+| Praca nad funkcją zaczynająca się od planu | Workflow specyfikacji |
+| Truth w zakresie gałęzi, która podróżuje z kodem | Truthmark |
+| Walidacja poprawności zachowania | Testy i przegląd |
+| Przegląd zmian dokumentacji wspieranych przez AI | Truthmark plus przegląd Git |
+
+Zakres Truthmark jest celowo wąski:
+
+```text
+make repository truth explicit
+route it to code
+zainstalować wokół niej instrukcje agenta
+keep the result reviewable in Git
+```
+
+## Więcej szczegółów
+
+README jest witryną sklepową: szybki kontekst, szybki start i podstawowy model myślowy.
+
+Aby poznać użycie komenda po komendzie, porównanie powierzchni, szczegóły obsługiwanych platform, konfigurację, routing, Portal i przykłady, przeczytaj [Przewodnik użytkownika Truthmark](../user-guide.md).
+
+## Status projektu
+
+Obecne wydanie zapewnia:
+
+- lokalne komendy CLI dla config, init, check, index, impact i workflow status
+- wygenerowane lokalne instrukcje agenta dla Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity i Cursor
+- diagnostykę route, authority, frontmatter, link, freshness, generated-surface, branch-scope i coverage
+- dokumenty truth w zakresie gałęzi oraz pochodne artefakty inteligencji repozytorium
+
+## Dokumentacja
+
+- [Przewodnik użytkownika](../user-guide.md)
+- [Indeks dokumentacji](../README.md)
+- [Przegląd architektury](../truthmark/engineering/architecture/overview.md)
+- [Kontrakty API i CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Przewodnik utrzymania repository truth](../standards/maintaining-repository-truth.md)
+
+Komendy lokalnego rozwoju i kontrybuowania znajdziesz w [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Granice projektu
+
+Truthmark jest celowo mały: lokalny, zatwierdzony, ograniczony do gałęzi i możliwy do przeglądu.
+
+Nie jest usługą hostowaną, serwerem MCP, wektorową bazą danych, ukrytą warstwą pamięci, produktem wymuszającym CI ani autonomicznym silnikiem przepisywania kodu. Pomaga utrzymać widoczność truth repozytorium; nie zastępuje testów, przeglądu kodu ani ludzkiego osądu.
+
+## Licencja
+
+MIT. Zobacz [LICENSE](../../LICENSE).

package/docs/readmes/README.pt.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Seus agentes escrevem código. O Truthmark mantém documentação voltada para humanos e revisável no Git.**
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
+
+![Banner do Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Início rápido: rodando localmente em cinco minutos
+
+Execute isto dentro do repositório Git que você quer que o Truthmark gerencie:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Ative o host de IA que você realmente usa. Configurações novas são neutras em relação a host; portanto, adicione uma lista `platforms` de nível superior a `.truthmark/config.yml` antes da inicialização:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Em seguida, instale os documentos de verdade locais do repositório, o roteamento e as instruções para hosts de IA:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Agora experimente o caminho de adoção mais comum: documentar, a partir do código e dos testes, um comportamento existente. No seu host de codificação com IA, peça ao workflow instalado:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+Depois disso, usuários normalmente não devem invocar o Truth Sync diretamente. Continue codificando por meio do seu host de IA; as instruções instaladas no repositório dizem ao agente para executar os testes relevantes e realizar a revisão Truth Sync antes da entrega quando houver mudanças em código funcional. Você revisa o diff de código resultante junto com o diff dos documentos de verdade.
+
+Se você quer apenas validação por CLI e ainda não quer workflows de IA específicos de host, deixe `platforms` omitido e execute `truthmark init && truthmark check`; você pode adicionar uma plataforma depois e executar `truthmark init` novamente.
+
+## 💡 O problema: a lacuna de documentação da IA
+
+Agentes de codificação com IA são incríveis para escrever código rapidamente. Mas essa velocidade cria um novo modo de falha perigoso: **a história do repositório se afasta da realidade.**
+
+* Comportamentos se perdem em históricos de chat efêmeros.
+* Documentos de arquitetura ficam desatualizados rapidamente.
+* Decisões de produto desaparecem após a entrega.
+* Revisores de código acabam examinando diffs de código crus sem entender o “porquê”.
+* Cada nova sessão de IA é forçada a redescobrir do zero a verdade do seu repositório.
+
+## 🎯 A solução: Truthmark
+
+**Truthmark** instala no seu repositório uma camada de workflow nativa do Git. Ele corrige a parte do desenvolvimento com IA que geralmente quebra: ajudar a documentação a permanecer alinhada com o código.
+
+Em vez de esperar que humanos e agentes de IA se lembrem de atualizar a documentação, o Truthmark transforma a documentação em um hábito sistemático e revisável dentro do próprio repositório.
+
+### ✨ Por que o Truthmark é único
+
+Truthmark não é apenas mais uma ferramenta de documentação. Ele é profundamente integrado ao workflow de IA:
+
+* **🚫 Sem dependência de fornecedor:** nenhum serviço hospedado, nenhum banco de dados oculto, nenhum servidor extra para operar.
+* **🌳 100% nativo do Git:** tudo vive no seu repositório. A verdade se move com a sua branch.
+* **🤝 Contrato pertencente a humanos e seguido por agentes:** Mantenedores possuem o contrato do repositório; agentes seguem as instruções instaladas enquanto programam.
+* **✅ Confiança por verificação:** o trabalho da IA fica mais fácil de confiar porque trabalhos que mudam comportamento incluem uma decisão ou diff de documento de verdade revisável por humanos.
+
+## 🔄 Como funciona
+
+Quando um agente de IA modifica seu código, o trabalho não está terminado. O Truthmark instala uma proteção de workflow no fim da tarefa que os agentes seguem antes da entrega:
+
+1. 💻 **Código:** o agente modifica código funcional.
+2. 🧪 **Teste:** testes relevantes são executados.
+3. 🔍 **Verificar:** Truthmark verifica a documentação mapeada como parte da revisão de encerramento instalada.
+4. 📝 **Documentação:** os docs são atualizados pelo agente quando a verdade do repositório mudou.
+5. 👀 **Revisão:** uma pessoa revisa o *diff de código* + o *diff de verdade*.
+
+## 🛠 Como você interage com o Truthmark
+
+Truthmark tem um contrato local do repositório e duas formas de usá-lo.
+
+### Pessoas instalam e validam o contrato
+
+Mantenedores e CI usam a CLI:
+
+* `truthmark config` - cria a configuração inicial.
+* `truthmark init` - instala ou atualiza roteamento, scaffolds de documentos de verdade e instruções para hosts de IA.
+* `truthmark check` - valida a verdade do repositório pelo terminal.
+
+### Agentes seguem o contrato enquanto programam
+
+Truthmark instala instruções locais do repositório para hosts de codificação com IA compatíveis, como Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor.
+
+O ciclo normal é simples:
+
+1. Peça ao seu agente uma mudança de código ou que documente um comportamento existente.
+2. As instruções instaladas dizem ao agente quando testar, quando atualizar documentos de verdade e quando parar para revisão humana.
+3. Você revisa diffs Git comuns: código mais quaisquer mudanças em documentos de verdade.
+
+As solicitações de agente iniciadas pelo usuário são intencionalmente poucas:
+
+* `/truthmark-document` - documenta comportamento implementado existente a partir de código e testes.
+* `/truthmark-realize` - implementa código a partir de documentos de verdade existentes.
+* `/truthmark-check` - audita a verdade do repositório.
+
+Truth Sync não é o modo usual de começar trabalho; é a revisão de encerramento após mudanças funcionais de código.
+Truth Structure não é um comando cotidiano; ele repara roteamento ou propriedade somente quando isso bloqueia o trabalho.
+
+## O que você recebe
+
+| Capacidade | O que faz |
+| --- | --- |
+| Verdade nativa do Git | Mantém a verdade do repositório em Markdown e configuração commitados. |
+| Documentação com escopo de branch | A verdade se move com a branch em vez de viver em uma sessão privada. |
+| CLI humana | Dá aos mantenedores comandos de configuração, atualização, validação e inspeção. |
+| Orientação de agente instalada | Diz aos agentes de codificação quando documentar, testar, sincronizar verdade, auditar ou parar para revisão. |
+| Roteamento explícito | Mapeia áreas de código para documentos de verdade canônicos. |
+| Entregas revisáveis | Produz diffs Git comuns tanto para código quanto para documentos de verdade. |
+| Operação local-first | Não requer serviço hospedado, daemon, banco de dados nem servidor MCP. |
+| Limites de escrita mais seguros | Separa workflows code-first, doc-first, read-only e doc-only. |
+| Validação | Relata problemas de roteamento, autoridade, frontmatter, links, superfícies geradas, escopo de branch, frescor e cobertura. |
+| Portal opcional | Gera, quando explicitamente ativado e solicitado, um site estático HTML commitado a partir de documentos de verdade em Markdown. |
+
+## Visão geral visual
+
+![Recursos do Truthmark](../assets/truthmark-features.png)
+
+**Recursos:** o que o Truthmark instala e como a superfície de workflow é dividida.
+
+![Posição do Truthmark](../assets/truthmark-position.png)
+
+**Posição:** onde o Truthmark se encaixa em relação a prompts, memória e workflows de especificação.
+
+![Fluxo de sincronização do Truthmark](../assets/truthmark-syncflow.png)
+
+**Fluxo de sincronização:** como o Truth Sync conclui mudanças normais de código antes da entrega.
+
+## Por que equipes o adotam
+
+Truthmark é para equipes que já sabem que agentes de IA podem gerar código.
+
+O próximo problema é governança.
+
+Não governança como cerimônia. Governança como uma pergunta simples:
+
+> Depois desta mudança assistida por IA, o repositório ainda diz a verdade?
+
+Truthmark ajuda equipes a responder isso com arquivos commitados, roteamento explícito e diffs revisáveis.
+
+Ele é útil quando você precisa de:
+
+- menos desvio de documentação
+- melhores entregas
+- verdade de produto específica por branch
+- documentação duradoura de arquitetura e API
+- ownership explícito entre docs e código
+- limites de escrita de agentes mais seguros
+- documentação revisável em vez de memória oculta
+- orientação de agente que ainda funciona a partir de arquivos commitados no repositório
+
+## Onde o Truthmark se encaixa
+
+Truthmark não substitui prompts, memória, specs, testes nem revisão de código.
+
+Ele dá a esses workflows um lugar durável para pousar no Git.
+
+| Necessidade | Melhor encaixe |
+| --- | --- |
+| Melhor saída de uma sessão de agente | Prompt melhor |
+| Continuidade pessoal ou no nível da sessão | Ferramenta de memória |
+| Trabalho de funcionalidade com plano primeiro | Workflow de especificação |
+| Verdade com escopo de branch que viaja com o código | Truthmark |
+| Validar correção de comportamento | Testes e revisão |
+| Revisar mudanças de documentação assistidas por IA | Truthmark mais revisão Git |
+
+A faixa de atuação do Truthmark é estreita por design:
+
+```text
+make repository truth explicit
+route it to code
+instalar orientação de agente ao redor dela
+keep the result reviewable in Git
+```
+
+## Aprofunde-se
+
+O README é a vitrine: contexto rápido, início rápido e o modelo mental central.
+
+Para uso comando por comando, comparações de superfícies, detalhes de plataformas compatíveis, configuração, roteamento, Portal e exemplos, leia o [guia do usuário do Truthmark](../user-guide.md).
+
+## Status do projeto
+
+A versão atual fornece:
+
+- comandos CLI locais para config, init, check, index, impact e status de workflows
+- instruções de agente locais do repositório geradas para Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor
+- diagnósticos de roteamento, autoridade, frontmatter, links, frescor, superfícies geradas, escopo de branch e cobertura
+- documentos de verdade com escopo de branch e artefatos derivados de inteligência do repositório
+
+## Documentação
+
+- [Guia do usuário](../user-guide.md)
+- [Índice de docs](../README.md)
+- [Visão geral da arquitetura](../truthmark/engineering/architecture/overview.md)
+- [Contratos de API e CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Guia de manutenção da verdade do repositório](../standards/maintaining-repository-truth.md)
+
+Para comandos de desenvolvimento local e contribuição, consulte [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Limites de design
+
+Truthmark é intencionalmente pequeno: local, commitado, com escopo de branch e revisável.
+
+Ele não é um serviço hospedado, servidor MCP, banco de dados vetorial, camada de memória oculta, produto de enforcement de CI nem motor autônomo de reescrita de código. Ele ajuda a verdade do repositório a permanecer visível; não substitui testes, revisão de código nem julgamento humano.
+
+## Licença
+
+MIT. Veja [LICENSE](../../LICENSE).