sinapse-ai 9.3.0 → 9.5.0

package/squads/squad-artdir/squad.yaml

@@ -0,0 +1,271 @@
+name: squad-artdir
+version: "2.0.0"
+description: >
+  Art direction for retention, conversion AND platform premium packaging.
+  v1.0 was born for landing pages. v2.0 extends the framework from 7 to 10
+  Pillars to cover SaaS platforms, logged-in product surfaces, multi-surface
+  design systems, and premium packaging that justifies 3x pricing. The core
+  principle is unchanged: every pixel carries behavioral intent, every
+  aesthetic decision is justified by a psychological principle and measured
+  by either conversion (LP) or retention + perceived value (Platform).
+author: Caio Imori
+license: MIT
+slashPrefix: SINAPSE
+
+metadata:
+  created_at: "2026-04-10"
+  updated_at: "2026-04-12"
+  created_by: "squad-creator (Craft)"
+  expanded_by: "sinapse-orqx (Imperator) via EPIC-artdir-v2"
+  agents_count: 14
+  tasks_count: 13
+  knowledge_bases_count: 8
+  workflows_count: 3
+  checklists_count: 1
+  templates_count: 1
+
+agents:
+  # ═══════════════════════════════════════════════════════════════════════════
+  # v1.0 CORE (10 agents — LP-focused, preserved verbatim)
+  # ═══════════════════════════════════════════════════════════════════════════
+
+  - id: artdir-orqx
+    name: Canvas
+    file: agents/artdir-orqx.md
+    role: "Orquestrador — coordena os 10 pilares, roteia briefings (LP vs Platform), entrega os deliverables padrao"
+    tasks:
+      - create-art-direction-brief
+      - validate-against-pillars
+
+  - id: visual-strategist
+    name: Prism
+    file: agents/visual-strategist.md
+    role: "Define linguagem visual, mood, posicionamento estetico baseado em audiencia e categoria"
+    tasks:
+      - diagnose-visual-language
+      - create-art-direction-brief
+
+  - id: motion-architect
+    name: Tempo
+    file: agents/motion-architect.md
+    role: "Sistema de motion — timing, easing, selecao de lib, performance, Disney 12 principles"
+    tasks:
+      - specify-motion-system
+
+  - id: type-systemist
+    name: Kern
+    file: agents/type-systemist.md
+    role: "Type scale, font pairing, tracking, hierarquia tipografica, fluid typography, custom type (premium)"
+    tasks:
+      - create-art-direction-brief
+
+  - id: color-psychologist
+    name: Spectrum
+    file: agents/color-psychologist.md
+    role: "Sistemas de cor justificados por neurociencia, WCAG AAA, Von Restorff, emotion mapping"
+    tasks:
+      - design-color-system
+
+  - id: layout-engineer
+    name: Grid
+    file: agents/layout-engineer.md
+    role: "Grids, spacing, full-bleed vs contained, responsividade, container queries"
+    tasks:
+      - create-wireflow
+
+  - id: ia-architect
+    name: Flow
+    file: agents/ia-architect.md
+    role: "Arquitetura de informacao para retencao cognitiva — disclosure, Zeigarnik, curiosity gaps"
+    tasks:
+      - create-wireflow
+      - audit-conversion
+
+  - id: cro-persuasion
+    name: Convert
+    file: agents/cro-persuasion.md
+    role: "Padroes de conversao — comparison tables, social proof, scarcity, risk reversal, sticky bars"
+    tasks:
+      - audit-conversion
+
+  - id: interaction-designer
+    name: Pulse
+    file: agents/interaction-designer.md
+    role: "Hover states, micro-interactions, feedback loops, custom cursors, prefers-reduced-motion"
+    tasks:
+      - specify-motion-system
+
+  - id: accessibility-guardian
+    name: Shield
+    file: agents/accessibility-guardian.md
+    role: "WCAG AAA, prefers-reduced-motion, contraste, HTML semantico, keyboard nav, ARIA, focus"
+    tasks:
+      - validate-against-pillars
+
+  # ═══════════════════════════════════════════════════════════════════════════
+  # v2.0 EXPANSION (4 agents — Platform / SaaS / Premium Packaging)
+  # ═══════════════════════════════════════════════════════════════════════════
+
+  - id: product-surface-director
+    name: Axiom
+    file: agents/product-surface-director.md
+    role: "Art direction de surfaces logadas — dashboards, empty states, data density, dark mode parity, choreographia de onboarding. Pilar 8."
+    tasks:
+      - design-product-surface
+      - first-5-minutes-choreography
+
+  - id: design-system-architect
+    name: Atlas
+    file: agents/design-system-architect.md
+    role: "Multi-surface design system — canonical tokens, surface dialects, semver, ownership, quarterly drift audit. Pilar 9."
+    tasks:
+      - design-token-system
+      - audit-drift-multi-surface
+
+  - id: platform-aesthetic-director
+    name: Vertex
+    file: agents/platform-aesthetic-director.md
+    role: "Custodiante do canon de SaaS premium (Linear/Vercel/Stripe/Framer/Arc/Raycast). Lens nos Pilares 8, 9, 10. Previne commodity contamination."
+    tasks:
+      - consult-saas-canon
+
+  - id: premium-packaging-strategist
+    name: Aura
+    file: agents/premium-packaging-strategist.md
+    role: "Traduz 'cobrar 3x mais' em decisoes estheticas concretas. Aplica os 5 principios nao-negociaveis. Pilar 10."
+    tasks:
+      - create-premium-packaging-brief
+      - first-5-minutes-choreography
+
+# ═══════════════════════════════════════════════════════════════════════════
+# KNOWLEDGE BASES — v1.0 (5) + v2.0 (2) = 7
+# ═══════════════════════════════════════════════════════════════════════════
+
+knowledge_bases:
+  - name: seven-pillars-framework
+    file: knowledge-base/seven-pillars-framework.md
+    description: "Os 7 pilares originais (v1.0) — preservado verbatim, canon LP"
+  - name: ten-pillars-framework
+    file: knowledge-base/ten-pillars-framework.md
+    description: "v2.0 extension — 10 pilares com applicability matrix LP vs Platform"
+  - name: psychological-toolkit
+    file: knowledge-base/psychological-toolkit.md
+    description: "Arsenal psicologico — 10 vieses cognitivos, 6 principios de retencao, 6 leis UX, 7 Gestalt"
+  - name: case-nyo-ia-reference
+    file: knowledge-base/case-nyo-ia-reference.md
+    description: "Analise completa do nyo.ia.br como referencia canonica de art direction para LP de conversao"
+  - name: saas-art-direction-canon
+    file: knowledge-base/saas-art-direction-canon.md
+    description: "v2.0 — Canon de 6 refs premium (Linear, Vercel, Stripe, Framer, Arc, Raycast) decomposto em 5 dimensoes"
+  - name: premium-packaging-principles
+    file: knowledge-base/premium-packaging-principles.md
+    description: "v2.0 — Os 5 principios nao-negociaveis de premium packaging (council-orqx pressurization)"
+  - name: motion-technique-catalog
+    file: knowledge-base/motion-technique-catalog.md
+    description: "Catalogo de tecnicas de motion com lib, easing, duracao e regras de performance"
+  - name: deliverables-templates
+    file: knowledge-base/deliverables-templates.md
+    description: "Templates dos 8 deliverables padrao da squad"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# TASKS — v1.0 (7) + v2.0 (6) = 13
+# ═══════════════════════════════════════════════════════════════════════════
+
+tasks:
+  # v1.0
+  - name: create-art-direction-brief
+    file: tasks/create-art-direction-brief.md
+  - name: diagnose-visual-language
+    file: tasks/diagnose-visual-language.md
+  - name: design-color-system
+    file: tasks/design-color-system.md
+  - name: specify-motion-system
+    file: tasks/specify-motion-system.md
+  - name: create-wireflow
+    file: tasks/create-wireflow.md
+  - name: audit-conversion
+    file: tasks/audit-conversion.md
+  - name: validate-against-pillars
+    file: tasks/validate-against-pillars.md
+  # v2.0
+  - name: design-product-surface
+    file: tasks/design-product-surface.md
+  - name: design-token-system
+    file: tasks/design-token-system.md
+  - name: audit-drift-multi-surface
+    file: tasks/audit-drift-multi-surface.md
+  - name: create-premium-packaging-brief
+    file: tasks/create-premium-packaging-brief.md
+  - name: consult-saas-canon
+    file: tasks/consult-saas-canon.md
+  - name: first-5-minutes-choreography
+    file: tasks/first-5-minutes-choreography.md
+
+# ═══════════════════════════════════════════════════════════════════════════
+# WORKFLOWS — v1.0 (2) + v2.0 (1) = 3
+# ═══════════════════════════════════════════════════════════════════════════
+
+workflows:
+  - name: full-art-direction-cycle
+    file: workflows/full-art-direction-cycle.yaml
+    description: "v1.0 — Ciclo completo LP do briefing ao art direction brief validado contra 7 pilares"
+  - name: conversion-audit-cycle
+    file: workflows/conversion-audit-cycle.yaml
+    description: "v1.0 — Auditoria de conversao de site/LP existente"
+  - name: saas-platform-art-direction-cycle
+    file: workflows/saas-platform-art-direction-cycle.yaml
+    description: "v2.0 — Ciclo completo para SaaS/plataforma/produto logado aplicando os 10 Pilares (canon -> token system -> product surface -> first 5 minutes -> premium packaging -> drift audit -> validate)"
+
+checklists:
+  - name: seven-pillars-validation-checklist
+    file: checklists/seven-pillars-validation-checklist.md
+
+templates:
+  - name: art-direction-brief-template
+    file: templates/art-direction-brief-template.md
+
+# ═══════════════════════════════════════════════════════════════════════════
+# CROSS-SQUAD CONNECTIONS
+# ═══════════════════════════════════════════════════════════════════════════
+
+cross_squad_connections:
+  inbound:
+    - squad-brand: "Brand guidelines, identidade visual, paleta de cores, tom visual, root tokens para Atlas"
+    - squad-research: "Pesquisa de audiencia, analise de concorrentes, benchmarks de conversao, feeds para Vertex"
+    - squad-copy: "Copy strategy, headlines, microcopy, CTA labels"
+    - squad-product: "PRDs, roadmap de features, personas, fluxo de uso diario para Axiom"
+    - squad-council: "Pressurizacao estrategica (v2.0: fonte dos 5 principios de premium packaging)"
+    - squad-finance: "Pricing power, unit economics que justificam posicionamento premium (input para Aura)"
+  outbound:
+    - squad-design: "Art direction brief, design tokens (DDL completo do Atlas), motion spec, wireflow anotado, component spec"
+    - squad-animations: "Motion spec, easing curves, timing tokens, kinesthetic narrative, custom motion signatures"
+    - squad-content: "Hierarquia visual para conteudo, pacing de leitura"
+    - squad-growth: "CRO patterns map, hipoteses de impacto, metricas de conversao + retencao"
+    - squad-commercial: "Pricing page art direction, premium packaging brief"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# v2.0 CHANGELOG
+# ═══════════════════════════════════════════════════════════════════════════
+
+changelog:
+  - version: "2.0.0"
+    date: "2026-04-12"
+    type: "major — additive expansion"
+    epic: "EPIC-artdir-v2"
+    summary: >
+      Expansion from LP-only to full platform/SaaS art direction. Framework
+      extended from 7 to 10 Pillars. 4 new specialist agents (Axiom, Atlas,
+      Vertex, Aura). 6 new tasks. 2 new knowledge bases. 1 new workflow.
+      v1.0 agents and pillars preserved verbatim for backward compatibility.
+    additions:
+      - "4 new agents: product-surface-director (Axiom), design-system-architect (Atlas), platform-aesthetic-director (Vertex), premium-packaging-strategist (Aura)"
+      - "6 new tasks: design-product-surface, design-token-system, audit-drift-multi-surface, create-premium-packaging-brief, consult-saas-canon, first-5-minutes-choreography"
+      - "2 new KBs: saas-art-direction-canon, premium-packaging-principles"
+      - "1 new KB for framework: ten-pillars-framework (extends seven-pillars)"
+      - "1 new workflow: saas-platform-art-direction-cycle"
+    breaking_changes: []
+    backward_compat: "Full — all v1.0 components preserved"
+  - version: "1.0.0"
+    date: "2026-04-10"
+    type: "initial release"
+    summary: "Squad created for LP art direction with 7 Pillars, 10 agents, 7 tasks, 5 KBs, 2 workflows"

