iron-edge 1.2.0 → 2.0.0

package/squads/squad-engineering/tasks/write-adr.md

@@ -0,0 +1,29 @@
+---
+task: write-adr
+responsavel: eng-architect
+entrada: uma decisão técnica que custa caro desfazer
+saida: docs/eng/adr/NNN-slug.md
+teto: cinco linhas
+---
+
+# Task: Escrever um ADR
+
+## Quando abre ADR
+Decisão que **custa caro desfazer**: banco, auth, hospedagem, formato de dado, dependência estrutural, fronteira entre módulos, mudança de stack. Preferência de estilo, nome de variável e escolha reversível em uma tarde **não** viram ADR — inflação de ADR faz ninguém ler nenhum.
+
+## Passos
+
+1. Numere em sequência a partir do que já existe em `docs/eng/adr/`. Nunca reaproveite número.
+2. Escreva as cinco linhas do `templates/adr-template.md`:
+   - **Contexto:** o que forçou a decisão agora.
+   - **Decisão:** o que foi decidido, em voz ativa.
+   - **Alternativa descartada:** qual, e o **motivo real** — "não gostei" não é motivo; "custa uma conta paga que o dono não quer" é.
+   - **Consequência:** o que passa a ser verdade, **inclusive o que fica pior**. ADR que só lista vantagem é propaganda.
+   - **Data:** absoluta.
+3. Cite o ADR no cabeçalho de `03-arquitetura.md`.
+
+## ADR que muda de ideia
+Não se apaga nem se reescreve ADR antigo: abre-se um novo que o **supera**, citando o número do anterior. O histórico da decisão é metade do valor do arquivo.
+
+## Último passo: memória
+Se o mesmo ADR já apareceu em dois projetos do dono, ele virou o default dele. Registre em `~/.iron/memory/squad-engineering/eng-architect.md`.

package/squads/squad-engineering/tasks/write-architecture.md

@@ -0,0 +1,44 @@
+---
+task: write-architecture
+responsavel: eng-architect
+entrada: docs/eng/02-prd.md aprovado + estado inicial
+saida: docs/eng/03-arquitetura.md (+ adr/NNN-*.md)
+teto: duas páginas, ADRs à parte
+---
+
+# Task: Escrever a arquitetura
+
+## Passos
+
+1. **Comece pela stack que já existe.** O estado inicial mediu; projeto existente não troca de stack sem ADR e sem aprovação do dono.
+
+2. **Greenfield sem preferência do dono: aplique o default por tipo** (tabela no `templates/arquitetura-template.md` e em `knowledge-base/stack-por-tipo.md`), sempre com `▸ sugestão, a definir` e **uma alternativa escrita**. Default silencioso é decisão tomada no lugar do dono.
+
+3. **Meça o que a máquina tem antes de recomendar.** Runtime, gerenciador, acesso de rede. Recomendar ferramenta ausente sem dizer que está ausente transforma a arquitetura em lista de compras. Em rede corporativa: painel bloqueado por proxy **não** é plataforma fora do ar — meça o alcance real.
+
+4. **Escreva as sete seções** do template: stack e por quê · módulos · dados · integrações · auth e permissões · deploy e ambientes · riscos · o que fica pra depois.
+
+5. **Abra um ADR pra cada decisão que custa caro desfazer** (banco, auth, hospedagem, formato de dado, dependência estrutural). Cinco linhas, pela task `write-adr`. Escolha de nome de variável não vira ADR.
+
+6. **Apresente e espere a aprovação** antes de qualquer story ser escrita em cima.
+
+## Meça antes de entregar (não estime)
+
+Antes de apresentar o documento, **conte**. Instrução que depende de o autor achar que "ficou mais ou menos do tamanho" é instrução que falha: num teste real, um documento foi entregue como "perto do limite, mas dentro" e estava **acima** do teto quando medido.
+
+```
+# mac/linux
+wc -lw <arquivo>
+# windows (PowerShell)
+Get-Content <arquivo> | Measure-Object -Line -Word
+```
+
+Régua: conte **linhas de conteúdo** (branco, separador e cabeçalho de seção não contam). Uma página ≈ 50 linhas de conteúdo **ou** 500 palavras — o que estourar primeiro.
+
+**Estourou: corte antes de entregar.** As três causas, nesta ordem de frequência: tem conteúdo de outro documento ali dentro (detalhe de implementação no PRD, requisito na arquitetura), a faixa está errada, ou tem enfeite. Nenhuma das três se resolve escrevendo mais.
+
+## Em FEATURE, não existe documento novo
+A contribuição do architect é uma **nota técnica dentro da story**, na seção `Notas técnicas`. Feature que precisa de documento de arquitetura próprio provavelmente era PROJETO, e a faixa é que estava errada.
+
+## Último passo: memória
+ADR que se repete entre projetos deste dono vira o default dele; stacks e versões medidas na máquina dele economizam a próxima varredura. `~/.iron/memory/squad-engineering/eng-architect.md`.

