docs: fix broken documentation links in ide-integration, CONTRIBUTING, and README (#205)

Fix multiple broken links pointing to non-existent files:

- docs/ide-integration.md: replace ./platforms/README.md (non-existent dir)
  and ./agent-reference-guide.md with valid paths to pt/platforms/ guides
  and guides/agent-selection-guide.md
- CONTRIBUTING.md: update CONTRIBUTING-PT.md references to the actual
  Portuguese version at docs/pt/contributing.md
- README.md: update docs/architecture/ARCHITECTURE-INDEX.md references
  to docs/architecture/AIOS-VISUAL-OVERVIEW.md which actually exists

Closes #204

Author: nikolasdehor

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to Synkra AIOS
 
-> **[Versao em Portugues](CONTRIBUTING-PT.md)**
+> **[Versao em Portugues](docs/pt/contributing.md)**
 
 Welcome to AIOS! Thank you for your interest in contributing. This guide will help you understand our development workflow, contribution process, and how to submit your changes.
 
@@ -549,7 +549,7 @@ git push --force-with-lease
 
 ### Q: Can I contribute in Portuguese?
 
-**A:** Yes! We accept PRs in Portuguese. See [CONTRIBUTING-PT.md](CONTRIBUTING-PT.md).
+**A:** Yes! We accept PRs in Portuguese. See [CONTRIBUTING-PT](docs/pt/contributing.md).
 
 ### Q: How do I become a maintainer?
 

README.md

@@ -481,7 +481,7 @@ O Synkra AIOS vem com 11 agentes especializados:
 ### Guias Essenciais
 
 - 📖 **[Guia do Usuário](docs/guides/user-guide.md)** - Passo a passo completo desde a concepção até a conclusão do projeto
-- 🏗️ **[Arquitetura Principal](docs/architecture/ARCHITECTURE-INDEX.md)** - Mergulho técnico profundo e design do sistema
+- 🏗️ **[Arquitetura Principal](docs/architecture/AIOS-VISUAL-OVERVIEW.md)** - Mergulho técnico profundo e design do sistema
 - 🚀 **[Guia de Squads](docs/guides/squads-guide.md)** - Estenda o AIOS para qualquer domínio além do desenvolvimento de software
 
 ### Documentação Adicional
@@ -490,7 +490,7 @@ O Synkra AIOS vem com 11 agentes especializados:
 - 📋 **[Primeiros Passos](docs/getting-started.md)** - Tutorial passo a passo para iniciantes
 - 🔧 **[Solução de Problemas](docs/troubleshooting.md)** - Soluções para problemas comuns
 - 🎯 **[Princípios Orientadores](docs/GUIDING-PRINCIPLES.md)** - Filosofia e melhores práticas do AIOS
-- 🏛️ **[Visão Geral da Arquitetura](docs/architecture/ARCHITECTURE-INDEX.md)** - Visão detalhada da arquitetura do sistema
+- 🏛️ **[Visão Geral da Arquitetura](docs/architecture/AIOS-VISUAL-OVERVIEW.md)** - Visão detalhada da arquitetura do sistema
 - ⚙️ **[Guia de Ajuste de Performance](docs/performance-tuning-guide.md)** - Otimize seu fluxo de trabalho AIOS
 - 🔒 **[Melhores Práticas de Segurança](docs/security-best-practices.md)** - Segurança e proteção de dados
 - 🔄 **[Guia de Migração](docs/migration-guide.md)** - Migração de versões anteriores

docs/ide-integration.md

@@ -468,10 +468,9 @@ npm run sync:ide:cursor
 
 ## Related Documentation
 
-- [Platform Guides](./platforms/README.md)
-- [Claude Code Guide](./platforms/claude-code.md)
-- [Cursor Guide](./platforms/cursor.md)
-- [Agent Reference Guide](./agent-reference-guide.md)
+- [Claude Code Guide](./pt/platforms/claude-code.md)
+- [Cursor Guide](./pt/platforms/cursor.md)
+- [Agent Selection Guide](./guides/agent-selection-guide.md)
 - [MCP Global Setup](./guides/mcp-global-setup.md)
 
 ---