package/squads/squad-artdir/tasks/audit-conversion.md

@@ -0,0 +1,97 @@
+# Task: Audit Conversion
+
+## Metadata
+- **ID:** audit-conversion
+- **Version:** 1.0.0
+- **Agent:** cro-persuasion (Convert), ia-architect (Flow) contributes
+- **Squad:** squad-artdir
+
+## Description
+
+Audit an existing site or landing page against CRO patterns and suggest improvements. Produces a prioritized list of changes with impact hypotheses and effort estimates.
+
+## Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| url | string | required | URL to audit |
+| objective | string | required | Primary conversion objective |
+| current_metrics | object | optional | Current conversion rate, bounce rate, time on page, scroll depth |
+| audience | string | required | Target audience description |
+
+## Steps
+
+1. **capture-current-state**
+   - Fetch and analyze the URL
+   - Screenshot key sections
+   - Map current section sequence
+
+2. **audit-clarity** (Score 1-10)
+   - Is the value proposition clear in < 5 seconds?
+   - Is the CTA visible above the fold?
+   - Is the copy specific or generic?
+
+3. **audit-proof** (Score 1-10)
+   - Types of social proof present (logos, testimonials, numbers, UGC)
+   - Specificity of proof (names, photos, results vs anonymous)
+   - Verifiability (real handles vs generic)
+
+4. **audit-urgency** (Score 1-10)
+   - Is there a reason to act now?
+   - Scarcity elements (real or perceived)
+   - Time-bound offers
+
+5. **audit-friction** (Score 1-10)
+   - Number of clicks to convert
+   - Form length and complexity
+   - Loading speed and perceived performance
+
+6. **audit-risk** (Score 1-10)
+   - Are objections addressed?
+   - Risk reversal elements (guarantees, free trial, no CC)
+   - Trust signals (security badges, compliance)
+
+7. **audit-accessibility** (Score 1-10)
+   - CTA contrast and visibility
+   - Keyboard navigation to conversion
+   - Screen reader CTA accessibility
+
+8. **audit-mobile** (Score 1-10)
+   - Mobile conversion path clarity
+   - Touch target sizes
+   - Mobile-specific CTA visibility
+
+9. **identify-gaps**
+   - Cross-reference present patterns against full CRO catalog
+   - Identify missing high-impact patterns
+   - Identify patterns that exist but are poorly implemented
+
+10. **prioritize-recommendations**
+    - For each gap: estimate impact (metric + direction + magnitude)
+    - For each gap: estimate implementation effort (low/medium/high)
+    - Sort by impact/effort ratio
+    - Mark quick wins (high impact, low effort)
+
+11. **compile-audit**
+    - Overall CRO Score (average of 7 dimensions)
+    - Top 5 quick wins
+    - Top 5 strategic improvements
+    - Before/after descriptions for each recommendation
+
+## Outputs
+
+| Output | Type | Description |
+|--------|------|-------------|
+| audit_report | document | Complete CRO audit with scores and analysis |
+| dimension_scores | array | Score 1-10 for each audit dimension |
+| recommendations | array | Prioritized list of improvements with impact estimates |
+| quick_wins | array | Top 5 high-impact, low-effort changes |
+| overall_score | number | Average of dimension scores |
+
+## Quality Criteria
+
+- Every recommendation MUST include impact hypothesis (metric + direction + estimated %)
+- Every recommendation MUST include effort estimate (low/medium/high)
+- Missing patterns MUST be compared against the full CRO catalog
+- Quick wins MUST be actionable within 1 dev day
+- Scores MUST be justified with specific observations from the site

