maestro-bundle 1.9.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +90 -90
  3. package/package.json +2 -2
  4. package/src/cli.mjs +72 -81
  5. package/templates/bundle-ai-agents/.spec/constitution.md +24 -24
  6. package/templates/bundle-ai-agents/AGENTS.md +71 -71
  7. package/templates/bundle-ai-agents/PRD_TEMPLATE.md +63 -63
  8. package/templates/bundle-ai-agents-deep/.spec/constitution.md +17 -17
  9. package/templates/bundle-ai-agents-deep/AGENTS.md +58 -58
  10. package/templates/bundle-ai-agents-deep/PRD_TEMPLATE.md +63 -63
  11. package/templates/bundle-ai-agents-deep/skills/deep-agent-memory/SKILL.md +158 -158
  12. package/templates/bundle-base/AGENTS.md +99 -99
  13. package/templates/bundle-data-pipeline/.spec/constitution.md +23 -23
  14. package/templates/bundle-data-pipeline/AGENTS.md +68 -68
  15. package/templates/bundle-data-pipeline/PRD_TEMPLATE.md +63 -63
  16. package/templates/bundle-frontend-spa/.spec/constitution.md +21 -21
  17. package/templates/bundle-frontend-spa/AGENTS.md +58 -58
  18. package/templates/bundle-frontend-spa/PRD_TEMPLATE.md +63 -63
  19. package/templates/bundle-jhipster-microservices/.spec/constitution.md +31 -31
  20. package/templates/bundle-jhipster-microservices/AGENTS.md +70 -70
  21. package/templates/bundle-jhipster-microservices/PRD_TEMPLATE.md +63 -63
  22. package/templates/bundle-jhipster-monorepo/.spec/constitution.md +22 -22
  23. package/templates/bundle-jhipster-monorepo/AGENTS.md +64 -64
  24. package/templates/bundle-jhipster-monorepo/PRD_TEMPLATE.md +63 -63
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Maestro
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,103 +1,103 @@
1
1
  # maestro-bundle
2
2
 
3
- Um comando. Contexto completo pro agente AI. Qualquer editor.
3
+ One command. Full context for your AI agent. Any editor.
4
4
 
5
5
  ```bash
6
6
  npx maestro-bundle ai-agents claude
7
7
  ```
8
8
 
9
- ## O problema
9
+ ## The problem
10
10
 
11
- Agentes AI (Claude Code, Cursor, Codex) são poderosos, mas sem contexto eles não sabem:
11
+ AI agents (Claude Code, Cursor, Codex) are powerful, but without context they don't know:
12
12
 
13
- - Qual a stack do projeto
14
- - Quais padrões de código seguir
15
- - O que a aplicação faz (requisitos)
16
- - Que ferramentas usar e quando
17
- - Qual o plano antes de sair codando
13
+ - What stack the project uses
14
+ - Which coding standards to follow
15
+ - What the application does (requirements)
16
+ - What tools to use and when
17
+ - That they should plan before coding
18
18
 
19
- O resultado é **vibing code** — o agente gera código sem direção, sem padrões, sem planejamento. Funciona para protótipos, mas é inviável para projetos reais com time.
19
+ The result is **vibing code** — the agent generates code with no direction, no standards, no planning. Fine for prototypes, unacceptable for real projects with teams.
20
20
 
21
- ## A solução: contexto em camadas
21
+ ## The solution: layered context
22
22
 
23
- O maestro-bundle resolve isso instalando **3 camadas de contexto** que trabalham juntas:
23
+ maestro-bundle solves this by installing **4 layers of context** that work together:
24
24
 
25
25
  ```
26
26
  ┌─────────────────────────────────────────────────────────┐
27
27
  │ │
28
- │ PRD.md O QUE construir │
29
- │ (requisitos) User stories, API spec, modelo │
30
- │ de dados, critérios de aceite │
28
+ │ PRD.md WHAT to build │
29
+ │ (requirements) User stories, API spec, data │
30
+ │ model, acceptance criteria │
31
31
  │ │
32
32
  ├─────────────────────────────────────────────────────────┤
33
33
  │ │
34
- │ AGENTS.md COMO construir │
35
- │ (padrões) Stack, arquitetura, convenções, │
36
- │ estrutura de projeto, git flow │
34
+ │ AGENTS.md HOW to build │
35
+ │ (standards) Stack, architecture, conventions, │
36
+ │ project structure, git flow │
37
37
  │ │
38
38
  ├─────────────────────────────────────────────────────────┤
39
39
  │ │
40
- │ Skills COM O QUE construir │
41
- │ (capacidades) RAG pipeline, clean architecture, │
42
- │ deploy, testes, etc. │
40
+ │ Skills WITH WHAT to build │
41
+ │ (capabilities) RAG pipeline, clean architecture, │
42
+ │ deploy, testing, etc. │
43
43
  │ │
44
44
  ├─────────────────────────────────────────────────────────┤
45
45
  │ │
46
- │ Spec Kit (SDD) EM QUE ORDEM construir │
47
- │ (processo) /speckit.specify → plan → tasks │
46
+ │ Spec Kit (SDD) IN WHAT ORDER to build │
47
+ │ (process) /speckit.specify → plan → tasks │
48
48
  │ → implement │
49
49
  │ │
50
50
  └─────────────────────────────────────────────────────────┘
51
51
  ```
