iron-edge 1.2.0 → 2.0.0

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

@@ -0,0 +1,112 @@
+name: feature-cycle
+version: "1.0"
+description: >
+  Faixa do meio. Mudança em projeto existente que estoura os limites do ajuste
+  (mais arquivos, mais de um módulo, rota nova, schema, integração existente
+  alterada), sem bandeira vermelha. Custa uma story, e só.
+trigger: >
+  "adiciona campo", "cria a tela de", "coloca um filtro em", "integra com o que
+  já existe" — em projeto que já roda.
+owner: eng-orqx
+
+entrada_obrigatoria:
+  - docs/eng/00-estado-inicial.md gravado
+  - Faixa FEATURE declarada com os gatilhos observados
+
+phases:
+  - name: "Fase 1 — Story"
+    agents: [eng-sprint]
+    tasks: [draft-stories]
+    input:
+      - Pedido do dono
+      - Estado inicial
+      - PRD e arquitetura, quando existirem no projeto
+    output:
+      - docs/eng/stories/NNN-slug.md (uma story, teto de uma página)
+    gate:
+      name: Tamanho
+      criteria: A story cabe numa sessão de trabalho. Não cabe, divide antes de aprovar.
+
+  - name: "Fase 2 — Nota técnica (condicional)"
+    agents: [eng-architect, eng-data]
+    tasks: [write-architecture, write-migration]
+    depends_on: "Fase 1"
+    condicao: >
+      Roda SÓ quando a story toca dado, auth ou integração. Não toca:
+      pule esta fase inteira. Fase que roda sempre vira ritual.
+    input:
+      - A story
+      - docs/eng/03-arquitetura.md, quando existir
+    output:
+      - Seção "Notas técnicas" da story preenchida
+      - Nenhum documento novo — nota técnica de feature mora DENTRO da story
+    gate:
+      name: Sem documento novo
+      criteria: >
+        Feature que precisa de documento de arquitetura próprio provavelmente
+        era PROJETO. A faixa é que estava errada.
+
+  - name: "Fase 3 — Aprovação do dono"
+    agents: [eng-orqx]
+    tasks: [plan-orchestration]
+    depends_on: "Fase 2"
+    input:
+      - A story completa
+    output:
+      - Status Aprovada, com "aprovado_por" e data no frontmatter
+    gate:
+      name: Aprovação
+      criteria: Palavra do dono. Sem ela, a story fica em Rascunho.
+      verdict: [APROVADA, REVISAR]
+
+  - name: "Fase 4 — Implementar"
+    agents: [eng-dev]
+    tasks: [develop-story]
+    depends_on: "Fase 3"
+    input:
+      - Story Aprovada, arquitetura, CLAUDE.md do repo
+    output:
+      - Código, testes, Registro do dev preenchido, status Em revisão
+    gate:
+      name: HALT
+      criteria: >
+        Dentro da story aprovada o dev não pergunta. Ele PARA nos sete HALTs
+        da task develop-story, e volta com a pergunta pronta.
+
+  - name: "Fase 5 — Gate e DoD"
+    agents: [eng-qa]
+    tasks: [operate-gate-code, verify-dod]
+    depends_on: "Fase 4"
+    input:
+      - Story implementada, diff, suíte, convenções do projeto
+    output:
+      - Parecer em _auditoria/
+      - Seção "Resultado do gate" preenchida
+      - Status Pronta
+    gate:
+      name: Gate LISTA B, faixa VAI SAIR, com a lente CONVENÇÃO
+      criteria: >
+        Zero achado impeditivo pela régua da skill gate. O auditor NÃO é
+        o subagente que implementou; sem isolamento, o parecer sai com a
+        linha "isolamento: comprometido".
+      verdict: [LIBERADO, REPROVADO]
+
+  - name: "Fase 6 — Publicar (condicional)"
+    agents: [eng-devops]
+    tasks: [publish]
+    depends_on: "Fase 5"
+    condicao: Roda só quando a mudança sai da máquina.
+    input:
+      - Story Pronta, parecer liberado com hash, aprovação do dono
+    output:
+      - Publicação feita, seção "Publicação" da story preenchida
+    gate:
+      name: Checklist pré-publicação
+      criteria: Os itens de checklists/pre-publicacao.md, cada um com evidência.
+      verdict: [PUBLICADO, BLOQUEADO]
+
+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.

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

