iron-edge 1.0.0

package/squads/squad-brand/knowledge-base/routing-catalog.md

@@ -0,0 +1,65 @@
+# Routing Catalog — Brand System
+
+Maps keywords and domains to specialist agents for intelligent routing.
+
+<!-- TODO: expand content -->
+
+## Domain Routing Matrix
+
+| Domain | Keywords | Primary Agent | Secondary Agent |
+|--------|----------|--------------|-----------------|
+| Brand equity & measurement | brand equity, brand value, brand loyalty, brand awareness, equity model | brand-system-architect | brand-auditor |
+| Brand identity & DNA | brand identity, identity prism, brand DNA, brand personality, brand culture, brand essence | brand-identity-designer | brand-system-architect |
+| Brand positioning | positioning, category, focus, differentiation, competitive position, category creation | brand-strategist | brand-identity-designer |
+| Visual identity | logo, visual identity, brand guidelines, design system, brand elements, brand manual | brand-identity-designer | brand-collateral-designer |
+| Brand culture & employer brand | brand culture, employer brand, internal brand, employee experience, culture alignment | brand-culture-architect | brand-strategist |
+| Brand architecture | brand architecture, sub-brands, branded house, house of brands, portfolio, brand hierarchy | brand-system-architect | brand-strategist |
+| Brand naming | naming, brand name, rename, name generation, nomenclature | brand-strategist | brand-identity-designer |
+| Brand archetypes | archetype, brand personality, brand character, Jung, hero, rebel, sage | brand-strategist | brand-culture-architect |
+| Brand storytelling | brand story, narrative, founder story, origin story, manifesto | brand-creative-engineer | brand-culture-architect |
+| Brand motion & VFX | motion, animation, brand video, visual effects, motion graphics | brand-motion-vfx | brand-creative-engineer |
+| Brand sonic identity | sonic branding, sound, jingle, audio logo, brand music | brand-sonic-designer | brand-identity-designer |
+| Brand growth | brand growth, brand performance, brand metrics, brand ROI, growth strategy | brand-growth-strategist | brand-auditor |
+| Brand audit | brand audit, brand health, brand consistency, brand compliance | brand-auditor | brand-system-architect |
+| Brand collateral | collateral, brand materials, presentations, templates, social media assets | brand-collateral-designer | brand-identity-designer |
+| Brand compilation | brand book, brand bible, brand guidelines compilation, brand deliverable | brand-compiler | brand-system-architect |
+
+## Usage Notes
+
+- Route to the **Primary Agent** by default for each domain.
+- Use the **Secondary Agent** when the primary is overloaded or when the request spans multiple domains.
+- For requests that span multiple domains, the orchestrator (brand-orqx) coordinates handoffs.
+
+---
+
+## Knowledge Base Index (atualizado 2026-04-10)
+
+| KB File | Cobre |
+|---------|-------|
+| `brand-strategy-frameworks-catalog.md` | Golden Circle, Aaker Equity/Identity, Ries Positioning, Kapferer Prism, Jennifer Aaker 5 Dimensions, BAV PowerGrid, Keller CBBE, Douglas Holt Cultural Branding, Byron Sharp, 5 Eras, Brand Promise |
+| `brand-valuation-frameworks.md` | Cost/Market/Income-based valuation, Interbrand/BrandZ/Brand Finance methodologies, NPS benchmarks, Brand Tracking, marca como ativo |
+| `brand-audit-criteria.md` | 5 dimensoes, BCS scoring, BAV PowerGrid diagnostico, Brand Tracking Studies, touchpoint audit |
+| `archetype-brand-mapping.md` | 12 arquetipos (Jung/Mark&Pearson), design system mapping, combinacoes |
+| `brand-experience-bx.md` | Customer Journey Map, touchpoints audit, sensory branding, spatial branding, PLG, D2C, communities |
+| `brand-rebranding-framework.md` | Decisao refresh vs rebrand, 5 fases, casos (Apple, Burberry, Old Spice, Twitter→X, Tropicana, Gap) |
+| `brand-activism-cultural-branding.md` | Douglas Holt, cultural branding model, brand storytelling, brand mythology, brand activism, purpose vs wokewashing |
+| `brand-naming-framework.md` | SMILE/SCRATCH (Alexandra Watkins), tipos de nomes, processo estruturado, naming tech, due diligence legal |
+| `brand-legal-ip.md` | INPI processo e custos, Protocolo de Madrid, USPTO/EUIPO, domain strategy, handle strategy, monitoring |
+| `employer-personal-branding.md` | EVP, Glassdoor/LinkedIn employer brand, internal branding, thought leadership, LinkedIn personal brand, Hub&Spoke |
+| `brand-digital-strategy.md` | Marca em redes sociais, SaaS brand excellence, marketplace brand, PLG, D2C, creator economy, SEO como marca |
+| `brazilian-branding-context.md` | Rankings Interbrand BR, agencias (Ana Couto, FutureBrand, CBA B+G), Alexandre Wollner, CONAR 2025, nuances culturais |
+| `sonic-branding-principles.md` | Audio logo specs, sonic DNA, UI sounds, specs tecnicas, exemplos iconicos |
+| `color-psychology.md` | Significados por cor, nuances brasileiras, sistemas de cor, arquetipos, WCAG |
+| `typography-personality.md` | Classificacao tipografica, arquetipos, type scale, pairing, fontes proprietarias de grandes marcas |
+| `archetype-brand-mapping.md` | 12 arquetipos completos com design system mapping |
+| `gestalt-principles.md` | Principios perceptivos aplicados a branding |
+| `cultural-brand-adaptation.md` | Hofstede, Erin Meyer, glocal model, cores por cultura, compliance regulatorio |
+| `brandbook-structure.md` | Estrutura 10 secoes, formatos de entrega, niveis (Essentials/System/Universe) |
+| `design-system-patterns.md` | 3-nivel tokens, dark mode, componentes |
+| `brand-audit-criteria.md` | Full audit framework, BCS score, BAV diagnostic, tracking |
+| `illustration-styles.md` | Estilos de ilustracao |
+| `photography-styles.md` | Direcao fotografica |
+| `3d-render-styles.md` | Estilos de render 3D |
+| `delivery-formats.md` | Formatos de entrega de assets |
+| `ai-api-capabilities.md` | Capacidades de IA para branding |
+| `product-categories.md` | Categorias de produtos |