package/squads/squad-engineering/tasks/write-brief.md

@@ -0,0 +1,42 @@
+---
+task: write-brief
+responsavel: eng-product
+entrada: pedido do dono + estado inicial
+saida: docs/eng/01-brief.md
+teto: uma página
+---
+
+# Task: Escrever o brief
+
+## Passos
+
+1. **Leia o estado inicial antes de perguntar qualquer coisa.** Metade das perguntas de brief já está respondida no disco, e perguntar o que a varredura mediu queima a paciência do dono.
+
+2. **Conduza a conversa.** Perguntas curtas, **uma por vez** quando o dono não domina o assunto. Ordem que funciona: o que dói hoje → quem senta na frente disso → como você vai saber que funcionou → o que trava (prazo, dinheiro, máquina) → o que isso definitivamente **não** é.
+
+3. **Escreva pelo `templates/brief-template.md`.** Teto de uma página.
+
+4. **O que o dono não disse entra como `(a definir)`.** Nunca como suposição bem-intencionada. Requisito inventado é o defeito mais caro deste cargo, porque ele passa despercebido até virar código.
+
+5. **Apresente e espere a aprovação.** Grave `aprovado por: <dono> · data:` no arquivo quando ela vier.
+
+## Meça antes de entregar (não estime)
+
+Antes de apresentar o documento, **conte**. Instrução que depende de o autor achar que "ficou mais ou menos do tamanho" é instrução que falha: num teste real, um documento foi entregue como "perto do limite, mas dentro" e estava **acima** do teto quando medido.
+
+```
+# mac/linux
+wc -lw <arquivo>
+# windows (PowerShell)
+Get-Content <arquivo> | Measure-Object -Line -Word
+```
+
+Régua: conte **linhas de conteúdo** (branco, separador e cabeçalho de seção não contam). Uma página ≈ 50 linhas de conteúdo **ou** 500 palavras — o que estourar primeiro.
+
+**Estourou: corte antes de entregar.** As três causas, nesta ordem de frequência: tem conteúdo de outro documento ali dentro (detalhe de implementação no PRD, requisito na arquitetura), a faixa está errada, ou tem enfeite. Nenhuma das três se resolve escrevendo mais.
+
+## Saída
+`docs/eng/01-brief.md` aprovado, com a lista de perguntas abertas visível — perguntas abertas em documento aprovado são dívida declarada, não detalhe.
+
+## Último passo: memória
+Requisito que **este dono sempre esquece** de pedir (exportar, apagar conta, login social, LGPD) vale ouro na próxima. Até três linhas em `~/.iron/memory/squad-engineering/eng-product.md`.

package/squads/squad-engineering/tasks/write-migration.md

