maestro-bundle 1.9.0 → 2.0.1

package/templates/bundle-ai-agents-deep/AGENTS.md

@@ -1,55 +1,55 @@
-# Projeto: Deep Agent (tipo Claude Code)
+# Project: Deep Agent (Claude Code-like)
 
-Você está construindo um Deep Agent — um agente AI autônomo que pode planejar, executar tarefas, gerenciar arquivos, delegar para subagentes e interagir com o usuário. Similar ao Claude Code, Cursor Agent ou Codex. Construído com o framework Deep Agents do LangChain.
+You are building a Deep Agent — an autonomous AI agent that can plan, execute tasks, manage files, delegate to subagents, and interact with the user. Similar to Claude Code, Cursor Agent, or Codex. Built with the LangChain Deep Agents framework.
 
 ## 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. 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. 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
 
-## Stack do projeto
+## Project Stack
 
-- **Linguagem:** Python 3.11+
+- **Language:** Python 3.11+
 - **Framework:** Deep Agents SDK (`deepagents`)
-- **Execução:** LangGraph (por baixo)
-- **Modelos:** Claude (Anthropic), GPT (OpenAI), Gemini (Google), Ollama (local)
+- **Execution:** LangGraph (under the hood)
+- **Models:** Claude (Anthropic), GPT (OpenAI), Gemini (Google), Ollama (local)
 - **Backends:** StateBackend, FilesystemBackend, StoreBackend, LocalShellBackend, Sandboxes
-- **API:** FastAPI (para servir o agente como API)
-- **Observabilidade:** LangSmith ou Langfuse
-- **Testes:** Pytest + evals customizados
+- **API:** FastAPI (to serve the agent as an API)
+- **Observability:** LangSmith or Langfuse
+- **Tests:** Pytest + custom evals
 
-## Estrutura do projeto
+## Project Structure
 
 ```
 src/
-├── agent/                      # Definição do Deep Agent principal
-│   ├── main.py                 # create_deep_agent + configuração
-│   ├── tools.py                # Tools customizadas
-│   ├── subagents.py            # Definição de subagentes
-│   ├── middleware.py            # Middleware customizado
-│   └── prompts.py              # System prompts versionados
-├── skills/                     # Skills que o agente pode carregar
+├── agent/                      # Main Deep Agent definition
+│   ├── main.py                 # create_deep_agent + configuration
+│   ├── tools.py                # Custom tools
+│   ├── subagents.py            # Subagent definitions
+│   ├── middleware.py            # Custom middleware
+│   └── prompts.py              # Versioned system prompts
+├── skills/                     # Skills the agent can load
 │   ├── code-review/SKILL.md
 │   ├── deploy/SKILL.md
 │   └── ...
-├── backends/                   # Configuração de backends
+├── backends/                   # Backend configuration
 │   ├── filesystem.py
 │   ├── store.py
 │   └── composite.py
-├── api/                        # Servir agente como API (opcional)
+├── api/                        # Serve agent as API (optional)
 │   ├── server.py               # FastAPI
 │   └── websocket.py            # Streaming via WebSocket
-├── evals/                      # Avaliação do agente
+├── evals/                      # Agent evaluation
 │   ├── golden_dataset.json
 │   ├── evaluators.py
 │   └── run_evals.py
@@ -58,48 +58,48 @@ src/
     └── models.py
 ```
 
-## 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
+- Maximum 500 lines per file, 20 lines per function
+- Type hints on public functions
 - f-strings, Black + Ruff
-- Nomes descritivos, guard clauses
-- Tratar exceções com tipos específicos
+- Descriptive names, guard clauses
+- Handle exceptions with specific types
 
-## Padrões de Deep Agent
+## Deep Agent Standards
 
-- System prompts versionados em `prompts.py`, nunca hardcoded
-- Tools com schemas Pydantic e descrições claras
-- Cada subagente tem UMA responsabilidade
-- Human-in-the-loop para operações destrutivas (delete, deploy, email)
-- Timeout e max_iterations em todo agente
-- Checkpointer obrigatório para persistência de estado
-- Backend explícito (nunca confiar no default em produção)
-- Skills carregadas on-demand, nunca todas no system prompt
+- System prompts versioned in `prompts.py`, never hardcoded
+- Tools with Pydantic schemas and clear descriptions
+- Each subagent has ONE responsibility
+- Human-in-the-loop for destructive operations (delete, deploy, email)
+- Timeout and max_iterations on every agent
+- Checkpointer mandatory for state persistence
+- Explicit backend (never rely on the default in production)
+- Skills loaded on-demand, never all in the system prompt
 
-## Middleware obrigatório
+## Mandatory Middleware
 
-O Deep Agent já vem com middleware padrão que não deve ser desabilitado:
-- **TodoListMiddleware** — Planejamento de tarefas
-- **FilesystemMiddleware** — Gerenciamento de arquivos
-- **SubAgentMiddleware** — Delegação para subagentes
-- **SummarizationMiddleware** — Compressão de contexto
+The Deep Agent comes with default middleware that should not be disabled:
+- **TodoListMiddleware** — Task planning
+- **FilesystemMiddleware** — File management
+- **SubAgentMiddleware** — Delegation to subagents
+- **SummarizationMiddleware** — Context compression
 
 ## Git
 
-- Commits: `feat(agent): adicionar tool de busca semântica`
-- Branches: `feature/<componente>-<descricao>`
-- Nunca commitar API keys, .env
+- Commits: `feat(agent): add semantic search tool`
+- Branches: `feature/<component>-<description>`
+- Never commit API keys, .env
 
-## Testes
+## Tests
 
-- Testes unitários para tools e middleware
-- Testes de integração para o agente completo
-- Evals com golden dataset + LLM-as-judge
-- Cobertura mínima: 80%
+- Unit tests for tools and middleware
+- Integration tests for the full agent
+- Evals with golden dataset + LLM-as-judge
+- Minimum coverage: 80%
 
 ## References
 
-- `references/deep-agents-api.md` — API reference do Deep Agents SDK
-- `references/backends-guide.md` — Guia de backends e quando usar cada um
-- `references/middleware-guide.md` — Middleware padrão e customizado
+- `references/deep-agents-api.md` — Deep Agents SDK API reference
+- `references/backends-guide.md` — Backends guide and when to use each one
+- `references/middleware-guide.md` — Default and custom middleware

package/templates/bundle-ai-agents-deep/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