invos 1.0.0

package/kit/.agents/squads/brand/tasks/brand-audit.md

@@ -0,0 +1,150 @@
+# Brand Audit
+
+```yaml
+task:
+  task_name: "Execute Brand Audit"
+  status: pending
+  responsible_executor: brand-chief
+  execution_type: Agent
+  estimated_time: "2-4h"
+  elicit: true
+
+  input:
+    - "Brand name"
+    - "Logo / visual assets"
+    - "Website URL"
+    - "Brand guidelines (if exist)"
+    - "Competitor list"
+    - "Marketing materials"
+
+  output:
+    - "6-dimension audit scorecard"
+    - "Priority action plan"
+    - "Detailed findings per dimension"
+
+  action_items:
+    - step: 1
+      name: "Collect Materials"
+      description: |
+        Gather from user:
+        1. Brand name, tagline
+        2. Logo files or screenshots
+        3. Website URL
+        4. Brand guidelines document (if any)
+        5. Top 3-5 competitors
+        6. Sample marketing materials
+        7. Customer testimonials/reviews (if available)
+
+    - step: 2
+      name: "Audit Strategy Dimension"
+      description: |
+        Route to @marty-neumeier methodology:
+        - Test onliness: "Is the brand the only ___ that ___?"
+        - Measure brand gap (strategy vs experience)
+        - Run charismatic brand test
+        - Assess purpose clarity
+        - Evaluate values specificity
+        Score: 1-10
+
+    - step: 3
+      name: "Audit Positioning Dimension"
+      description: |
+        Route to @april-dunford methodology:
+        - Identify competitive alternatives
+        - Assess differentiated value clarity
+        - Evaluate target customer definition
+        - Check market category fit
+        - Run one-word test
+        Score: 1-10
+
+    - step: 4
+      name: "Audit Naming Dimension"
+      description: |
+        Route to @alexandra-watkins methodology:
+        - SMILE test the brand name (5 criteria)
+        - SCRATCH test the brand name (7 tests)
+        - Evaluate tagline (if exists)
+        Score: 1-10
+
+    - step: 5
+      name: "Audit Visual Identity Dimension"
+      description: |
+        Route to @michael-johnson methodology:
+        - Check consistency across touchpoints
+        - Evaluate color strategy mapping to personality
+        - Assess typography hierarchy
+        - Review imagery/photography style
+        - Check brand guidelines completeness
+        - Test scalability (16px to billboard)
+        Score: 1-10
+
+    - step: 6
+      name: "Audit Logo Dimension"
+      description: |
+        Route to @sagi-haviv methodology:
+        - Simplicity test (describe in 10 words, sketch from memory)
+        - Distinctiveness (ownable in category?)
+        - Versatility (mono, small, large, dark/light)
+        - Timelessness (will it age well?)
+        - Appropriateness (matches personality?)
+        Score: 1-10
+
+    - step: 7
+      name: "Audit Brand Experience Dimension"
+      description: |
+        Route to @emily-heyward methodology:
+        - Emotional hook test
+        - Touchpoint coherence check
+        - Movement potential assessment
+        - Brand tension analysis
+        - Shared enemy identification
+        Score: 1-10
+
+    - step: 8
+      name: "Synthesize Report"
+      description: |
+        Compile:
+        1. Score dashboard (6 dimensions + overall average)
+        2. Strengths (scores 7+)
+        3. Weaknesses (scores below 6)
+        4. Priority actions (fix strategy first, always)
+        5. Agent assignments per action
+
+  output_example: |
+    ## Brand Audit Report: Acme SaaS
+
+    **Score Dashboard:**
+    | Dimension | Score | Auditor | Key Finding |
+    |-----------|-------|---------|-------------|
+    | Strategy | 6/10 | @marty-neumeier | Onliness statement uses "best" — not provable |
+    | Positioning | 5/10 | @april-dunford | Target is "businesses" — too broad |
+    | Naming | 8/10 | @alexandra-watkins | Name scores 21/25 SMILE, passes SCRATCH |
+    | Visual Identity | 4/10 | @michael-johnson | No typography hierarchy; colors inconsistent across web/print |
+    | Logo | 7/10 | @sagi-haviv | Clean mark, works at scale; weak at 16px |
+    | Brand Experience | 5/10 | @emily-heyward | No emotional hook; website feels transactional |
+    | **Overall** | **5.8/10** | | |
+
+    **Strengths:** Naming (8), Logo (7) — strong foundation to build on.
+    **Weaknesses:** Visual Identity (4), Positioning (5), Experience (5).
+
+    **Priority Actions:**
+    1. Fix positioning — narrow target customer [@april-dunford]
+    2. Rebuild visual identity system — color + type hierarchy [@michael-johnson]
+    3. Rewrite onliness statement — remove superlatives [@marty-neumeier]
+    4. Add emotional hook to homepage experience [@emily-heyward]
+
+  acceptance_criteria:
+    - "All 6 dimensions scored 1-10"
+    - "Each dimension has specific findings"
+    - "Actions prioritized correctly"
+    - "Overall score calculated"
+
+  veto_conditions:
+    - "Missing brand materials for 3+ dimensions → partial audit only"
+    - "Audit scores lack specific findings → VETO (scores without rationale are useless)"
+    - "Recommendations without agent assignments → VETO (every fix must have an owner)"
+
+  handoff:
+    on_complete: "Present to user. Recommend workflow based on findings."
+    deliverable: "Brand Audit Report"
+```

