maestro-bundle 1.8.0 → 2.0.0

package/templates/bundle-data-pipeline/AGENTS.md

@@ -1,65 +1,65 @@
-# Projeto: Pipeline de Dados e ML
+# Project: Data and ML Pipeline
 
-Você está construindo um pipeline de dados que inclui ingestão, processamento, treinamento de modelos e serving. O projeto usa Python com foco em engenharia de dados e machine learning.
+You are building a data pipeline that includes ingestion, processing, model training, and serving. The project uses Python with a focus on data engineering and machine learning.
 
 ## 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/pandas-patterns.md` — Padrões de transformação com Pandas
-- `references/mlflow-guide.md` — Guia de experiment tracking
-- `references/data-validation.md` — Validação com Pandera/Great Expectations
+- `references/pandas-patterns.md` — Pandas transformation patterns
+- `references/mlflow-guide.md` — Experiment tracking guide
+- `references/data-validation.md` — Validation with Pandera/Great Expectations
 
-## Stack do projeto
+## Project Stack
 
-- **Linguagem:** Python 3.11+
-- **Dados:** Pandas, Polars, NumPy
+- **Language:** Python 3.11+
+- **Data:** Pandas, Polars, NumPy
 - **ML:** Scikit-learn, XGBoost, LightGBM
-- **Deep Learning:** PyTorch (quando necessário)
-- **Pipeline:** Apache Airflow ou Prefect
+- **Deep Learning:** PyTorch (when needed)
+- **Pipeline:** Apache Airflow or Prefect
 - **Experiment Tracking:** MLflow
-- **RAG (se aplicável):** LangChain + pgvector
-- **Banco:** PostgreSQL
+- **RAG (if applicable):** LangChain + pgvector
+- **Database:** PostgreSQL
 - **Containers:** Docker
-- **Validação:** Pandera, Great Expectations
+- **Validation:** Pandera, Great Expectations
 
-## Estrutura do projeto
+## Project Structure
 
 ```
 src/
 ├── data/
-│   ├── raw/                    # Dados originais (imutáveis, nunca editar)
-│   ├── processed/              # Dados transformados
+│   ├── raw/                    # Original data (immutable, never edit)
+│   ├── processed/              # Transformed data
 │   └── features/               # Feature store
 ├── pipelines/
-│   ├── ingestion/              # Ingestão de fontes externas
-│   ├── preprocessing/          # Limpeza e transformação
-│   ├── feature_engineering/    # Criação de features
-│   └── training/               # Pipeline de treino
+│   ├── ingestion/              # Ingestion from external sources
+│   ├── preprocessing/          # Cleaning and transformation
+│   ├── feature_engineering/    # Feature creation
+│   └── training/               # Training pipeline
 ├── models/
-│   ├── training/               # Scripts de treino
-│   ├── evaluation/             # Avaliação e métricas
-│   └── serving/                # API de inferência (FastAPI)
-├── rag/                        # Se aplicável
+│   ├── training/               # Training scripts
+│   ├── evaluation/             # Evaluation and metrics
+│   └── serving/                # Inference API (FastAPI)
+├── rag/                        # If applicable
 │   ├── ingest.py
 │   ├── retriever.py
 │   └── embeddings.py
-├── notebooks/                  # APENAS exploração (não vai para prod)
+├── notebooks/                  # ONLY for exploration (does not go to prod)
 ├── tests/
 │   ├── test_preprocessing.py
 │   ├── test_features.py
@@ -69,50 +69,50 @@ src/
     └── models_config.yaml
 ```
 
-## Padrões de código
+## Code Standards
 
-- Máximo 500 linhas por arquivo, 20 linhas por função
-- Type hints em funções públicas
-- Docstrings em funções de transformação de dados (input/output)
-- Black + Ruff para formatação
-- Notebook → script Python antes de ir para produção
+- Maximum 500 lines per file, 20 lines per function
+- Type hints on public functions
+- Docstrings on data transformation functions (input/output)
+- Black + Ruff for formatting
+- Notebook -> Python script before going to production
 
-## Padrões de dados
+## Data Standards
 
-- Dados originais são IMUTÁVEIS — nunca editar `raw/`
-- Cada transformação é uma função pura (input → output, sem side effects)
-- Validar schema na entrada de cada pipeline step (Pandera)
-- Versionamento de datasets com DVC
-- Logging de todas as transformações
+- Original data is IMMUTABLE -- never edit `raw/`
+- Each transformation is a pure function (input -> output, no side effects)
+- Validate schema at the entry of each pipeline step (Pandera)
+- Dataset versioning with DVC
+- Logging of all transformations
 
-## Padrões de ML
+## ML Standards
 