@@ -0,0 +1,31 @@
+---
+task: write-migration
+responsavel: eng-data
+entrada: arquitetura aprovada + story que toca dado
+saida: migration com caminho de volta, políticas de acesso, seed quando a story pedir
+teto: a story
+---
+
+# Task: Escrever migration
+
+## Passos
+
+1. **Introspecte antes de escrever.** Leia o schema **real** do banco. Nunca assuma que uma tabela ou coluna existe porque o documento diz que existe: documento envelhece em silêncio, banco não.
+
+2. **Snapshot ou backup antes de qualquer DDL.** Inclusive em ambiente que "é só de teste" — a regra da casa é que `.env` pode ser produção, e confirmar o destino custa dez segundos.
+
+3. **Escreva o caminho de volta junto com a ida.** Down, rollback, ou o comando de reversão escrito por extenso. Migration sem volta é decisão irreversível tomada sem ninguém perceber que era irreversível.
+
+4. **Idempotência:** rodar duas vezes tem que dar o mesmo resultado. Migration que só funciona na primeira execução quebra em toda reaplicação, e reaplicação sempre acontece.
+
+5. **Permissões e acesso por linha (RLS):** escreva a política e **teste com um usuário que não deveria enxergar o dado**. Política que nunca foi testada pelo lado de fora é política presumida.
+
+6. **Fuso declarado** em toda coluna e todo job onde a data de corte decide o resultado. Máquina em fuso diferente do negócio grava no dia errado, e o dado sai plausível — ninguém percebe até o fechamento do mês.
+
+7. **Produção exige aprovação explícita do dono na hora.** Aprovação de ontem não vale pra migration de hoje.
+
+## Nunca
+Migration sem volta · rodar em produção sem aprovação na hora · assumir `.env` como ambiente de teste · ecoar string de conexão, credencial ou dado pessoal em log ou saída.
+
+## Último passo: memória
+Convenção de schema deste dono, o que já quebrou em migration, e jobs com seus fusos. `~/.iron/memory/squad-engineering/eng-data.md`.

package/squads/squad-engineering/tasks/write-prd.md

@@ -0,0 +1,44 @@
+---
+task: write-prd
+responsavel: eng-product
+entrada: docs/eng/01-brief.md aprovado
+saida: docs/eng/02-prd.md
+teto: duas páginas
+---
+
+# Task: Escrever o PRD
+
+## Passos
+
+1. **Transforme cada dor do brief em requisito numerado.** `RF-1`, `RF-2`, e assim por diante. A numeração é o que deixa story, teste e parecer apontarem pro mesmo lugar.
+
+2. **Todo RF leva critério de aceite** no formato `dado <estado>, quando <ação>, então <resultado observável>`. RF sem critério não é requisito, é desejo — e desejo não dá pra testar nem pra auditar.
+
+3. **Escreva os não funcionais que este software realmente tem:** desempenho, acesso e permissão, dado pessoal e LGPD, disponibilidade e backup. O que não se aplica sai da lista com `n/a`, não fica em branco.
+
+4. **Fora de escopo é seção obrigatória.** É ela que impede a story de crescer sozinha.
+
+5. **Escreva pelo `templates/prd-template.md`.** Teto de duas páginas. Estourou o teto: ou o escopo é grande demais pra uma rodada, ou tem detalhe de implementação no lugar errado — e detalhe de implementação é do `eng-architect`.
+
+6. **Apresente e espere a aprovação.** Registre `versão`, `aprovado por` e `data`.
+
+## Meça antes de entregar (não estime)
+
+Antes de apresentar o documento, **conte**. Instrução que depende de o autor achar que "ficou mais ou menos do tamanho" é instrução que falha: num teste real, um documento foi entregue como "perto do limite, mas dentro" e estava **acima** do teto quando medido.
+
+```
+# mac/linux
+wc -lw <arquivo>
+# windows (PowerShell)
+Get-Content <arquivo> | Measure-Object -Line -Word
+```
+
+Régua: conte **linhas de conteúdo** (branco, separador e cabeçalho de seção não contam). Uma página ≈ 50 linhas de conteúdo **ou** 500 palavras — o que estourar primeiro.
+
+**Estourou: corte antes de entregar.** As três causas, nesta ordem de frequência: tem conteúdo de outro documento ali dentro (detalhe de implementação no PRD, requisito na arquitetura), a faixa está errada, ou tem enfeite. Nenhuma das três se resolve escrevendo mais.
+
+## Mudança depois de aprovado
+Escopo que muda depois de story aprovada gera **versão nova** do PRD e aviso explícito ao `eng-sprint`, que revisa as stories derivadas. Editar o PRD em silêncio deixa stories aprovadas apontando pra um contrato que não existe mais.
+
+## Último passo: memória
+Formato de PRD que este dono leu inteiro e aprovou sem alterar, e vocabulário do negócio dele. `~/.iron/memory/squad-engineering/eng-product.md`.

package/squads/squad-engineering/templates/adr-template.md

