maestro-bundle 1.8.0 → 2.0.0

package/templates/bundle-jhipster-microservices/PRD_TEMPLATE.md

@@ -1,50 +1,50 @@
 # Product Requirements Document (PRD)
 
-> Este documento define os requisitos do produto. Deve ser preenchido pelo analista de requisitos e/ou pelo dev antes de iniciar o desenvolvimento. O agente AI usa este documento como contexto para entender O QUE construir.
+> This document defines the product requirements. It should be filled out by the requirements analyst and/or the developer before starting development. The AI agent uses this document as context to understand WHAT to build.
 
-## 1. Resumo Executivo
+## 1. Executive Summary
 
-<!-- Descreva em 2-3 frases o que é o produto e qual problema resolve -->
+<!-- Describe in 2-3 sentences what the product is and what problem it solves -->
 
-## 2. Usuários Alvo
+## 2. Target Users
 
-<!-- Quem vai usar o sistema? Descreva as personas -->
+<!-- Who will use the system? Describe the personas -->
 
-### Persona 1: [Nome]
-- **Perfil:**
-- **Objetivos:**
-- **Dores:**
+### Persona 1: [Name]
+- **Profile:**
+- **Goals:**
+- **Pain points:**
 
-## 3. Escopo do MVP
+## 3. MVP Scope
 
-### Incluído no MVP
+### Included in MVP
 - [ ] Feature 1
 - [ ] Feature 2
 - [ ] Feature 3
 
-### Fora do MVP (futuro)
-- [ ] Feature futura 1
-- [ ] Feature futura 2
+### Out of MVP (future)
+- [ ] Future feature 1
+- [ ] Future feature 2
 
 ## 4. User Stories
 
-### US01: [Título]
-**Como** [persona], **quero** [ação], **para** [benefício].
+### US01: [Title]
+**As** [persona], **I want** [action], **so that** [benefit].
 
-**Critérios de aceite:**
-- [ ] CA1:
-- [ ] CA2:
+**Acceptance criteria:**
+- [ ] AC1:
+- [ ] AC2:
 
-### US02: [Título]
-**Como** [persona], **quero** [ação], **para** [benefício].
+### US02: [Title]
+**As** [persona], **I want** [action], **so that** [benefit].
 
-**Critérios de aceite:**
-- [ ] CA1:
-- [ ] CA2:
+**Acceptance criteria:**
+- [ ] AC1:
+- [ ] AC2:
 
-## 5. Arquitetura de Alto Nível
+## 5. High-Level Architecture
 
-<!-- Diagrama em Mermaid ou ASCII mostrando os componentes principais -->
+<!-- Mermaid or ASCII diagram showing the main components -->
 
 ```mermaid
 graph LR
@@ -52,7 +52,7 @@ graph LR
     B --> C[Database]
 ```
 
-### Estrutura de Diretórios
+### Directory Structure
 
 ```
 project/
@@ -61,29 +61,29 @@ project/
 └── ...
 ```
 
-## 6. Features Detalhadas
+## 6. Detailed Features
 
-### Feature 1: [Nome]
-- **Descrição:**
-- **Regras de negócio:**
+### Feature 1: [Name]
+- **Description:**
+- **Business rules:**
   -
 - **Inputs:**
 - **Outputs:**
 - **Edge cases:**
   -
 
-### Feature 2: [Nome]
-- **Descrição:**
-- **Regras de negócio:**
+### Feature 2: [Name]
+- **Description:**
+- **Business rules:**
   -
 
-## 7. Stack Tecnológica
+## 7. Technology Stack
 
-| Componente | Tecnologia | Justificativa |
+| Component | Technology | Justification |
 |---|---|---|
 | Backend | | |
 | Frontend | | |
-| Banco de dados | | |
+| Database | | |
 | Cache | | |
 | Deploy | | |
 
@@ -92,7 +92,7 @@ project/
 ### Endpoints
 
 #### `GET /api/v1/resource`
-- **Descrição:**
+- **Description:**
 - **Response:** `200 OK`
 ```json
 {
@@ -104,7 +104,7 @@ project/
 ```
 
 #### `POST /api/v1/resource`
-- **Descrição:**
+- **Description:**
 - **Body:**
 ```json
 {
@@ -113,7 +113,7 @@ project/
 ```
 - **Response:** `201 Created`
 
-## 9. Modelo de Dados
+## 9. Data Model
 
 ```sql
 CREATE TABLE example (
@@ -123,39 +123,39 @@ CREATE TABLE example (
 );
 ```
 
