docs(ai): translate AGENTS.md, constitution, skills, templates and scripts to English

Project documentation standard is English. The initial bootstrap was
written in Portuguese; this commit translates all AI artifacts while
keeping structure, links and frontmatter intact so the AI Week review
checks still pass.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: iagolaguna

.agents/skills/implementing/SKILL.md

@@ -6,49 +6,51 @@ type: skill
 
 # implementing
 
-Use esta skill quando o usuário disser "implementa", "implementa essa spec",
-"implementa specs/<feature>.md", ou pedir execução autônoma a partir de uma
-spec já aprovada.
-
-## Pré-requisitos
-
-- `specs/<feature>/spec.md` existe, aprovado pelo usuário.
-- Constituição lida ([.specify/memory/constitution.md](../../../.specify/memory/constitution.md)).
-- AGENTS.md lido para limites de autonomia.
-
-Se algum desses faltar, **pare** e peça para o usuário rodar a skill
-`specification` primeiro.
-
-## Fluxo
-
-1. **Branch.** `git checkout -b feat/<feature-slug>` (use `fix/<slug>` para
-   bug fix, `chore/<slug>` para tooling).
-2. **Quebrar em tasks.** Liste 3–8 tasks concretas em TodoWrite.
-3. **Implementar task-a-task.**
-   - Para cada task: editar arquivos → rodar `yarn lint --fix` → rodar
-     `yarn test` no escopo afetado → marcar task completa.
-   - Nunca pule testes. Princípio 2 da constitution.
-4. **Lint & types.** Rode `yarn lint` e `yarn lint:ts` antes de commitar.
-5. **i18n.** Se adicionou string visível, rode `yarn lint:locales`.
-   Princípio 3 da constitution.
-6. **Build.** `yarn build` precisa passar.
-7. **Commit.** Use `speckit-git-commit` para formatar Conventional Commits.
-8. **PR.** Abra com `gh pr create` linkando a spec, princípios afetados,
-   e plano de teste manual.
+Use this skill when the user says "implement it", "implement this spec",
+"implement specs/<feature>.md", or asks for autonomous execution from an
+already-approved spec.
+
+## Prerequisites
+
+- `specs/<feature>/spec.md` exists and is approved by the user.
+- Constitution has been read
+  ([.specify/memory/constitution.md](../../../.specify/memory/constitution.md)).
+- AGENTS.md has been read for autonomy limits.
+
+If any of these is missing, **stop** and ask the user to run the
+`specification` skill first.
+
+## Flow
+
+1. **Branch.** `git checkout -b feat/<feature-slug>` (use `fix/<slug>`
+   for bug fixes, `chore/<slug>` for tooling).
+2. **Break into tasks.** List 3–8 concrete tasks in TodoWrite.
+3. **Implement task by task.**
+   - For each task: edit files → run `yarn lint --fix` → run
+     `yarn test` in the affected scope → mark task complete.
+   - Never skip tests. Principle 2 of the constitution.
+4. **Lint & types.** Run `yarn lint` and `yarn lint:ts` before
+   committing.
+5. **i18n.** If a visible string was added, run `yarn lint:locales`.
+   Principle 3 of the constitution.
+6. **Build.** `yarn build` must pass.
+7. **Commit.** Use `speckit-git-commit` to format Conventional Commits.
+8. **PR.** Open with `gh pr create`, linking the spec, principles
+   affected, and manual test plan.
 
 ## Autonomy limits
 
-Veja [AGENTS.md](../../../AGENTS.md). Em resumo:
+See [AGENTS.md](../../../AGENTS.md). In short:
 
-- **Não tocar** `manifest.json`, `package.json`, `.travis.yml`,
-  `.github/`, `.vtex/deployment.yaml` sem confirmação explícita.
-- **Não publicar.** `vtex publish` e `npm publish` são manuais.
-- **Não force-push** na branch que já tem PR aberto.
+- **Do not touch** `manifest.json`, `package.json`, `.travis.yml`,
+  `.github/`, `.vtex/deployment.yaml` without explicit confirmation.
+- **Do not publish.** `vtex publish` and `npm publish` are manual.
+- **Do not force-push** to a branch that already has an open PR.
 