@@ -0,0 +1,137 @@
+name: projeto-cycle
+version: "1.0"
+description: >
+  Faixa completa. Software novo, módulo novo, ou qualquer bandeira vermelha
+  (auth, pagamento, dado pessoal, integração externa nova, troca de stack,
+  migração de produção). Quatro documentos com teto de tamanho, e stories.
+trigger: >
+  "quero um app", "cria uma plataforma", "monta um sistema de", "automatiza
+  esse processo com código" — e todo pedido que carrega bandeira vermelha.
+owner: eng-orqx
+
+entrada_obrigatoria:
+  - docs/eng/00-estado-inicial.md gravado e reportado ao dono
+  - Faixa PROJETO declarada com os gatilhos observados
+  - Plano de orquestração apresentado e aprovado
+
+phases:
+  - name: "Fase 1 — Brief"
+    agents: [eng-product]
+    tasks: [write-brief]
+    input:
+      - Pedido do dono, estado inicial, conversa de descoberta
+    output:
+      - docs/eng/01-brief.md (teto de uma página)
+    gate:
+      name: Aprovação do dono
+      criteria: >
+        Nada inventado: o que ele não disse está escrito como "(a definir)".
+        Documento que estourou o teto está errado, não completo.
+      verdict: [APROVADO, REVISAR]
+
+  - name: "Fase 2 — PRD"
+    agents: [eng-product]
+    tasks: [write-prd]
+    depends_on: "Fase 1"
+    input:
+      - Brief aprovado
+    output:
+      - docs/eng/02-prd.md (teto de duas páginas)
+    gate:
+      name: Aprovação do dono
+      criteria: Todo RF tem critério de aceite no formato dado/quando/então.
+      verdict: [APROVADO, REVISAR]
+
+  - name: "Fase 3 — Arquitetura"
+    agents: [eng-architect]
+    tasks: [write-architecture, write-adr]
+    depends_on: "Fase 2"
+    input:
+      - PRD aprovado, estado inicial, stack detectada na máquina
+    output:
+      - docs/eng/03-arquitetura.md (teto de duas páginas)
+      - docs/eng/adr/NNN-slug.md (cinco linhas cada)
+    gate:
+      name: Aprovação do dono
+      criteria: >
+        Stack default vem sempre com a marca de sugestão a definir e uma
+        alternativa escrita. Ferramenta que a máquina não tem é declarada
+        como ausente, não recomendada em silêncio.
+      verdict: [APROVADO, REVISAR]
+
+  - name: "Fase 4 — Ambiente (condicional)"
+    agents: [eng-devops]
+    tasks: [prepare-environment]
+    depends_on: "Fase 3"
+    condicao: >
+      Roda SÓ quando o estado inicial mostrou que falta ambiente. Projeto que
+      já tem repositório, ignore e scripts pula esta fase inteira.
+    input:
+      - Arquitetura aprovada, estado inicial
+    output:
+      - Repositório, .gitignore, scripts, variáveis conferidas por presença
+    gate:
+      name: Segredo
+      criteria: .gitignore cobre segredo ANTES do primeiro commit.
+
+  - name: "Fase 5 — Lote de stories"
+    agents: [eng-sprint]
+    tasks: [draft-stories]
+    depends_on: "Fase 3"
+    input:
+      - PRD e arquitetura aprovados
+    output:
+      - docs/eng/stories/NNN-slug.md (lote), com ordem e dependências
+    gate:
+      name: Aprovação do lote pelo dono
+      criteria: >
+        Cada story cabe numa sessão e tem critérios que saem do PRD.
+        Aprovação por LOTE é o que permite ao dev não perguntar depois.
+      verdict: [APROVADO, REVISAR]
+
+  - name: "Fase 6 — Por story: implementar, auditar, publicar"
+    agents: [eng-dev, eng-data, eng-qa, eng-devops]
+    tasks: [develop-story, write-migration, operate-gate-code, verify-dod, publish]
+    depends_on: ["Fase 4", "Fase 5"]
+    porque_depende_das_duas: >
+      Da Fase 5 pelas stories, e da Fase 4 porque é aqui que o código passa a existir
+      e a ser commitado: o .gitignore tem que cobrir segredo ANTES do primeiro commit.
+      Se a Fase 4 foi pulada por já haver ambiente, a dependência está satisfeita.
+    execution: >
+      Uma story por vez, na ordem definida na fase 5. O eng-data entra só nas
+      stories que tocam dado; o eng-devops, só quando a story publica.
+    input:
+      - Story Aprovada, arquitetura, convenções do projeto
+    output:
+      - Código, testes, parecer em _auditoria/, story em Pronta
+    gate:
+      name: Gate LISTA B por story, mais a DoD única
+      criteria: >
+        Zero achado impeditivo pela régua da skill gate. Quem implementa não é
+        quem audita. A DoD de checklists/dod.md é a única do squad.
+      verdict: [LIBERADO, REPROVADO]
+
+  - name: "Fase 7 — Retro"
+    agents: [eng-sprint]
+    tasks: [run-retro]
+    depends_on: "Fase 6"
+    input:
+      - Lote fechado, memórias dos cargos que trabalharam
+    output:
+      - Memórias podadas (promovido, arquivado com motivo, cortado no teto)
+      - Aprendizados para a skill anotar
+      - Próximos passos para a skill salvar
+    gate:
+      name: Nenhum
+      criteria: Retro não bloqueia entrega. Ela alimenta a próxima.
+
+veredito_final: >
+  Fechado o lote, o eng-orqx compara a entrega com o PRD e reporta ao dono o
+  que ficou de fora e o que virou perguntas abertas. Entrega que não fecha com
+  o PRD não é entrega parcial em silêncio: é lista escrita.
+
+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.