-- Todo modelo precisa de baseline (majority class, média, regressão linear)
-- Cross-validation k=5 mínimo
-- Métricas documentadas: accuracy, precision, recall, F1, AUC
-- Feature importance registrada no MLflow
-- Modelo serializado com versão
-- A/B testing antes de substituir modelo em produção
+- Every model needs a baseline (majority class, mean, linear regression)
+- Cross-validation k=5 minimum
+- Documented metrics: accuracy, precision, recall, F1, AUC
+- Feature importance recorded in MLflow
+- Serialized model with version
+- A/B testing before replacing a model in production
 
 ## Git
 
-- Commits: `feat(preprocessing): adicionar normalização de salários`
-- Branches: `feature/<pipeline>-<descricao>`
-- Nunca commitar dados (usar .gitignore, DVC para dados)
-- Nunca commitar modelos binários (usar MLflow registry)
+- Commits: `feat(preprocessing): add salary normalization`
+- Branches: `feature/<pipeline>-<description>`
+- Never commit data (use .gitignore, DVC for data)
+- Never commit binary models (use MLflow registry)
 
-## Testes
+## Tests
 
-- Testes de schema (Pandera) para cada transformação
-- Testes unitários para funções de feature engineering
-- Testes de regressão para métricas do modelo
-- Cobertura mínima: 80% em pipelines de transformação
+- Schema tests (Pandera) for each transformation
+- Unit tests for feature engineering functions
+- Regression tests for model metrics
+- Minimum coverage: 80% on transformation pipelines
 
-## O que NÃO fazer
+## What NOT to do
 
-- Não colocar notebook em produção sem refatorar
-- Não treinar sem baseline
-- Não ignorar data drift
-- Não usar random seed inconsistente
-- Não hardcodar paths — usar config
-- Não fazer SELECT * em queries de dados grandes
+- Do not put notebooks in production without refactoring
+- Do not train without a baseline
+- Do not ignore data drift
+- Do not use inconsistent random seeds
+- Do not hardcode paths -- use config
+- Do not use SELECT * on large data queries

package/templates/bundle-data-pipeline/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-frontend-spa/.spec/constitution.md

@@ -1,32 +1,32 @@
-# Constitution — Projeto Frontend SPA
+# Constitution — Frontend SPA Project
 
-## Princípios
+## Principles
 
-1. **Spec primeiro, código depois** — Toda demanda passa pelo fluxo SDD antes de implementação
-2. **Componente = 1 responsabilidade** — Componentes pequenos e focados
-3. **Server state no React Query** — Nunca duplicar dados da API no estado global
-4. **TypeScript strict** — Zero `any`, types para tudo
-5. **Mobile-first** — Escrever para mobile, breakpoints para desktop
+1. **Spec first, code later** — Every demand goes through the SDD flow before implementation
+2. **Component = 1 responsibility** — Small and focused components
+3. **Server state in React Query** — Never duplicate API data in global state
+4. **TypeScript strict** — Zero `any`, types for everything
+5. **Mobile-first** — Write for mobile, breakpoints for desktop
 
-## Padrões de desenvolvimento
+## Development Standards
 
 - React 18+, TypeScript strict mode
 - Tailwind CSS + Shadcn/UI
 - Feature-based folder structure
-- Custom hooks para lógica reutilizável
-- React Hook Form + Zod para formulários
+- Custom hooks for reusable logic
+- React Hook Form + Zod for forms
 
-## Padrões de componentes
+## Component Standards
 
-- Composição sobre configuração
-- Loading/Error/Empty states em todo async
-- Acessibilidade: semantic HTML, aria-labels
-- Lazy loading por rota
-- Máximo 200 linhas por componente
+- Composition over configuration
+- Loading/Error/Empty states on every async
+- Accessibility: semantic HTML, aria-labels
+- Lazy loading per route
+- Maximum 200 lines per component
 
-## Padrões de qualidade
+## Quality Standards
 
-- Vitest + Testing Library para componentes
-- Playwright para E2E
-- Cobertura mínima: 70%
-- Commits seguem Conventional Commits
+- Vitest + Testing Library for components
+- Playwright for E2E
+- Minimum coverage: 70%
+- Commits follow Conventional Commits

package/templates/bundle-frontend-spa/AGENTS.md

@@ -1,110 +1,110 @@
-# Projeto: Frontend SPA (Single Page Application)
+# Project: Frontend SPA (Single Page Application)
 
-Você está construindo uma aplicação frontend moderna com React, TypeScript e Tailwind CSS que consome APIs REST ou GraphQL.
+You are building a modern frontend application with React, TypeScript, and Tailwind CSS that consumes REST or GraphQL APIs.
 
 ## 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/react-component-patterns.md` — Padrões de componentes React
-- `references/tailwind-design-system.md` — Design system com Tailwind
-- `references/testing-library-guide.md` — Guia de testes com Testing Library
+- `references/react-component-patterns.md` — React component patterns
+- `references/tailwind-design-system.md` — Design system with Tailwind
+- `references/testing-library-guide.md` — Testing Library guide
 
-## Stack do projeto
+## Project Stack
 