-## Quando reportar de volta
+## When to pause and report
 
-Pause e reporte para o usuário quando:
+Pause and report back to the user when:
 
-- O build falhar de um jeito que sugere mudança em dep range.
-- O typecheck encontrar problema em código que você não tocou.
-- Uma decisão de produto/UX não estiver na spec.
+- The build fails in a way that suggests a dependency range change.
+- Typecheck flags an issue in code you did not touch.
+- A product/UX decision is not covered by the spec.

.agents/skills/specification/SKILL.md

@@ -6,53 +6,53 @@ type: skill
 
 # specification
 
-Use esta skill quando o usuário pedir para "criar uma spec", "escrever um SDD",
-ou referenciar um arquivo em `specs/`. O entregável é um arquivo
-`specs/<feature-slug>/spec.md` com três seções obrigatórias.
+Use this skill when the user asks to "create a spec", "write an SDD", or
+references a file under `specs/`. The deliverable is a
+`specs/<feature-slug>/spec.md` file with three mandatory sections.
 
-## Quando usar
+## When to use
 
-- Feature nova que toca o contrato público do `PickupPointsModal`.
-- Mudança de arquitetura (novo container, novo fluxo de estado).
-- Refactor com impacto cross-cutting (i18n, fetchers, mapa).
+- New feature that touches the public contract of `PickupPointsModal`.
+- Architectural change (new container, new state flow).
+- Refactor with cross-cutting impact (i18n, fetchers, map).
 
-**Não use** para bug fix pontual ou tweak de estilo — vai direto para
-`implementing` ou `speckit-git-commit`.
+**Do not use** for a one-off bug fix or a styling tweak — go straight to
+`implementing` or `speckit-git-commit`.
 
-## Estrutura do entregável
+## Deliverable structure
 
 ```markdown
 # Spec: <feature>
 
 ## Business Context
-- Problema que estamos resolvendo
-- Stakeholders (quem pediu, quem é impactado)
-- Métricas de sucesso
+- Problem being solved
+- Stakeholders (who asked, who is impacted)
+- Success metrics
 
 ## Architectural Decisions
-- Componentes/arquivos afetados
-- Alternativas consideradas + por que foram descartadas
-- Riscos de backward-compatibility (referenciar Principle 1 da constitution)
+- Components/files affected
+- Alternatives considered + why they were dropped
+- Backward-compatibility risk (cite Principle 1 of the constitution)
 
 ## Technical Contract
-- Mudanças em props/eventos
-- Mudanças em fixtures/mocks
-- Plano de testes (golden path + edge cases)
-- Plano de i18n (chaves novas, locales tocados)
-- Critérios de aceite verificáveis
+- Changes to props/events
+- Changes to fixtures/mocks
+- Test plan (golden path + edge cases)
+- i18n plan (new keys, locales touched)
+- Verifiable acceptance criteria
 ```
 
-## Inputs esperados
+## Expected inputs
 
-- Descrição em linguagem natural da feature.
-- Link para ticket Jira/issue se existir.
-- Lista de arquivos suspeitos (se o usuário já investigou).
+- Natural-language description of the feature.
+- Link to a Jira/issue ticket if one exists.
+- List of suspected files (if the user has already investigated).
 
-## Como aplicar
+## How to apply
 
-1. Ler [.specify/memory/constitution.md](../../../.specify/memory/constitution.md)
-   para entender princípios vinculantes.
-2. Ler [AGENTS.md](../../../AGENTS.md) para limites de autonomia.
-3. Esboçar as 3 seções com `TBD` onde faltar input.
-4. Apresentar para o usuário antes de criar o arquivo final.
-5. Não implementar nada — apenas spec.
+1. Read [.specify/memory/constitution.md](../../../.specify/memory/constitution.md)
+   to understand binding principles.
+2. Read [AGENTS.md](../../../AGENTS.md) for autonomy limits.
+3. Sketch the 3 sections with `TBD` markers where input is missing.
+4. Present the draft to the user before creating the final file.
+5. Do not implement anything — spec only.