-## 10. Requisitos Não-Funcionais
+## 10. Non-Functional Requirements
 
-| Requisito | Alvo | Prioridade |
+| Requirement | Target | Priority |
 |---|---|---|
-| Performance | Response time < 500ms | Alta |
-| Disponibilidade | 99.9% uptime | Média |
-| Segurança | OWASP Top 10 | Alta |
-| Escalabilidade | Até X usuários simultâneos | Média |
+| Performance | Response time < 500ms | High |
+| Availability | 99.9% uptime | Medium |
+| Security | OWASP Top 10 | High |
+| Scalability | Up to X simultaneous users | Medium |
 
-## 11. Fases de Implementação
+## 11. Implementation Phases
 
-### Fase 1: Foundation
-- [ ] Setup do projeto
-- [ ] Modelo de dados
-- [ ] Endpoints básicos
+### Phase 1: Foundation
+- [ ] Project setup
+- [ ] Data model
+- [ ] Basic endpoints
 
-### Fase 2: Core Features
-- [ ] Feature 1 completa
-- [ ] Feature 2 completa
+### Phase 2: Core Features
+- [ ] Feature 1 complete
+- [ ] Feature 2 complete
 
-### Fase 3: Polish
-- [ ] Testes E2E
+### Phase 3: Polish
+- [ ] E2E tests
 - [ ] Performance
-- [ ] Documentação
+- [ ] Documentation
 
-## 12. Riscos e Mitigações
+## 12. Risks and Mitigations
 
-| Risco | Impacto | Probabilidade | Mitigação |
+| Risk | Impact | Probability | Mitigation |
 |---|---|---|---|
 | | | | |
 
-## 13. Critérios de Sucesso
+## 13. Success Criteria
 
-- [ ] Critério 1
-- [ ] Critério 2
-- [ ] Critério 3
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3

package/templates/bundle-jhipster-monorepo/.spec/constitution.md

@@ -1,32 +1,32 @@
-# Constitution — Projeto JHipster Monorepo
+# Constitution — JHipster Monorepo Project
 
-## Princípios
+## Principles
 
-1. **Spec primeiro, código depois** — Toda demanda passa pelo fluxo SDD antes de implementação
-2. **JDL como fonte de verdade** — Modelo de entidades definido em JDL, código gerado pelo JHipster
-3. **Enriquecer, não substituir** — Entidades geradas pelo JHipster são enriquecidas com DDD, não reescritas do zero
-4. **Migrations versionadas** — Toda mudança de schema via Liquibase changeset, nunca manual
-5. **DTO na fronteira** — Nunca expor entidade JPA na API REST
+1. **Spec first, code later** — Every demand goes through the SDD flow before implementation
+2. **JDL as source of truth** — Entity model defined in JDL, code generated by JHipster
+3. **Enrich, don't replace** — Entities generated by JHipster are enriched with DDD, not rewritten from scratch
+4. **Versioned migrations** — Every schema change via Liquibase changeset, never manual
+5. **DTO at the boundary** — Never expose JPA entities in the REST API
 
-## Padrões de desenvolvimento
+## Development Standards
 
 ### Java / Spring Boot
-- Java 21+, Records para DTOs
-- Constructor injection (nunca @Autowired em campo)
-- @Transactional apenas no Service
-- Entidades com comportamento rico (não anêmicas)
-- MapStruct para conversão Entity ↔ DTO
+- Java 21+, Records for DTOs
+- Constructor injection (never @Autowired on fields)
+- @Transactional only on Services
+- Entities with rich behavior (not anemic)
+- MapStruct for Entity <-> DTO conversion
 
 ### Angular
 - Standalone components (Angular 17+)
-- Lazy loading por rota
-- Reactive Forms com validação
-- Services para chamadas HTTP
+- Lazy loading per route
+- Reactive Forms with validation
+- Services for HTTP calls
 
-## Padrões de qualidade
+## Quality Standards
 
-- Cobertura mínima: 80%
-- JUnit 5 + Mockito para backend
-- Jest + Cypress para frontend
-- Code review obrigatório
-- Commits seguem Conventional Commits
+- Minimum coverage: 80%
+- JUnit 5 + Mockito for backend
+- Jest + Cypress for frontend
+- Code review mandatory
+- Commits follow Conventional Commits

package/templates/bundle-jhipster-monorepo/AGENTS.md

@@ -1,51 +1,51 @@
-# Projeto: JHipster Monorepo
+# Project: JHipster Monorepo
 
