@@ -0,0 +1,861 @@
# Reference: translation glossary
Every entry below is sourced from a translated field already in
`src/content/**` . The citation shows the path; if you disagree with a choice,
open that file and read it in context before changing the glossary. The glossary
changes only when the source text changes.
Two formats appear in the data: `{ en, pt }` (the `localized` Zod helper in
`src/content/config.ts` ) and `{ en: {...}, pt: {...} }` (the rules page's
`copy.json` ). Both are searched.
## Source map
| Collection | Fields translated | Register |
| ----------------------------------------- | ----------------: | ------------------------- |
| `chapters/skills.json` | 11 (recall only) | Tutorial / instructor |
| `commonSkills/*.json` | 49 | Skill catalog / reference |
| `efforts/*.json` | 3 | Selector labels |
| `handsOnPrompts/*.json` | 1 | Lab prompts |
| `phases/*.json` | 12 | Phase tabs + code lines |
| `providers/*.json` | 12 | Provider blurbs + tiers |
| `routes/*.json` | 8 | Route table |
| `rules/{copy,prompts,skills,stages}.json` | 24 | Case-study page |
| `skillFiles/*.json` | 4 | Anatomy labels |
| `skillInstallPrompts/install.json` | 1 | Long install prompt |
| `skillWorkflow/*.json` | 25 | Forge steps |
| `trees/*.json` | 8 | Worktree nodes |
| `workers/*.json` | 3 | Worker cards |
Total: 161 fields with distinct translations. The corpus is small enough to
treat as the source of truth; don't add glossary entries that aren't backed by
an example already in the tree.
## What stays in English
These terms appear in the existing Portuguese copy without translation. They are
the product vocabulary and **must not ** be localized:
| English term | Why it stays |
| ------------ | ------------------------------------------------------------------------------------------ |
| `skill` | Product noun. The whole site teaches "skills" as a format. |
| `worktree` | Git term, kept by every other Brazilian technical writer. |
| `worker` | In product copy keeps English; in prose may become `agente` — see notes below. |
| `branch` | Git term. `branch` (English) coexists with `galho` (literal) but the corpus uses `branch` . |
| `merge` | Git term. |
| `commit` | Git term, also a commit hook label. |
| `diff` | Git / code-review term. |
| `brief` | The hand-off package; product term. |
| `gate` | Verification term. `gate` is used in tab labels and prose ("discipline de gates"). |
| `pipeline` | The /rules/ nav label keeps `Pipeline` . |
| `recall` | The /skills/ and /rules/ practice labels keep `Recall` . |
| `prompt` | The artifact that goes into a model session. |
| `worker` | See above. |
| `check` | Used in `check the diff` , `cheque` . The corpus prefers `verificação` and `gate` . |
| `patch` | Used in `jump from error message straight to a patch` → `patch` kept. |
| `ratchet` | The /rules/ "CLI ratchet" — kept English by deliberate metaphor. |
| `kit` | "field kit" → "kit de campo"; bare `kit` may stay English. |
| `loadout` | "UM LOADOUT PRÁTICO" — kept in English. |
Compound borrowings stay as a unit: `commitlint` , `lint-staged` , `husky` ,
`pnpm` , `npm` , `astro` , `tsconfig` .
## What translates — and how
Sorted by source term, with the citation.
### A
- **acceptance criteria** → `critérios de aceitação`
- `phases/plan.json` :: `copy` ("write acceptance criteria")
- **adversarial attention** → `atenção crítica`
- `routes/review.json` :: `why`
- **ambiguity** → `ambiguidade`
- `phases/plan.json` :: `title` ("Turn ambiguity into work" → "Transforme
ambiguidade em trabalho")
- `routes/plan.json` :: `label`
- **architecture** → `arquitetura`
- **artifact** → `artefato`
- `providers/openai.json` :: `tiers[0][2]`
### B
- **behavior** → `comportamento`
- `commonSkills/unlazy.json` :: `use` ("turns 'done' into runnable acceptance
checks")
- **bounded** → `delimitado` _ (never `limitado`) _
- `phases/build.json` :: `title` ("Execute one bounded slice" → "Execute uma
fatia delimitada")
- `phases/build.json` :: `copy`
- `routes/build.json` :: `label` ("Bounded execution" → "Execução delimitada")
- **branch (in "branch collision")** → `Colisão de branches`
- `full-guide-pt.json`
- **brief** → `brief` _ (kept) _
- **build** → `construir` (verb), `build` / `CONSTRUIR` (tab labels)
- `routes/build.json` :: `label`
### C
- **cautious / caution** → `cuidado`
- `commonSkills/*.json` :: `caution` field
- **check yourself** → `Teste-se`
- `chapters/skills.json` :: `sections[2].eyebrow`
- **citation** → `citação` _ (not used in current copy but a likely target) _
- **claim (verb)** → `levar afirmações até suas fontes`
- `commonSkills/research.json` :: `rule` ("Trace claims to owners")
- **clipboard** → kept English in source prompts (technical UI)
- **collide / collision** → `colidir` / `colisão`
- **command** → `comando`
- `rules/skills.json` :: `gate.lesson`
- **commit hook** → `hook de commit` _ (compound: keep `hook` English) _
- **common** → `comum` / `comuns`
- **communicate** → `COMUNICAR`
- `commonSkills/caveman.json` :: `label`
- **communication style** → `ESTILO DE COMUNICAÇÃO`
- **completion discipline** → `DISCIPLINA DE CONCLUSÃO`
- **compress / compress noisy output** → `comprima saídas ruidosas`
- **concrete examples** → `Exemplos concretos`
- **context (in "context economy")** → `ECONOMIA DE CONTEXTO`
- **context (UI label, e.g. "context: isolated")** → `contexto: isolado`
- **copy (verb / noun)** → `copiar` (verb), `cópia` (noun)
- `rules/copy.json` :: `copyButton` ("COPY PROMPT" → "COPIAR PROMPT")
- **create** → `criar`
- `skillWorkflow/scaffold.json` :: `title` neighborhood (e.g.
`Criar uma skill` )
- **criteria** → `critérios`
- `phases/plan.json` :: `copy`
### D
- **dangerous / not used directly** —
- **debug / debugging** → `diagnosticar` (verb in `commonSkills/debug.json` ),
`diagnóstico` (noun)
- **define (a trigger)** → `definir`
- `commonSkills/trigger.json` :: `action` ("Choose a short action-oriented
name. Write a discriminating description")
- **deliverable** → kept English in tabs
- **deploy** → kept English
- **desired difficulty / desirable difficulty** → `Dificuldade desejável`
- `rules/copy.json` :: `recallEyebrow`
- **deterministic** → `determinístico` / `determinística`
- `commonSkills/scaffold.json` :: `action`
- **develop / developer** → kept English
- **diagnosis / diagnose / diagnostic loop** → `diagnóstico` / `DIAGNOSTICAR` /
`CICLO DE DIAGNÓSTICO`
- **diff** → `diff` _ (kept) _
- `phases/review.json` :: `code` ("diff + checks → review → merge / iterate" →
"diff + verificações → revisar → merge / iterar")
- **discipline** → `disciplina`
- `commonSkills/unlazy.json` :: `kind` ("COMPLETION DISCIPLINE")
- `commonSkills/research.json` :: `kind` ("SOURCE DISCIPLINE")
- **discover / discovery / discoverable** → `descobrir` / `descoberta` /
`descobrível`
- **do / done** → `fazer` / `feito` / `pronto`
- `commonSkills/caveman.json` :: `example` ("Built. Tests pass. Published." →
"Feito. Testes passaram. Publicado.")
- **document** → `documentação`
### E
- **each / every** → `cada`
- **economize** → `ECONOMIZAR`
- **effort (reasoning effort)** → `esforço de raciocínio`
- `providers/openai.json` :: `copy`
- **embed** → kept English
- **enforcement** → `enforcement` _(kept English in the compound
`camadas de enforcement` )_
- **engineer / engineering** → `ENGENHARIA DE IA` (uppercase, brand-like)
- **enumerate** → kept English
- **evidence** → `evidência` / `evidências`
- `phases/review.json` :: `title` ("Reconnect result to intent" → "Reconecte o
resultado à intenção")
- `full-guide-pt.json` ("Skills · agentes · worktrees · evidências")
- **example** → `exemplo` / `Exemplos`
- `rules/copy.json` :: `examplesLabel`
- **execute** → `executar`
- **explain** → `explicar`
- **explore / exploration** → `explorar` / `Explorar` (tab) / `EXPLORAR` (label)
- **extract** → `extrair`
- `rules/copy.json` :: `skillsText` ("distilled from mistakes" → "extraídos de
erros")
### F
- **fail / failure** → `falhar` / `falha` _ (singular and plural both used) _
- **field guide** → `guia de campo`
- `rules/copy.json` :: `back`
- **field kit** → `kit de campo`
- **filter** → `filtragem`
- `commonSkills/tokens.json` :: `use` ("Filtering preserves context")
- **flag (verb)** → `sinalizar` _(rare in current copy; the `tokens` skill uses
"Sinal primeiro" for the noun)_
- **fly** → kept English
- **follow (a workflow)** → `seguir`
- **fork** → kept English
- **frame (verb)** → `enquadrar`
- **from intent to evidence** → `Da intenção à evidência`
- **from memory** → `de memória`
- `chapters/skills.json` :: `recall.0.answer`
- **front-end / frontend** → `frontend`
### G
- **gap** → `lacuna`
- **gate / gate discipline** → `gate` _ (kept) _ , `catraca` (in `ratchet` )
- **get (something wrong)** → `errar` (idiomatic: "ainda erraria")
- **git worktrees** → `Git worktrees` _(capitalized "Git" preserved, "worktrees"
kept English)_
- `full-guide-pt.json`
- **give (a brief / a contract)** → `dar`
- **goal** → `objetivo`
- **good prompt** → `Bom prompt`
- **good prompt + skills** → `Bom prompt + skills`
- **green (in "prove green is real")** → `verde`
- `rules/copy.json` :: `skillGate`
- **guide** → `guia` (often kept English when referring to the published
`/full-guide/` )
### H
- **habit** → `hábito`
- **handoff** → `passagem` (in full-guide hero) / `handoff` (in code paths)
- **hard (failure / bug / judgment)** → `difícil` / `duro`
- `commonSkills/debug.json` :: `use` ("hard bugs" → "bugs difíceis")
- **help** → `ajudar`
- **here** → `aqui` (omit when English does — many of the existing PT strings
drop "here")
- **hide / hidden** → `oculto` / `escondido`
- **hint** → `dica`
- **hold (verb, "the rule can hold")** → `segurar`
- `rules/copy.json` :: `pipelineTitle` ("Five places where a rule can hold" →
"Cinco lugares onde a regra segura")
- **hook** → `hook` _ (kept) _
- **host** → `host` _ (kept; technical term) _
- **how to use** → kept English in tab labels
### I
- **improve** → `melhorar`
- **include** → `incluir`
- **independent (review / judgment)** → `independente`
- **inspect** → `inspecionar`
- **install** → `instalar`
- **instance** → kept English
- **intent** → `intenção`
- `phases/review.json` :: `title`
- **invoke / not used directly** —
- **ironclad / not used directly** —
- **isolate / isolated / isolation** → `isolar` / `isolado`
- `routes/plan.json` (`isolation` )
- **iterate / iteration** → `iterar` / `iteração` / `iterações`
- `full-guide-pt.json`
### J
- **job (of a skill)** → `trabalho` / `função` (context-dependent; see
`caveman.json` :: `use` )
- **judgment** → `julgamento`
- `routes/review.json` :: `label` ("Independent judgment" → "Julgamento
independente")
- **jump (from … to …)** → `pular`
- `commonSkills/debug.json` :: `caution`
### K
- **keep (signal)** → `manter` / `mantenha`
- `commonSkills/tokens.json` :: `rule`
- **key / keyword** → `chave`
- **kind (of skill)** → kept English in field names; Portuguese title-only in
some places (e.g. `SIMPLIFICATION INSTINCT` )
### L
- **lab** → `lab` _ (kept) _
- **label** → `rótulo` (rare; the site usually keeps English `label` in chrome)
- **landing (page)** → kept English
- **language (EN/PT)** → `idioma`
- `commonSkills/unlazy.json` :: `example` ("Gate: language toggle persists" →
"Gate: idioma persiste")
- **last** → `último`
- `rules/skills.json` :: `parallel.lesson` ("verifier last" → "verifier por
último")
- **launch / not used directly** —
- **layer** → `camada`
- **lean** → `enxuto`
- **learn** → `aprender`
- **leave (out)** → `deixar de fora`
- `chapters/skills.json` :: `recall.0.answer`
- **left** → `esquerda` (direction) / `restante`
- **lesson** → `lição` _(the corpus uses `lesson` in field names; prose uses
`lição` rarely)_
- **let** → `deixe` / `deixar`
- **level (capability level)** → `nível`
- **lifecycle / not used directly** —
- **light (model)** → `leve`
- **like (this)** → `como`
- **link** → `link` _ (kept) _
- **list (verb)** → `listar` / `liste`
- **load / loading** → `carregar` / `carrega` / `carregue`
- `chapters/skills.json` :: `recall.0.answer`
- **loadout** → `LOADOUT` _ (kept in caps, brand-like) _
- **local** → `local`
- **log** → `log` _ (kept) _
- **long-term retention** → `retenção de longo prazo`
- `rules/copy.json` :: `recallText`
### M
- **main / main branch** → `main` _ (kept) _
- **maintain / not used directly** —
- **manage / management** → `gerenciar`
- **map (verb)** → `mapear`
- **mark / marker** → `marca` / `marcador`
- **match (verb)** → `corresponder`
- **meaningful** → `significativo` / `significativa`
- **measure (verb)** → `medir` / `mensurar`
- **merge** → `merge` _ (kept) _
- **message** → `mensagem`
- `commonSkills/debug.json` :: `caution` ("Do not jump from error message" →
"Não pule da mensagem de erro")
- **metadata** → `metadados` / kept English
- **migration** → `migration` _ (kept) _
- **mind** → `mente`
- `full-guide-pt.json`
- **minimize (verb)** → `minimize`
- `commonSkills/debug.json` :: `use`
- **minor** → kept English
- **minute** → `minuto`
- **mirror (verb)** → `espelhar`
- **miss (a failure / a check)** → `perder` / `faltar`
- **mix / mixed** → `misturar` / `misto`
- **mock** → `mock` _ (kept) _
- **mode** → `modo`
- **modify** → `modificar`
- **module** → `módulo`
- **move (verb)** → `mover`
- **multiple** → `múltiplo` / `vários`
- `full-guide-pt.json` ("várias mãos")
### N
- **name (verb)** → `nomear`
- **narrow** → `estreito` / `estreita`
- `commonSkills/validate.json` :: `output`
- **necessary** → `necessário` / `necessária`
- **network** → `rede`
- **never** → `nunca` / `jamais`
- **new** → `novo` / `nova`
- **next** → `próximo`
- **nice / not used directly** —
- **non-obvious** → `não óbvio` / `não óbvia`
- **normal** → `normal`
- **note (a name / a fact)** → `notar` / `anotar`
- **nothing** → `nada`
- **notice (verb)** → kept English
- **now** → `agora`
- **number** → `número`
### O
- **observable / observation** → `observável` / `observação`
- **observed** → `observado`
- **obsolete** → `obsoleto`
- **off / turn off** → `desligar` / `desativar`
- **offer** → `oferecer`
- **often** → `frequentemente`
- **omit** → `omitir`
- **on (a path / a model)** → `em` / `no` / `na`
- **once** → `uma vez`
- **one-shot** → kept English
- **only** → `apenas` / `só`
- **open (source)** → `ABRIR FONTE` _(kept in caps; "Open source" is a phrase,
not a verb)_
- **open (a file / a repo)** → `abrir`
- `rules/copy.json` :: `examplesMeta` ("open the source, then adapt" → "abra a
fonte, depois adapte")
- **opinion** → `opinião`
- **opportunity** → `oportunidade`
- **optimize** → `otimizar`
- `routes/build.json` :: `why`
- **orchestrate / orchestrator** → `orquestrar` / `orquestrador`
- **order** → `ordem`
- **origin** → `origem`
- **other** → `outro` / `outra`
- **otherwise** → `caso contrário`
- **our** → `nosso` / `nossa` / `nossos` / `nossas`
- **out (of context)** → `fora`
- **over** → `sobre`
- **override** → `substituir` (in `research.json` :: `caution` )
- **overview** → `visão geral`
### P
- **package** → `pacote` / `PACOTE`
- `skillFiles/skill.json` :: `en` ("SKILL PACKAGE" → "PACOTE DE SKILL")
- **page** → `página`
- **pair** → `par`
- **panel** → `painel`
- **parameter** → `parâmetro`
- **parent** → kept English
- **part** → `parte`
- **particular** → `específico`
- **patch** → `patch` _ (kept) _
- **path** → `caminho`
- `rules/copy.json` :: `copyText` ("adapt the path names to another project" →
"adapte os caminhos para outro projeto")
- **pattern** → `padrão`
- `commonSkills/review.json` :: `tagline` ("standards × ×
especificação")
- **pause / not used directly** —
- **people** → `pessoas` / `equipe`
- **per (each)** → `por`
- **percent** → `por cento` / `%` _ (symbol kept) _
- **perform** → `executar` / `realizar`
- **period** → `período`
- **permission** → `permissão`
- **pick** → `escolher`
- **pipeline** → `Pipeline` _ (kept) _
- **place** → `lugar`
- **plain** → `simples`
- **plan** → `planejar` (verb), `plano` (noun)
- **platform** → `plataforma`
- **play (a role)** → `desempenhar`
- **please / not used directly** —
- **plus** → `mais`
- **point** → `ponto`
- **policy** → `política`
- `rules/copy.json` :: `pipelineText` ("deterministic policy in a command" →
"política determinística em um comando")
- **poor** → `fraco`
- **populate** → `preencher`
- **portable** → `portátil`
- **positive** → `positivo`
- **possible** → `possível`
- **post** → kept English
- **power** → `poder` / `energia`
- **practice (noun)** → `prática`
- `rules/copy.json` :: `recallLabel` ("Retrieval practice" → "Prática de
recuperação")
- **predict** → `prever`
- **prefer** → `preferir`
- `commonSkills/scaffold.json` :: `use` (pattern; "prefira prova executável a
prosa" is the established cadence)
- **prepare** → `preparar`
- **present** → `apresentar` / `presente`
- **preview** → kept English in UI labels
- **previous** → `anterior`
- **print** → `imprimir`
- **prior (work / art)** → `anterior`
- `rules/skills.json` :: `parallel.lesson` ("prior-art scout first" →
"prior-art scout primeiro")
- **private** → `privado`
- **proactive** → `proativo`
- **probably** → `provavelmente`
- **problem** → `problema`
- **procedure** → `procedimento`
- **process (noun / verb)** → `processo` / `processar`
- **produce** → `produzir`
- **product** → `produto`
- **production** → `produção`
- **profile** → `perfil`
- `routes/build.json` :: `label` neighborhood ("strong / broad")
- **program** → `programa`
- **project** → `projeto`
- **prompt** → `prompt` _ (kept) _
- **proof** → `prova` / `evidência`
- `phases/review.json` :: `title` neighborhood
- `skillWorkflow/observe.json` :: `proof`
- **properly** → `corretamente`
- **propose** → `propor`
- **protect** → `proteger`
- **provider** → kept English in tab labels
- **public** → `público`
- **pull (a request)** → kept English
- **purpose** → `propósito`
- **push** → kept English
### Q
- **qualifier / not used directly** —
- **quality** → `qualidade`
- **query** → `consultar` (verb) / `consulta` (noun)
- `rules/copy.json` :: `skillRepo` ("query before crawling" → "consulte antes
de explorar")
- **question** → `pergunta`
- `chapters/skills.json` :: `recall.*.question`
- **quick** → `rápido`
- **quote** → kept English
- **quote (verb)** → `citar`
### R
- **race / not used directly** —
- **raise (effort)** → `aumentar` / `subir`
- **rank (verb)** → `ranquear`
- `commonSkills/debug.json` :: `use`
- **rapid** → `rápido`
- **rate** → `taxa` / `ritmo`
- **rather (than)** → `em vez de` / `do que`
- **raw** → `bruto`
- `commonSkills/tokens.json` :: `caution` ("Read raw output" → "Leia saída
bruta")
- **reach** → `alcançar`
- **react** → kept English
- **read** → `ler`
- **ready** → `pronto`
- `trees/tests.json` :: `small` ("8 checks · ready" → "8 verificações ·
pronto")
- **real (model)** → `real`
- **realistic** → `realista` / `realistas`
- `skillWorkflow/observe.json` :: `action` ("two or three realistic requests")
- **really** → `realmente`
- **reason** → `razão`
- **reasoning** → `raciocínio`
- **recall** → `recuperação` (noun), `recuperar` (verb), `Recall` (UI label)
- **recent** → `recente`
- **recipe** → `receita`
- **recommend** → `recomendar`
- **record** → `registrar`
- **recover / recovery** → `recuperar` / `recuperação`
- **redirect** → `redirecionar`
- **reduce / reduction** → `reduzir` / `redução`
- **reference** → `referência` (noun), `references/` (kept English)
- **reflect** → `refletir`
- **refuse / refused** → `recusar`
- **regard** → `considerar`
- **register** → `registrar`
- **regular** → `regular`
- **reject** → `rejeitar`
- **relate** → `relacionar`
- **release** → kept English
- **relevant** → `relevante`
- **rely** → `confiar`
- **remain** → `permanecer`
- **remember** → `lembrar`
- `chapters/skills.json` :: `recall.1.question` neighborhood ("Where do the
workflow, the facts, and the repeated mechanics each go?" → "Onde vão o
workflow, os fatos e as mecânicas repetidas?")
- **remove** → `remover`
- **rename** → `renomear`
- **render** → `renderizar` _ (technical term; keep English if context demands) _
- **repeat** → `repetir`
- **replace** → `substituir`
- **report** → `reportar` / `relatório` (noun) / `REPORTAR` (label)
- **repository** → `repositório`
- **represent** → `representar`
- **require** → `exigir` / `requerer`
- **reset** → `resetar` _ (or kept English) _
- **resolve** → `resolver`
- **resource** → `recurso`
- **respect** → `respeitar`
- **respond** → `responder`
- **response** → `resposta`
- **responsibility** → `responsabilidade`
- `full-guide-pt.json` ("não abrir mão da responsabilidade")
- **rest** → `resto`
- **restore** → `restaurar` / `recuperar`
- **restrict** → `restringir`
- **result** → `resultado`
- **retain** → `reter`
- **return** → `retornar` / `devolver`
- **reuse** → `reúso` (noun) / `reutilizar` (verb)
- **reveal** → `revelação` (noun), `revelar` (verb)
- `chapters/skills.json` :: `recall[2].copy`
- **review** → `revisão` (noun), `revisar` (verb), `REVISÃO` (label)
- **rewrite** → `reescrever`
- **rigorous** → `rigoroso`
- **role** → `papel`
- **rollback** → kept English
- **root (noun)** → `raiz`
- `trees/main.json` :: `rootLabel` (English "ROOT" → Portuguese "RAIZ")
- **route (verb / noun)** → `rotear` / `rota` / `Roteamento`
- `routes/*.json` (collection name in code; "Roteamento de modelos" in body)
### S
- **safe / safety** → `segurança`
- **same** → `mesmo` / `mesma`
- **sample** → `amostra`
- **save** → `salvar`
- **scale** → `escala`
- **scan** → `verificar` / `escanear`
- **scatter** → `dispersar`
- **scenario** → `cenário`
- **scope** → `escopo`
- **script** → `script` _ (kept) _ , also `roteiro` (rare)
- **search** → `buscar` / `busca`
- **section** → `seção`
- **security** → `segurança`
- **seed** → `semente`
- **select** → `selecionar` / `selecione`
- **selector** → kept English in tab labels
- **self-contained** → `autocontido`
- **send** → `enviar` / `mandar`
- **separate** → `separado` / `separar`
- **server** → `servidor`
- **service** → `serviço`
- **session** → `sessão`
- **set (a value / a state)** → `definir` / `configurar`
- **set up** → `configurar`
- **several** → `vários` / `várias`
- `full-guide-pt.json` ("várias mãos")
- **shape** → `forma`
- **share** → `compartilhar`
- **ship** → `entregar`
- `chapters/skills.json` :: `recall.title` ("ship it" → "enviar")
- **short** → `curto` / `breve`
- **should** → `deve`
- **show** → `mostrar`
- **shrink** → `encolher`
- **shut** → kept English
- **side** → `lado`
- **signal** → `sinal`
- `commonSkills/caveman.json` :: `rule` ("Signal first. Drop filler." → "Sinal
primeiro. Corte o excesso.")
- `commonSkills/tokens.json` :: `rule`
- **sign** → `assinar`
- **simplification** → `simplificação`
- **simplify** → `simplificar` / `SIMPLIFICAR`
- `commonSkills/ponytail.json` :: `label`
- **since** → `desde`
- **single** → `único` / `única`
- **site** → `site` _ (kept) _
- **size** → `tamanho`
- **skill** → `skill` _ (kept) _
- **slash** → `barra`
- **slice** → `fatia`
- `phases/build.json` :: `title` ("Execute one bounded slice" → "Execute uma
fatia delimitada")
- **small** → `pequeno` / `pequena`
- **smart** → `inteligente`
- **smooth** → `suave`
- **snippets** → kept English
- **soft** → `macio`
- **solid** → `sólido`
- **solve** → `resolver`
- **some** → `algum` / `alguns`
- **sort** → `classificar` / `ordenar`
- **source** → `fonte` / `FONTES`
- `commonSkills/research.json` :: `kind` ("SOURCE DISCIPLINE" → "DISCIPLINA DE
FONTES")
- **specific** → `específico` / `específica`
- **spec** → `especificação`
- `commonSkills/review.json` :: `tagline` ("standards × ×
especificação")
- **speed** → `velocidade`
- **spend (time / reasoning)** → `investir` / `gastar`
- `routes/plan.json` :: `why` ("Spend reasoning here" → "Invista raciocínio
aqui")
- **split** → `dividir` / `dividido`
- **stable** → `estável`
- **stage** → `etapa`
- **stale** → `obsoleto`
- **stamp** → `carimbo`
- **standard** → `padrão`
- **start** → `começar` / `iniciar`
- **state** → `estado`
- **step** → `passo` (in `skillWorkflow/*` )
- **stop** → `parar`
- **store** → `armazenar`
- **strategy** → `estratégia`
- **strict** → `rigoroso` / `estrito`
- **string** → `string` _ (kept) _
- **strip** → `cortar` / `descartar`
- `commonSkills/caveman.json` :: `rule` ("Drop filler" → "Corte o excesso")
- `commonSkills/tokens.json` :: `rule`
- **strong (model)** → `forte`
- **study** → `estudar` / `estudo` (noun)
- **style** → `estilo`
- **subagent** → `subagente`
- `full-guide-pt.json` ("O ciclo de subagentes")
- **submit** → `enviar`
- **subsequent** → `subsequente`
- **subset** → `subconjunto`
- **subtract** → `subtrair`
- **success** → `sucesso`
- **successful** → `bem-sucedido`
- **summary** → `resumo`
- **super** → `super`
- **support (verb / noun)** → `suportar` / `suporte`
- **sure** → `certo`
- **swap** → `trocar`
- **switch** → `trocar`
- **symbol** → `símbolo`
- **system** → `sistema`
### T
- **table** → `tabela`
- **tag** → `tag` _ (kept) _
- **take (action)** → `tomar` / `fazer`
- **talk** → `falar`
- **target** → `alvo`
- **task** → `tarefa`
- **team** → `equipe`
- **template** → `template` _ (kept) _
- **term** → `termo`
- **test** → `testar` (verb), `teste` (noun)
- **text** → `texto`
- **than** → `do que` / `que`
- **that** → `que` / `aquilo`
- **the (article)** → `o` / `a` / `os` / `as`
- **then** → `então`
- **there** → `lá` / `ali`
- **these** → `estes` / `estas`
- **they** → `eles` / `elas`
- **thing** → `coisa`
- **think** → `pensar`
- **this** → `este` / `esta` / `isto`
- **those** → `aqueles` / `aquelas`
- **thread** → `linha` / `fio`
- **three** → `três`
- **through** → `através` / `por`
- **throw** → `lançar`
- **thus** → `assim`
- **time** → `tempo`
- **timeout** → kept English
- **tiny** → `minúsculo` / `tiny` (in `Tiny Tasks` )
- **tip** → `dica`
- **title** → `título`
- **to** → `para` / `a` / `de`
- **today** → `hoje`
- **together** → `junto`
- **token** → `token` _ (kept) _
- **too (also / excessive)** → `também` / `demais`
- **tool** → `ferramenta`
- **top** → `topo`
- **topic** → `tópico`
- **total** → `total`
- **trace (verb)** → `traçar` / `levar até a fonte`
- `commonSkills/research.json` :: `rule` ("Trace claims to owners" → "Leve
afirmações até suas fontes")
- **track** → `rastrear`
- **trade** → `trocar`
- **train** → `treinar`
- **transfer** → `transferir`
- **translate** → `traduzir`
- **trigger** → `gatilho`
- `phases/plan.json` neighborhood; `commonSkills/trigger.json` :: `kind`
neighborhood
- **trim** → `aparar` / `reduzir`
- **true** → `verdadeiro`
- **trust** → `confiar`
- **try** → `tentar` / `experimentar`
- **turn (into)** → `virar` / `transformar`
- **two** → `dois` / `duas`
- **type** → `tipo`
- **typography** → `tipografia`
### U
- **unblock** → `desbloquear`
- **uncertainty** → `incerteza`
- **uncover** → `descobrir`
- **undefined** → `indefinido`
- **under** → `sob` / `abaixo`
- **undo** → `desfazer`
- **unique** → `único`
- **unit** → `unidade`
- **unrelated** → `não relacionado`
- **unsafe** → `inseguro`
- **until** → `até`
- **up (to)** → `até`
- **update** → `atualizar` / `Atualização`
- **upgrade** → `atualizar`
- **upon** → `sobre`
- **URL** → kept English (`URL` )
- **use (verb)** → `usar` / `Use`
- **useful** → `útil`
- **user** → `usuário`
- **usual** → `habitual`
### V
- **valid / validate / validation** → `válido` / `validar` / `validação`
- **value** → `valor`
- **verbose** → `verboso`
- `commonSkills/tokens.json` :: `use` ("verbose tests" → "testes verbosos")
- **verify** → `verificar` / `VALIDAR`
- **version** → `versão`
- **versus / vs** → `versus` / `vs` _ (kept) _
- **video** → kept English
- **view** → `vista` / `visão`
- **virtual** → `virtual`
- **visible** → `visível`
- **visit** → `visitar`
### W
- **wait** → `esperar`
- **walk** → `caminhar`
- **want** → `querer`
- **warn / warning** → `alerta` / `aviso`
- `commonSkills/caveman.json` :: `caution` ("security warnings" → "alertas de
segurança")
- **watch** → `assistir` / `observar`
- **way** → `caminho` / `maneira`
- **we** → `nós`
- **weak** → `fraco`
- **wear** → kept English
- **web** → `web` _ (kept) _
- **what** → `o que`
- **wheel** → `roda`
- **when** → `quando`
- **where** → `onde`
- **whether** → `se`
- **which** → `qual` / `que`
- **while** → `enquanto`
- **white** → `branco`
- **who** → `quem`
- **why** → `por que`
- **wide** → `amplo` / `largo`
- **will** → `vai` / `irá`
- **window** → `janela`
- **with** → `com`
- **within** → `dentro` / `em`
- **without** → `sem`
- **work (verb / noun)** → `trabalhar` / `trabalho`
- **worker** → `worker` _ (kept in `routes/plan.json` :: `small` etc.) _ **or **
`agente`
- The corpus is mixed: `full-guide-pt.json` keeps `worker` , but
`rules/copy.json` :: `heroAside` says `3 agentes` . Choose **agent ** →
`agente` in prose; **worker ** stays English in tab labels and code-like
fragments.
- **worktree** → `worktree` _ (kept) _
- **would** → `iria`
- **wrap** → `envolver` / `quebrar`
- **write** → `escrever`
- **wrong** → `errado`
### X / Y / Z
- **xml** → kept English
- **yaml** → kept English
- **yet** → `ainda`
- **you** → `você` / `você` _(informal register, consistent with the existing
corpus)_
- **zero** → `zero` _ (kept) _
- **zip** → kept English
## Punctuation and orthography
- **Hyphenation.** Long compound phrases often gain a hyphen in the Portuguese
copy where English would have a space: `gate-discipline` , `subagent workflow`
(no hyphen). Match the source field by field.
- **Question marks and exclamation.** Always preceded by a space per Acordo
Ortográfico 1990: `?` , `!` , `;` , `:` — but the corpus already complies; this
is just to keep consistency.
- **Em dash.** The corpus uses `—` (U+2014) with surrounding spaces: "X — Y",
not "X—Y". Match.
- **Mid-sentence `→` ** keeps the spaces: `context → fact → action` .
- **Brand/glyph characters** (`<i></i>` , `<b></b>` , `↗` , `→` , `× , `·` ) are
copied verbatim, including any surrounding spaces.
## Number formatting
- Thousands separator: `.` in Portuguese (not `,` ).
- 1.000 / 10.000 — but the site rarely shows raw numbers; the spec is
preserved here so a future agent does not silently flip a separator.
- Decimals: `,` in Portuguese (not `.` ). Again, the site rarely needs this, but
`8 checks · ready` → `8 verificações · pronto` keeps the integer and swaps the
noun.
Marcos Paulo