.agents/skills/speckit-analyze/SKILL.md

@@ -6,37 +6,37 @@ type: skill
 
 # speckit-analyze
 
-Auditoria leve antes de abrir o PR. Detecta drift entre os 4 artefatos:
-spec → plan → tasks → código.
+Lightweight audit before opening the PR. Detects drift across the four
+artifacts: spec → plan → tasks → code.
 
-## Quando usar
+## When to use
 
-- Depois de `speckit-implement` e antes do `gh pr create`.
-- Quando o autor da spec é diferente do implementador.
-- Antes de pedir review humano em feature grande.
+- After `speckit-implement` and before `gh pr create`.
+- When the spec author is different from the implementer.
+- Before requesting human review on a large feature.
 
 ## Checks
 
-1. **Spec → Plan:** todo critério de aceite da spec aparece como
-   item no plano?
-2. **Plan → Tasks:** todo arquivo listado em "Files to touch" tem ao
-   menos uma task?
-3. **Tasks → Code:** todo arquivo modificado em `git diff` está em
-   alguma task?
-4. **Constitution check:** o diff respeita os 5 princípios?
+1. **Spec → Plan:** does every acceptance criterion from the spec
+   appear as an item in the plan?
+2. **Plan → Tasks:** does every file listed under "Files to touch"
+   have at least one task?
+3. **Tasks → Code:** is every file modified in `git diff` covered by
+   some task?
+4. **Constitution check:** does the diff respect the 5 principles?
 
 ## Output
 
-Relatório em markdown listando:
+A markdown report listing:
 
-- ✅ Items alinhados
-- ⚠️ Drift (mudou no código mas não na task / spec)
-- ❌ Faltando (criterio de aceite sem implementação)
+- ✅ Items in sync
+- ⚠️ Drift (changed in code but not in the task/spec)
+- ❌ Missing (acceptance criterion without implementation)
 
-Não corrige nada — só reporta. O usuário decide se atualiza spec/plan
-ou se reverte o código.
+It does not fix anything — it only reports. The user decides whether to
+update spec/plan or revert the code.
 
-## Importante
+## Important
 
-`speckit-analyze` é **read-only**. Nunca edita spec, plan, tasks ou
-código. Se encontrar drift, retorna o relatório e para.
+`speckit-analyze` is **read-only**. It never edits the spec, plan,
+tasks or code. If drift is found, it returns the report and stops.

.agents/skills/speckit-checklist/SKILL.md

@@ -6,47 +6,47 @@ type: skill
 
 # speckit-checklist
 
-Gera um checklist de validação para colocar no PR description ou em
-`specs/<slug>/checklist.md`. Não é genérico — é derivado da spec e dos
-princípios da constituição.
+Generates a validation checklist to drop into the PR description or
+into `specs/<slug>/checklist.md`. Not generic — it is derived from the
+spec and the constitution principles.
 
-## Quando usar
+## When to use
 
-- Antes de pedir review humano.
-- Em features que tocam checkout-critical paths.
+- Before requesting human review.
+- On features touching checkout-critical paths.
 