@@ -0,0 +1,13 @@
+# Template: ADR
+
+Dono: `eng-architect`. Vai pra `docs/eng/adr/NNN-slug.md`. **Cinco linhas.** ADR existe pra decisão que custa caro desfazer; escolha de nome de variável não vira ADR.
+
+```markdown
+# ADR-NNN — <a decisão em quatro palavras>
+
+**Contexto:** <o que forçou a decisão>
+**Decisão:** <o que foi decidido>
+**Alternativa descartada:** <qual, e o motivo real>
+**Consequência:** <o que passa a ser verdade, inclusive o que fica pior>
+**Data:** AAAA-MM-DD
+```

package/squads/squad-engineering/templates/arquitetura-template.md

@@ -0,0 +1,43 @@
+# Template: arquitetura
+
+Dono: `eng-architect`. Vai pra `docs/eng/03-arquitetura.md`. **Teto: duas páginas** (os ADRs ficam em `adr/`, fora da conta).
+
+```markdown
+# Arquitetura — <nome do software>
+aprovado por:
+data:
+ADRs: adr/001-..., adr/002-...
+
+## Stack e por quê
+<três linhas. Quando for o default por tipo, escrever "▸ sugestão, a definir" e a alternativa.>
+Alternativa considerada: <qual, e por que não>
+
+## Módulos
+<lista ou diagrama simples. O que é responsabilidade de quem.>
+
+## Dados
+<uma tabela ou um diagrama. Entidades, campos-chave, relações.>
+
+## Integrações
+<serviço externo, o que entra, o que sai, o que acontece quando ele cai>
+
+## Auth e permissões
+<quem entra, como, e quem enxerga o quê>
+
+## Deploy e ambientes
+<onde roda, quais ambientes existem, como se publica, como se volta>
+
+## Riscos
+<o que pode dar errado e o sinal de que está dando>
+
+## Fica pra depois
+<o que foi conscientemente adiado>
+```
+
+**Stack default por tipo** — só quando o dono não tem preferência e o estado inicial não detectou stack; sempre com `▸ sugestão, a definir` e uma alternativa escrita:
+
+| Tipo | Default | Alternativa |
+|---|---|---|
+| site, LP, vitrine sem login e sem dado | HTML + Vite | Astro |
+| app com login, formulário que grava, painel, pagamento | Next.js + Supabase + Vercel | Remix ou SvelteKit + Supabase |
+| script, job, automação de negócio | Node ou Python, conforme o que a máquina já tem | o outro, declarado |

package/squads/squad-engineering/templates/brief-template.md

@@ -0,0 +1,34 @@
+# Template: brief
+
+Dono: `eng-product`. Vai pra `docs/eng/01-brief.md`. **Teto: uma página.**
+
+```markdown
+# Brief — <nome do software>
+
+## Problema
+<o que dói hoje, em duas ou três linhas. O problema, não a solução.>
+
+## Quem usa
+<quem senta na frente disso. Se houver mais de um perfil, um por linha.>
+
+## Resultado esperado
+<como saberemos que funcionou. Número quando o dono souber o número; "(a definir)" quando não souber.>
+
+## Restrições
+- Prazo: <ou "(a definir)">
+- Máquina e ambiente: <sistema, o que já existe instalado, rede corporativa>
+- Orçamento: <ou "(a definir)">
+- LGPD / dado pessoal: <coleta dado pessoal? qual?>
+
+## O que NÃO é
+<a fronteira. A seção que mais economiza retrabalho.>
+
+## Perguntas abertas
+- (a definir) <uma por linha>
+
+---
+aprovado por:
+data:
+```
+
+Regra dura: **nada inventado.** Requisito, número, nome, prazo e integração que o dono não disse entram como `(a definir)`, não como suposição bem-intencionada.

package/squads/squad-engineering/templates/checklist-pre-publicacao-template.md

@@ -0,0 +1,29 @@
+# Template: checklist pré-publicação (formulário de evidência)
+
+Dono: `eng-devops`. A lista canônica de itens é `checklists/pre-publicacao.md` — este arquivo é só o formulário que se preenche por publicação, com o comando e a saída real ao lado de cada item.
+
+**Item sem evidência é item não cumprido.** Marcar `[x]` de memória é o defeito que este formulário existe pra impedir.
+
+```markdown
+# Pré-publicação — <story NNN> — AAAA-MM-DD
+
+- [ ] Parecer liberado, hash confere com o arquivo em disco
+      evidência: <comando de hash + as duas linhas comparadas>
+- [ ] Testes verdes
+      evidência: <comando + resumo da saída>
+- [ ] Árvore limpa
+      evidência: <saída de git status>
+- [ ] Segredo ausente do diff
+      evidência: <comando de varredura + resultado>
+- [ ] Variáveis presentes no destino (presença, nunca valor)
+      evidência: <lista de nomes conferidos>
+- [ ] Rollback conhecido e escrito na story
+      evidência: <o comando ou o passo>
+- [ ] Aprovação do dono registrada
+      evidência: <onde está escrita, com data>
+- [ ] Um assunto por publicação (branch nova, sem reuso, um PR)
+      evidência: <nome da branch + o que ela contém>
+
+destino:
+publicado em:
+```