package/squads/squad-artdir/tasks/audit-drift-multi-surface.md

@@ -0,0 +1,55 @@
+# Task: Audit Drift (Multi-Surface Consistency Audit)
+
+## Metadata
+- **ID:** audit-drift-multi-surface
+- **Version:** 1.0.0
+- **Agent:** design-system-architect (Atlas) — primary
+- **Supporting agents:** platform-aesthetic-director (Vertex), premium-packaging-strategist (Aura)
+- **Squad:** squad-artdir
+- **Pilar:** 9 (Multi-Surface Design System Architecture)
+
+## Description
+
+Audit a product's deployed surfaces against the canonical token system. Detect drift. Produce remediation priorities sorted by impact on premium perception. This is the quarterly task that prevents surface degradation — the single strongest defense of pricing power.
+
+## Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| product_url | string | required | Main product URL |
+| canonical_tokens | yaml | required | Reference token system (from design-token-system) |
+| surfaces_to_audit | array | required | List of surfaces with URLs/access methods |
+| audit_scope | enum | optional | full / critical-only / surface-specific |
+
+## Steps
+
+1. **inventory-surfaces** — list all 7 canonical surfaces and their current state (deployed / missing / partial).
+2. **capture-screenshots** — screenshot each surface for visual comparison. Delegate to playwright MCP via Bash.
+3. **token-diff** — for code-accessible surfaces (marketing, product), diff deployed CSS against canonical tokens.
+4. **manual-audit** — for hard surfaces (email, PDF, support, mobile), manual visual audit against the canon.
+5. **classify-drift** — every drift classified as: critical (visible to users on first impression) / moderate (visible on repeated use) / minor (internal inconsistency).
+6. **premium-impact-score** — for each drift, score impact on premium perception (0-5).
+7. **remediation-priorities** — ranked list with owner, effort estimate, and expected perception lift.
+8. **handoff-to-aura** — Aura receives the audit and produces a packaging impact summary.
+9. **schedule-re-audit** — calendar placeholder for next quarterly audit.
+
+## Outputs
+
+| Output | Format | Description |
+|--------|--------|-------------|
+| drift_inventory | markdown | Full inventory with classification |
+| screenshots | folder | Visual evidence per surface |
+| remediation_priorities | markdown | Ranked list with owner + effort + impact |
+| premium_impact_report | markdown | Summary for Aura / executive |
+| re_audit_schedule | markdown | Next audit date |
+
+## Quality Gates
+
+- All 7 canonical surfaces are audited (or explicitly excluded with justification)
+- Every drift has an impact score
+- Remediation priorities have owners assigned
+- Billing PDF and transactional email are NOT missing from the audit
+
+---
+
+*squad-artdir v2.0 | Pilar 9 task*

