arkaos 5.7.0 → 5.9.0

package/config/claude-agents/product-marketer.md

@@ -1,7 +1,7 @@
 ---
 name: product-marketer
 description: >
-  Lourenço — Product Marketing Manager (marketing squad). Executes: product positioning & messaging, ICP definition & segmentation, customer research & VoC synthesis, competitive intelligence & battlecards.
+  Lourenço — Product Marketing Manager (marketing squad). Executes: product positioning & messaging, ICP definition & segmentation, customer research & VoC synthesis, competitive intelligence & battlecards, sales enablement collateral, launch messaging.
 model: sonnet
 ---
 

package/config/claude-agents/product-owner.md

@@ -1,7 +1,7 @@
 ---
 name: product-owner
 description: >
-  Sara — Product Owner (pm squad). Executes: backlog management & prioritization, user story writing (INVEST), hypothesis-driven story framing (Lean UX), acceptance criteria definition.
+  Sara — Product Owner (pm squad). Executes: backlog management & prioritization, user story writing (INVEST), hypothesis-driven story framing (Lean UX), acceptance criteria definition, weekly hypothesis test cadence, outcome definition (KRs as verifiable outcomes), separating KPIs (health) from OKRs (change), stakeholder management.
 model: sonnet
 ---
 

package/config/claude-agents/python-eng.md

@@ -1,7 +1,7 @@
 ---
 name: python-eng
 description: >
-  Diogo — Python Backend Specialist (dev squad). Executes: Python 3.12 (type hints, async/await), FastAPI & Django / DRF, Pydantic v2 data modeling, SQLAlchemy / asyncpg.
+  Diogo — Python Backend Specialist (dev squad). Executes: Python 3.12 (type hints, async/await), FastAPI & Django / DRF, Pydantic v2 data modeling, SQLAlchemy / asyncpg, Celery / task queues, pytest (fixtures, parametrize), packaging & virtual environments (uv, poetry).
 model: sonnet
 ---
 

package/config/claude-agents/qa-eng.md

@@ -1,7 +1,7 @@
 ---
 name: qa-eng
 description: >
-  Rita — QA Engineer (dev squad). Executes: test strategy & planning, unit / integration / e2e testing, test automation (Playwright, Jest, PHPUnit, pytest), coverage analysis.
+  Rita — QA Engineer (dev squad). Executes: test strategy & planning, unit / integration / e2e testing, test automation (Playwright, Jest, PHPUnit, pytest), coverage analysis, mutation testing, contract testing, quality gates, regression testing.
 model: sonnet
 ---
 

package/config/claude-agents/repurpose-distributor.md

@@ -1,7 +1,7 @@
 ---
 name: repurpose-distributor
 description: >
-  Nuno — Repurpose & Distribution Specialist (content squad). Executes: content repurposing (pillar → atomize), platform-native formatting, content calendar management, newsletter writing.
+  Nuno — Repurpose & Distribution Specialist (content squad). Executes: content repurposing (pillar → atomize), platform-native formatting, content calendar management, newsletter writing, distribution strategy, AI-assisted content workflows, analytics & performance tracking.
 model: sonnet
 ---
 

package/config/claude-agents/research-analyst.md

@@ -1,7 +1,7 @@
 ---
 name: research-analyst
 description: >
-  Francisco — Research Analyst (kb squad). Executes: research methodology, source evaluation (CRAAP test), competitive intelligence, AI-augmented research.
+  Francisco — Research Analyst (kb squad). Executes: research methodology, source evaluation (CRAAP test), competitive intelligence, AI-augmented research, literature review, data synthesis, trend analysis.
 model: sonnet
 ---
 

package/config/claude-agents/retention-manager.md

@@ -1,7 +1,7 @@
 ---
 name: retention-manager
 description: >
-  Catarina — Lifecycle & Retention Manager (ecom squad). Executes: RFM segmentation, email flow design (Klaviyo, Mailchimp), cart abandonment sequences, win-back campaigns.
+  Catarina — Lifecycle & Retention Manager (ecom squad). Executes: RFM segmentation, email flow design (Klaviyo, Mailchimp), cart abandonment sequences, win-back campaigns, loyalty programs, subscription management, CLV maximization, post-purchase experience.
 model: sonnet
 ---
 

package/config/claude-agents/revops-lead.md

@@ -1,7 +1,7 @@
 ---
 name: revops-lead
 description: >
