docs: add documentation index and Spec Kit guide

Add comprehensive documentation index to README (EN + PT-BR):
- Getting Started section with quick links
- Architecture & Design docs
- Development guides
- Project management (roadmap, tasks)
- Package documentation

Create Spec Kit collaborative development guide:
- Complete 7-step workflow explanation
- Practical examples (file upload feature)
- How to contribute using Spec Kit
- Benefits for contributors
- FAQ section

Available in both English and Portuguese:
- docs/SPEC_KIT_GUIDE.md
- docs/pt-br/SPEC_KIT_GUIDE.md

This enables the community to contribute using structured,
collaborative development with clear specifications.

Author: kayossouza

README.md

@@ -8,7 +8,47 @@ Open-source platform for conversational forms powered by LLMs.
 
 [English](./README.md) | [Português](./README.pt-BR.md)
 
-**[Quick Start](#quick-start) · [Documentation](./docs) · [Architecture](./docs/ARCHITECTURE.md) · [Contributing](./CONTRIBUTING.md)**
+**[Quick Start](#quick-start) · [Documentation](#documentation-index) · [Architecture](./docs/ARCHITECTURE.md) · [Contributing](./CONTRIBUTING.md)**
+
+---
+
+## Documentation Index
+
+### Getting Started
+- [Quick Start Guide](#quick-start) - Get up and running in 5 minutes
+- [Installation](#installation) - Detailed setup instructions
+- [Using @flowform/core](#using-flowformcore) - Core package usage
+
+### Architecture & Design
+- [Architecture Overview](./docs/ARCHITECTURE.md) - Design decisions and patterns
+- [Project Specification](./docs/PROJECT_SPEC.md) - Complete technical specification
+- [ADRs (Architecture Decision Records)](./docs/adr/) - Major design decisions
+
+### Development
+- [Development Guide](./docs/DEVELOPMENT.md) - Setup, workflow, troubleshooting
+- [Contributing Guide](./CONTRIBUTING.md) - How to contribute
+- [Spec Kit Guide](./docs/SPEC_KIT_GUIDE.md) - Collaborative development workflow
+- [Code Style](./CONTRIBUTING.md#code-style) - Coding standards
+
+### Project Management
+- [Roadmap & Tasks](./docs/TASKS_MVP.md) - 11 phases, 300+ tasks
+- [Changelog](./CHANGELOG.md) - Version history and release notes
+- [v0.1.0 Release Notes](./docs/releases/v0.1.0.md) - Core orchestrator release
+
+### Package Documentation
+- [@flowform/core README](./packages/core/README.md) - Core package API reference
+
+### Contributing with Spec Kit
+
+Flowform uses [Spec Kit](./docs/SPEC_KIT_GUIDE.md) for structured, collaborative development:
+
+1. **Choose a feature** from [TASKS_MVP.md](./docs/TASKS_MVP.md)
+2. **Write a spec** using Spec Kit workflow
+3. **Get feedback** from community
+4. **Implement** with clear guidance
+5. **Ship it!**
+
+New to Spec Kit? Read the [complete guide](./docs/SPEC_KIT_GUIDE.md) to understand how we build features collaboratively.
 
 ---
 

README.pt-BR.md

@@ -8,7 +8,47 @@ Plataforma open-source para formulários conversacionais com LLMs.
 
 [English](./README.md) | [Português](./README.pt-BR.md)
 
-**[Início Rápido](#início-rápido) · [Documentação](./docs/pt-br) · [Arquitetura](./docs/pt-br/ARCHITECTURE.md) · [Contribuindo](./CONTRIBUTING.pt-BR.md)**
+**[Início Rápido](#início-rápido) · [Documentação](#índice-de-documentação) · [Arquitetura](./docs/pt-br/ARCHITECTURE.md) · [Contribuindo](./CONTRIBUTING.pt-BR.md)**
+
+---
+
+## Índice de Documentação
+
+### Começando
+- [Guia de Início Rápido](#início-rápido) - Configure em 5 minutos
+- [Instalação](#instalação) - Instruções detalhadas de setup
+- [Usando @flowform/core](#usando-flowformcore) - Uso do pacote core
+
+### Arquitetura & Design
+- [Visão Geral da Arquitetura](./docs/pt-br/ARCHITECTURE.md) - Decisões de design e padrões
+- [Especificação do Projeto](./docs/PROJECT_SPEC.md) - Especificação técnica completa
+- [ADRs (Architecture Decision Records)](./docs/adr/) - Decisões de design importantes
+
+### Desenvolvimento
+- [Guia de Desenvolvimento](./docs/pt-br/DEVELOPMENT.md) - Setup, workflow, troubleshooting
+- [Guia de Contribuição](./CONTRIBUTING.pt-BR.md) - Como contribuir
+- [Guia do Spec Kit](./docs/pt-br/SPEC_KIT_GUIDE.md) - Workflow de desenvolvimento colaborativo
+- [Estilo de Código](./CONTRIBUTING.pt-BR.md#estilo-de-código) - Padrões de código
+
+### Gerenciamento do Projeto
+- [Roadmap & Tasks](./docs/TASKS_MVP.md) - 11 fases, 300+ tarefas
+- [Changelog](./CHANGELOG.pt-BR.md) - Histórico de versões e release notes
+- [Release Notes v0.1.0](./docs/releases/v0.1.0.md) - Release do core orchestrator
+
+### Documentação de Pacotes
+- [@flowform/core README](./packages/core/README.md) - Referência da API do core
+
+### Contribuindo com Spec Kit
+
+Flowform usa [Spec Kit](./docs/pt-br/SPEC_KIT_GUIDE.md) para desenvolvimento estruturado e colaborativo:
+
+1. **Escolha uma feature** de [TASKS_MVP.md](./docs/TASKS_MVP.md)
+2. **Escreva uma spec** usando workflow Spec Kit
+3. **Obtenha feedback** da comunidade
+4. **Implemente** com orientação clara
+5. **Shipar!**
+
+Novo no Spec Kit? Leia o [guia completo](./docs/pt-br/SPEC_KIT_GUIDE.md) para entender como construímos features colaborativamente.
 
 ---