package/squads/squad-artdir/tasks/consult-saas-canon.md

@@ -0,0 +1,54 @@
+# Task: Consult SaaS Canon
+
+## Metadata
+- **ID:** consult-saas-canon
+- **Version:** 1.0.0
+- **Agent:** platform-aesthetic-director (Vertex) — primary
+- **Supporting agents:** analyst (Scope), visual-strategist (Prism)
+- **Squad:** squad-artdir
+- **Pilars:** 8, 9, 10 (lens)
+
+## Description
+
+Consult the `saas-art-direction-canon.md` KB to extract the most relevant references for a given platform briefing. Decompose the references across the 5 canonical dimensions (Visual DNA, Hero pattern, Design system, Pricing, Onboarding). Return a curated set of principles tailored to the briefing category. Prevents commodity contamination by blocking Pinterest moodboards and stock references.
+
+## Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| product_category | string | required | Product category (dev tool / fintech / creative tool / ...) |
+| audience | string | required | Target audience |
+| positioning | string | required | Positioning statement |
+| pricing_posture | enum | optional | premium / mainstream / free |
+| proposed_references | array | optional | References the user/client is proposing (for commodity audit) |
+
+## Steps
+
+1. **parse-briefing** — extract category, audience, positioning.
+2. **commodity-audit** — if proposed_references contains Pinterest moodboards, Dribbble shots, or Figma community templates, BLOCK and escalate.
+3. **category-match** — match the category to the closest refs in the canon (dev tool -> Vercel/Raycast; fintech -> Stripe; creative tool -> Framer/Arc; productivity -> Linear).
+4. **decompose-refs** — for the 2-3 most relevant refs, produce the 5-dimension decomposition.
+5. **extract-principles** — derive cross-reference principles relevant to the case.
+6. **identify-custom-craft** — from the refs, identify candidate custom craft elements the new product should consider (e.g., "Vercel owns Geist — this product should own something equivalent").
+7. **feedback-to-agents** — return principles to Axiom (product surface), Atlas (design system), Aura (premium packaging).
+8. **log-consultation** — log the consultation for the quarterly canon review.
+
+## Outputs
+
+| Output | Format | Description |
+|--------|--------|-------------|
+| canon_consultation | markdown | Full consultation with refs, decomposition, principles |
+| category_fit_matrix | markdown | How each canon ref fits (or not) the briefing category |
+| custom_craft_candidates | markdown | List of candidate custom craft elements |
+| commodity_audit_result | markdown | Pass / fail with blocking reasons |
+
+## Quality Gates
+
+- At least 2 canon refs decomposed for the briefing
+- Commodity audit is performed (not skipped)
+- Custom craft candidates are identified
+- Principles are TRACED to specific refs (not invented)
+
+---
+
+*squad-artdir v2.0 | Canon consultation task*

