diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..987a36e
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,37 @@
+# CLAUDE.md
+
+Este ficheiro fornece orientação ao Claude Code (claude.ai/code) quando trabalha com o código neste repositório.
+
+## Sobre o Projecto
+
+Biblioteca .NET 9+ open-source para geração de ficheiros SAF-T (Standard Audit File for Tax) com arquitectura extensível multi-país. Publicada como pacotes NuGet (`Simansoft.SAFT.*`). Actualmente implementada para Moçambique, com suporte a XML, JSON e hashes SHA-1.
+
+## Comandos
+
+```bash
+# Compilar
+dotnet build
+
+# Testes (ainda em implementação)
+dotnet test
+```
+
+## Arquitectura
+
+```
+src/
+├── SAF-T.Core/ # Contratos e modelos base (independente de país)
+├── SAF-T.Cryptography/ # Geração de hashes SHA-1 para assinatura de documentos
+└── SAF-T.Mozambique/ # Implementação específica para Moçambique
+samples/
+└── SAF-T.Examples/ # Exemplos de utilização
+```
+
+- **`SAF-T.Core`** — Define as interfaces e modelos partilhados. Para adicionar suporte a um novo país, cria-se um novo projecto que implementa os contratos deste núcleo sem o modificar.
+- **`SAF-T.Cryptography`** — Independente do país; fornece a lógica de hash usada para assinar documentos de facturação.
+- **`SAF-T.Mozambique`** — Implementação concreta para as regras fiscais moçambicanas.
+
+## Estratégia de Branches
+
+A estratégia de branches deste repositório está documentada em `CONTRIBUTING.md`.
+Consulta esse ficheiro para as regras de Git Flow, convenções de nomenclatura e destinos de merge.
diff --git a/src/SAF-T.Mozambique/SAF-T.Mozambique.csproj b/src/SAF-T.Mozambique/SAF-T.Mozambique.csproj
index 4eed5b3..37b86ad 100644
--- a/src/SAF-T.Mozambique/SAF-T.Mozambique.csproj
+++ b/src/SAF-T.Mozambique/SAF-T.Mozambique.csproj
@@ -38,7 +38,7 @@
-
+