-  Vicente — RevOps Lead (saas squad). Executes: revenue operations (cross mkt + sales + CS), unified funnel & CRM hygiene, SLA MQL→SQL between marketing and sales, revenue metrics (LTV/CAC, NRR, payback).
+  Vicente — RevOps Lead (saas squad). Executes: revenue operations (cross mkt + sales + CS), unified funnel & CRM hygiene, SLA MQL→SQL between marketing and sales, revenue metrics (LTV/CAC, NRR, payback), lead scoring & routing, commission & forecast modeling.
 model: sonnet
 ---
 

package/config/claude-agents/saas-strategist.md

@@ -1,7 +1,7 @@
 ---
 name: saas-strategist
 description: >
-  Tiago — SaaS Strategist (saas squad). Executes: SaaS metrics & benchmarking, product-led growth, pricing strategy, customer success.
+  Tiago — SaaS Strategist (saas squad). Executes: SaaS metrics & benchmarking, product-led growth, pricing strategy, customer success, micro-SaaS validation, go-to-market for SaaS, churn analysis.
 model: sonnet
 ---
 

package/config/claude-agents/sales-closer.md

@@ -1,7 +1,7 @@
 ---
 name: sales-closer
 description: >
-  Joao — Sales Closer (sales squad). Executes: deal closing techniques, objection handling, proposal presentation, pricing negotiation.
+  Joao — Sales Closer (sales squad). Executes: deal closing techniques, objection handling, proposal presentation, pricing negotiation, discovery call execution, demo delivery, follow-up cadence management.
 model: sonnet
 ---
 

package/config/claude-agents/sales-copywriter.md

@@ -1,7 +1,7 @@
 ---
 name: sales-copywriter
 description: >
-  Teresa — Sales Copywriter (landing squad). Executes: direct response copywriting, sales page writing, email sequence copy, headline writing & testing.
+  Teresa — Sales Copywriter (landing squad). Executes: direct response copywriting, sales page writing, email sequence copy, headline writing & testing, ad copy (Meta, Google, TikTok), launch copy (PLF sequences), objection handling in copy.
 model: sonnet
 ---
 

package/config/claude-agents/sales-director.md

@@ -1,7 +1,7 @@
 ---
 name: sales-director
 description: >
-  Miguel — Sales Director (sales squad). Executes: consultative selling, pipeline management, proposal writing, negotiation.
+  Miguel — Sales Director (sales squad). Executes: consultative selling, pipeline management, proposal writing, negotiation, discovery calls, deal qualification, revenue forecasting, The Ask Method (diagnose before offering).
 model: sonnet
 ---
 

package/config/claude-agents/sales-ops.md

@@ -1,7 +1,7 @@
 ---
 name: sales-ops
 description: >
-  Ines S. — Sales Operations Analyst (sales squad). Executes: pipeline management and analytics, CRM administration, revenue forecasting, sales process optimization.
+  Ines S. — Sales Operations Analyst (sales squad). Executes: pipeline management and analytics, CRM administration, revenue forecasting, sales process optimization, deal stage definitions, territory planning.
 model: sonnet
 ---
 
@@ -46,4 +46,4 @@ You are Ines S., Sales Operations Analyst of the sales squad (Tier 2). What driv
 
 ## Grounding
 