package/kit/.agents/squads/brand/tasks/brand-book-creation.md

@@ -0,0 +1,136 @@
+# Brand Book Creation
+
+```yaml
+task:
+  task_name: "Create Brand Book / Guidelines"
+  status: pending
+  responsible_executor: michael-johnson
+  execution_type: Agent
+  estimated_time: "2-3h"
+  elicit: true
+
+  input:
+    - "Brand strategy document"
+    - "Positioning canvas"
+    - "Brand name + tagline"
+    - "Logo files + usage rules"
+    - "Color system"
+    - "Typography specifications"
+    - "Brand voice definition"
+
+  output:
+    - "Complete brand guidelines document"
+    - "Do's and Don'ts for each element"
+
+  action_items:
+    - step: 1
+      name: "Section 1: Brand Story"
+      description: |
+        - Brand purpose / why we exist
+        - Brand values (from strategy)
+        - Brand personality
+        - Brand archetype
+
+    - step: 2
+      name: "Section 2: Logo"
+      description: |
+        - Primary logo (full lockup)
+        - Logo variations (horizontal, stacked, icon)
+        - Clear space rules
+        - Minimum size specifications
+        - Color versions (full, mono, reversed)
+        - Logo DON'Ts (stretch, recolor, add effects, etc.)
+
+    - step: 3
+      name: "Section 3: Color"
+      description: |
+        - Primary palette with codes (HEX, RGB, CMYK)
+        - Secondary palette
+        - Neutral palette
+        - Semantic colors
+        - Color usage ratios (60-30-10 rule)
+        - Color accessibility notes
+
+    - step: 4
+      name: "Section 4: Typography"
+      description: |
+        - Brand typeface (name, weights, usage)
+        - UI typeface (name, weights, usage)
+        - Type scale / hierarchy
+        - Line height and spacing rules
+        - Font pairing rationale
+
+    - step: 5
+      name: "Section 5: Imagery"
+      description: |
+        - Photography style (mood, lighting, composition)
+        - Illustration style (if applicable)
+        - Iconography guidelines
+        - Image treatment (filters, overlays)
+
+    - step: 6
+      name: "Section 6: Layout"
+      description: |
+        - Grid system (columns, margins, gutters)
+        - Spacing system (base unit)
+        - Card/component patterns
+        - White space philosophy
+
+    - step: 7
+      name: "Section 7: Voice & Tone"
+      description: |
+        - Voice definition (3 adjectives)
+        - Tone modulation per context
+        - Words we love / words we avoid
+        - Writing style rules
+
+    - step: 8
+      name: "Section 8: Digital"
+      description: |
+        - Responsive behavior
+        - Dark mode palette
+        - Animation/motion guidelines
+        - Social media templates
+
+  output_example: |
+    # Brand Book — Synkra (Excerpt)
+
+    ## 1. Brand Story
+    **Purpose:** We exist to make AI orchestration intuitive for development teams.
+    **Archetype:** The Sage — knowledge through systems, clarity through structure.
+
+    ## 2. Logo Usage
+    - Primary lockup: Wordmark + icon, horizontal
+    - Clear space: Minimum 1x icon height on all sides
+    - Minimum size: 24px height (digital), 10mm (print)
+    - **DON'Ts:** Never stretch, never place on busy backgrounds,
+      never change color proportions, never add drop shadows
+
+    ## 3. Color (excerpt)
+    | Color | HEX | RGB | CMYK | Usage |
+    |-------|-----|-----|------|-------|
+    | Deep Indigo | #4338CA | 67,56,202 | 85,78,0,0 | Primary brand, CTAs |
+    | Electric Teal | #0D9488 | 13,148,136 | 82,0,26,12 | Accents, highlights |
+    | Slate 900 | #0F172A | 15,23,42 | 90,72,42,62 | Body text |
+    **Ratio:** 60% neutrals, 30% primary, 10% accent
+
+    ## 7. Voice & Tone
+    **Voice:** Clear, Confident, Human
+    **We say:** "Let's build this together" / **We avoid:** "Leverage synergies"
+
+  acceptance_criteria:
+    - "All 8 sections complete"
+    - "Logo usage includes DON'Ts"
+    - "Colors have all format codes"
+    - "Typography hierarchy is specific"
+    - "Voice section is actionable"
+
+  veto_conditions:
+    - "Missing logo DON'Ts section → VETO"
+    - "Colors without accessibility check → VETO"
+    - "Typography without hierarchy → VETO"
+
+  handoff:
+    on_complete: "Present to brand-chief for final review and coherence check"
+    deliverable: "Complete brand guidelines document"
+```

