Skip to content

Commit 1d4f22c

Browse files
cleberhenselcleberhensel
committed
feat: initial release - vibe devtools opensource ecosystem
🎉 Vibe DevTools - Complete ecosystem for AI-powered development Transform AI-assisted development with Cursor, Copilot & Gemini into a 10x more productive experience. ## Core Components ### CLI Tool (vibe-devtools v0.4.1) - Install and manage vibe packages from npm, GitHub, or local sources - Cross-platform symlink management (macOS, Linux, Windows) - Multi-agent support (Cursor, Copilot, Gemini) - Global storage with project-level symlinks ### Foundation Kit (@vibe-devtools/basic v1.0.1) 8 professional commands for creation and planning: - /maker.command - Create professional commands with QUEST framework - /maker.rule - Create rules with best practices - /maker.script - Create executable scripts - /maker.prompt - Create reusable prompts - /planner.project - Auto-generate 10-100+ atomic tasks from objectives - /planner.backlog - Generate structured backlogs - /constitution - Define project governance principles - /vibe.manager - Manage vibes, memory, tasks, Trello/Slack integrations ### Research Kit (@vibe-devtools/research v1.0.0) 12 specialized commands for academic-level research: - /research.simple.pipeline - Quick research (5-10 min) - /research.deep.pipeline - Deep investigation (20-40 min, 4-6h saved) - /research.expert.pipeline - PhD-level review (1-2h, weeks of work saved) - Multi-dimensional scoring system (7 criteria) - Validation pipelines and synthesis generation - + 9 specialized research commands ## Open Source Infrastructure ### Governance - MIT License - Maximum adoption and flexibility - Contributor Covenant Code of Conduct v2.1 - Comprehensive CONTRIBUTING.md with PR workflow - SECURITY.md with vulnerability reporting process - Complete issue/PR templates ### Documentation - Installation guide with troubleshooting - Quick start guide (5 min to productive) - Creating vibes guide (structure, testing, publishing) - Complete API documentation ### Automation - Changesets for automated version management - GitHub Actions CI/CD - Automatic npm publishing with provenance - Monorepo architecture with pnpm workspaces ## Tech Stack - TypeScript 5.x with strict mode - Node.js 18+ (ES2022 target) - pnpm 8.x for workspace management - Commander.js for CLI - Chalk, Ora, CLI-Table3 for beautiful terminal UI - Cross-platform symlink handling ## Architecture Highlights - Monorepo structure (apps/ + packages/) - Global storage (~/.vibes/) with project symlinks - Symlink fallback strategies (junction on Windows, copy as last resort) - Template-based code generation - Integration with Trello and Slack ## Installation Global: npm install -g vibe-devtools vdt install @vibe-devtools/basic Via npx (zero installation): npx vibe-devtools install @vibe-devtools/basic ## Links - npm: https://www.npmjs.com/org/vibe-devtools - Docs: Complete documentation in /docs/ - Contributing: See CONTRIBUTING.md - Security: See SECURITY.md --- Ready for open source release 🚀 Built with ☕ and ✨ by @cleberhensel Powered by AI agentic development
0 parents  commit 1d4f22c

194 files changed