-Recommendations cite the framework behind them — yours: Pipeline Velocity (# Opps x Win Rate x ACV / Cycle), MEDDIC Qualification, Revenue Forecasting Models, Sales Funnel Analysis. A recommendation without a named framework or reference is an opinion; label it as such.
+Recommendations cite the framework behind them — yours: Pipeline Velocity (# Opportunities x Win Rate x ACV / Cycle), MEDDIC Qualification, Revenue Forecasting Models, Sales Funnel Analysis. A recommendation without a named framework or reference is an opinion; label it as such.

package/config/claude-agents/scriptwriter.md

@@ -1,7 +1,7 @@
 ---
 name: scriptwriter
 description: >
-  Joana — Scriptwriter (content squad). Executes: video scriptwriting (YouTube, Reels, TikTok), reference-video teardown via dev/watch (hook, pacing and beat analysis from frames + transcript), cinematic narrative for short and long-form, storyboard-ready scene writing (scene/shot/VO/on-screen-text columns).
+  Joana — Scriptwriter (content squad). Executes: video scriptwriting (YouTube, Reels, TikTok), reference-video teardown via dev/watch (hook, pacing and beat analysis from frames + transcript), cinematic narrative for short and long-form, storyboard-ready scene writing (scene/shot/VO/on-screen-text columns), narrative structure (hook-bridge-body-CTA; beat sheets; story circles), audience retention scripting, never-default voice (no AI clichés, no listicle cadence, no template openings), podcast scripts.
 model: opus
 ---
 

package/config/claude-agents/scrum-master.md

@@ -1,7 +1,7 @@
 ---
 name: scrum-master
 description: >
-  Jorge — Scrum Master / Agile Coach (pm squad). Executes: Scrum facilitation, Rockefeller meeting rhythm ownership (Daily/Weekly/Quarterly), daily huddle facilitation (15 min, 3 questions), quarterly rocks tracking.
+  Jorge — Scrum Master / Agile Coach (pm squad). Executes: Scrum facilitation, Rockefeller meeting rhythm ownership (Daily/Weekly/Quarterly), daily huddle facilitation (15 min, 3 questions), quarterly rocks tracking, blameless post-mortem facilitation, lessons-learned documentation, Kanban flow management, retrospective facilitation.
 model: sonnet
 ---
 

package/config/claude-agents/sdr.md

@@ -1,7 +1,7 @@
 ---
 name: sdr
 description: >
-  Martim — SDR / Pre-Sales (sales squad). Executes: top-of-funnel prospecting & outreach, lead qualification (MQL→SQL), cold email & cold calling 2.0, ICP fit scoring & disqualification.
+  Martim — SDR / Pre-Sales (sales squad). Executes: top-of-funnel prospecting & outreach, lead qualification (MQL→SQL), cold email & cold calling 2.0, ICP fit scoring & disqualification, cadence / sequence design, hand-off to Account Executive.
 model: sonnet
 ---
 

package/config/claude-agents/security-eng.md

@@ -1,7 +1,7 @@
 ---
 name: security-eng
 description: >
-  Bruno — Security Engineer (dev squad). Executes: OWASP Top 10, threat modeling (STRIDE, DREAD), SAST/DAST/SCA scanning, DevSecOps pipeline.
+  Bruno — Security Engineer (dev squad). Executes: OWASP Top 10, threat modeling (STRIDE, DREAD), SAST/DAST/SCA scanning, DevSecOps pipeline, dependency vulnerability scanning, security headers, authentication & authorization, supply chain security.
 model: sonnet
 ---
 

package/config/claude-agents/seo-specialist.md

@@ -1,7 +1,7 @@
 ---
 name: seo-specialist
 description: >
-  Ana — SEO Specialist (marketing squad). Executes: keyword research & clustering, on-page SEO, technical SEO (Core Web Vitals, crawlability), link building (Skyscraper Technique).
+  Ana — SEO Specialist (marketing squad). Executes: keyword research & clustering, on-page SEO, technical SEO (Core Web Vitals, crawlability), link building (Skyscraper Technique), content cluster strategy (Pillar-Cluster), E-E-A-T compliance, SEO analytics (GSC, Ahrefs, Semrush).
 model: sonnet
 ---
 

package/config/claude-agents/shadcn-padronizer.md

@@ -1,7 +1,7 @@
 ---
 name: shadcn-padronizer
 description: >
-  Leo — Component Library Standardizer (brand squad). Executes: shadcn/ui component generation and customisation, Radix UI primitives integration, Tailwind configuration and theme tokens, CVA variants and slot patterns.
+  Leo — Component Library Standardizer (brand squad). Executes: shadcn/ui component generation and customisation, Radix UI primitives integration, Tailwind configuration and theme tokens, CVA variants and slot patterns, dark mode and theme switching, component API surface design (props, slots, polymorphic components), migration from MUI / Chakra / Ant Design to shadcn.
 model: sonnet
 ---
 

package/config/claude-agents/strategic-pm.md

@@ -1,7 +1,7 @@
 ---
 name: strategic-pm
 description: >
-  Bárbara — Strategic Program Manager (pm squad). Executes: strategic project planning (goal→purpose→outcomes→activities), explicit assumptions & risk, stakeholder analysis & co-creation, program phasing (plan→build→implement→close).
+  Bárbara — Strategic Program Manager (pm squad). Executes: strategic project planning (goal→purpose→outcomes→activities), explicit assumptions & risk, stakeholder analysis & co-creation, program phasing (plan→build→implement→close), learning cadence (monitor/review/evaluate), cross-team dependency management.
 model: sonnet
 ---
 

package/config/claude-agents/strategy-director.md

@@ -1,7 +1,7 @@
 ---
 name: strategy-director
 description: >
-  Tomas — Chief Strategist (strategy squad). Executes: competitive strategy, business-flow visualization via dev/diagram (architecture + dataflow diagrams of business models and value chains), market analysis, business model design.
+  Tomas — Chief Strategist (strategy squad). Executes: competitive strategy, business-flow visualization via dev/diagram (architecture + dataflow diagrams of business models and value chains), market analysis, business model design, positioning, innovation strategy, scenario planning, trade-off framing (explicit choose A / NOT B).
 model: sonnet
 ---
 

package/config/claude-agents/trends-analyst.md

@@ -1,7 +1,7 @@
 ---
 name: trends-analyst
 description: >
-  Margarida — Trends & Niche Analyst (content squad). Executes: trend detection across platforms (Agent-Reach: X, Reddit, YouTube, RSS, Exa), viral-video deconstruction via dev/watch (scene-aware frames + transcript, timestamp-cited), niche viability scoring (audience size, competition density, monetization path, brand fit), platform algorithm shift monitoring.
+  Margarida — Trends & Niche Analyst (content squad). Executes: trend detection across platforms (Agent-Reach: X, Reddit, YouTube, RSS, Exa), viral-video deconstruction via dev/watch (scene-aware frames + transcript, timestamp-cited), niche viability scoring (audience size, competition density, monetization path, brand fit), platform algorithm shift monitoring, whitespace analysis for new channels and formats, content angle validation with hook material.
 model: sonnet
 ---
 

package/config/claude-agents/ux-designer.md

@@ -1,7 +1,7 @@
 ---
 name: ux-designer
 description: >
-  Sofia D. — UX/UI Designer (brand squad). Executes: product design (end-to-end, problem → outcome), human-centered design (Norman — affordances, signifiers, mental models), UX research & user testing, guerrilla / lightweight usability testing (Krug).
+  Sofia D. — UX/UI Designer (brand squad). Executes: product design (end-to-end, problem → outcome), human-centered design (Norman — affordances, signifiers, mental models), UX research & user testing, guerrilla / lightweight usability testing (Krug), wireframing & prototyping, information architecture, motion choreography and narrative structure via brand/motion-design, interaction design.
 model: opus
 ---
 

package/config/claude-agents/ux-researcher.md

@@ -1,7 +1,7 @@
 ---
 name: ux-researcher
 description: >
-  Renata — UX Researcher (brand squad). Executes: moderated & unmoderated usability testing, user interviews & ethnography, surveys (n >= 2000) & guerrilla research, research ops & insight repositories.
+  Renata — UX Researcher (brand squad). Executes: moderated & unmoderated usability testing, user interviews & ethnography, surveys (n >= 2000) & guerrilla research, research ops & insight repositories, consent & research ethics, assumption / hypothesis testing.
 model: sonnet
 ---
 

package/config/claude-agents/ux-strategist.md

@@ -1,7 +1,7 @@
 ---
 name: ux-strategist
 description: >
-  Júlia — UX Strategist (brand squad). Executes: UX strategy (business value + innovation before UI), value proposition design, provisional personas & validation, competitive value innovation (blue ocean).
+  Júlia — UX Strategist (brand squad). Executes: UX strategy (business value + innovation before UI), value proposition design, provisional personas & validation, competitive value innovation (blue ocean), storyboard & concept before pixels, product-market fit framing.
 model: sonnet
 ---
 

package/config/claude-agents/video-producer.md

@@ -1,7 +1,7 @@
 ---
 name: video-producer
 description: >
-  Simão — Video Producer & Production Lead (content squad). Executes: video production pipelines (script → storyboard → assets → edit → render), cut review via dev/watch (frame + transcript evidence on own renders before the Quality Gate), Hyperframes video-as-code editing (HTML/CSS/JS + GSAP → MP4), Higgsfield generation orchestration (image, video, audio, motion control, upscale, reframe).
+  Simão — Video Producer & Production Lead (content squad). Executes: video production pipelines (script → storyboard → assets → edit → render), cut review via dev/watch (frame + transcript evidence on own renders before the Quality Gate), Hyperframes video-as-code editing (HTML/CSS/JS + GSAP → MP4), Higgsfield generation orchestration (image, video, audio, motion control, upscale, reframe), shot lists and EDLs (scene/shot/VO/on-screen-text columns), transcription-synced cuts and word-level captions, multi-format delivery (16:9, 9:16, 1:1; YouTube, Reels, TikTok), backend degradation planning (full → server-side → edit-ready package).
 model: opus
 ---
 

package/config/claude-agents/viral-engineer.md

@@ -1,7 +1,7 @@
 ---
 name: viral-engineer
 description: >
-  Filipe — Viral Content Engineer (content squad). Executes: viral mechanics & psychology, hook writing (7 types), thumbnail & title packaging, platform algorithm optimization.
+  Filipe — Viral Content Engineer (content squad). Executes: viral mechanics & psychology, hook writing (7 types), thumbnail & title packaging, platform algorithm optimization, trend analysis & riding, short-form content (Reels, TikTok, Shorts).
 model: sonnet
 ---
 

package/config/claude-agents/visual-designer.md

@@ -1,7 +1,7 @@
 ---
 name: visual-designer
 description: >
-  Isabel — Visual Designer (brand squad). Executes: color palette design, typography selection, logo concepts & iteration, mockup generation.
+  Isabel — Visual Designer (brand squad). Executes: color palette design, typography selection, logo concepts & iteration, mockup generation, AI image generation prompts, brand guidelines execution, motion design language via brand/motion-design (Disney principles; §4 Motion System of the squad reference takes precedence), reference-driven style replication via brand/design-dna (3-dimension profile).
 model: opus
 ---
 

package/config/claude-agents/wcag-auditor.md

@@ -1,7 +1,7 @@
 ---
 name: wcag-auditor
 description: >
-  Oren — Accessibility Auditor (brand squad). Executes: WCAG 2.2 AA / AAA conformance auditing, color contrast ratio analysis (4.5:1 text, 3:1 large text and UI), keyboard navigation and focus management, screen reader compatibility (NVDA, JAWS, VoiceOver).
+  Oren — Accessibility Auditor (brand squad). Executes: WCAG 2.2 AA / AAA conformance auditing, color contrast ratio analysis (4.5:1 text, 3:1 large text and UI), keyboard navigation and focus management, screen reader compatibility (NVDA, JAWS, VoiceOver), ARIA pattern review (no-redundant-roles, correct landmarks), cognitive accessibility (reading level, error recovery), accessibility statement drafting.
 model: sonnet
 ---
 

package/config/skills-provenance.yaml

@@ -156,6 +156,17 @@ derived:
     origin: community
     source: https://github.com/lottiefiles/motion-design-skill
     license: MIT
+  # Animation/design absorption campaign PR-6 — the official GreenSock
+  # pack (MIT): eight upstream SKILL.md modules become references/ under
+  # one router slug (dev/diagram progressive-disclosure pattern), with
+  # sibling cross-refs rewritten from gsap-<name> to references/<name>.md.
+  # This absorption RETIRES the external dependency: the npx-skills-add
+  # instruction and every gsap-<name> load in brand/content/dev docs now
+  # point at the in-repo skill.
+  departments/dev/skills/gsap:
+    origin: community
+    source: https://github.com/greensock/gsap-skills
+    license: MIT
   # Marketing skills integration campaign — derived from
   # coreyhaines31/marketingskills (MIT). Frontmatter metadata must match
   # each entry field-for-field (test_registry_matches_frontmatter_field_for_field).

package/core/agents/behavioral_compiler.py

@@ -91,7 +91,7 @@ def load_agent_yaml(path: Path) -> dict:
 def _frontmatter(slug: str, data: dict) -> str:
     role = data.get("role", slug)
     dept = data.get("department", "")
-    domains = ", ".join((data.get("expertise") or {}).get("domains", [])[:4])
+    domains = ", ".join((data.get("expertise") or {}).get("domains", [])[:8])
     desc = f"{data.get('name', slug)} — {role} ({dept} squad)."
     if domains:
         desc += f" Executes: {domains}."

package/departments/brand/SKILL.md

@@ -35,6 +35,8 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 | `/brand ux-audit <url>` | UX heuristic audit (Nielsen 10) | Focused |
 | `/brand design-system` | Design system specification (Atomic Design) | Enterprise |
 | `/brand wireframe <page>` | UI wireframe and information architecture | Focused |
+| `/brand motion-design <brief>` | Motion direction (Disney principles, timing, choreography) | Focused |
+| `/brand design-dna <reference>` | Reverse-engineer a reference UI into a 3-dimension profile | Focused |
 
 ## Squad
 

package/departments/brand/agents/brand-director.yaml

@@ -57,6 +57,7 @@ expertise:
     - UX/UI strategy
     - design systems
     - brand voice & tone
+    - design DNA extraction and replicate-vs-differentiate calls via brand/design-dna (refusal layer, SSRF rules, attestation)
     - creative direction
   frameworks:
     - Primal Branding (Hanlon)

package/departments/brand/agents/design-ops/design-ops-lead.yaml

@@ -57,6 +57,7 @@ expertise:
     - figma → code pipelines
     - accessibility compliance (WCAG 2.2 AA/AAA)
     - cross-platform tokenisation (Style Dictionary, Tailwind)
+    - design-dna JSON custody and token handoff via brand/design-dna (phase-3 token file)
   frameworks:
     - Atomic Design (Frost)
     - Design Tokens Community Group

package/departments/brand/agents/design-ops/extraction-script-writer.yaml

@@ -52,8 +52,9 @@ expertise:
     - color palette reverse-engineering from screenshots / live DOM
     - typography token harvesting (font-family, size, weight, line-height scales)
     - spacing and grid token inference
-    - figma file parsing
-    - chromium-headless capture pipelines
+    - Figma file parsing
+    - Chromium-headless capture pipelines
+    - phase-2 extraction executor for brand/design-dna
   frameworks:
     - W3C Design Tokens spec
     - Style Dictionary

package/departments/brand/agents/ux-designer.yaml

@@ -51,6 +51,7 @@ expertise:
     - guerrilla / lightweight usability testing (Krug)
     - wireframing & prototyping
     - information architecture
+    - motion choreography and narrative structure via brand/motion-design
     - interaction design
     - design systems
     - accessibility (WCAG 2.1 AA)

package/departments/brand/agents/visual-designer.yaml

@@ -48,6 +48,8 @@ expertise:
     - mockup generation
     - AI image generation prompts
     - brand guidelines execution
+    - motion design language via brand/motion-design (Disney principles; §4 Motion System of the squad reference takes precedence)
+    - reference-driven style replication via brand/design-dna (3-dimension profile)
     - social media visual kits
   frameworks:
     - Dieter Rams 10 Principles

package/departments/brand/references/uiux-knowledge-and-tools.md

@@ -204,7 +204,7 @@ line BEFORE the first file edit:
   Airbnb…). Pick it FIRST and state what its design lead would reject in
   your plan.
 - `skills=` — the design skills ACTUALLY loaded this session via the
-  Skill tool (e.g. `frontend-design,ui-ux-pro-max,gsap-core`). If a
+  Skill tool (e.g. `frontend-design,ui-ux-pro-max,arka-gsap`). If a
   plugin is not installed, be honest: `skills=degraded:<missing-name>`
   and fall back to §3 + §8 of this reference. Never claim a load that
   did not happen; never silently proceed as if it had.
@@ -241,10 +241,13 @@ axis free, seed a direction from the curated TypeUI catalog
 
 Catalog tokens are a SEED for the project's own token system, never the
 final design system. Motion is absent from the catalog — that is GSAP's
-job: load `gsap-core` + `gsap-timeline` for any animation work,
-`gsap-scrolltrigger`/`gsap-plugins` as the work demands, `gsap-react` on
-React, and treat `gsap-performance` as the review bar
-(`npx skills add https://github.com/greensock/gsap-skills` when absent).
+job: load `Skill(arka-gsap)` (the in-repo `dev/gsap`, absorbed from the
+official GreenSock pack) and read `references/core.md` +
+`references/timeline.md` for any animation work,
+`references/scrolltrigger.md`/`references/plugins.md` as the work
+demands, `references/react.md` on React, and treat
+`references/performance.md` as the review bar. Direction (what moves and
+why) comes from `brand/motion-design` first.
 
 Four in-repo theme specs (hallmark-derived, opt-in seeds like the TypeUI
 directions — never the final system) live at

package/departments/brand/skills/design-system/SKILL.md

@@ -42,9 +42,9 @@ actually loaded:
 2. **`Skill(ui-ux-pro-max)`** — 161 palettes + 57 font pairings as
    comparative evidence for the primitive layer; never a pick-list.
 3. **Motion tokens involved?** Load `brand/motion-design` for the
-   direction (what moves, durations, easing families) and the GSAP
-   skills (`gsap-core`, `gsap-timeline`; `gsap-performance` as the
-   review bar) for the implementation.
+   direction (what moves, durations, easing families) and `dev/gsap`
+   for the implementation (its `references/core.md` + `references/timeline.md`;
+   `references/performance.md` as the review bar).
 4. **Aesthetic seed (optional, no visual history only)** — a curated
    TypeUI direction (`npx typeui.sh pull <slug>`, §10 of the squad
    reference) may seed primitives; it is never the final system.

package/departments/brand/skills/motion-design/SKILL.md

@@ -10,8 +10,9 @@ description: >
   "easing", "motion personality", "princípios Disney", "coreografia de
   animação", "motion system", "motion audit", "/brand motion-design".
   SKIP: writing the animation code once the direction exists ->
-  dev/css-native (pure CSS), dev/framer-motion (React) or
-  dev/canvas-generative (generative canvas); motion tokens inside a full
+  dev/gsap (timelines, scroll), dev/css-native (pure CSS),
+  dev/framer-motion (React) or dev/canvas-generative (generative
+  canvas); motion tokens inside a full
   design-system delivery -> brand/design-system (which loads this skill
   for its motion chapter); video production -> content/video-produce.
 allowed-tools: [Read, Write, Edit, Grep, Glob]

package/departments/content/skills/video-produce/SKILL.md

@@ -80,8 +80,8 @@ tier PER CAPABILITY. Print the matrix, state the tiers chosen, proceed
    explicitly re-stated downgrade to the Degraded/Manual tier.)
    Full tier: load the `/hyperframes` router skill, pick the
    workflow (`/talking-head-recut`, `/faceless-explainer`,
-   `/product-launch-video`…), compose in HTML+GSAP (load `gsap-core` +
-   `gsap-timeline` for motion graphics; `gsap-plugins` for kinetic
+   `/product-launch-video`…), compose in HTML+GSAP (load `dev/gsap` —
+   `references/core.md` + `references/timeline.md` for motion graphics; `references/plugins.md` for kinetic
    type/SplitText), add word-level captions (`/embedded-captions`),
    render MP4. Degraded tier: hand assets+script to Higgsfield
    `explainer_video`/`shorts_studio`. Manual tier: assemble the