-Você está construindo uma aplicação monolítica com JHipster. Backend em Java/Spring Boot, frontend em Angular, banco PostgreSQL, tudo em um único repositório.
+You are building a monolithic application with JHipster. Backend in Java/Spring Boot, frontend in Angular, PostgreSQL database, all in a single repository.
 
 ## Specification-Driven Development (SDD)
 
-A regra fundamental de SDD está definida no bundle-base (AGENTS.md base) e é inegociável:
-**Sem spec, sem código. Sem exceção.** O agente deve recusar implementar qualquer demanda que
-não tenha passado pelo fluxo `/speckit.specify` → `/speckit.plan` → `/speckit.tasks` → `/speckit.implement`.
+The fundamental SDD rule is defined in the bundle-base (base AGENTS.md) and is non-negotiable:
+**No spec, no code. No exception.** The agent must refuse to implement any demand that
+has not gone through the `/speckit.specify` → `/speckit.plan` → `/speckit.tasks` → `/speckit.implement` flow.
 
-Se o usuário pedir para codar algo sem spec, PARE e inicie o fluxo SDD primeiro.
-Consulte `.specify/specs/` para verificar se já existe spec para a demanda.
+If the user asks to code something without a spec, STOP and initiate the SDD flow first.
+Check `.specify/specs/` to verify if a spec already exists for the demand.
 
 ## Product Requirements Document
 
-O arquivo `PRD.md` na raiz do projeto contém os requisitos do produto definidos pelo analista/dev. Consulte-o para entender O QUE construir, as user stories, critérios de aceite, modelo de dados e API specification. Este AGENTS.md define COMO o agente deve trabalhar; o PRD define O QUE deve ser construído.
+The `PRD.md` file at the project root contains the product requirements defined by the analyst/dev. Consult it to understand WHAT to build, the user stories, acceptance criteria, data model, and API specification. This AGENTS.md defines HOW the agent should work; the PRD defines WHAT should be built.
 
-- `PRD.md` — Requisitos do produto, user stories, API spec, modelo de dados
+- `PRD.md` — Product requirements, user stories, API spec, data model
 
 ## References
 
-Documentos de referência que o agente deve consultar quando necessário:
+Reference documents that the agent should consult when necessary:
 
-- `references/jhipster-jdl-guide.md` — Guia completo de JDL
-- `references/spring-boot-patterns.md` — Padrões Spring Boot
-- `references/angular-patterns.md` — Padrões Angular no JHipster
-- `references/liquibase-guide.md` — Guia de migrations Liquibase
+- `references/jhipster-jdl-guide.md` — Complete JDL guide
+- `references/spring-boot-patterns.md` — Spring Boot patterns
+- `references/angular-patterns.md` — Angular patterns in JHipster
+- `references/liquibase-guide.md` — Liquibase migrations guide
 
-## Stack do projeto
+## Project Stack
 
-- **Backend:** Java 21 + Spring Boot 3.x (gerado pelo JHipster)
-- **Frontend:** Angular 17+ com TypeScript
-- **Banco:** PostgreSQL
-- **Cache:** Ehcache ou Redis
-- **Migrations:** Liquibase (padrão JHipster)
-- **Auth:** JWT (padrão JHipster) ou OAuth2/Keycloak
-- **Testes:** JUnit 5 + Mockito (back), Jest + Cypress (front)
-- **Build:** Maven ou Gradle
-- **API docs:** Swagger/OpenAPI (auto-gerado)
+- **Backend:** Java 21 + Spring Boot 3.x (generated by JHipster)
+- **Frontend:** Angular 17+ with TypeScript
+- **Database:** PostgreSQL
+- **Cache:** Ehcache or Redis
+- **Migrations:** Liquibase (JHipster default)
+- **Auth:** JWT (JHipster default) or OAuth2/Keycloak
+- **Tests:** JUnit 5 + Mockito (back), Jest + Cypress (front)
+- **Build:** Maven or Gradle
+- **API docs:** Swagger/OpenAPI (auto-generated)
 
-## Estrutura JHipster Monorepo
+## JHipster Monorepo Structure
 
 ```
 project/
 ├── src/
 │   ├── main/
-│   │   ├── java/com/empresa/projeto/
-│   │   │   ├── domain/                  # Entidades JPA (enriquecer com DDD)
+│   │   ├── java/com/company/project/
+│   │   │   ├── domain/                  # JPA Entities (enrich with DDD)
 │   │   │   │   ├── Demand.java
 │   │   │   │   ├── Task.java
 │   │   │   │   └── enumeration/
@@ -81,27 +81,27 @@ project/
 └── package.json                       # Frontend deps
 ```
 