package/squads/squad-finance/README.md

@@ -2,6 +2,12 @@
 
 > Squad especializada em inteligencia financeira para agencias e negocios digitais. Cobre analise de rentabilidade, precificacao, forecasting, unit economics, controle orcamentario e otimizacao de custos.
 
+<!-- gen:start -->
+| camada | agentes | tasks | KBs | workflows | templates | checklists |
+|---|---|---|---|---|---|---|
+| iron 5 · xq 0 | 5 | 45 | 21 | 4 | 4 | 3 |
+<!-- gen:end -->
+
 ## Visao Geral
 
 | Metrica | Quantidade |
@@ -23,7 +29,16 @@
 
 ## Ativacao
 
-```bash
+Você entra por aqui, pedindo em português ao Claude Code:
+
+```
+"usa o iron-finance"
+```
+
+Os nomes com `@` abaixo são **papéis internos** deste squad — quem os aciona é o
+orquestrador, não você. Não são comandos de barra nem menções que você digita.
+
+```
 # Via orquestrador (recomendado)
 @finance-orqx
 
@@ -70,11 +85,8 @@
 
 ## Integracao com Core Agents
 
-Este squad trabalha com o framework SINAPSE core:
-- @architect (Aria) para decisoes tecnicas
-- @developer (Dex) para implementacao
-- @quality-gate (Quinn) para validacao de qualidade
+Este squad é orquestrado pelo `iron-ceo`, que abre o orquestrador do squad em `~/.iron/<squad>/agents/<squad>-orqx.md`.
 
 ---
 
-*Parte do ecossistema SINAPSE-AI — 18 squads, 186 agentes*
+Parte do ecossistema Iron Edge

package/squads/squad-finance/agents/budget-controller.md

@@ -1,3 +1,12 @@
+---
+id: budget-controller
+layer: iron
+role: specialist
+orchestrated_by: finance-orqx
+squad: squad-finance
+model: sonnet
+---
+
 # Agent: Vault — Budget Controller
 
 ## Identidade