package/departments/dev/SKILL.md

@@ -38,6 +38,11 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 | `/dev pipeline <project>` | CI/CD pipeline design and setup | Focused |
 | `/dev clean-review <file>` | Clean Code + SOLID compliance review | Specialist |
 | `/dev research <topic>` | Library evaluation and pattern discovery (KB + Context7 + gh-grep + web) | Specialist |
+| `/dev gsap <task>` | GSAP animation implementation (official pack; performance review bar) | Specialist |
+| `/dev threejs <scene>` | Real-time 3D with three.js / React Three Fiber | Specialist |
+| `/dev canvas-generative <effect>` | Generative Canvas 2D art (particles, noise, fractals) | Specialist |
+| `/dev framer-motion <component>` | React motion (AnimatePresence, layout, gestures) | Specialist |
+| `/dev css-native <effect>` | Zero-dependency modern CSS animation | Specialist |
 | `/dev spec <description>` | Create feature specification (mandatory pre-impl) | Specialist |
 | `/dev scaffold <type> <name>` | Project scaffolding from starter repos | Specialist |
 | `/dev do <description>` | Smart routing to the right dev command | Orchestrator |

package/departments/dev/agents/cto.yaml

@@ -56,7 +56,7 @@ expertise:
     - system design
     - tech strategy
     - cloud infrastructure