-- **Framework:** React 18+ com TypeScript (strict mode)
+- **Framework:** React 18+ with TypeScript (strict mode)
 - **Bundler:** Vite
-- **Estilização:** Tailwind CSS + Shadcn/UI
-- **Estado:** Zustand (global) + React Query (server state)
-- **Roteamento:** React Router v6+
+- **Styling:** Tailwind CSS + Shadcn/UI
+- **State:** Zustand (global) + React Query (server state)
+- **Routing:** React Router v6+
 - **Forms:** React Hook Form + Zod
 - **HTTP:** Axios
-- **WebSocket:** Socket.io-client (se real-time)
-- **Testes:** Vitest + Testing Library + Playwright (E2E)
+- **WebSocket:** Socket.io-client (if real-time)
+- **Tests:** Vitest + Testing Library + Playwright (E2E)
 
-## Estrutura do projeto
+## Project Structure
 
 ```
 src/
-├── features/                   # Organizado por feature/domínio
+├── features/                   # Organized by feature/domain
 │   ├── demands/
-│   │   ├── components/         # Componentes da feature
+│   │   ├── components/         # Feature components
 │   │   │   ├── DemandList.tsx
 │   │   │   ├── DemandCard.tsx
 │   │   │   └── DemandForm.tsx
 │   │   ├── hooks/              # Custom hooks
 │   │   │   └── useDemands.ts
-│   │   ├── services/           # Chamadas API
+│   │   ├── services/           # API calls
 │   │   │   └── demandApi.ts
-│   │   ├── types.ts            # Types da feature
+│   │   ├── types.ts            # Feature types
 │   │   └── index.ts            # Barrel export
 │   ├── dashboard/
 │   └── auth/
-├── shared/                     # Compartilhado entre features
+├── shared/                     # Shared across features
 │   ├── components/             # Button, Modal, Table, etc.
 │   ├── hooks/                  # useDebounce, useLocalStorage, etc.
 │   ├── lib/                    # api.ts (axios instance), utils
-│   └── types/                  # Types globais
+│   └── types/                  # Global types
 ├── layouts/                    # AppLayout, AuthLayout
-├── routes/                     # Configuração de rotas
-├── config/                     # Constantes, env vars
-├── styles/                     # Globals CSS
+├── routes/                     # Route configuration
+├── config/                     # Constants, env vars
+├── styles/                     # Global CSS
 └── tests/
     ├── e2e/                    # Playwright
     └── setup.ts                # Vitest setup
 ```
 
-## Padrões de código
+## Code Standards
 
-- Máximo 200 linhas por componente
-- Props tipadas com interface (não type)
-- Um componente = uma responsabilidade
-- Custom hooks para lógica reutilizável
-- Server state no React Query, UI state no Zustand
-- React Hook Form + Zod para formulários
-- Lazy loading por rota
+- Maximum 200 lines per component
+- Props typed with interface (not type)
+- One component = one responsibility
+- Custom hooks for reusable logic
+- Server state in React Query, UI state in Zustand
+- React Hook Form + Zod for forms
+- Lazy loading per route
 
-## Padrões de componentes
+## Component Standards
 
-- Composição > configuração (slots > props booleanas)
-- Container/Presenter para componentes complexos
-- Loading/Error/Empty states em todo componente async
-- Acessibilidade: semantic HTML, aria-labels, keyboard nav
+- Composition > configuration (slots > boolean props)
+- Container/Presenter for complex components
+- Loading/Error/Empty states on every async component
+- Accessibility: semantic HTML, aria-labels, keyboard nav
 
 ## Git
 
 - Commits: `feat(demands): adicionar filtro por status`
-- Branches: `feature/<feature>-<descricao>`
-- Nunca commitar node_modules, .env, dist/
+- Branches: `feature/<feature>-<description>`
+- Never commit node_modules, .env, dist/
 
-## Testes
+## Tests
 
-- Vitest + Testing Library: componentes e hooks
-- Playwright: fluxos E2E (login, CRUD, navegação)
-- Cobertura mínima: 70%
-- Testar comportamento, não implementação
+- Vitest + Testing Library: components and hooks
+- Playwright: E2E flows (login, CRUD, navigation)
+- Minimum coverage: 70%
+- Test behavior, not implementation
 
-## O que NÃO fazer
+## What NOT to do
 
-- Não usar `any` em TypeScript
-- Não fazer fetch dentro do componente (usar React Query)
-- Não duplicar dados da API no estado global
-- Não usar index como key em listas dinâmicas
-- Não criar mega-componentes de 500+ linhas
-- Não ignorar loading/error states
-- Não estilizar com CSS inline quando tem Tailwind
+- Do not use `any` in TypeScript
+- Do not fetch inside the component (use React Query)
+- Do not duplicate API data in global state
+- Do not use index as key in dynamic lists
+- Do not create mega-components of 500+ lines
+- Do not ignore loading/error states
+- Do not style with inline CSS when you have Tailwind