package/squads/squad-artdir/tasks/create-art-direction-brief.md

@@ -0,0 +1,110 @@
+# Task: Create Art Direction Brief
+
+## Metadata
+- **ID:** create-art-direction-brief
+- **Version:** 1.0.0
+- **Agent:** artdir-orqx (Canvas) orchestrates; visual-strategist (Prism), type-systemist (Kern) contribute
+- **Squad:** squad-artdir
+
+## Description
+
+Generate a complete Art Direction Brief with psychological justification for every aesthetic decision. This is the primary deliverable of the squad — the master document that guides all downstream design and development work.
+
+## Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| briefing | string | required | Project briefing from user or client |
+| audience | string | required | Target audience description |
+| category | string | required | Market category |
+| objective | string | required | Primary conversion objective |
+| references | array | optional | Reference URLs or mood references |
+| brand_guidelines | string | optional | Existing brand guidelines to respect |
+| diagnostic | object | optional | Output from diagnose-visual-language (if existing site) |
+
+## Steps
+
+1. **parse-briefing**
+   - Extract project type, audience, category, objective
+   - Identify constraints from brand guidelines (if any)
+   - Determine which pillars need highest attention
+
+2. **define-visual-language** (Prism)
+   - Analyze audience expectations
+   - Research category visual conventions
+   - Define mood (adjectives, references, territory)
+   - Decide dark/light mode with justification
+   - Set density, temperature, weight, contrast, movement levels
+
+3. **design-color-system** (Spectrum)
+   - Select accent color with neuropsychological rationale
+   - Define neutral palette
+   - Create semantic colors
+   - Verify WCAG compliance
+   - Map Von Restorff application
+
+4. **define-typography** (Kern)
+   - Select font pairing with positioning rationale
+   - Define type scale (modular, fluid)
+   - Set tracking and leading per context
+   - Plan font loading strategy
+
+5. **specify-motion** (Tempo)
+   - Define motion philosophy
+   - Select libs
+   - Specify hero technique
+   - Set easing and timing defaults
+   - Plan prefers-reduced-motion fallbacks
+
+6. **design-ia** (Flow)
+   - Define section sequence with cognitive roles
+   - Plan progressive disclosure levels
+   - Identify Zeigarnik loops and curiosity gaps
+   - Mark peak and end moments
+
+7. **map-cro-patterns** (Convert)
+   - Select patterns by page type
+   - Position social proof elements
+   - Define CTA strategy (primary, secondary, sticky)
+   - Plan risk reversal approach
+
+8. **define-layout** (Grid)
+   - Set grid system and spacing scale
+   - Decide full-bleed vs contained per section
+   - Define responsive breakpoints
+   - Set section pacing
+
+9. **validate-accessibility** (Shield)
+   - Verify contrast ratios
+   - Confirm reduced-motion plan
+   - Check semantic structure plan
+   - Validate keyboard nav approach
+
+10. **compile-brief**
+    - Consolidate all sections into Art Direction Brief
+    - Ensure every decision cites psychological principle
+    - Add impact hypotheses per section
+    - Generate the remaining 7 deliverables
+
+## Outputs
+
+| Output | Type | Description |
+|--------|------|-------------|
+| art_direction_brief | document | Complete Art Direction Brief (Deliverable 1) |
+| design_tokens | document | Design Token System (Deliverable 2) |
+| motion_spec | document | Motion Spec (Deliverable 3) |
+| wireflow | document | Annotated Wireflow (Deliverable 4) |
+| component_spec | document | Component Library Spec (Deliverable 5) |
+| cro_map | document | CRO Patterns Map (Deliverable 6) |
+| implementation_guide | document | Implementation Guide (Deliverable 7) |
+| validation_checklist | document | Validation Checklist (Deliverable 8) |
+
+## Quality Criteria
+
+- EVERY aesthetic decision MUST cite a psychological principle
+- Brief MUST be > 500 lines (comprehensive)
+- All 7 pillars MUST be addressed
+- WCAG AAA for CTAs, AA for body text — verified
+- Impact hypotheses MUST specify metric + direction + rationale
+- prefers-reduced-motion fallbacks MUST be defined
+- Mobile-first layout MUST be explicit