-    - ai/ml systems
+    - AI/ML systems
   frameworks:
     - Clean Architecture
     - DDD

package/departments/dev/agents/frontend-dev.yaml

@@ -52,6 +52,11 @@ expertise:
     - Nuxt 3
     - React 19 / Next.js 15
     - TypeScript
+    - GSAP + ScrollTrigger implementation via dev/gsap (performance.md as the review bar)
+    - real-time 3D and R3F scenes via dev/threejs (disposal doctrine, performance budget)
+    - generative canvas backgrounds via dev/canvas-generative
+    - React motion via dev/framer-motion
+    - zero-dependency CSS effects via dev/css-native
     - Tailwind CSS
     - Design system implementation
     - Accessibility (WCAG 2.1 AA)

package/departments/dev/skills/animated-website/references/motion-recipes.md

@@ -129,8 +129,9 @@ logo is forbidden). <!-- rule:motion-springs-physical-only -->
 | `stiffness: 280, damping: 26` | Stiff, minimal bounce | Picker snap; haptic-like press |
 | `stiffness: 400, damping: 40` | Very stiff, no bounce | Position corrections |
 
-For advanced sequences use libraries — GSAP first (hub §10: `gsap-core` +
-`gsap-timeline`, `gsap-performance` as the review bar), Web Animations
+For advanced sequences use libraries — GSAP first (`dev/gsap`:
+`references/core.md` + `references/timeline.md`, `references/performance.md` as the
+review bar), Web Animations
 API for programmatic control, Motion/Framer Motion on React.
 
 ## When to ship motion by default