package/squads/squad-brand/knowledge-base/sonic-branding-principles.md

@@ -0,0 +1,180 @@
+# Sonic Branding Principles — Knowledge Base
+
+> Fundamentos de identidade sonora e branding auditivo.
+
+---
+
+## 1. O Que É Sonic Branding
+
+Sonic branding é o uso estratégico de som para criar reconhecimento e conexão emocional com uma marca. Na Era da Experiencia (2015-presente), com a explosao de podcasts, assistentes de voz (Alexa, Siri, Google Assistant) e ambientes sem tela, identidade sonora tornou-se estrategica — nao opcional.
+
+**Martin Lindstrom** ("Brand Sense", 2005): marcas que engajam multiplos sentidos criam conexoes emocionais 70% mais fortes.
+
+Componentes:
+- **Audio logo** — Assinatura sonora (ex: Intel bong, Netflix ta-dum)
+- **Sonic DNA** — Padrão melódico/rítmico que permeia toda a marca
+- **UI sounds** — Sons de interface (notificações, confirmações)
+- **Audio beds** — Música de fundo para conteúdo
+- **Voice guidelines** — Tom e estilo de voz humana/sintetizada
+- **Hold music / podcast intro** — Oportunidades frequentemente desperdicadas
+
+---
+
+## 2. Elementos Sonoros
+
+### 2.1 Audio Logo
+| Característica | Guideline |
+|---------------|-----------|
+| Duração | 1-4 segundos (ideal: 2-3s) |
+| Notas | 3-7 notas (simplicidade = memorabilidade) |
+| Reconhecimento | Deve ser identificável em 1-2 exposições |
+| Versões | Curta (1s), padrão (2-3s), estendida (5-8s) |
+| Formatos | WAV 48kHz/24bit (master), MP3 320kbps, AAC 256kbps |
+
+### 2.2 Sonic DNA
+- **Definição:** Fragmento musical de 3-5 notas que carrega a essência sonora
+- **Uso:** Base para todas as peças sonoras da marca
+- **Flexibilidade:** Pode ser tocado em diferentes instrumentos, tempos e contextos
+- **Consistência:** Intervalo melódico e ritmo core devem ser preservados
+
+### 2.3 UI Sounds
+| Som | Duração | Propósito | Característica |
+|-----|---------|-----------|----------------|
+| Success | 300-600ms | Confirmação positiva | Tom ascendente, major |
+| Error | 300-500ms | Erro/falha | Tom descendente, menor tensão |
+| Warning | 400-700ms | Atenção necessária | Suspense, sem resolução |
+| Notification | 200-500ms | Nova mensagem/alerta | Distinto, não intrusivo |
+| Loading complete | 300-500ms | Tarefa finalizada | Resolução satisfatória |
+| Click/tap | 50-150ms | Feedback de interação | Sutil, tátil |
+
+### 2.4 Audio Beds
+| Mood | Tempo (BPM) | Instrumentação | Uso |
+|------|-------------|----------------|-----|
+| Inspiracional | 100-120 | Strings, piano, pads | Hero videos, about us |
+| Energético | 120-140 | Beats, synths, guitar | Promos, launches |
+| Calmo/Trust | 60-80 | Ambient pads, acoustic | Onboarding, support |
+| Sofisticado | 80-100 | Jazz elements, minimal | Premium content |
+| Tecnológico | 90-110 | Electronic, glitch, minimal | Product demos, tech |
+
+---
+
+## 3. Mapeamento Personalidade → Som
+
+### Por Arquétipo
+| Arquétipo | Instrumentos | Tonalidade | Tempo | Textura |
+|-----------|-------------|------------|-------|---------|
+| Inocente | Ukulele, glockenspiel, flauta | Major, bright | Moderado | Light, airy |
+| Explorador | Drums étnicos, guitar acústica | Mixolydian | Variado | Organic, raw |
+| Sábio | Piano, cello, ambient | Minor/modal | Lento-moderado | Deep, layered |
+| Herói | Brass, drums, power chords | Major, heroic | Rápido | Bold, powerful |
+| Fora-da-lei | Distortion guitar, bass pesado | Minor, blues | Médio-rápido | Raw, gritty |
+| Mago | Synths, harp, chimes | Diminished, suspended | Variado | Ethereal, mysterious |
+| Cara Comum | Acoustic guitar, handclaps | Major simples | Moderado | Warm, simple |
+| Amante | Saxophone, strings, piano | Minor sensual | Lento | Smooth, warm |
+| Bobo | Kazoo, marimba, percussão fun | Major, pentatonic | Rápido | Playful, bouncy |
+| Cuidador | Acoustic, music box, pads | Major suave | Lento | Gentle, warm |
+| Criador | Piano, eclectic mix | Variada | Variado | Textured, unique |
+| Governante | Orchestra, timpani, brass | Major grandioso | Moderado | Grand, authoritative |
+
+### Por Atributo de Marca
+| Atributo | Tradução Sonora |
+|----------|----------------|
+| Confiável | Tons graves, harmonia estável, resolução clara |
+| Inovador | Texturas eletrônicas, intervalos inesperados |
+| Luxuoso | Reverb longo, instrumentos acústicos premium, silêncio |
+| Acessível | Melodia simples, tons médios, ritmo constante |
+| Disruptivo | Glitch, síncope, sons não-convencionais |
+| Humano | Instrumentos acústicos, imperfeições sutis |
+
+---
+
+## 4. Especificações Técnicas
+
+### Formato Master
+- **Sample rate:** 48kHz (vídeo) ou 44.1kHz (áudio puro)
+- **Bit depth:** 24-bit
+- **Formato:** WAV (lossless)
+- **Loudness:** -14 LUFS (streaming standard)
+- **True peak:** < -1 dBTP
+
+### Formatos de Entrega
+| Plataforma | Formato | Bitrate | Notas |
+|------------|---------|---------|-------|
+| Master | WAV 48kHz/24bit | Lossless | Arquivo original |
+| Web | MP3 | 320kbps | Compatibilidade universal |
+| Mobile | AAC | 256kbps | iOS nativo |
+| Streaming | OGG Vorbis | 320kbps | Web alternative |
+| Podcast | MP3 | 192kbps | Voz otimizada |
+
+### Loop Requirements
+- **Seamless:** Crossfade no loop point (50-200ms)
+- **Durações padrão:** 15s, 30s, 60s, 120s
+- **Teste:** Mínimo 3 loops consecutivos sem "click" audível
+
+---
+
+## 5. Acessibilidade Sonora
+
+### Princípios
+1. **Nunca depender apenas de som** para comunicar informação crítica
+2. **Sempre oferecer alternativa visual** para feedback sonoro
+3. **Volume ajustável** pelo usuário
+4. **Respeitar configurações do sistema** (silent mode, do not disturb)
+
+### Frequências Acessíveis
+- **Evitar:** Frequências acima de 12kHz (perda auditiva por idade)
+- **Preferir:** Faixa 200Hz-4kHz para máxima percepção
+- **UI sounds:** Manter entre 500Hz-3kHz
+
+### Duração e Repetição
+- **Alarmes:** Máximo 3 repetições, depois silenciar
+- **Notificações:** Única execução, não repetir
+- **Feedback:** Instantâneo (< 100ms de latência)
+
+---
+
+## 6. Processo de Criação
+
+### Etapas
+1. **Brand Analysis** — Mapear personalidade, valores, arquétipo
+2. **Sonic Moodboard** — 10-15 referências sonoras de marcas admiradas
+3. **Sonic DNA** — Definir fragmento melódico core (3-5 notas)
+4. **Audio Logo** — Criar 3 versões a partir do Sonic DNA
+5. **UI Sounds** — Derivar sons de interface do DNA
+6. **Audio Beds** — Criar moods baseados na paleta sonora
+7. **Testing** — Testar em 5+ dispositivos, A/B com público
+8. **Documentation** — Regras de uso, formatos, licenciamento
+
+### Critérios de Avaliação
+| Critério | Peso | Descrição |
+|----------|------|-----------|
+| Memorabilidade | 25% | Reconhecível após 2-3 exposições |
+| Distinção | 20% | Diferente de concorrentes |
+| Flexibilidade | 20% | Funciona em múltiplos contextos |
+| Conexão emocional | 15% | Evoca sentimento alinhado à marca |
+| Simplicidade | 10% | Fácil de reproduzir/cantarolar |
+| Atemporalidade | 10% | Não preso a tendência sonora |
+
+---
+
+## 7. Exemplos Icônicos
+
+| Marca | Audio Logo | Notas | Por que funciona |
+|-------|-----------|-------|------------------|
+| Intel | 5 notas ascendentes | D-D-G-D-A | Memorável, tecnológico, otimista |
+| Netflix | Ta-dum | 2 notas + reverb | Anticipação, cinematográfico |
+| McDonald's | I'm Lovin' It | 5 notas melódicas | Cantável, universal, alegre |
+| Apple | Startup chime | Acorde C major | Clean, harmonioso, confiável |
+| NBC | 3 notas | G-E-C | Simples, broadcast, autoritário |
+| T-Mobile | 5 notas | Jingle reconhecível | Vibrante, acessível |
+
+---
+
+## 8. DON'Ts
+
+- Copiar ou imitar audio logos existentes
+- Usar mais de 7 notas no audio logo
+- Criar sons UI que são incômodos ou estressantes
+- Ignorar teste em dispositivos de baixa qualidade (celular speaker)
+- Mudar o audio logo com frequência (mínimo 5 anos de uso)
+- Competir com voz humana no volume (audio beds -6dB sob voz)