package/squads/squad-finance/agents/finance-orqx.md

@@ -1,3 +1,12 @@
+---
+id: finance-orqx
+layer: iron
+role: orchestrator
+orchestrated_by: finance-orqx
+squad: squad-finance
+model: opus
+---
+
 # Agent: Ledger — Financial Intelligence Orchestrator
 
 ## Identidade
@@ -88,5 +97,5 @@ Ledger e o CFO virtual da squad. Coordena todas as analises financeiras, prioriz
 
 ## Escalation
 
-- **Escalates to:** @sinapse-orqx (Imperator) para coordenacao cross-squad, decisoes arquiteturais ou escalacoes alem do escopo da squad
-- **Receives from:** @sinapse-orqx quando o ecossistema Sinapse roteia demandas financeiras para esta squad
+- **Escalates to:** @iron-ceo (Imperator) para coordenacao cross-squad, decisoes arquiteturais ou escalacoes alem do escopo da squad
+- **Receives from:** @iron-ceo quando o ecossistema Iron Edge roteia demandas financeiras para esta squad

package/squads/squad-finance/agents/pricing-strategist.md

@@ -1,3 +1,12 @@
+---
+id: pricing-strategist
+layer: iron
+role: specialist
+orchestrated_by: finance-orqx
+squad: squad-finance
+model: sonnet
+---
+
 # Agent: Mint — Pricing Strategist
 
 ## Identidade

package/squads/squad-finance/agents/profitability-analyst.md

@@ -1,3 +1,12 @@
+---
+id: profitability-analyst
+layer: iron
+role: specialist
+orchestrated_by: finance-orqx
+squad: squad-finance
+model: sonnet
+---
+
 # Agent: Margin — Profitability Analyst
 
 ## Identidade

package/squads/squad-finance/agents/revenue-analyst.md

@@ -1,3 +1,12 @@
+---
+id: revenue-analyst
+layer: iron
+role: specialist
+orchestrated_by: finance-orqx
+squad: squad-finance
+model: sonnet
+---
+
 # Agent: Flow — Revenue Analyst
 
 ## Identidade

package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md

@@ -994,5 +994,5 @@ Principle: small continuous improvements yield large results over time.
 
 ---
 
-*Contabilidade Master Reference v1.0 -- SINAPSE squad-finance knowledge base*
+*Contabilidade Master Reference v1.0 -- Iron Edge squad-finance knowledge base*
 *Source: MS-012 Contabilidade Research (2026-04-06, verified 2026-04-07)*

package/squads/squad-finance/knowledge-base/finance-master-reference.md

@@ -942,5 +942,5 @@ Series B:    Founders 38% | Angels 7%  | Seed 11% | A 19% | B 25%
 
 ---
 
-*Finance Master Reference v1.0 -- SINAPSE squad-finance knowledge base*
+*Finance Master Reference v1.0 -- Iron Edge squad-finance knowledge base*
 *Source: MS-013 Finance Research (2026-04-07)*

package/squads/squad-finance/squad.yaml

@@ -4,7 +4,6 @@
 # Squad especializada em inteligencia financeira para agencias e negocios
 # digitais. Cobre analise de rentabilidade, precificacao, forecasting,
 # unit economics, controle orcamentario e otimizacao de custos.
-# 5 agents | 45 tasks | 8 KBs | 4 workflows | 3 checklists | 4 templates
 # ══════════════════════════════════════════════════════════════════════════════
 
 name: squad-finance
@@ -20,16 +19,9 @@ license: UNLICENSED
 slashPrefix: IRON
 
 metadata:
-  total_files: 82
   created_at: "2026-03-16"
   updated_at: "2026-03-16"
   created_by: "squad-creator (Craft)"
-  agents_count: 5
-  tasks_count: 45
-  knowledge_bases_count: 21
-  workflows_count: 4
-  checklists_count: 3
-  templates_count: 4
 
 # ══════════════════════════════════════════════════════════════════════════════
 # AGENTES — 5 ESPECIALISTAS