52
52
 
53
- Cada camada dá ao agente um tipo de contexto diferente. Juntas, elas fazem o agente trabalhar como um dev senior que conhece o projeto, segue os padrões e planeja antes de codar.
53
+ Each layer gives the agent a different type of context. Together, they make the agent work like a senior dev who knows the project, follows the standards, and plans before coding.
54
54
 
55
- ## O que instala
55
+ ## What it installs
56
56
 
57
57
  ```bash
58
58
  npx maestro-bundle ai-agents claude
59
59
  ```
60
60
 
61
- | O que | Para que | Quem preenche |
61
+ | What | Purpose | Who fills it |
62
62
  |---|---|---|
63
- | **AGENTS.md** | Padrões, stack, convenções do projeto | Bundle (automático) |
64
- | **Skills** | Capacidades específicas (RAG, clean arch, testes...) | Bundle (automático) |
65
- | **PRD.md** | Requisitos do produto, user stories, API spec | Analista / Dev |
66
- | **Spec Kit** | Processo SDD — spec → plan → tasks → implement | Agente + Dev |
67
- | **Constitution** | Princípios inegociáveis do projeto | Bundle (automático) |
68
- | **LangChain Skills** | 11 skills oficiais LangChain (bundles AI) | Bundle (automático) |
63
+ | **AGENTS.md** | Standards, stack, conventions | Bundle (automatic) |
64
+ | **Skills** | Specific capabilities (RAG, clean arch, tests...) | Bundle (automatic) |
65
+ | **PRD.md** | Product requirements, user stories, API spec | Analyst / Dev |
66
+ | **Spec Kit** | SDD process — spec → plan → tasks → implement | Agent + Dev |
67
+ | **Constitution** | Non-negotiable project principles | Bundle (automatic) |
68
+ | **LangChain Skills** | 11 official LangChain skills (AI bundles) | Bundle (automatic) |
69
69
 
70
- O dev só precisa preencher o `PRD.md`. Todo o resto vem pronto.
70
+ The dev only needs to fill in `PRD.md`. Everything else comes ready.
71
71
 
72
- ## Como funciona na prática
72
+ ## How it works in practice
73
73
 
74
74
  ```
75
- 1. Dev instala o bundle
75
+ 1. Dev installs the bundle
76
76
  $ npx maestro-bundle ai-agents claude
77
77
 
78
- 2. Analista/dev preenche o PRD.md com os requisitos
78
+ 2. Analyst/dev fills PRD.md with requirements
79
79
 
80
- 3. Dev abre o editor e pede uma feature:
81
- "Cria o endpoint de autenticação JWT"
80
+ 3. Dev opens the editor and requests a feature:
81
+ "Create the JWT authentication endpoint"
82
82
 
83
- 4. O agente já sabe:
84
- - Os requisitos (PRD.md)
85
- - A stack e padrões (AGENTS.md)
86
- - Como fazer JWT (skill de authentication)
87
- - Que precisa criar spec antes de codar (Spec Kit)
83
+ 4. The agent already knows:
84
+ - The requirements (PRD.md)
85
+ - The stack and standards (AGENTS.md)
86
+ - How to do JWT (authentication skill)
87
+ - That it needs to create a spec before coding (Spec Kit)
88
88
 
89
- 5. Resultado: código governado, consistente, planejado
89
+ 5. Result: governed, consistent, planned code
90
90
  ```
91
91
 
92
- ## Bundles disponíveis
92
+ ## Available bundles
93
93
 
94
- | Bundle | Tipo de projeto | Stack |
94
+ | Bundle | Project type | Stack |
95
95
  |---|---|---|