package/kit/.agents/squads/brand/tasks/brand-diagnosis.md

@@ -0,0 +1,135 @@
+# Brand Diagnosis
+
+```yaml
+task:
+  task_name: "Diagnose Brand Strategy"
+  status: pending
+  responsible_executor: marty-neumeier
+  execution_type: Agent
+  estimated_time: "1-2h"
+  elicit: true
+
+  input:
+    - "Business description (what the company does)"
+    - "Target market"
+    - "Competitor landscape"
+    - "Founder's vision"
+
+  output:
+    - "Brand Gap analysis"
+    - "Onliness statement"
+    - "Brand Ladder"
+    - "Charismatic Brand Test results"
+    - "Brand archetype selection"
+
+  action_items:
+    - step: 1
+      name: "Gather Context"
+      description: |
+        Ask the user:
+        1. What does your company/product do?
+        2. Who is your ideal customer?
+        3. Who are your top 3 competitors?
+        4. Why did you start this? What frustrates you about the status quo?
+        5. If your brand were a person, how would they act?
+
+    - step: 2
+      name: "Brand Gap Analysis"
+      description: |
+        Assess the 5 Disciplines (Neumeier):
+        1. DIFFERENTIATE — How clear is the brand's distinction?
+        2. COLLABORATE — Is the brand co-created with customers?
+        3. INNOVATE — Is the brand pushing boundaries?
+        4. VALIDATE — Is the brand tested with real people?
+        5. CULTIVATE — Is the brand being grown systematically?
+        Score each 1-10. Identify gaps.
+
+    - step: 3
+      name: "Onliness Exercise (Zag)"
+      description: |
+        Fill in the Zag template:
+        "Our brand is the ONLY _________ that _________."
+
+        Requirements:
+        - The first blank = your category
+        - The second blank = your unique value
+        - Must be TRUE and PROVABLE
+        - Must NOT use superlatives (best, leading, #1)
+
+    - step: 4
+      name: "Brand Ladder"
+      description: |
+        Build from bottom to top:
+        1. FEATURES — What does the product do?
+        2. BENEFITS — What does the customer get?
+        3. VALUES — What does the brand stand for?
+        4. IDENTITY — How does the brand make people feel about THEMSELVES?
+
+    - step: 5
+      name: "Charismatic Brand Test"
+      description: |
+        Score the brand on 5 criteria:
+        1. Does it have a clear ENEMY?
+        2. Does it inspire CULT-LIKE devotion?
+        3. Is there a clear BEFORE/AFTER transformation?
+        4. Would customers TATTOO the logo?
+        5. Does the brand CREATE CULTURE?
+        Score each 1-10. 40+ = charismatic.
+
+    - step: 6
+      name: "Archetype Selection"
+      description: |
+        Using data/brand-archetypes.md:
+        1. Map customer desires to archetype desires
+        2. Map customer fears to archetype fears
+        3. Select primary archetype (1 only)
+        4. Optionally select secondary (max 1)
+        5. Document rationale
+
+  output_example: |
+    ## Brand Diagnosis: Synkra
+
+    **Onliness Statement:**
+    "Synkra is the ONLY AI development orchestrator that coordinates specialized agents through story-driven workflows."
+
+    **Brand Gap Scores:**
+    | Discipline    | Score | Finding |
+    |--------------|-------|---------|
+    | Differentiate | 8/10  | Clear "AI orchestration" niche, no direct competitor uses agent-squad model |
+    | Collaborate   | 5/10  | Limited community input; roadmap is founder-driven |
+    | Innovate      | 9/10  | Novel meta-framework approach, ahead of market |
+    | Validate      | 3/10  | No formal brand testing with users yet |
+    | Cultivate     | 4/10  | Brand applied inconsistently across docs vs product |
+
+    **Brand Ladder:**
+    - IDENTITY: "I'm the developer who doesn't waste time on boilerplate"
+    - VALUES: Precision, autonomy, craftsmanship
+    - BENEFITS: Ship 3x faster with consistent quality
+    - FEATURES: Agent squads, story-driven dev, automated QA gates
+
+    **Charismatic Brand Test:** 32/50
+    - Clear enemy (chaotic AI-assisted coding): 8/10
+    - Cult devotion: 5/10 — too early
+    - Before/After: 9/10 — strong transformation narrative
+    - Tattoo test: 4/10 — logo not iconic yet
+    - Creates culture: 6/10 — "story-driven" methodology emerging
+
+    **Archetype:** The Magician (primary), The Sage (secondary)
+    Rationale: Transforms complexity into simplicity; users feel empowered, not dependent.
+
+  acceptance_criteria:
+    - "Onliness statement is specific, true, and provable"
+    - "Brand Gap scored on all 5 disciplines"
+    - "Brand Ladder complete (all 4 levels)"
+    - "Archetype selected with documented rationale"
+    - "Charismatic Brand Test scored"
+
+  veto_conditions:
+    - "Onliness uses 'best' or 'leading' → VETO"
+    - "Brand Ladder skips the Identity level → VETO"
+    - "No competitive context provided → VETO"
+
+  handoff:
+    on_complete: "Pass to april-dunford for positioning"
+    deliverable: "Brand strategy document"
+```