@@ -199,7 +191,7 @@ cross_squad_connections:
     - squad-brand: "Investimento em marca, ROI de branding"
 
 tags:
-  - financial-intelligence
+  - squad-finance
   - profitability
   - pricing
   - budgeting
@@ -209,3 +201,20 @@ tags:
   - cost-optimization
   - agency-finance
   - p-and-l
+
+# === GERADO por scripts/build-manifest.js — NAO EDITAR ===
+generated:
+  agents_total: 5
+  agents_iron: 5
+  agents_xq: 0
+  tasks: 45
+  knowledge_bases: 21
+  workflows: 4
+  templates: 4
+  checklists: 3
+  agents:
+    - { id: budget-controller, layer: iron, role: specialist, orchestrated_by: finance-orqx }
+    - { id: finance-orqx, layer: iron, role: orchestrator, orchestrated_by: finance-orqx }
+    - { id: pricing-strategist, layer: iron, role: specialist, orchestrated_by: finance-orqx }
+    - { id: profitability-analyst, layer: iron, role: specialist, orchestrated_by: finance-orqx }
+    - { id: revenue-analyst, layer: iron, role: specialist, orchestrated_by: finance-orqx }

package/squads/squad-growth/README.md

@@ -2,6 +2,12 @@
 
 > Squad de Growth Analytics — orquestra analytics engineering, CRO, experimentacao, SEO, data analysis e growth engineering para maximizar crescimento mensuravel. Toda decisao e data-driven, toda acao e rastreavel, todo resultado e atribuivel.
 
+<!-- gen:start -->
+| camada | agentes | tasks | KBs | workflows | templates | checklists |
+|---|---|---|---|---|---|---|
+| iron 7 · xq 0 | 7 | 77 | 23 | 6 | 6 | 3 |
+<!-- gen:end -->
+
 ## Visao Geral
 
 | Metrica | Quantidade |
@@ -25,7 +31,16 @@
 
 ## Ativacao
 
-```bash
+Você entra por aqui, pedindo em português ao Claude Code:
+
+```
+"usa o iron-growth"
+```
+
+Os nomes com `@` abaixo são **papéis internos** deste squad — quem os aciona é o
+orquestrador, não você. Não são comandos de barra nem menções que você digita.
+
+```
 # Via orquestrador (recomendado)
 @growth-orqx
 
@@ -84,11 +99,8 @@
 
 ## Integracao com Core Agents
 
-Este squad trabalha com o framework SINAPSE core:
-- @architect (Aria) para decisoes tecnicas
-- @developer (Dex) para implementacao
-- @quality-gate (Quinn) para validacao de qualidade
+Este squad é orquestrado pelo `iron-ceo`, que abre o orquestrador do squad em `~/.iron/<squad>/agents/<squad>-orqx.md`.
 
 ---
 
-*Parte do ecossistema SINAPSE-AI — 18 squads, 186 agentes*
+Parte do ecossistema Iron Edge

package/squads/squad-growth/agents/ga-analytics-engineer.md

@@ -1,3 +1,12 @@
+---
+id: ga-analytics-engineer
+layer: iron
+role: specialist
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: sonnet
+---
+
 # Agent: Signal — Analytics Architecture & Tracking Engineer
 
 ## Identidade

package/squads/squad-growth/agents/ga-campaign-analyst.md

@@ -1,3 +1,12 @@
+---
+id: ga-campaign-analyst
+layer: iron
+role: specialist
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: sonnet
+---
+
 # Agent: Pulse — Campaign Analytics & Channel Attribution
 
 ## Identidade

package/squads/squad-growth/agents/ga-cro-specialist.md

@@ -1,3 +1,12 @@
+---
+id: ga-cro-specialist
+layer: iron
+role: specialist
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: sonnet
+---
+
 # Agent: Convert — CRO & Experimentation Specialist
 
 ## Identidade

package/squads/squad-growth/agents/ga-data-analyst.md