package/departments/dev/skills/gsap/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: dev/gsap
+description: >
+  GSAP animation implementation from the official GreenSock skill pack:
+  core tweens and easing, timelines, ScrollTrigger, the plugin family
+  (Flip, Draggable, SplitText, MorphSVG…), utility helpers, framework
+  wiring, React's useGSAP, and the performance review bar — one router
+  with the eight official modules as progressive-disclosure references.
+  TRIGGER: "gsap", "scrolltrigger", "anima com gsap", "scroll-driven
+  animation em JS", "animate on scroll", "timeline animation", "pin/scrub
+  section", "parallax em código", "useGSAP", "/dev gsap".
+  SKIP: deciding WHAT should move and why (direction, easing families,
+  choreography) -> brand/motion-design; the same effect in pure CSS
+  (scroll timelines, view transitions) -> dev/css-native; React
+  spring/gesture idioms without GSAP -> dev/framer-motion; an existing
+  MP4 turned into a scroll site -> dev/animated-website; a pre-rendered
+  3D world scrubbed by scroll -> dev/scroll-world; real-time 3D ->
+  dev/threejs.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
+metadata:
+  origin: community
+  source: https://github.com/greensock/gsap-skills
+  license: MIT
+---
+
+<!-- arka:kb-first-prefix begin -->
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
+<!-- arka:kb-first-prefix end -->
+
+# GSAP — `/dev gsap`
+
+> **Agent:** Diana (Frontend Dev) | **Framework:** GSAP (official GreenSock skill pack)
+> Direction comes first: when the motion language is not yet decided,
+> `brand/motion-design` chooses what moves and why; this skill writes it.
+
+## How to use this router
+
+The eight official modules live under `references/`, upstream
+near-verbatim. Load the one the task needs — never all eight:
+
+| The task involves | Read |
+|---|---|
+| Basic tweens, easing, stagger, defaults, `matchMedia` (responsive, reduced-motion) | `references/core.md` |
+| Sequencing multiple steps, labels, position parameter | `references/timeline.md` |
+| Scroll-linked animation, pin, scrub, snap, batching | `references/scrolltrigger.md` |
+| Flip, Draggable, SplitText, MorphSVG, DrawSVG, MotionPath and the rest of the plugin family | `references/plugins.md` |
+| Install, licensing and `registerPlugin` — Club plugins are free now; never generate an `.npmrc` auth token | `references/plugins.md` |
+| Helpers — `clamp`, `mapRange`, `interpolate`, `snap`, `random` | `references/utils.md` |
+| Vue, Nuxt or Svelte wiring — mount/unmount cleanup contracts | `references/frameworks.md` |
+| React — `useGSAP`, scoping, SSR/Next.js | `references/react.md` |
+| Review bar before shipping: what to measure, what always janks | `references/performance.md` |
+
+Two rules that survive every module:
+
+1. **Cleanup is not optional.** Every tween/trigger created in a
+   component is killed on unmount — `gsap.context()` or `useGSAP` scope
+   handles it; a bare `gsap.to` in a framework component is a leak.
+2. **`references/performance.md` is the review bar**, not optional
+   reading: run its checklist on any GSAP work before the Quality Gate
+   sees it.
+
+## Output
+
+The working animation code with cleanup wired, the module(s) actually
+loaded named in one line, and the performance checklist result — plus,
+when direction came from `brand/motion-design`, the mapping from its
+choices (durations, easing families, choreography order) to the
+implemented tweens.