Lines changed: 53993 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.changeset/README.md‎

Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
1+
# Changesets
2+
3+
Este projeto usa [Changesets](https://github.com/changesets/changesets) para gerenciar versões e changelogs.
4+
5+
## Como Usar
6+
7+
### 1. Criar um Changeset
8+
9+
Após fazer mudanças em um package, crie um changeset:
10+
11+
```bash
12+
pnpm changeset
13+
```
14+
15+
Siga os prompts:
16+
1. Selecione quais packages mudaram
17+
2. Escolha o tipo de bump (patch/minor/major)
18+
3. Escreva um resumo das mudanças
19+
20+
Isso cria um arquivo em `.changeset/` que descreve suas mudanças.
21+
22+
### 2. Commit o Changeset
23+
24+
```bash
25+
git add .changeset/
26+
git commit -m "chore: add changeset for X"
27+
git push
28+
```
29+
30+
### 3. Versioning Automático
31+
32+
Quando você faz push para `main`:
33+
34+
1. **Changesets bot** cria/atualiza um PR "Version Packages"
35+
2. O PR mostra exatamente quais versions serão bumped
36+
3. Quando você merge o PR:
37+
- Versions são atualizadas
38+
- CHANGELOGs são gerados
39+
- Packages são publicados no npm
40+
- GitHub Releases são criadas
41+
42+
## Tipos de Bump
43+
44+
- **patch** (1.0.0 → 1.0.1): Bugfixes, docs, small changes
45+
- **minor** (1.0.0 → 1.1.0): New features, non-breaking changes
46+
- **major** (1.0.0 → 2.0.0): Breaking changes
47+
48+
## Exemplos
49+
50+
### Exemplo 1: Fix em basic
51+
52+
```bash
53+
# Faz mudanças no basic
54+
vi packages/basic/README.md
55+
56+
# Cria changeset
57+
pnpm changeset
58+
# → Select: basic
59+
# → Type: patch
60+
# → Summary: "Fix typos in documentation"
61+
62+
# Commit
63+
git add .
64+
git commit -m "docs: fix typos in basic README"
65+
git push
66+
```
67+
68+
### Exemplo 2: Nova feature em research
69+
70+
```bash
71+
# Adiciona nova feature
72+
vi packages/research/.cursor/commands/new-command.md
73+
74+
# Cria changeset
75+
pnpm changeset
76+
# → Select: research
77+
# → Type: minor
78+
# → Summary: "Add new research command for X"
79+
80+
# Commit
81+
git add .
82+
git commit -m "feat: add new research command"
83+
git push
84+
```
85+
86+
### Exemplo 3: Breaking change na CLI
87+
88+
```bash
89+
# Faz breaking change
90+
vi apps/cli/src/index.ts
91+
92+
# Cria changeset
93+
pnpm changeset
94+
# → Select: cli
95+
# → Type: major
96+
# → Summary: "BREAKING: change command syntax"
97+
98+
# Commit
99+
git add .
100+
git commit -m "feat!: breaking change in CLI"
101+
git push
102+
```
103+
104+
## Workflow
105+
106+
```
107+
1. Dev faz mudanças
108+
↓
109+
2. Dev cria changeset
110+
↓
111+
3. Dev faz push
112+
↓
113+
4. Changesets bot cria PR "Version Packages"
114+
↓
115+
5. Reviewer aprova e faz merge
116+
↓
117+
6. Workflow automático publica packages
118+
↓
119+
7. ✅ Packages publicados no npm + GitHub Releases criadas
120+
```
121+
122+
## Comandos Úteis
123+
124+
```bash
125+
# Criar changeset
126+
pnpm changeset
127+
128+
# Ver status dos changesets
129+
pnpm changeset status
130+
131+
# Aplicar changesets (bump versions) - local only
132+
pnpm changeset version
133+
134+
# Publicar packages - local only (use GitHub Actions)
135+
pnpm changeset publish
136+
```
137+
138+
## Arquivos Gerados
139+
140+
- `.changeset/*.md` - Changesets pendentes
141+
- `packages/*/CHANGELOG.md` - Changelogs gerados
142+
- `apps/*/CHANGELOG.md` - Changelogs gerados
143+
144+
## Regras
145+
146+
- ✅ SEMPRE crie um changeset para mudanças publicáveis
147+
- ✅ Escreva resumos claros e descritivos
148+
- ✅ Use o tipo correto (patch/minor/major)
149+
- ❌ NUNCA bump versions manualmente
150+
- ❌ NUNCA publique localmente (use GitHub Actions)
151+
152+

‎.changeset/config.json‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
3+
"changelog": "@changesets/cli/changelog",
4+
"commit": false,
5+
"fixed": [],
6+
"linked": [],
7+
"access": "public",
8+
"baseBranch": "main",
9+
"updateInternalDependencies": "patch",
10+
"ignore": [],
11+
"___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
12+
"onlyUpdatePeerDependentsWhenOutOfRange": true
13+
}
14+
}

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
name: Bug Report
3+
about: Reportar um problema ou comportamento inesperado
4+
title: '[BUG] '
5+
labels: bug
6+
assignees: ''
7+
---
8+
9+
## Descrição do Bug
10+
11+
Uma descrição clara e concisa do que está errado.
12+
13+
## Para Reproduzir
14+
15+
Passos para reproduzir o comportamento:
16+
17+
1. Executar comando '...'
18+
2. Com argumentos '....'
19+
3. Observar erro '....'
20+
21+
## Comportamento Esperado
22+
23+
Uma descrição clara do que deveria acontecer.
24+
25+
## Comportamento Atual
26+
27+
O que realmente acontece.
28+
29+
## Screenshots/Logs
30+
31+
Se aplicável, adicione screenshots ou logs de erro para ajudar a explicar o problema.
32+
33+
```
34+
Cole logs de erro aqui
35+
```
36+
37+
## Ambiente
38+
39+
**CLI**:
40+
- Versão do vibe-devtools: [ex: 0.4.1] (`vdt --version`)
41+
- Instalação: [ ] Global [ ] npx
42+
43+
**Package Afetado**:
44+
- Nome: [ex: @vibe-devtools/basic]
45+
- Versão: [ex: 1.0.1]
46+
47+
**Sistema**:
48+
- OS: [ex: macOS 14.0, Windows 11, Ubuntu 22.04]
49+
- Node.js: [ex: 20.10.0] (`node -v`)
50+
- pnpm version (se aplicável): [ex: 8.15.0]
51+
52+
**Agente de IA**:
53+
- [ ] Cursor
54+
- [ ] GitHub Copilot
55+
- [ ] Gemini CLI
56+
- [ ] Outro: _____
57+
58+
## Contexto Adicional
59+
60+
Qualquer outra informação relevante sobre o problema.
61+
62+
## Possível Solução
63+
64+
(Opcional) Se você tem alguma ideia de como corrigir, compartilhe aqui.
65+
66+
---
67+
68+
**Checklist**:
69+
- [ ] Procurei por issues similares antes de criar esta
70+
- [ ] Estou usando a versão mais recente
71+
- [ ] Forneci todas as informações de ambiente
72+
- [ ] Incluí logs de erro (se aplicável)
73+

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: 💬 GitHub Discussions
4+
url: https://github.com/onosendae/vibe-devtools/discussions
5+
about: Perguntas, ideias e discussões gerais
6+
- name: 📚 Documentação
7+
url: https://github.com/onosendae/vibe-devtools#readme
8+
about: Leia a documentação completa
9+
- name: 📦 npm Registry
10+
url: https://www.npmjs.com/org/vibe-devtools
11+
about: Ver packages publicados
12+