96
- | `ai-agents` | Sistemas multi-agente com AI | Python, LangChain, LangGraph, FastAPI, pgvector |
97
- | `ai-agents-deep` | Deep Agent (tipo Claude Code) | Python, Deep Agents SDK, LangGraph, Subagentes |
98
- | `jhipster-monorepo` | Aplicação JHipster monolítica | Java 21, Spring Boot, Angular, PostgreSQL |
99
- | `jhipster-microservices` | Microsserviços JHipster | Java 21, Spring Boot, Kafka, Consul, K8s |
100
- | `data-pipeline` | Pipeline de dados e ML | Python, Pandas, Scikit-learn, MLflow |
96
+ | `ai-agents` | Multi-agent AI systems | Python, LangChain, LangGraph, FastAPI, pgvector |
97
+ | `ai-agents-deep` | Deep Agent (Claude Code-like) | Python, Deep Agents SDK, LangGraph, Subagents |
98
+ | `jhipster-monorepo` | JHipster monolithic app | Java 21, Spring Boot, Angular, PostgreSQL |
99
+ | `jhipster-microservices` | JHipster microservices | Java 21, Spring Boot, Kafka, Consul, K8s |
100
+ | `data-pipeline` | Data & ML pipeline | Python, Pandas, Scikit-learn, MLflow |
101
101
  | `frontend-spa` | Frontend SPA | React, TypeScript, Tailwind, Vite |
102
102
 
103
103
  ```bash
@@ -109,49 +109,49 @@ npx maestro-bundle data-pipeline copilot
109
109
  npx maestro-bundle frontend-spa windsurf
110
110
  ```
111
111
 
112
- ## Editores suportados
112
+ ## Supported editors
113
113
 
114
- | Editor | Comando | Onde instala |
114
+ | Editor | Command | Where it installs |
115
115
  |---|---|---|
116
116
  | **Claude Code** | `npx maestro-bundle <bundle> claude` | `CLAUDE.md` + `.claude/skills/` |
117
117
  | **Cursor** | `npx maestro-bundle <bundle> cursor` | `AGENTS.md` + `.cursor/skills/` |
118
118
  | **OpenAI Codex** | `npx maestro-bundle <bundle> codex` | `AGENTS.md` + `.agents/skills/` |
119
119
  | **GitHub Copilot** | `npx maestro-bundle <bundle> copilot` | `.github/copilot-instructions.md` |
120
120
  | **Windsurf** | `npx maestro-bundle <bundle> windsurf` | `.windsurfrules` |
121
- | **Todos** | `npx maestro-bundle <bundle> all` | Tudo acima no mesmo repo |
121
+ | **All** | `npx maestro-bundle <bundle> all` | All of the above in the same repo |
122
122
 
123
- ## O que acontece ao instalar
123
+ ## What happens when you install
124
124
 
125
125
  ```
126
126
  $ npx maestro-bundle ai-agents claude
127
127
 
128
- Bundle: Sistema Multi-Agente com AI
128
+ Bundle: Multi-Agent AI System
129
129
  Editor: Claude Code
130
130
 
131
- ✔ Claude Code: AGENTS.md, CLAUDE.md, 14 skills em .claude/skills/
132
- ✔ PRD.md template instalado
133
- ✔ 11 LangChain Skills instaladas
134
- ✔ specify-cli v0.4.3 instalado
135
- ✔ Spec Kit inicializado (/speckit.* commands disponíveis)
136
- ✔ Constitution do bundle integrado
131
+ ✔ Claude Code: AGENTS.md, CLAUDE.md, 14 skills in .claude/skills/
132
+ ✔ PRD.md template installed
133
+ ✔ 11 LangChain Skills installed
134
+ ✔ specify-cli v0.4.3 installed
135
+ ✔ Spec Kit initialized (/speckit.* commands available)
136
+ ✔ Bundle constitution integrated
137
137
 
138
- Pronto!
138
+ Done!
139
139
 
140
- Próximo passo:
141
- 1. Preencha o PRD.md com os requisitos do produto
142
- 2. Abra o projeto no editor AI
143
- 3. Use /speckit.specify para começar a primeira feature
140
+ Next steps:
141
+ 1. Fill in PRD.md with your product requirements
142
+ 2. Open the project in your AI editor
143
+ 3. Use /speckit.specify to start your first feature
144
144
  ```
145
145
 
146
- ## Estrutura no projeto
146
+ ## Project structure
147
147
 
