📦 Versão 3.2.0

📚 Documentação do FASE

Versão: 3.2.0 | Última atualização: 2026-03-25

Bem-vindo ao centro de documentação do FASE! Aqui você encontra tudo que precisa para instalar, usar e contribuir ao projeto.

📖 Documentos Principais

Para Usuários

Documento	Descrição
Guia do Usuário	Guia completo de instalação e uso do FASE
Comandos	Lista com todos os 32 comandos disponíveis
NPM Registry	Configuração do npm registry e instalação

Para Desenvolvedores

Documento	Descrição
Guia de Contribuição	Como contribuir para o FASE (bugs, features, traduções)
Git Hooks	Git hooks e verificações de segurança
Padronização de Caminhos	Mecanismo de padronização de caminhos

🎯 Começar Por Aqui

Sou um Usuário

Leia Guia do Usuário para instalação
Explore Comandos para ver o que está disponível

Quero Contribuir

Abra uma issue descrevendo sua ideia
Leia Guia de Contribuição
Siga o setup local
Abra um Pull Request

Encontrei um Bug

Procure em GitHub Issues por issue similar
Abra uma nova issue com os detalhes

📋 Estrutura de Arquivos

docs/
├── README.md              # Este arquivo (índice)
├── guia-do-usuario.md     # Guia para usuários
├── COMANDOS.md            # Lista de comandos
├── CONTRIBUINDO.md        # Guia de contribuição
├── HOOKS.md               # Git hooks documentation
├── NPM-REGISTRY.md        # Configuração npm
├── technical/
│   └── padronizacao-caminhos.md   # Path standardization
└── maintainers/
    └── MANTENEDORES.md     # Informações para maintainers

🌐 Documentos em Português

Toda documentação do FASE é em português brasileiro:

✅ Guias de usuário
✅ Documentação de development
✅ Comentários no código
✅ Mensagens de erro e output

Exceções (em inglês):

⚙️ Termos técnicos consagrados (framework, hook, commit)
💻 Comandos e código
📦 Nomes de pacotes npm

🆘 Precisa de Ajuda?

Problema técnico: Abra uma issue com tag [help]
Bug descoberto: Reporte com template bug_report.md
Sugestão: Use template feature_request.md

📈 Melhorias Documentadas

v3.2.0 (Março 2026)

Path Standardization & Multi-Runtime Architecture

✅ Todos os comandos e agentes agora usam padrão universal @~/.fase/
✅ Installer converte automaticamente para caminhos específicos de cada runtime
✅ 129 testes unitários com cobertura completa
✅ Documentação expandida sobre path standardization
✅ Renomeação de arquivos: .pt.md → .md para consistência

Novos Documentos:

📚 Padronização de Caminhos - Explicação do mecanismo de padronização de caminhos
📚 Seções expandidas em bin/test/README.md e bin/test/TESTING.md

Ver também: CHANGELOG.md para histórico completo de versões

v2.4.0 (Março 2026)

✅ Adicionado pre-commit hooks para validação de pacote npm
✅ Criado GitHub Actions para publicação automática
✅ Templates de issues para bug reports e features
✅ CONTRIBUTING.md com instruções detalhadas
✅ Este índice de documentação

📞 Contato

GitHub: isaaceliape/FASE
Issues: GitHub Issues
Email: Via issue (por favor, não compartilhar emails publicamente)

Versão: 3.2.0 Última atualização: 2026-03-13