-## Padrões de código
+## Code Standards
 
 ### Java
-- Máximo 500 linhas por classe
-- Records para DTOs imutáveis (Java 21)
-- Optional ao invés de null returns
-- Streams API para coleções (não loops imperativos)
+- Maximum 500 lines per class
+- Records for immutable DTOs (Java 21)
+- Optional instead of null returns
+- Streams API for collections (not imperative loops)
 - Google Java Style Guide
-- Lombok apenas para: `@Slf4j`, `@RequiredArgsConstructor`. Evitar `@Data`.
-- Nunca `@Autowired` em campo — usar constructor injection
+- Lombok only for: `@Slf4j`, `@RequiredArgsConstructor`. Avoid `@Data`.
+- Never `@Autowired` on fields -- use constructor injection
 
 ### Angular
-- Strict mode habilitado
+- Strict mode enabled
 - Standalone components (Angular 17+)
-- Signals para estado reativo quando possível
-- Lazy loading por rota/feature
-- Reactive Forms com validação
+- Signals for reactive state when possible
+- Lazy loading per route/feature
+- Reactive Forms with validation
 
-## JDL — Modelo de entidades
+## JDL -- Entity Model
 
-Usar JDL para definir entidades e gerar código:
+Use JDL to define entities and generate code:
 
 ```jdl
 entity Demand {
@@ -141,19 +141,19 @@ dto * with mapstruct
 service * with serviceImpl
 ```
 
-## Enriquecer JHipster com DDD
+## Enriching JHipster with DDD
 
-O JHipster gera entidades anêmicas por padrão. Enriqueça com comportamento:
+JHipster generates anemic entities by default. Enrich them with behavior:
 
 ```java
-// NÃO FAZER — entidade anêmica (padrão JHipster)
+// DON'T -- anemic entity (JHipster default)
 public class Demand {
     private String description;
     private DemandStatus status;
-    // apenas getters/setters
+    // only getters/setters
 }
 
-// FAZER — entidade rica
+// DO -- rich entity
 public class Demand {
     private String description;
     private DemandStatus status;
@@ -181,9 +181,9 @@ public class Demand {
 }
 ```
 
-## Liquibase — Migrations
+## Liquibase -- Migrations
 
-Sempre gerar changeset para mudanças de schema:
+Always generate changesets for schema changes:
 
 ```xml
 <changeSet id="20260327-1" author="dev">
@@ -204,27 +204,27 @@ Sempre gerar changeset para mudanças de schema:
 </changeSet>
 ```
 
-## Testes
+## Tests
 
-- **JUnit 5:** Testar services e entidades enriquecidas
-- **MockMvc:** Testar controllers (status codes, validação)
-- **Testcontainers:** Integração com PostgreSQL real
-- **Jest:** Componentes Angular
+- **JUnit 5:** Test services and enriched entities
+- **MockMvc:** Test controllers (status codes, validation)
+- **Testcontainers:** Integration with real PostgreSQL
+- **Jest:** Angular components
 - **Cypress:** E2E flows
-- Cobertura mínima: 80%
+- Minimum coverage: 80%
 
 ## Git
 
-- Commits: `feat(demand): adicionar decomposição automática`
-- Branches: `feature/<entity>-<descricao>`
-- Nunca alterar arquivos gerados do JHipster sem necessidade
-- Regenerar com `jhipster import-jdl` quando mudar modelo
+- Commits: `feat(demand): add automatic decomposition`
+- Branches: `feature/<entity>-<description>`
+- Never alter JHipster-generated files unnecessarily
+- Regenerate with `jhipster import-jdl` when changing the model
 
-## O que NÃO fazer
+## What NOT to do
 
-- Não editar manualmente arquivos que o JHipster regenera (liquibase gerado, webpack config)
-- Não colocar regras de negócio no REST controller
-- Não usar `@Transactional` em todo lugar — só onde necessário
-- Não criar services genéricos "God class"
-- Não ignorar DTOs — nunca expor entidade JPA na API
-- Não usar Lombok `@Data` (gera equals/hashCode perigoso com JPA)
+- Do not manually edit files that JHipster regenerates (generated liquibase, webpack config)
+- Do not put business rules in the REST controller
+- Do not use `@Transactional` everywhere -- only where necessary
+- Do not create generic "God class" services
+- Do not ignore DTOs -- never expose JPA entities in the API
+- Do not use Lombok `@Data` (generates dangerous equals/hashCode with JPA)