package/squads/squad-brand/knowledge-base/typography-personality.md

@@ -0,0 +1,90 @@
+# Typography Personality — Knowledge Base
+
+## Classificacao Tipografica
+
+| Classe | Personalidade | Quando Usar | Exemplos |
+|--------|--------------|-------------|----------|
+| **Serif** | Tradicao, confianca, elegancia, autoridade | Marcas premium, financeiras, editoriais | Times, Georgia, Playfair Display, Lora |
+| **Sans-serif** | Moderno, limpo, acessivel, tech | Marcas tech, startups, minimalistas | Inter, Helvetica, Roboto, Montserrat |
+| **Slab Serif** | Forte, confiavel, industrial, friendly | Marcas robustas, construccao, food | Rockwell, Roboto Slab, Zilla Slab |
+| **Mono** | Tecnico, codigo, dados, precision | Tech, dados, documentacao tecnica | JetBrains Mono, Fira Code, Source Code |
+| **Display** | Impacto, unico, expressivo | Headlines, logos, hero text APENAS | Oswald, Bebas Neue, custom fonts |
+| **Script** | Elegante, pessoal, feminino, artesanal | Luxury, beauty, weddings, artesanal | Pacifico, Great Vibes, Dancing Script |
+| **Handwritten** | Autentitico, casual, humano | Marcas jovens, artesanais, pessoais | Caveat, Patrick Hand, Indie Flower |
+
+## Mapeamento Arquetipo → Tipografia
+
+| Arquetipo | Display | Body | Mood |
+|-----------|---------|------|------|
+| Inocente | Rounded sans-serif | Light sans-serif | Friendly, simple |
+| Explorador | Bold condensed | Geometric sans | Adventurous, direct |
+| Sabio | Classic serif | Readable serif | Intellectual, trustworthy |
+| Heroi | Heavy bold sans | Strong sans-serif | Powerful, bold |
+| Fora-da-Lei | Distressed/grunge | Edgy sans-serif | Rebellious, raw |
+| Mago | Elegant serif | Refined sans | Mystical, premium |
+| Governante | High-contrast serif | Conservative serif/sans | Authoritative, premium |
+| Criador | Unique display | Modern sans | Creative, unique |
+| Amante | Script or thin serif | Elegant serif | Romantic, refined |
+
+## Type Scale Ratios
+
+| Nome | Ratio | Uso |
+|------|-------|-----|
+| Minor Second | 1.067 | Muito compacto, tables |
+| Major Second | 1.125 | Compacto, apps mobile |
+| Minor Third | 1.200 | Balanceado, web geral |
+| Major Third | 1.250 | Classico, versatil |
+| Perfect Fourth | 1.333 | Dramatic, editorial |
+| Augmented Fourth | 1.414 | Bold, impactful |
+| Perfect Fifth | 1.500 | Grande contraste |
+| Golden Ratio | 1.618 | Harmonico, classico |
+
+**Exemplo (Major Third 1.250, base 16px):**
+- h1: 48.83px | h2: 39.06px | h3: 31.25px | h4: 25px | h5: 20px | h6: 16px | body: 16px | small: 12.8px | caption: 10.24px
+
+## Font Pairing Rules
+1. **Contraste:** serif display + sans body (ex: Playfair + Inter)
+2. **Concordancia:** mesma familia em weights diferentes (ex: Roboto Bold + Roboto Regular)
+3. **EVITAR conflito:** duas fontes similares mas diferentes (ex: Arial + Helvetica)
+4. **Max 3 fontes:** display + body + accent (mono optional)
+
+## Web Performance
+- Subsetting: remover glyphs nao usados (latin-ext se nao precisa de acentos especiais)
+- font-display: swap (previne FOIT)
+- Preload: `<link rel="preload" href="font.woff2" as="font" crossorigin>`
+- Variable fonts: 1 arquivo vs multiplos weights (economia de 60%+)
+- Fallback stack: `font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;`
+
+## Fontes Customizadas de Grandes Marcas
+
+Marcas de grande porte criam fontes proprietarias para diferenciacao maxima. Custo: US$ 50K-500K+.
+
+| Marca | Fonte Proprietaria | Caracteristica |
+|-------|-------------------|---------------|
+| Apple | San Francisco (SF Pro) | Sistema, clean, legibilidade extrema |
+| Google | Google Sans (Product Sans) | Geometric, acessivel, moderna |
+| Netflix | Netflix Sans | Economica em espaco, legivel em TV |
+| Samsung | SamsungOne | Global, multi-script |
+| IBM | IBM Plex | Open source, corporativa + humana |
+| Airbnb | Cereal | Amigavel, distintiva, moderna |
+| Spotify | Circular | Geometric, energica, moderna |
+
+## Pairing Recomendado por Caso de Uso
+
+| Caso | Display | Body | Justificativa |
+|------|---------|------|--------------|
+| Startup tech moderna | Space Grotesk | Inter | Tech + legivel |
+| Marca editorial premium | Playfair Display | Source Sans Pro | Heritage + acessivel |
+| Luxury / fashion | Cormorant Garamond | Lato Light | Elegancia + modernidade |
+| Marca jovem/energica | Montserrat Bold | Open Sans | Impacto + leitura |
+| Developer / tech B2D | JetBrains Mono | Inter | Credibilidade tecnica |
+
+## Classificacao por Personalidade (Kapferer/Aaker)
+
+| Dimensao de Personalidade (Jennifer Aaker) | Tipografia Recomendada |
+|------------------------------------------|----------------------|
+| Sincerity (Dove, Natura) | Rounded sans-serif, humanista |
+| Excitement (Nike, Red Bull) | Bold condensed, display energica |
+| Competence (McKinsey, Volvo) | Serif classica ou sans-serif geometrica neutra |
+| Sophistication (Chanel, Rolex) | Serif elegante, alto contraste, thin weight |
+| Ruggedness (Jeep, Harley-Davidson) | Slab serif, display industrial, condensed bold |

package/squads/squad-brand/preferences/README.md

@@ -0,0 +1,16 @@
+# Preferences Directory
+
+> Diretorio para logs de preferencias por projeto/cliente.
+> Atualizado automaticamente pelo brand-auditor (Sentinel) via task `update-brand-preferences`.
+
+## Como usar
+
+1. Para cada novo projeto, criar uma copia de `templates/preference-log-template.md`
+2. Nomear como `{projeto}-preferences.md` (ex: `astro-preferences.md`)
+3. Sentinel atualiza apos cada ciclo de aprovacao
+4. Todos os agents consultam antes de iniciar nova entrega
+
+## Arquivos
+
+- `README.md` — Este arquivo
+- `{projeto}-preferences.md` — Um arquivo por projeto ativo