Uploading files

Co-authored-by: Claude <noreply@anthropic.com>

README.md

@@ -1,5 +1,56 @@
-# epifah
+# Epifah
 
-Reimplementação moderna do lado "telemóvel" do protocolo Aha Radio, para
-usar o MediaNav Evolution de um Renault Clio IV como ecrã/controlo de uma
-app de media atual (rádios web, podcasts, biblioteca local, etc.).
+Reimplementação independente do protocolo usado pela app legada **Aha Radio**, para voltar a usar
+o ecrã e os controlos do MediaNav Evolution de um Renault Clio IV com apps de media atuais.
+
+> Projeto pessoal, em fase inicial (reverse engineering). **Ainda não há nada utilizável.**
+> Não afiliado à Harman nem à Renault.
+
+## Porquê
+
+A Aha Radio (Harman) está praticamente morta, mas a head unit continua a falar o seu protocolo.
+O objetivo é perceber esse protocolo, escrever uma app Android que o fale e usá-lo para mostrar e
+controlar conteúdo atual no ecrã do carro, coisas que o streaming Bluetooth genérico não permite.
+E, claro, pelo desafio.
+
+## Estado
+
+Fase 0: preparação e pesquisa. O plano completo, os riscos e as fases estão em
+[`docs/PROJECT.md`](docs/PROJECT.md).
+
+## Estrutura
+
+```
+docs/        plano, descobertas, especificação do protocolo, capturas sanitizadas
+tools/       scripts de análise
+prototype/   prova de conceito
+app/         app Android
+AGENTS.md    contexto do projeto para LLMs e novos colaboradores
+```
+
+## Uso de IA
+
+Este projeto é desenvolvido com ajuda de IA, e prefiro ser claro quanto a isso.
+
+- **Ferramenta:** [Claude](https://claude.ai) (Anthropic), em conversa, para pesquisa, planeamento,
+  escrita de documentação, escolha do nome e, mais à frente, apoio na análise e no código.
+- **Responsabilidade:** as decisões e o que é publicado são meus. A IA não substitui a validação:
+  qualquer afirmação sobre o protocolo tem de ter evidência (capturas, hooks, código analisado)
+  e não é aceite só porque um modelo a disse.
+- **Limitações:** os modelos podem errar ou inventar detalhes. Por isso as hipóteses estão marcadas
+  como tal na documentação e o [`AGENTS.md`](AGENTS.md) instrui os agentes a não inventar
+  informação de protocolo.
+- **Transparência:** commits com contributo relevante de IA podem incluir o trailer
+  `Co-authored-by`. Código e documentação gerados ou assistidos por IA são revistos antes de entrar.
+
+## Legal
+
+- Análise feita sobre equipamento próprio, para fins de interoperabilidade.
+- Este repositório não contém nem distribui código, APKs ou serviços da Harman. A implementação e
+  a documentação são originais.
+- Todas as marcas pertencem aos respetivos titulares e são usadas apenas para descrever compatibilidade.
+
+## Contribuir
+
+Ainda é cedo. Se tiveres um MediaNav Evolution ou documentação do protocolo Aha de outros
+fabricantes, abre um issue.