package/squads/squad-engineering/templates/estado-inicial-template.md

@@ -0,0 +1,26 @@
+# Template: estado inicial
+
+Preenchido pelo `eng-orqx` na task `initial-state-audit`. Vai pra `docs/eng/00-estado-inicial.md` nas faixas FEATURE e PROJETO; na faixa AJUSTE fica inline na conversa e não vira arquivo.
+
+**Teto: quinze linhas.** Relatório que estourou o teto virou inventário, e inventário ninguém lê antes de decidir.
+
+```
+Estado detectado: <VAZIO | ESQUELETO | PARCIAL | MADURO | IRON-GERIDO>
+Stack: <detectada, ou "nenhuma"> · Git: <sim/não · branch · árvore limpa/suja>
+
+Já existe:
+- <o que está lá, medido — não suposto>
+
+Faltando:
+- <o que o pedido precisa e não está lá>
+
+Recomendação: faixa <AJUSTE | FEATURE | PROJETO>
+Porque: <os gatilhos observados, não a impressão geral>
+
+Bloqueador antes de qualquer plano: <segredo em arquivo versionado, se houver; senão apague esta linha>
+```
+
+Regras:
+- Só entra o que foi **medido**. Nada de "provavelmente usa Next".
+- Em máquina gerenciada por empregador: registrar **existência**, nunca conteúdo de cliente.
+- Segredo em arquivo versionado é bloqueador **antes** do plano, não achado pra depois.

package/squads/squad-engineering/templates/memoria-do-cargo-template.md

@@ -0,0 +1,32 @@
+# Template: memória do cargo
+
+Cada cargo tem um arquivo em `~/.iron/memory/squad-engineering/<cargo>.md`, **fora** da árvore que o instalador gerencia — atualização de pacote não toca nele. Nasce deste template na primeira vez que o cargo roda.
+
+**Teto: oitenta linhas por cargo.** Estourou, o `eng-sprint` poda na retro.
+
+```markdown
+# Memória · <cargo>
+atualizado: AAAA-MM-DD
+
+## Ativo
+- AAAA-MM-DD · <fato ou padrão que vale hoje> · origem: <identificador do projeto ou "geral">
+
+## Candidato a promoção
+- <padrão visto em dois ou mais projetos, ou em três ou mais sessões> · visto em: <onde> · destino: anotar | CLAUDE.md do dono | template do squad
+
+## Arquivado
+- ~~<padrão>~~ · arquivado AAAA-MM-DD · motivo: <por que deixou de valer>
+```
+
+## Regras duras
+- **Nunca:** código, caminho de cliente, nome de terceiro, valor de credencial. Em máquina de empregador, só padrão e data.
+- **Nunca estado de projeto** — isso mora no `PROJETO.md` do cofre e em `docs/eng/`. Memória é o que sobrevive ao projeto.
+- **No campo `origem`, use o identificador do projeto ou `geral`** — e, quando o fato for da máquina, escreva `esta máquina`, nunca o nome do dono. Memória é lida por outros cargos e acaba colada em relatório; nome próprio ali é ruído que viaja.
+- **Data sempre absoluta.** "Semana passada" não sobrevive a três meses.
+- O que aparecer na memória de dois cargos diferentes é candidato a subir pra um lugar só.
+
+## Quem escreve
+O próprio cargo, no **último passo** de toda task: se aprendeu algo que vale pra próxima vez, até três linhas; se não aprendeu, não escreve. Memória que cresce toda sessão vira lixão.
+
+## Quem poda
+O `eng-sprint`, na retro: promove o que repetiu, arquiva o que morreu (com data e motivo), corta pra caber no teto.

package/squads/squad-engineering/templates/plano-de-orquestracao-template.md