@@ -1,3 +1,12 @@
+---
+id: ga-data-analyst
+layer: iron
+role: specialist
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: sonnet
+---
+
 # Agent: Insight — Data Analysis & Business Intelligence
 
 ## Identidade

package/squads/squad-growth/agents/ga-growth-hacker.md

@@ -1,3 +1,12 @@
+---
+id: ga-growth-hacker
+layer: iron
+role: specialist
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: sonnet
+---
+
 # Agent: Lever — Growth Engineering & Activation
 
 ## Identidade

package/squads/squad-growth/agents/ga-seo-strategist.md

@@ -1,3 +1,12 @@
+---
+id: ga-seo-strategist
+layer: iron
+role: specialist
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: sonnet
+---
+
 # Agent: Rank — SEO Strategy & Technical SEO
 
 ## Identidade

package/squads/squad-growth/agents/growth-orqx.md

@@ -1,3 +1,12 @@
+---
+id: growth-orqx
+layer: iron
+role: orchestrator
+orchestrated_by: growth-orqx
+squad: squad-growth
+model: opus
+---
+
 # Agent: Catalyst — Growth Orchestrator
 
 ## Identidade
@@ -14,7 +23,7 @@ Orquestrador do squad de Growth Analytics. Coordena todos os agentes, classifica
 1. Classificar maturidade de analytics do projeto (Level 0-4)
 2. Criar growth brief com North Star Metric e AARRR framework
 3. Selecionar workflow adequado (instrumentacao, CRO, SEO, campanha)
-4. Orquestrar pipeline entre os 6 agentes especializados
+4. Orquestrar pipeline entre os agentes especializados
 5. Conduzir quality gate de data quality (tracking accuracy >= 98%)
 6. Gerenciar handoffs cross-squad (inbound/outbound)
 7. Conduzir growth retrospective com learnings consolidados
@@ -39,7 +48,7 @@ Orquestrador do squad de Growth Analytics. Coordena todos os agentes, classifica
 ## Cross-Squad Delegation
 - **Paid media requests** (Meta Ads, Google Ads, CRO for paid traffic) → delegate to squad-paidmedia via `/pm:agents:paidmedia-orqx`
 - **Copy A/B tests** → coordinate with squad-copy via `/copywriting:agents:copy-strategist`
-- **UX experiments** → coordinate with squad-design via `/digital-experience:agents:design-orqx`
+- **UX experiments** → coordinate with squad-design via `@design-orqx` (squad-design)
 - **Pricing experiments** → delegate to squad-finance via `/finance:agents:finance-orqx`
 
 ## Cross-Squad Handoffs
@@ -80,7 +89,7 @@ Orquestrador do squad de Growth Analytics. Coordena todos os agentes, classifica
 | `instrumentation-first` | Setup tracking & analytics from scratch | Signal, Insight |
 | `cro-optimization` | Conversion rate optimization cycle | Convert, Lever |
 | `seo-acceleration` | Organic growth strategy | Rank, Insight |
-| `growth-campaign` | Full growth campaign (plan → execute → measure) | All 6 agents |
+| `growth-campaign` | Full growth campaign (plan → execute → measure) | All the squad agents |
 | `experimentation-sprint` | 2-week A/B testing sprint | Convert, Lever, Insight |
 | `analytics-audit` | Audit existing analytics setup | Signal, Insight, Catalyst |
 
@@ -98,5 +107,5 @@ Orquestrador do squad de Growth Analytics. Coordena todos os agentes, classifica
 
 ## Escalation
 
-- **Escalates to:** @sinapse-orqx (Imperator) para coordenacao cross-squad, decisoes arquiteturais ou escalacoes alem do escopo da squad
-- **Receives from:** @sinapse-orqx quando o ecossistema Sinapse roteia demandas de growth/analytics para esta squad
+- **Escalates to:** @iron-ceo (Imperator) para coordenacao cross-squad, decisoes arquiteturais ou escalacoes alem do escopo da squad
+- **Receives from:** @iron-ceo quando o ecossistema Iron Edge roteia demandas de growth/analytics para esta squad