-## Estrutura
+## Structure
 
 ```markdown
 # Checklist — <feature>
 
 ## Pre-merge gates
-- [ ] `yarn lint` passa
-- [ ] `yarn lint:ts` passa
-- [ ] `yarn test` passa
-- [ ] `yarn lint:locales` passa (se mexeu em i18n)
-- [ ] `yarn build` passa
-- [ ] CHANGELOG atualizado se mudança visível
+- [ ] `yarn lint` passes
+- [ ] `yarn lint:ts` passes
+- [ ] `yarn test` passes
+- [ ] `yarn lint:locales` passes (if i18n was touched)
+- [ ] `yarn build` passes
+- [ ] CHANGELOG updated if the change is user-visible
 
 ## Constitution checks
-- [ ] Princípio 1: contrato público preservado ou major bump
-- [ ] Princípio 2: testes cobrem golden path + edge case
-- [ ] Princípio 3: chaves novas em todos os locales
-- [ ] Princípio 4: sem regressão de bundle/TTI
-- [ ] Princípio 5: utils novos são puros
+- [ ] Principle 1: public contract preserved or major bump
+- [ ] Principle 2: tests cover golden path + edge case
+- [ ] Principle 3: new keys present in every locale
+- [ ] Principle 4: no bundle/TTI regression
+- [ ] Principle 5: new utilities are pure
 
 ## Manual QA
-- [ ] Cenário <X> testado no demo (`yarn start`)
-- [ ] Funciona com `searchAddress` vazio
-- [ ] Funciona com 0 pickup points retornados
-- [ ] Funciona em locale `pt-BR` e `en-US`
+- [ ] Scenario <X> tested in the demo (`yarn start`)
+- [ ] Works with empty `searchAddress`
+- [ ] Works with 0 pickup points returned
+- [ ] Works in `pt-BR` and `en-US` locales
 
 ## Rollback plan
-- Branch revertível? <sim/não>
-- Migração de dados? <sim/não>
-- Feature flag? <nome>
+- Branch revertable? <yes/no>
+- Data migration? <yes/no>
+- Feature flag? <name>
 ```
 
 ## Template
 
-Veja [.specify/templates/checklist-template.md](../../../.specify/templates/checklist-template.md).
+See [.specify/templates/checklist-template.md](../../../.specify/templates/checklist-template.md).

.agents/skills/speckit-clarify/SKILL.md

@@ -6,36 +6,36 @@ type: skill
 
 # speckit-clarify
 
-Gera perguntas focadas para destravar uma spec com TBDs ou ambiguidades.
-Roda entre `speckit-specify` e `speckit-plan`.
+Generates focused questions to unblock a spec with TBDs or ambiguities.
+Runs between `speckit-specify` and `speckit-plan`.
 
-## Quando usar
+## When to use
 
-- `spec.md` tem 2+ `TBD` em campos obrigatórios.
-- Critério de aceite vago ("deve funcionar bem").
-- Stakeholder não foi explícito em edge cases.
+- `spec.md` has 2+ `TBD` markers in required fields.
+- Vague acceptance criteria ("it should just work well").
+- A stakeholder was not explicit about edge cases.
 
-## Fluxo
+## Flow
 
-1. Ler `specs/<slug>/spec.md`.
-2. Identificar lacunas em:
-   - Business Context (quem, por quê, métrica)
-   - Architectural Decisions (alternativas, riscos)
-   - Technical Contract (props, fixtures, i18n, aceite)
-3. Gerar **no máximo 5 perguntas** por iteração, em ordem de impacto.
-4. Aguardar respostas do usuário.
-5. Atualizar `spec.md` com as respostas — preservar o histórico em
-   `## Clarifications` no fim do arquivo.
+1. Read `specs/<slug>/spec.md`.
+2. Identify gaps in:
+   - Business Context (who, why, metric)
+   - Architectural Decisions (alternatives, risks)
+   - Technical Contract (props, fixtures, i18n, acceptance)
+3. Generate **at most 5 questions** per iteration, ordered by impact.
+4. Wait for user replies.
+5. Update `spec.md` with the answers — preserve history under a
+   `## Clarifications` section at the end of the file.
 
-## Perguntas boas
+## Good questions
 
-- Específicas: "O modal deve fechar ao escolher um pickup? Antes ou
-  depois do confirm?"
-- Acionáveis: a resposta muda o plan.
-- Únicas: não repete o que já está respondido na spec.
+- Specific: "Should the modal close when a pickup is chosen? Before or
+  after the confirm step?"
+- Actionable: the answer changes the plan.
+- Unique: not already answered earlier in the spec.
 
-## Perguntas ruins
+## Bad questions
 
-- "Tem mais alguma coisa?"
-- "O que você acha?"
-- Perguntas que o agente pode responder lendo o código.
+- "Anything else?"
+- "What do you think?"
+- Questions the agent could answer by reading the code.