@@ -0,0 +1,20 @@
+# Template: plano de orquestração
+
+Dono: `eng-orqx`. Fica na conversa; em PROJETO, no topo de `docs/eng/00-estado-inicial.md`. **Teto: dez linhas.**
+
+```
+faixa: <AJUSTE | FEATURE | PROJETO>[ · forçada pelo dono · AAAA-MM-DD]
+porque: <os gatilhos observados>
+
+1. <cargo> → <artefato> → <onde grava>
+2. <cargo> → <artefato> → <onde grava>
+3. ...
+
+aprovações previstas: <quais documentos o dono aprova, e quando>
+▸ <quem roda de verdade>
+```
+
+Regras:
+- A linha `▸` é obrigatória em toda resposta que envolveu outro cargo. Duas formas honestas:
+  `▸ o eng-dev rodou como subagente.` ou `▸ eu operei o método do cargo eng-dev (delegação real indisponível nesta sessão).`
+- `faixa: forçada pelo dono` só aparece quando ele mandou pular etapa. O Iron avisa o risco em uma linha, registra e segue. Nunca recusa.

package/squads/squad-engineering/templates/prd-template.md

@@ -0,0 +1,41 @@
+# Template: PRD
+
+Dono: `eng-product`. Vai pra `docs/eng/02-prd.md`. **Teto: duas páginas.**
+
+```markdown
+# PRD — <nome do software>
+versão: 1
+aprovado por:
+data:
+
+## Objetivo
+<uma linha.>
+
+## Requisitos funcionais
+
+### RF-1 — <título curto>
+<o que o sistema faz.>
+critério de aceite: dado <estado inicial>, quando <ação>, então <resultado observável>.
+
+### RF-2 — <título curto>
+...
+
+## Requisitos não funcionais
+- Desempenho: <ou "(a definir)">
+- Acesso e permissão: <quem enxerga o quê>
+- Dado pessoal / LGPD: <o que é coletado, por quanto tempo fica, como se apaga>
+- Disponibilidade e backup: <ou "(a definir)">
+
+## Fora de escopo
+- <o que este PRD deliberadamente não faz>
+
+## Dependências
+- <serviço, conta, credencial ou decisão de terceiro que trava o trabalho>
+
+## Perguntas abertas
+- (a definir)
+```
+
+Regras:
+- **Todo RF tem critério de aceite**, no formato dado/quando/então. RF sem critério não é requisito, é desejo.
+- Mudança de escopo depois de story aprovada gera **versão nova** do PRD e aviso ao `eng-sprint`.

package/squads/squad-engineering/templates/story-template.md

@@ -0,0 +1,69 @@
+# Template: story
+
+Dono das seções conforme a tabela abaixo. Vai pra `docs/eng/stories/NNN-slug.md`. **Teto: uma página.** Story que não cabe numa sessão de trabalho é dividida **antes** da aprovação.
+
+```markdown
+---
+id: NNN
+titulo:
+status: Rascunho | Aprovada | Em andamento | Em revisão | Pronta
+faixa: FEATURE | PROJETO
+aprovado_por:
+data:
+---
+
+## Contexto
+<duas ou três linhas: de onde essa story veio e o que ela destrava.>
+
+## Objetivo
+<uma linha.>
+
+## Critérios de aceite
+- dado <estado>, quando <ação>, então <resultado observável>
+- <só o que está no PRD>
+
+## Fora de escopo
+- <o que esta story deliberadamente não faz>
+
+## Notas técnicas
+<vazio até o architect ou o data escreverem. Nota técnica mora aqui, não em documento novo.>
+
+## Tarefas
+- [ ] <tarefa>
+- [ ] <tarefa>
+
+## Registro do dev
+arquivos tocados:
+comandos rodados:
+decisões:
+modelo usado:
+o que ficou de fora:
+
+## Resultado do gate
+parecer: _auditoria/AAAA-MM-DD-gate-<slug>.md
+veredito:
+hash:
+
+## Publicação
+destino:
+data:
+rollback:
+
+## Log
+- AAAA-MM-DD · <cargo> · <uma linha>
+```
+
+## Quem edita o quê (a story é um contrato)
+
+| Seção | Escreve | Também edita |
+|---|---|---|
+| Status | `eng-sprint` | `eng-dev` avança até Em revisão · `eng-qa` fecha em Pronta |
+| Contexto, Objetivo, Critérios de aceite, Fora de escopo | `eng-sprint` | ninguém — mudança reabre no PRD |
+| Notas técnicas | `eng-sprint` | `eng-architect`, `eng-data` |
+| Tarefas | `eng-sprint` cria | `eng-dev` marca `[x]` quando passou |
+| Registro do dev | `eng-dev` | só `eng-dev` |
+| Resultado do gate | `eng-qa` | só `eng-qa` |
+| Publicação | `eng-devops` | só `eng-devops` |
+| Log | qualquer cargo, uma linha datada | |
+
+**Regra do template:** quem implementa **não** é quem audita, e os dois rodam em subagentes separados. Se a plataforma não permitir isolar, o parecer sai com `isolamento: comprometido`, conforme a skill `gate`.