package/kit/.agents/squads/brand/tasks/brand-touchpoint-audit.md

@@ -0,0 +1,100 @@
+# Brand Touchpoint Audit
+
+```yaml
+task:
+  task_name: "Audit Brand Touchpoints"
+  status: pending
+  responsible_executor: emily-heyward
+  execution_type: Agent
+  estimated_time: "1-2h"
+  elicit: true
+
+  input:
+    - "Brand strategy"
+    - "Website URL"
+    - "Marketing materials"
+    - "Product screenshots"
+
+  output:
+    - "Touchpoint scorecard"
+    - "Coherence analysis"
+    - "Recommendations per touchpoint"
+
+  action_items:
+    - step: 1
+      name: "Map Touchpoints"
+      description: |
+        Identify and list all brand touchpoints:
+        1. Website (above the fold, key pages)
+        2. Product/app (onboarding, key flows, errors)
+        3. Email (welcome, transactional, marketing)
+        4. Social media (profiles, content style)
+        5. Packaging (physical, unboxing)
+        6. Customer support (tone, speed, resolution)
+        7. Advertising (paid, organic)
+        8. Sales materials (decks, proposals)
+
+    - step: 2
+      name: "Score Each Touchpoint"
+      description: |
+        For each, score 1-10 on:
+        - Brand alignment: Does it reflect the brand strategy?
+        - Emotional impact: Does it make people feel something?
+        - Consistency: Is it consistent with other touchpoints?
+        - Quality: Is the execution high quality?
+
+    - step: 3
+      name: "Identify Gaps"
+      description: |
+        - Which touchpoints are OFF-brand?
+        - Where is the emotional hook missing?
+        - Where is inconsistency breaking trust?
+        - Which touchpoint has the most impact if fixed?
+
+    - step: 4
+      name: "Prioritize Fixes"
+      description: |
+        Order by: Impact (high→low) × Effort (low→high)
+        Quick wins first, then strategic improvements.
+
+  output_example: |
+    ## Touchpoint Scorecard — Synkra
+
+    | Touchpoint | Alignment | Emotion | Consistency | Quality | Avg |
+    |------------|-----------|---------|-------------|---------|-----|
+    | Website (hero) | 9 | 8 | 9 | 9 | 8.8 |
+    | Onboarding flow | 7 | 5 | 8 | 7 | 6.8 |
+    | Welcome email | 6 | 4 | 5 | 6 | 5.3 |
+    | Social media | 8 | 7 | 6 | 7 | 7.0 |
+    | Error states | 4 | 3 | 5 | 4 | 4.0 |
+    | Docs site | 8 | 6 | 7 | 8 | 7.3 |
+
+    ### Top 3 Gaps
+    1. **Error states (4.0):** Generic browser errors, no brand voice, no emotional recovery
+    2. **Welcome email (5.3):** Template-style, no personality, missing brand narrative
+    3. **Onboarding flow (6.8):** Functional but emotionally flat, no "aha moment" design
+
+    ### Priority Fixes (Impact x Effort)
+    | Priority | Touchpoint | Fix | Impact | Effort | Owner |
+    |----------|------------|-----|--------|--------|-------|
+    | 1 | Welcome email | Rewrite with brand voice + narrative arc | High | Low | emily-heyward |
+    | 2 | Error states | Design branded error pages with helpful tone | High | Medium | michael-johnson |
+    | 3 | Onboarding | Add emotional hooks at key moments | High | High | emily-heyward |
+
+  acceptance_criteria:
+    - "All touchpoints mapped and scored"
+    - "Top 3 gaps identified"
+    - "Priority fix list created"
+
+  veto_conditions:
+    - condition: "Touchpoint audit conducted without brand strategy as baseline"
+      action: "VETO — cannot evaluate coherence without a reference point. Run brand-diagnosis first."
+    - condition: "Scoring applied without defining scoring criteria per dimension"
+      action: "VETO — subjective scores without criteria are meaningless. Define dimensions first."
+    - condition: "Recommendations lack prioritization by impact"
+      action: "VETO — an unordered list of fixes is not actionable. Prioritize by brand impact and effort."
+
+  handoff:
+    on_complete: "Pass to brand-chief for synthesis with overall brand audit"
+    deliverable: "Touchpoint scorecard + priority fixes"
+```