148
148
  ```
149
- seu-projeto/
150
- ├── CLAUDE.md # Aponta para AGENTS.md
151
- ├── AGENTS.md # Stack, padrões, convenções (automático)
152
- ├── PRD.md # Requisitos do produto (preencher!)
149
+ your-project/
150
+ ├── CLAUDE.md # Points to AGENTS.md
151
+ ├── AGENTS.md # Stack, standards, conventions (automatic)
152
+ ├── PRD.md # Product requirements (fill this in!)
153
153
  ├── .claude/
154
- │ ├── skills/ # Capacidades do agente
154
+ │ ├── skills/ # Agent capabilities
155
155
  │ │ ├── rag-pipeline/
156
156
  │ │ ├── clean-architecture/
157
157
  │ │ ├── testing-strategy/
@@ -161,7 +161,7 @@ seu-projeto/
161
161
  │ ├── speckit.plan.md
162
162
  │ ├── speckit.tasks.md
163
163
  │ └── speckit.implement.md
164
- ├── .specify/ # Specs, plans, tasks das features
164
+ ├── .specify/ # Feature specs, plans, tasks
165
165
  │ ├── memory/constitution.md
166
166
  │ ├── templates/
167
167
  │ └── specs/
@@ -169,36 +169,36 @@ seu-projeto/
169
169
  │ ├── spec.md
170
170
  │ ├── plan.md
171
171
  │ └── tasks.md
172
- ├── skills/ # Skills canônicas (Deep Agents)
173
- └── references/ # Docs de referência
172
+ ├── skills/ # Canonical skills (Deep Agents)
173
+ └── references/ # Reference docs
174
174
  ```
175
175
 
176
- ## Processo SDD com Spec Kit
176
+ ## SDD process with Spec Kit
177
177
 
178
- O bundle instala o [GitHub Spec Kit](https://github.com/github/spec-kit) que adiciona commands no editor para o fluxo de Specification-Driven Development:
178
+ The bundle installs [GitHub Spec Kit](https://github.com/github/spec-kit) which adds commands to your editor for Specification-Driven Development:
179
179
 
180
- | Command | O que faz |
180
+ | Command | What it does |
181
181
  |---|---|
182
- | `/speckit.specify` | Especificar O QUE construir e POR QUÊ |
183
- | `/speckit.plan` | Planejar arquitetura e decisões técnicas |
184
- | `/speckit.tasks` | Quebrar em tasks atômicas |
185
- | `/speckit.implement` | Executar as tasks seguindo o plano |
182
+ | `/speckit.specify` | Specify WHAT to build and WHY |
183
+ | `/speckit.plan` | Plan architecture and technical decisions |
184
+ | `/speckit.tasks` | Break down into atomic tasks |
185
+ | `/speckit.implement` | Execute tasks following the plan |
186
186
 
187
- O agente é instruído a seguir esse fluxo para features novas. Bug fixes simples podem ir direto.
187
+ The agent is instructed to follow this flow for new features. Simple bug fixes can go directly.
188
188
 
189
- ## LangChain Skills (bundles AI)
189
+ ## LangChain Skills (AI bundles)
190
190
 
191
- Os bundles `ai-agents` e `ai-agents-deep` instalam automaticamente as [11 skills oficiais do LangChain](https://github.com/langchain-ai/langchain-skills) cobrindo LangChain, LangGraph e Deep Agents.
191
+ The `ai-agents` and `ai-agents-deep` bundles automatically install the [11 official LangChain skills](https://github.com/langchain-ai/langchain-skills) covering LangChain, LangGraph, and Deep Agents.
192
192
 
193
- ## Pré-requisitos
193
+ ## Prerequisites
194
194
 
195
195
  - **Node.js 18+**
196
196
  - **Git**
197
- - **uv** ou **pip** (para o Spec Kit — instalado automaticamente)
197
+ - **uv** or **pip** (for Spec Kit — installed automatically)
198
198
 
199
199
  ## Links
200
200
 
201
- - [AGENTS.md](https://agents.md/) — Padrão universal para instruções de agentes AI
201
+ - [AGENTS.md](https://agents.md/) — Universal standard for AI agent instructions
202
202
  - [GitHub Spec Kit](https://github.com/github/spec-kit) — Specification-Driven Development
203
- - [LangChain Skills](https://github.com/langchain-ai/langchain-skills) — Skills oficiais LangChain
204
- - [Agent Skills](https://agentskills.io) — Padrão aberto para skills de agentes
203
+ - [LangChain Skills](https://github.com/langchain-ai/langchain-skills) — Official LangChain skills
204
+ - [Agent Skills](https://agentskills.io) — Open standard for agent skills
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "maestro-bundle",
3
- "version": "1.9.0",
4
- "description": "Instala bundles de governança para projetos com AI agents. Um comando, tudo configurado.",
3
+ "version": "2.0.1",
4
+ "description": "One command. Full context for your AI agent. Any editor. Install governance bundles with skills, PRD, AGENTS.md and GitHub Spec Kit.",
5
5
  "bin": {
6
6
  "maestro-bundle": "./src/cli.mjs"
7
7
  },