package/squads/squad-engineering/workflows/ajuste-cycle.yaml

@@ -0,0 +1,75 @@
+name: ajuste-cycle
+version: "1.0"
+description: >
+  Faixa mais leve. Mudança pequena em projeto que já existe: até três arquivos,
+  sem schema, auth, pagamento, integração nova ou dependência nova. Zero documento.
+  O pedido do dono É a story.
+trigger: >
+  Pedido de correção ou mudança pequena em projeto existente, sem bandeira vermelha.
+  "bug", "erro", "quebrou", "troca o texto", "ajusta o espaçamento".
+owner: eng-orqx
+
+entrada_obrigatoria:
+  - Estado inicial rodado (versão inline, sem arquivo)
+  - Faixa AJUSTE declarada em uma linha, com os gatilhos observados
+
+phases:
+  - name: "Fase 1 — Implementar"
+    agents: [eng-dev]
+    tasks: [develop-story]
+    input:
+      - Pedido do dono (é o contrato desta faixa)
+      - Mini-audit: git status, suíte existente, convenções do projeto
+    output:
+      - Código alterado
+      - Registro do que foi tocado (na conversa; não vira arquivo nesta faixa)
+    gate:
+      name: Nenhum ainda
+      criteria: O gate desta faixa roda depois da reverificação, na fase 2
+
+  - name: "Fase 2 — Reverificar a faixa contra o diff real"
+    agents: [eng-dev]
+    tasks: [verify-track-after-diff]
+    depends_on: "Fase 1"
+    input:
+      - Diff real (git diff --stat, git status --short)
+      - Limites da faixa AJUSTE
+    output:
+      - Confirmação da faixa, OU declaração de estouro para o eng-orqx
+    gate:
+      name: Limites da faixa
+      criteria: >
+        Coube nos limites, segue pra fase 3. Estourou, PARA:
+        o eng-orqx sobe pra FEATURE, o eng-sprint escreve a story a posteriori
+        em dez linhas, e o gate roda na LISTA B antes de fechar.
+      verdict: [COUBE, ESTOUROU]
+
+  - name: "Fase 3 — Gate na faixa do destino"
+    agents: [eng-qa]
+    tasks: [operate-gate-code]
+    depends_on: "Fase 2"
+    input:
+      - Diff
+      - Destino da mudança (fica na máquina, ou sai dela?)
+    output:
+      - Parecer, no formato e na proporção da skill gate
+    gate:
+      name: Gate
+      criteria: >
+        Destino LOCAL roda só a lente ★. Destino que sai da máquina
+        roda a faixa VAI SAIR. Código que toca dado de produção nunca é LOCAL.
+      verdict: [LIBERADO, REPROVADO]
+
+publicacao: >
+  Se a mudança precisa sair da máquina, o eng-devops publica pela task publish.
+  Nenhum outro cargo publica, em nenhuma faixa.
+
+registro: >
+  Faixa AJUSTE não gera documento em docs/eng/. O rastro é a skill salvar,
+  no diário do dono.
+
+vocabulario_do_gate: >
+  Os nomes de faixa, painel e lente citados neste arquivo são os da skill gate do pacote.
+  Variantes instaladas usam outras palavras para a mesma ideia (a faixa que sai da máquina
+  aparece como VAI SAIR ou CLIENTE-FINAL; a que fica, como LOCAL ou INTERNO). O eng-qa lê a
+  régua instalada e usa as palavras dela — ver tasks/operate-gate-code.md.