package/squads/squad-artdir/tasks/create-premium-packaging-brief.md

@@ -0,0 +1,61 @@
+# Task: Create Premium Packaging Brief
+
+## Metadata
+- **ID:** create-premium-packaging-brief
+- **Version:** 1.0.0
+- **Agent:** premium-packaging-strategist (Aura) — primary
+- **Supporting agents:** platform-aesthetic-director (Vertex), design-system-architect (Atlas), product-surface-director (Axiom), type-systemist (Kern), motion-architect (Tempo)
+- **Squad:** squad-artdir
+- **Pilar:** 10 (Premium Packaging & Perceived Value)
+
+## Description
+
+Produce the Premium Packaging Brief — the master deliverable that justifies and operationalizes premium pricing through art direction. Applies the 5 non-negotiable principles from `premium-packaging-principles.md`. Blocks the brief if the product cannot commit to the 5 principles.
+
+## Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| product | string | required | Product name + description |
+| target_price | number | required | Target price point |
+| competitor_price | number | required | Direct competitor reference price |
+| multiplier | number | derived | target / competitor (should be >= 2x for this task to apply) |
+| brand_tokens | object | optional | Brand token system from squad-brand |
+| existing_surfaces | array | optional | Inventory of currently deployed surfaces |
+
+## Steps
+
+1. **diagnostic-intake** — Aura asks the 5 diagnostic questions. If ANY answer is "no" or "we do not know," escalate with remediation plan.
+2. **select-custom-craft** — identify the ONE custom craft element (type / icon / motion / illustration). Delegate to Kern (type) or Tempo (motion) or squad-brand (icon/illustration) for specification.
+3. **design-strategic-friction** — identify at least one strategic friction point in the funnel. Coordinate with Convert (cro-persuasion) for CRO implications.
+4. **first-5-minutes-choreo** — design the onboarding choreography for the first 5 minutes. Coordinate with Axiom (product-surface-director).
+5. **surface-inventory-audit** — delegate to Atlas via `audit-drift-multi-surface` to audit current state of all 7 canonical surfaces.
+6. **consult-vertex** — Vertex identifies category-fit references from the canon.
+7. **restraint-audit** — apply Principle 1 (restraint reads as confidence). Count accents, type weights, CTAs per viewport.
+8. **assemble-brief** — produce the Premium Packaging Brief deliverable.
+9. **validate-against-pillar-10** — checklist: 5 principles, 5 diagnostic answers, 7 surface inventory.
+10. **handoff-to-canvas** — Canvas (artdir-orqx) integrates the brief with the rest of the art direction deliverables.
+
+## Outputs
+
+| Output | Format | Description |
+|--------|--------|-------------|
+| premium_packaging_brief | markdown | Master brief with the 5 principles applied |
+| custom_craft_spec | markdown | Specification for the ONE custom craft element |
+| friction_point_design | markdown | Strategic friction point and justification |
+| first_5_minutes_choreography | markdown | Onboarding theater spec |
+| restraint_audit | markdown | Accent/type-weight/CTA count vs. principle |
+| pillar_10_checklist | markdown | Validation checklist result |
+
+## Quality Gates
+
+- The 5 diagnostic questions ALL have answers (not "we don't know")
+- At least ONE custom craft element is identified
+- At least ONE strategic friction point is designed
+- First 5 Minutes Choreography is documented
+- Surface inventory covers all 7 canonical surfaces
+- Restraint audit shows: max 1 accent, max 3 type weights, max 3 CTAs/viewport
+
+---
+
+*squad-artdir v2.0 | Pilar 10 task*