package/kit/.agents/squads/brand/tasks/coherence-check.md

@@ -0,0 +1,132 @@
+# Coherence Check
+
+## Task Definition
+
+```yaml
+task:
+  name: "Cross-Phase Brand Coherence Check"
+  id: coherence-check
+  status: pending
+  responsible_executor: brand-chief
+  execution_type: Agent
+  estimated_time: "15-30 minutes"
+  elicit: true
+
+  description: |
+    Verifies alignment between all brand phases — strategy, positioning, naming,
+    visual identity, and activation. Ensures no phase contradicts another and
+    the brand story is coherent end-to-end.
+
+  input:
+    - "Brand strategy document (from diagnosis phase)"
+    - "Positioning canvas (from positioning phase)"
+    - "Selected name + SMILE/SCRATCH scores (from naming phase)"
+    - "Visual identity brief or brand guidelines (from identity phase)"
+    - "Movement architecture / Brand Soul Canvas (from activation phase, if exists)"
+
+  output:
+    - "Coherence scorecard (6 alignment checks)"
+    - "Misalignment report (if any)"
+    - "Priority fixes with responsible agent"
+
+  action_items:
+    - step: 1
+      name: "Collect Phase Outputs"
+      description: "Gather all completed phase deliverables. Minimum 2 phases must be complete to run coherence check."
+
+    - step: 2
+      name: "Strategy-Positioning Alignment"
+      description: |
+        Check: Does the positioning canvas reflect the brand strategy?
+        - Onliness statement → Positioning differentiator alignment
+        - Brand values → Value proposition alignment
+        - Brand personality → Positioning tone alignment
+      score: "1-10"
+
+    - step: 3
+      name: "Positioning-Naming Alignment"
+      description: |
+        Check: Does the name reinforce the positioning?
+        - Name SMILE score → Does it suggest the positioning?
+        - Name emotional register → Matches brand personality?
+        - Name legs → Support brand extension strategy?
+      score: "1-10"
+
+    - step: 4
+      name: "Naming-Identity Alignment"
+      description: |
+        Check: Does the visual identity match the name's personality?
+        - Typography → Reflects name character?
+        - Color system → Supports name emotion?
+        - Logo → Works with the name at all sizes?
+      score: "1-10"
+
+    - step: 5
+      name: "Identity-Strategy Alignment"
+      description: |
+        Check: Does the visual identity reflect the original brand strategy?
+        - Design rationale traces to brand values?
+        - Color choices align with archetype?
+        - Typography reflects brand personality?
+      score: "1-10"
+
+    - step: 6
+      name: "Activation-Everything Alignment"
+      description: |
+        Check: Does the movement architecture align with all previous phases?
+        - Brand tension → Traces to positioning gap?
+        - Shared enemy → Consistent with brand values?
+        - Tribe definition → Matches target from positioning?
+        - Touchpoint rituals → Reflect visual identity?
+      score: "1-10"
+
+    - step: 7
+      name: "Generate Coherence Report"
+      description: |
+        Compile all scores into coherence scorecard.
+        Flag any alignment below 7/10 as misalignment.
+        For each misalignment, identify responsible agent and recommended fix.
+
+  output_example: |
+    ## Coherence Scorecard — Synkra
+
+    | Alignment Check | Score | Status |
+    |-----------------|-------|--------|
+    | Strategy ↔ Positioning | 9/10 | PASS |
+    | Positioning ↔ Naming | 8/10 | PASS |
+    | Naming ↔ Identity | 7/10 | PASS |
+    | Identity ↔ Strategy | 9/10 | PASS |
+    | Activation ↔ Everything | 6/10 | MISALIGNED |
+    | **Overall Coherence** | **7.8/10** | **CONDITIONAL PASS** |
+
+    ### Misalignment Report
+    | Check | Score | Issue | Responsible | Fix |
+    |-------|-------|-------|-------------|-----|
+    | Activation ↔ Everything | 6/10 | Shared enemy ("tool sprawl") not reflected in visual identity — imagery shows harmony, not disruption tension | michael-johnson | Add visual tension element to hero imagery; introduce contrast motif in brand illustrations |
+
+    ### Verdict
+    **CONDITIONAL PASS** — 1 misalignment detected (non-critical).
+    Proceed to next phase but schedule identity refresh for activation alignment.
+
+  acceptance_criteria:
+    - "All available alignments scored 1-10"
+    - "Any score below 7 has specific misalignment identified"
+    - "Each misalignment has responsible agent and fix recommendation"
+    - "Overall coherence score calculated (average of all checks)"
+
+  veto_conditions:
+    - condition: "Fewer than 2 phases complete"
+      action: "VETO — need minimum 2 phase outputs to check coherence"
+    - condition: "Strategy phase not complete"
+      action: "VETO — strategy is the baseline. Cannot check coherence without it."
+    - condition: "Misalignment score below 5/10 on any check"
+      action: "ESCALATE — critical misalignment requires phase rework before proceeding"
+
+  handoff:
+    on_pass:
+      target: "Next incomplete phase or brand-chief for final review"
+      deliverable: "Coherence scorecard confirming alignment"
+    on_fail:
+      target: "Agent responsible for misaligned phase"
+      deliverable: "Misalignment report with specific fixes required"
+```