‎.github/ISSUE_TEMPLATE/custom_vibe.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
name: Custom Vibe Showcase
3+
about: Compartilhar um vibe customizado que você criou
4+
title: '[VIBE] '
5+
labels: community, vibe
6+
assignees: ''
7+
---
8+
9+
## 🎨 Nome do Vibe
10+
11+
Nome do seu vibe package.
12+
13+
## 📝 Descrição
14+
15+
Uma descrição clara do que seu vibe faz.
16+
17+
## 🎯 Propósito
18+
19+
Que problema esse vibe resolve? Para quem é útil?
20+
21+
## 📦 Instalação
22+
23+
Como instalar seu vibe?
24+
25+
```bash
26+
vdt install @yourorg/your-vibe
27+
```
28+
29+
ou
30+
31+
```bash
32+
vdt install github:youruser/your-vibe
33+
```
34+
35+
## ✨ Features
36+
37+
Que commands/rules/scripts seu vibe fornece?
38+
39+
- `/command.one` - Descrição breve
40+
- `/command.two` - Descrição breve
41+
- Rule: `my-rule.mdc` - Descrição breve
42+
43+
## 💡 Exemplos de Uso
44+
45+
Mostre exemplos práticos de como usar seu vibe:
46+
47+
```bash
48+
# Exemplo 1
49+
/command.one "fazer algo incrível"
50+
51+
# Exemplo 2
52+
/command.two --option value
53+
```
54+
55+
## 🔗 Links
56+
57+
- **npm**: https://www.npmjs.com/package/@yourorg/your-vibe
58+
- **GitHub**: https://github.com/youruser/your-vibe
59+
- **Docs**: [link se houver]
60+
61+
## 📸 Screenshots/Demos
62+
63+
(Opcional) Screenshots ou GIFs demonstrando seu vibe em ação.
64+
65+
## 🏗️ Tecnologias/Dependências
66+
67+
Seu vibe depende de alguma tecnologia específica?
68+
69+
- Node.js version mínima
70+
- Dependências externas
71+
- Integrações (Trello, Slack, etc)
72+
73+
## 🎓 Aprendizados
74+
75+
(Opcional) O que você aprendeu criando este vibe? Dicas para outros criadores?
76+
77+
## 🤝 Contribuições
78+
79+
Seu vibe aceita contribuições?
80+
81+
- [ ] Sim, aceito PRs
82+
- [ ] Issues são bem-vindas
83+
- [ ] Apenas showcase
84+
85+
## 📄 Licença
86+
87+
Qual licença seu vibe usa?
88+
89+
- [ ] MIT
90+
- [ ] Apache 2.0
91+
- [ ] GPL
92+
- [ ] Outra: _____
93+
94+
---
95+
96+
**Para Maintainers**: Considerar adicionar ao [awesome-vibes list] se destacado!
97+

0 commit comments

Comments
 (0)