# 🌌 Comunidade Lya Studio Coder

Bem-vindo! Este é o **espaço oficial** para toda a comunidade da Lya. Aqui você pode reportar bugs, sugerir melhorias, tirar dúvidas e interagir com outros usuários e desenvolvedores.

## 📚 Índice

- [Começar aqui](#começar-aqui)
- [Canais de Comunicação](#canais-de-comunicação)
- [Como Criar Tópicos & Discussões](#como-criar-tópicos--discussões)
- [Formas de Contribuir](#formas-de-contribuir)
- [Código de Conduta](#código-de-conduta)
- [FAQ da Comunidade](#faq-da-comunidade)
- [Eventos & Meetups](#eventos--meetups)

---

## 🚀 Começar aqui

### Se você é novo na Lya:

1. **Download e instalação:** [Releases](https://github.com/StudioCodeAI/Lya-Studio-Coder/releases/latest)
2. **Guia de instalação:** [docs/INSTALACAO.md](docs/INSTALACAO.md)
3. **Primeiros passos:** [Quick Start](docs/QUICK_START.md) *(em breve)*
4. **Tutoriais em vídeo:** [YouTube Playlist](https://www.youtube.com/@LyaStudioCoder) *(em breve)*

### Se você quer ajudar:

- **Relatar um bug:** [Abrir issue](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new?template=bug.md)
- **Sugerir uma melhoria:** [Abrir issue](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new?template=feature.md)
- **Contribuir com código:** [Guia de contribuição](CONTRIBUTING.md)
- **Melhorar documentação:** PRs são bem-vindos!

---

## 💬 Canais de Comunicação

### GitHub Issues
**Para:** Bug reports, feature requests, perguntas técnicas  
**Link:** [Abrir issue](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new/choose)  
**Resposta esperada:** 24-48h

| Tipo | Template | Uso |
|---|---|---|
| 🐞 **Bug Report** | [bug.md](.github/ISSUE_TEMPLATE/bug.md) | Encontrou um erro? Reporte aqui |
| 💡 **Feature Request** | [feature.md](.github/ISSUE_TEMPLATE/feature.md) | Quer uma nova funcionalidade? |
| ❓ **Dúvida / Help** | [help.md](.github/ISSUE_TEMPLATE/help.md) | Não consegue fazer algo funcionar? |

### GitHub Discussions ⭐ **RECOMENDADO PARA COMUNIDADE**
**Para:** Conversas, ideias, compartilhar setups, trocar experiências  
**Link:** [Participar](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions)  
**Categorias principais:**

- 💬 **[General](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/general)** — conversas gerais, apresentações e bate-papo
- 🚀 **[Feature Ideas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/feature-ideas)** — ideias de novas funcionalidades e melhorias
- 📚 **[Show & Tell](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/show-and-tell)** — mostre seu setup, workflow, plugins criados
- ❓ **[Q&A](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/q-a)** — perguntas e respostas da comunidade
- 🐞 **[Troubleshooting](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/troubleshooting)** — ajuda mútua para resolver problemas
- 📰 **[Announcements](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/announcements)** — atualizações, releases, eventos
- 💡 **[Melhorias Propostas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/melhorias-propostas)** — discussões sobre otimizações e enhancements

### Discord *(em breve)*
Servidor oficial para chat em tempo real, voice calls e comunidade mais ativa.  
📍 **Link:** [discord.gg/lya-studio-coder](https://discord.gg/lya-studio-coder) *(será publicado aqui)*

---

## 🎯 Como Criar Tópicos & Discussões

### **Para Sugerir uma Melhoria (Recomendado)**

1. **Acesse:** [GitHub Discussions → Feature Ideas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=feature-ideas)
2. **Preencha:**
   ```
   Título: [Breve descrição da melhoria]
   Exemplo: "Adicionar atalho customizável para mudar de provedor"
   
   Descrição:
   - **O que você quer?** (descrição clara)
   - **Por que faz falta?** (problema que resolve)
   - **Como você imagina a solução?** (sugestão de implementação)
   - **Exemplos ou mockups?** (se houver)
   ```

3. **Exemplo prático:**
   ```
   ## 🎯 O que você quer?
   Adicionar tema escuro e light automático baseado na configuração do Windows
   
   ## ❓ Por que faz falta?
   Muitos usuários usam modo escuro no Windows e gostariam que a Lya 
   acompanhasse essa configuração automaticamente
   
   ## 💡 Como você imagina?
   - Detectar configuração do Windows (Light/Dark/Auto)
   - Sincronizar com o tema da Lya
   - Opção para forçar um tema específico
   
   ## 📸 Mockup / Referência
   [Se tiver, compartilhe screenshot ou link]
   ```

4. **Comunidade vota!** 👍 — quanto mais upvotes, maior a prioridade

---

### **Para Discussão de Melhoria (Brainstorm)**

1. **Acesse:** [GitHub Discussions → Melhorias Propostas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=melhorias-propostas)
2. **Ideale junto com a comunidade:**
   ```
   Título: [Brainstorm] Melhorar performance do terminal
   
   Inicial: Vocês acham que o terminal fica lento em projetos grandes?
   Vamos discutir soluções?
   ```

3. **Discussão aberta** — pessoas comentam, debatem, refinam a ideia
4. **Se ganhar tração** → Vira uma Feature Request formal

---

### **Para Reportar um Bug**

1. **Acesse:** [Issues → Bug Report](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new?template=bug.md)
2. **Template automático** te guia
3. **Preencha:**
   - Versão da Lya
   - Sistema operacional
   - Passos para reproduzir
   - Comportamento esperado vs real
   - Screenshot/vídeo (importante!)

---

### **Para Tirar uma Dúvida**

1. **Acesse:** [Discussions → Q&A](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=q-a)
2. **Título claro:** "Como fazer X?" ou "Por que Y não funciona?"
3. **Descreva:** o que tentou, o que aconteceu, o que esperava

---

## 🎁 Sistema de Votação

Na **Feature Ideas**, você pode:
- ✅ Dar upvote 👍 em sugestões que gostaria de ver implementadas
- 💬 Comentar com sua opinião
- 🔔 Acompanhar a discussão

**Mais upvotes = Maior chance de entrar no roadmap!**

---

## 🛠️ Formas de Contribuir

### Não precisa saber programar para contribuir! Veja as opções:

#### 1. 🐞 **Testar e Relatar Bugs**
- Use a Lya em produção
- Encontrou algo que não funciona? [Reporte aqui](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new?template=bug.md)
- Inclua: versão da Lya, SO, passos para reproduzir, screenshot

#### 2. 💡 **Sugerir Melhorias**
- Tem uma ideia? [Comece em Feature Ideas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=feature-ideas)
- Se ganhar tração, vira item no roadmap
- Você ajuda a moldar o futuro da Lya!

#### 3. 📝 **Melhorar Documentação**
- Achou algo confuso no README?
- Exemplos desatualizados?
- [Abra um PR](https://github.com/StudioCodeAI/Lya-Studio-Coder/compare) — documentação é sempre bem-vinda

#### 4. 🤝 **Ajudar Outros Usuários**
- Responda perguntas em [Discussions → Q&A](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/q-a)
- Compartilhe dicas em **Show & Tell**
- Ajude com troubleshooting em **Troubleshooting**

#### 5. 💻 **Contribuir com Código**
- Olhe issues com label `good first issue` ou `help wanted`
- Comente: "Vou trabalhar nisso"
- Siga [CONTRIBUTING.md](CONTRIBUTING.md)
- Faça um PR!

#### 6. 🎨 **Criar Skills / Extensões**
- Crie plugins customizados para a Lya
- Publique no repositório de skills (em breve)
- Compartilhe com a comunidade em **Show & Tell**

#### 7. 💰 **Apoiar Financeiramente**
- [Ko-fi](https://ko-fi.com/lyastudiocoder) — pague um café para o desenvolvedor
- Ajude a manter a Lya viva e em desenvolvimento

---

## 📊 Roadmap Público & Tracking

O roadmap da Lya é **100% público** e dirigido pela comunidade:

- 📌 **Veja o roadmap:** [CHANGELOG.md](CHANGELOG.md) e [Discussions → Roadmap](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions)
- 🗳️ **Vote em features:** [Feature Ideas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/feature-ideas)
- 📈 **Acompanhe progresso:** Issues linkadas ao roadmap mostram status

---

## 📋 Código de Conduta

Este projeto adere ao **[Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/)**.

### Em resumo:

✅ **Seja respeitoso** — com todos, independentemente de experiência, gênero, orientação  
✅ **Seja inclusivo** — bem-vindo a todos  
✅ **Seja construtivo** — críticas são sobre ideias, não sobre pessoas  
✅ **Seja paciente** — nem todos têm o mesmo nível de experiência  

❌ **Não toleramos:**
- Assédio, discriminação ou abuso
- Spam ou publicidade agressiva
- Compartilhar informações privadas sem consentimento

**Viu algo errado?** Reporte para luis.card@hotmail.com com contexto.

---

## ❓ FAQ da Comunidade

### Instalação & Setup

**P: Posso usar a Lya em macOS / Linux?**  
R: Ainda não — é Windows-only por enquanto. Mas está no [roadmap](https://github.com/StudioCodeAI/Lya-Studio-Coder#-roadmap)!

**P: Preciso de Node.js instalado?**  
R: Não! O instalador (.exe/.msi) é self-contained — vem com o runtime embutido.

**P: Quanto espaço em disco a Lya usa?**  
R: ~47 MB para instalação + espaço para seus dados (projetos, memória vetorial, etc).

### Usando a Lya

**P: Minhas chaves de API são seguras?**  
R: Sim! Local-first por princípio — suas chaves ficam só no seu computador, nunca são enviadas.

**P: Posso usar múltiplos provedores de IA?**  
R: Sim! Gemini, Claude, GPT, Ollama, Groq, NVIDIA, OpenRouter — todos na mesma IDE.

**P: A Lya funciona offline?**  
R: Parcialmente. Chat local (Ollama) funciona offline. Provedores na nuvem precisam de internet.

### Comunidade & Contribuição

**P: Como faço para sugerir uma feature?**  
R: [Acesse Feature Ideas](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=feature-ideas) e descreva sua ideia. A comunidade vota e quanto mais upvotes, maior a prioridade!

**P: Posso criar plugins para a Lya?**  
R: Sim! Documentação em desenvolvimento. Por enquanto, converse em [Discussions](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions).

**P: Onde fico sabendo de novas versões?**  
R: 
- [Watch](https://github.com/StudioCodeAI/Lya-Studio-Coder/subscription) o repositório
- Se inscreva em [Announcements](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/announcements)
- Siga [@LyaStudioCoder](https://twitter.com/lyastudiocoder) no Twitter/X

**P: Como reporto um bug?**  
R: [Abra uma Issue](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new?template=bug.md) com detalhes: versão, SO, passos para reproduzir e screenshot.

---

## 🎉 Eventos & Meetups

### Planejamento

Estamos planejando:
- 📺 **Transmissões ao vivo** (Twitch) — demos e tutoriais
- 🎤 **Office hours** — conversa direta com o desenvolvedor
- 🏆 **Hackathons** — compita e crie coisas legais com a Lya
- 📚 **Workshop** — aprenda a fazer plugins e extensões

**Quer ser notificado?** [Inscreva-se em Announcements](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/categories/announcements)

---

## 🌍 Segue a Lya!

- **Twitter/X:** [@LyaStudioCoder](https://twitter.com/lyastudiocoder)
- **Discord:** (em breve)
- **YouTube:** (em breve)
- **GitHub:** [Star ⭐ para acompanhar](https://github.com/StudioCodeAI/Lya-Studio-Coder)

---

## 📞 Precisa de Ajuda?

| Situação | Faça isso |
|---|---|
| 🐞 Encontrou um bug | [Abra uma issue](https://github.com/StudioCodeAI/Lya-Studio-Coder/issues/new?template=bug.md) |
| 💡 Sugerir melhoria | [Feature Ideas Discussion](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=feature-ideas) |
| 💬 Discutir ideias | [Melhorias Propostas Discussion](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=melhorias-propostas) |
| ❓ Dúvida de uso | [Pergunte em Q&A](https://github.com/StudioCodeAI/Lya-Studio-Coder/discussions/new?category=q-a) |
| 🚨 Problema de segurança | [SECURITY.md](SECURITY.md) |
| 📧 Contato direto | luis.card@hotmail.com |

---

## 🌟 Membros Destaque da Comunidade

Aqui vamos destacar membros ativos que contribuem regularmente:
- *(em breve — você pode ser o primeiro!)*

---

## 🙏 Obrigado!

**Cada pessoa nesta comunidade faz a Lya melhor.**

Se você está lendo isso, você JÁ faz parte. Bem-vindo! 🌌

---

*Última atualização: Junho 2026*