npm - @jaimevalasek/aioson - Versions diffs - 1.6.0 → 1.7.2 - Mend

@jaimevalasek/aioson 1.6.0 → 1.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (275) hide show

package/CHANGELOG.md +74 -0
package/README.md +729 -232
package/docs/design-previews/pt.squarespace.com-homepage.html +889 -0
package/docs/integrations/sdlc-genius-boundary.md +76 -0
package/docs/integrations/sdlc-genius-eval-matrix.md +75 -0
package/docs/integrations/sdlc-genius-install-checklist.md +93 -0
package/docs/integrations/sdlc-genius-review-samples.md +86 -0
package/docs/pt/README.md +3 -0
package/docs/pt/agentes.md +1 -0
package/docs/pt/comandos-cli.md +888 -2
package/docs/pt/design-hybrid-forge.md +255 -6
package/docs/pt/devlog-pipeline.md +270 -0
package/docs/pt/fluxo-artefatos.md +178 -0
package/docs/pt/hooks-session-guard.md +454 -0
package/docs/pt/monitor-de-contexto.md +59 -5
package/docs/pt/sdd-automation-scripts.md +557 -0
package/docs/pt/site-forge.md +309 -0
package/docs/pt/spec-learnings-pipeline.md +265 -0
package/package.json +1 -1
package/src/a2a/client.js +165 -0
package/src/a2a/server.js +223 -0
package/src/cli.js +235 -1
package/src/commands/agent-audit.js +397 -0
package/src/commands/agent-export-skill.js +229 -0
package/src/commands/artifact-validate.js +189 -0
package/src/commands/brief-gen.js +405 -0
package/src/commands/brief-validate.js +65 -0
package/src/commands/classify.js +256 -0
package/src/commands/context-compact.js +49 -0
package/src/commands/context-health.js +175 -0
package/src/commands/context-monitor.js +71 -0
package/src/commands/context-trim.js +177 -0
package/src/commands/detect-test-runner.js +55 -0
package/src/commands/devlog-export-brains.js +27 -0
package/src/commands/devlog-process.js +292 -0
package/src/commands/devlog-watch.js +131 -0
package/src/commands/feature-close.js +165 -0
package/src/commands/gate-check.js +228 -0
package/src/commands/hooks-emit.js +253 -0
package/src/commands/hooks-install.js +347 -0
package/src/commands/learning-auto-promote.js +195 -0
package/src/commands/learning-evolve.js +18 -9
package/src/commands/learning-export.js +103 -0
package/src/commands/learning-rollback.js +164 -0
package/src/commands/live.js +25 -1
package/src/commands/pattern-detect.js +33 -0
package/src/commands/preflight-context.js +30 -0
package/src/commands/preflight.js +208 -0
package/src/commands/pulse-update.js +130 -0
package/src/commands/runner-daemon.js +274 -0
package/src/commands/runner-plan.js +70 -0
package/src/commands/runner-queue-from-plan.js +166 -0
package/src/commands/runner-queue.js +189 -0
package/src/commands/runner-run.js +129 -0
package/src/commands/runtime.js +47 -1
package/src/commands/self-implement-loop.js +256 -0
package/src/commands/session-guard.js +218 -0
package/src/commands/sizing.js +165 -0
package/src/commands/skill.js +65 -0
package/src/commands/spec-checkpoint.js +177 -0
package/src/commands/spec-status.js +79 -0
package/src/commands/spec-sync.js +190 -0
package/src/commands/spec-tasks.js +288 -0
package/src/commands/squad-autorun.js +1220 -0
package/src/commands/squad-bus.js +217 -0
package/src/commands/squad-card.js +149 -0
package/src/commands/squad-daemon.js +134 -0
package/src/commands/squad-dependency-graph.js +164 -0
package/src/commands/squad-review.js +106 -0
package/src/commands/squad-scaffold.js +55 -0
package/src/commands/squad-tool-register.js +157 -0
package/src/commands/state-save.js +122 -0
package/src/commands/update.js +2 -0
package/src/commands/verify-gate.js +572 -0
package/src/commands/workflow-execute.js +241 -0
package/src/constants.js +22 -0
package/src/install-profile.js +2 -2
package/src/install-wizard.js +3 -2
package/src/installer.js +6 -0
package/src/lib/health-check.js +158 -0
package/src/lib/hook-protocol.js +76 -0
package/src/mcp/apps/squad-dashboard/app.js +163 -0
package/src/mcp/apps/squad-dashboard/index.html +261 -0
package/src/mcp/apps/squad-dashboard/mcp-manifest.json +23 -0
package/src/mcp/resources/squad-state.js +130 -0
package/src/preflight-engine.js +443 -0
package/src/runner/cascade.js +97 -0
package/src/runner/cli-launcher.js +109 -0
package/src/runner/plan-importer.js +63 -0
package/src/runner/queue-store.js +159 -0
package/src/runtime-store.js +61 -3
package/src/squad/agent-teams-adapter.js +264 -0
package/src/squad/brief-validator.js +350 -0
package/src/squad/bus-bridge.js +140 -0
package/src/squad/context-compactor.js +265 -0
package/src/squad/cross-ai-synthesizer.js +250 -0
package/src/squad/hooks-generator.js +196 -0
package/src/squad/inter-squad-events.js +175 -0
package/src/squad/intra-bus.js +345 -0
package/src/squad/learning-extractor.js +213 -0
package/src/squad/pattern-detector.js +365 -0
package/src/squad/preflight-context.js +296 -0
package/src/squad/recovery-context.js +242 -71
package/src/squad/reflection.js +365 -0
package/src/squad/squad-scaffold.js +177 -0
package/src/squad/state-manager.js +310 -0
package/src/squad/task-decomposer.js +652 -0
package/src/squad/verify-gate.js +303 -0
package/src/updater.js +4 -5
package/src/worker-runner.js +186 -1
package/template/.aioson/agents/analyst.md +62 -1
package/template/.aioson/agents/architect.md +61 -1
package/template/.aioson/agents/copywriter.md +463 -0
package/template/.aioson/agents/design-hybrid-forge.md +14 -0
package/template/.aioson/agents/dev.md +271 -25
package/template/.aioson/agents/deyvin.md +67 -8
package/template/.aioson/agents/discovery-design-doc.md +44 -0
package/template/.aioson/agents/genome.md +14 -0
package/template/.aioson/agents/neo.md +83 -2
package/template/.aioson/agents/orache.md +50 -4
package/template/.aioson/agents/orchestrator.md +197 -1
package/template/.aioson/agents/pm.md +35 -0
package/template/.aioson/agents/product.md +50 -5
package/template/.aioson/agents/profiler-enricher.md +14 -0
package/template/.aioson/agents/profiler-forge.md +14 -0
package/template/.aioson/agents/profiler-researcher.md +14 -0
package/template/.aioson/agents/qa.md +273 -21
package/template/.aioson/agents/setup.md +96 -10
package/template/.aioson/agents/sheldon.md +131 -6
package/template/.aioson/agents/site-forge.md +1753 -0
package/template/.aioson/agents/squad.md +352 -0
package/template/.aioson/agents/tester.md +53 -0
package/template/.aioson/agents/ux-ui.md +203 -4
package/template/.aioson/brains/README.md +128 -0
package/template/.aioson/brains/_index.json +16 -0
package/template/.aioson/brains/scripts/query.js +103 -0
package/template/.aioson/brains/site-forge/visual-patterns.brain.json +205 -0
package/template/.aioson/config.md +143 -13
package/template/.aioson/constitution.md +33 -0
package/template/.aioson/context/project-pulse.md +34 -0
package/template/.aioson/docs/LAYERS.md +79 -0
package/template/.aioson/docs/README.md +76 -0
package/template/.aioson/docs/example-external-api-context.md +72 -0
package/template/.aioson/genomes/copywriting.md +204 -0
package/template/.aioson/locales/en/agents/architect.md +17 -0
package/template/.aioson/locales/en/agents/dev.md +79 -13
package/template/.aioson/locales/en/agents/orache.md +6 -0
package/template/.aioson/locales/en/agents/orchestrator.md +24 -0
package/template/.aioson/locales/en/agents/product.md +50 -0
package/template/.aioson/locales/en/agents/sheldon.md +115 -0
package/template/.aioson/locales/en/agents/squad.md +14 -0
package/template/.aioson/locales/en/agents/tester.md +6 -0
package/template/.aioson/locales/es/agents/analyst.md +2 -0
package/template/.aioson/locales/es/agents/architect.md +19 -0
package/template/.aioson/locales/es/agents/dev.md +64 -4
package/template/.aioson/locales/es/agents/deyvin.md +2 -0
package/template/.aioson/locales/es/agents/discovery-design-doc.md +2 -0
package/template/.aioson/locales/es/agents/genome.md +2 -0
package/template/.aioson/locales/es/agents/neo.md +2 -0
package/template/.aioson/locales/es/agents/orache.md +2 -0
package/template/.aioson/locales/es/agents/orchestrator.md +26 -0
package/template/.aioson/locales/es/agents/pair.md +2 -0
package/template/.aioson/locales/es/agents/pm.md +2 -0
package/template/.aioson/locales/es/agents/product.md +52 -0
package/template/.aioson/locales/es/agents/profiler-enricher.md +2 -0
package/template/.aioson/locales/es/agents/profiler-forge.md +2 -0
package/template/.aioson/locales/es/agents/profiler-researcher.md +2 -0
package/template/.aioson/locales/es/agents/qa.md +2 -0
package/template/.aioson/locales/es/agents/setup.md +2 -0
package/template/.aioson/locales/es/agents/sheldon.md +117 -0
package/template/.aioson/locales/es/agents/squad.md +16 -0
package/template/.aioson/locales/es/agents/tester.md +9 -0
package/template/.aioson/locales/es/agents/ux-ui.md +2 -0
package/template/.aioson/locales/fr/agents/analyst.md +2 -0
package/template/.aioson/locales/fr/agents/architect.md +19 -0
package/template/.aioson/locales/fr/agents/dev.md +64 -4
package/template/.aioson/locales/fr/agents/deyvin.md +2 -0
package/template/.aioson/locales/fr/agents/discovery-design-doc.md +2 -0
package/template/.aioson/locales/fr/agents/genome.md +2 -0
package/template/.aioson/locales/fr/agents/neo.md +2 -0
package/template/.aioson/locales/fr/agents/orache.md +2 -0
package/template/.aioson/locales/fr/agents/orchestrator.md +26 -0
package/template/.aioson/locales/fr/agents/pair.md +2 -0
package/template/.aioson/locales/fr/agents/pm.md +2 -0
package/template/.aioson/locales/fr/agents/product.md +52 -0
package/template/.aioson/locales/fr/agents/profiler-enricher.md +2 -0
package/template/.aioson/locales/fr/agents/profiler-forge.md +2 -0
package/template/.aioson/locales/fr/agents/profiler-researcher.md +2 -0
package/template/.aioson/locales/fr/agents/qa.md +2 -0
package/template/.aioson/locales/fr/agents/setup.md +2 -0
package/template/.aioson/locales/fr/agents/sheldon.md +117 -0
package/template/.aioson/locales/fr/agents/squad.md +16 -0
package/template/.aioson/locales/fr/agents/tester.md +9 -0
package/template/.aioson/locales/fr/agents/ux-ui.md +2 -0
package/template/.aioson/locales/pt-BR/agents/analyst.md +64 -3
package/template/.aioson/locales/pt-BR/agents/architect.md +42 -0
package/template/.aioson/locales/pt-BR/agents/dev.md +147 -14
package/template/.aioson/locales/pt-BR/agents/deyvin.md +47 -0
package/template/.aioson/locales/pt-BR/agents/neo.md +62 -1
package/template/.aioson/locales/pt-BR/agents/orchestrator.md +158 -2
package/template/.aioson/locales/pt-BR/agents/pm.md +95 -1
package/template/.aioson/locales/pt-BR/agents/product.md +145 -18
package/template/.aioson/locales/pt-BR/agents/qa.md +16 -0
package/template/.aioson/locales/pt-BR/agents/setup.md +101 -18
package/template/.aioson/locales/pt-BR/agents/sheldon.md +132 -1
package/template/.aioson/locales/pt-BR/agents/squad.md +14 -0
package/template/.aioson/locales/pt-BR/agents/tester.md +449 -0
package/template/.aioson/rules/README.md +69 -0
package/template/.aioson/rules/data-format-convention.md +136 -0
package/template/.aioson/rules/example-monetary-values.md +30 -0
package/template/.aioson/schemas/squad-manifest.schema.json +124 -3
package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +2 -0
package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -0
package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +66 -0
package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +368 -0
package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -0
package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -0
package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -0
package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +165 -0
package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -0
package/template/.aioson/skills/marketing/references/fascinations.md +192 -0
package/template/.aioson/skills/marketing/references/five-acts.md +248 -0
package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -0
package/template/.aioson/skills/marketing/references/offer-structure.md +203 -0
package/template/.aioson/skills/marketing/references/one-belief.md +149 -0
package/template/.aioson/skills/marketing/references/patterns.md +218 -0
package/template/.aioson/skills/marketing/references/pms-research.md +193 -0
package/template/.aioson/skills/marketing/vsl-craft.md +385 -0
package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +1 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/analyst.md +30 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/architect.md +23 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/dev.md +47 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/deyvin.md +27 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +35 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/product.md +25 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/qa.md +30 -0
package/template/.aioson/skills/process/aioson-spec-driven/references/sheldon.md +25 -0
package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +4 -1
package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +15 -0
package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +32 -0
package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +20 -0
package/template/.aioson/skills/process/simplify/SKILL.md +173 -0
package/template/.aioson/skills/static/context-budget-guide.md +46 -0
package/template/.aioson/skills/static/harness-sensors.md +74 -0
package/template/.aioson/skills/static/landing-page-deploy.md +192 -0
package/template/.aioson/skills/static/landing-page-forge.md +730 -0
package/template/.aioson/skills/static/multi-agent-patterns.md +43 -0
package/template/.aioson/skills/static/react-motion-patterns.md +22 -0
package/template/.aioson/skills/static/static-html-patterns/checklists.md +43 -0
package/template/.aioson/skills/static/static-html-patterns/css-tokens.md +609 -0
package/template/.aioson/skills/static/static-html-patterns/motion.md +193 -0
package/template/.aioson/skills/static/static-html-patterns/premium.md +711 -0
package/template/.aioson/skills/static/static-html-patterns/structure.md +209 -0
package/template/.aioson/skills/static/static-html-patterns/utilities.md +190 -0
package/template/.aioson/skills/static/static-html-patterns.md +58 -1913
package/template/.aioson/skills/static/threejs-patterns.md +929 -0
package/template/.aioson/skills/static/ui-ux-modern.md +1 -0
package/template/.aioson/skills/static/web-research-cache.md +112 -0
package/template/.aioson/tasks/implementation-plan.md +21 -1
package/template/.aioson/tasks/squad-create.md +22 -0
package/template/.aioson/tasks/squad-design.md +30 -0
package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -0
package/template/.claude/commands/aioson/agent/design-hybrid-forge.md +5 -0
package/template/.claude/commands/aioson/agent/orache.md +5 -0
package/template/.claude/commands/aioson/agent/sheldon.md +5 -0
package/template/.claude/commands/aioson/agent/site-forge.md +5 -0
package/template/AGENTS.md +55 -3
package/template/CLAUDE.md +31 -0
package/template/OPENCODE.md +4 -0
package/template/researchs/.gitkeep +0 -0
package/template/.aioson/skills/design-system/components/SKILL.md:Zone.Identifier +0 -0
package/template/.aioson/skills/design-system/dashboards/SKILL.md:Zone.Identifier +0 -0
package/template/.aioson/skills/design-system/foundations/SKILL.md:Zone.Identifier +0 -0
package/template/.aioson/skills/design-system/motion/SKILL.md:Zone.Identifier +0 -0
package/template/.aioson/skills/design-system/patterns/SKILL.md:Zone.Identifier +0 -0

package/template/.aioson/skills/static/static-html-patterns/structure.md ADDED Viewed

@@ -0,0 +1,209 @@
+# Structure — HTML Production Shell
+> Load when building any landing page. Contains the Hero Law and the complete semantic HTML skeleton.
+---
+## 0. THE HERO LAW (read this first, it overrides everything)
+> **The hero section is NEVER a grid of cards.**
+> The hero is: full viewport height — background (animated mesh OR full-bleed photograph) — ONE large headline — ONE or TWO supporting lines — TWO buttons — optional social proof strip below. That is it.
+>
+> Card grids belong in the Features or Tools section. A hero with cards looks like a dashboard, not a landing page.
+>
+> For Bold & Cinematic: the hero background must be ALIVE (animated mesh gradient or parallax image).
+> For Clean & Luminous: the hero background must have generous whitespace and a large, confident headline.
+---
+## 1. HTML Structure — The Production Shell
+Every landing page follows this semantic skeleton:
+```html
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="description" content="[real product description]">
+  <title>[Product Name] — [Value Proposition]</title>
+  <!-- Preload critical fonts (eliminate layout shift) -->
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=[ChosenFont]:wght@400;500;600;700;800&display=swap" rel="stylesheet">
+  <!-- Inline critical CSS (above-the-fold only: reset, header, hero) -->
+  <style>
+    /* === CRITICAL CSS — inline here, rest in external file === */
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    html { font-size: 16px; scroll-behavior: smooth; }
+    body { font-family: var(--font-body); background: var(--color-bg); color: var(--color-text); -webkit-font-smoothing: antialiased; }
+    img { max-width: 100%; display: block; object-fit: cover; }
+    a { text-decoration: none; color: inherit; }
+    button { cursor: pointer; border: none; font: inherit; }
+    /* rest of CSS below */
+  </style>
+</head>
+<body>
+  <!-- HEADER: sticky, transparent → solid on scroll -->
+  <header class="header" id="header">
+    <div class="container header__inner">
+      <a href="/" class="header__logo" aria-label="Home">
+        <span class="logo-mark">●</span>
+        <span class="logo-text">ProductName</span>
+      </a>
+      <nav class="header__nav" aria-label="Main navigation">
+        <a href="#features">Features</a>
+        <a href="#how-it-works">How it works</a>
+        <a href="#pricing">Pricing</a>
+      </nav>
+      <a href="#cta" class="btn btn--primary btn--sm">Get started</a>
+      <button class="header__burger" aria-label="Open menu" aria-expanded="false">
+        <span></span><span></span><span></span>
+      </button>
+    </div>
+  </header>
+  <main>
+    <!-- HERO: full viewport, image/gradient + content -->
+    <section class="hero" aria-labelledby="hero-title">
+      <div class="hero__bg">
+        <img src="https://images.unsplash.com/photo-[id]?w=1920&q=80&fit=crop"
+             alt="" role="presentation" loading="eager" fetchpriority="high">
+        <div class="hero__overlay" aria-hidden="true"></div>
+      </div>
+      <div class="container hero__content">
+        <span class="hero__label reveal">Category / Tagline</span>
+        <h1 class="hero__title reveal reveal-delay-1" id="hero-title">
+          Bold Headline That <em class="gradient-text">Changes Everything</em>
+        </h1>
+        <p class="hero__subtitle reveal reveal-delay-2">
+          Supporting text that adds real context — who benefits, how fast, what outcome.
+        </p>
+        <div class="hero__actions reveal reveal-delay-3">
+          <a href="#signup" class="btn btn--primary btn--lg">Primary CTA</a>
+          <a href="#demo" class="btn btn--ghost btn--lg">
+            <span class="btn__icon" aria-hidden="true">▶</span>
+            Watch demo
+          </a>
+        </div>
+        <div class="hero__social-proof reveal reveal-delay-4">
+          <span>Trusted by 2,000+ teams</span>
+          <div class="avatar-group" aria-label="User avatars">
+            <img src="https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=40&h=40&fit=crop&crop=face" alt="User" width="40" height="40">
+            <img src="https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=40&h=40&fit=crop&crop=face" alt="User" width="40" height="40">
+            <img src="https://images.unsplash.com/photo-1527980965255-d3b416303d12?w=40&h=40&fit=crop&crop=face" alt="User" width="40" height="40">
+          </div>
+          <div class="star-rating" aria-label="5 out of 5 stars">★★★★★ <span>4.9</span></div>
+        </div>
+      </div>
+      <!-- Decorative floating elements (aria-hidden) -->
+      <div class="hero__decor" aria-hidden="true">
+        <div class="orb orb--1"></div>
+        <div class="orb orb--2"></div>
+        <div class="orb orb--3"></div>
+      </div>
+    </section>
+    <!-- LOGOS: social proof bar -->
+    <section class="logos-bar" aria-label="Trusted by">
+      <div class="container">
+        <p class="logos-bar__label">Trusted by teams at</p>
+        <div class="logos-bar__track">
+          <!-- Logo images or text placeholders -->
+        </div>
+      </div>
+    </section>
+    <!-- FEATURES: 3 or 6 cards in grid -->
+    <section class="features" id="features" aria-labelledby="features-title">
+      <div class="container">
+        <div class="section-header">
+          <span class="section-label">Features</span>
+          <h2 class="section-title" id="features-title">Everything you need</h2>
+          <p class="section-subtitle">One sentence expanding on the value.</p>
+        </div>
+        <div class="features__grid">
+          <article class="feature-card reveal">
+            <div class="feature-card__icon" aria-hidden="true">⚡</div>
+            <h3 class="feature-card__title">Feature Name</h3>
+            <p class="feature-card__desc">What it does and why it matters to the user.</p>
+          </article>
+          <!-- repeat 5 more -->
+        </div>
+      </div>
+    </section>
+    <!-- HOW IT WORKS: numbered steps, alternating layout -->
+    <section class="how-it-works" id="how-it-works" aria-labelledby="hiw-title">
+      <div class="container">
+        <div class="section-header">
+          <span class="section-label">Process</span>
+          <h2 class="section-title" id="hiw-title">How it works</h2>
+        </div>
+        <ol class="steps" role="list">
+          <li class="step reveal">
+            <span class="step__number" aria-hidden="true">01</span>
+            <div class="step__content">
+              <h3>Step title</h3>
+              <p>Explanation focused on what the user does and gets.</p>
+            </div>
+            <div class="step__visual">
+              <img src="https://images.unsplash.com/photo-[id]?w=600&q=80" alt="[descriptive alt]" loading="lazy">
+            </div>
+          </li>
+        </ol>
+      </div>
+    </section>
+    <!-- TESTIMONIALS -->
+    <section class="testimonials" aria-labelledby="testimonials-title">
+      <div class="container">
+        <h2 class="section-title" id="testimonials-title">What teams say</h2>
+        <div class="testimonials__grid">
+          <blockquote class="testimonial-card reveal">
+            <p class="testimonial-card__quote">"Specific outcome they achieved using the product."</p>
+            <footer class="testimonial-card__author">
+              <img src="https://images.unsplash.com/photo-[id]?w=48&h=48&fit=crop&crop=face"
+                   alt="[Name]" width="48" height="48" loading="lazy">
+              <div>
+                <cite class="testimonial-card__name">Full Name</cite>
+                <span class="testimonial-card__role">Role, Company</span>
+              </div>
+            </footer>
+          </blockquote>
+        </div>
+      </div>
+    </section>
+    <!-- FINAL CTA -->
+    <section class="cta-final" id="cta" aria-labelledby="cta-title">
+      <div class="container">
+        <h2 class="cta-final__title reveal" id="cta-title">Ready to get started?</h2>
+        <p class="cta-final__subtitle reveal reveal-delay-1">Join thousands of teams already using [Product].</p>
+        <a href="#signup" class="btn btn--primary btn--xl reveal reveal-delay-2">Start for free</a>
+        <p class="cta-final__note">No credit card required · Cancel anytime</p>
+      </div>
+    </section>
+  </main>
+  <footer class="footer" role="contentinfo">
+    <div class="container footer__inner">
+      <a href="/" class="footer__logo" aria-label="Home">ProductName</a>
+      <nav class="footer__nav" aria-label="Footer navigation">
+        <a href="/privacy">Privacy</a>
+        <a href="/terms">Terms</a>
+        <a href="/contact">Contact</a>
+      </nav>
+      <p class="footer__copy">© 2026 ProductName. All rights reserved.</p>
+    </div>
+  </footer>
+  <!-- Scripts: async, non-blocking -->
+  <script async src="main.js"></script>
+</body>
+</html>
+```

package/template/.aioson/skills/static/static-html-patterns/utilities.md ADDED Viewed

@@ -0,0 +1,190 @@
+# Utilities — Performance, JS, BEM, Responsive, A11y, Images, SCSS
+> Load when you need: performance rules, minimal JS patterns, naming conventions,
+> responsive strategy, accessibility checklist, Unsplash image IDs, or SCSS architecture.
+> These sections are short — all included in one file for convenience.
+---
+## 3. Performance Patterns (always apply)
+```html
+<!-- Critical: preconnect fonts before CSS -->
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<!-- Hero image: eager + fetchpriority for LCP -->
+<img src="hero.jpg" loading="eager" fetchpriority="high" alt="">
+<!-- Below-fold images: lazy -->
+<img src="feature.jpg" loading="lazy" alt="[descriptive]">
+<!-- Non-critical CSS: preload then apply -->
+<link rel="preload" href="styles.css" as="style" onload="this.onload=null;this.rel='stylesheet'">
+<noscript><link rel="stylesheet" href="styles.css"></noscript>
+<!-- Scripts: always async or defer -->
+<script async src="analytics.js"></script>
+<script defer src="interactions.js"></script>
+```
+**Critical CSS inline rule:** Only header + hero CSS in `<style>` tag. Everything else in external file.
+---
+## 4. Minimal JavaScript (interactions only)
+```js
+// Header: add .scrolled class after scroll
+window.addEventListener('scroll', () => {
+  document.getElementById('header')
+    .classList.toggle('scrolled', window.scrollY > 40);
+}, { passive: true });
+// Mobile menu toggle
+document.querySelector('.header__burger')?.addEventListener('click', function() {
+  const expanded = this.getAttribute('aria-expanded') === 'true';
+  this.setAttribute('aria-expanded', String(!expanded));
+  document.querySelector('.header__nav').classList.toggle('open', !expanded);
+});
+// Scroll reveal with IntersectionObserver
+const observer = new IntersectionObserver((entries) => {
+  entries.forEach(entry => {
+    if (entry.isIntersecting) {
+      entry.target.classList.add('revealed');
+      observer.unobserve(entry.target);
+    }
+  });
+}, { threshold: 0.15 });
+document.querySelectorAll('.reveal').forEach(el => observer.observe(el));
+// Counter animation (for stats section)
+function animateCounter(el) {
+  const target = +el.dataset.target;
+  const duration = 1500;
+  const start = performance.now();
+  requestAnimationFrame(function tick(now) {
+    const progress = Math.min((now - start) / duration, 1);
+    const eased = 1 - Math.pow(1 - progress, 3); // ease-out cubic
+    el.textContent = Math.round(eased * target).toLocaleString();
+    if (progress < 1) requestAnimationFrame(tick);
+  });
+}
+```
+---
+## 5. CSS Naming Convention (BEM-lite)
+```
+component           → .hero, .feature-card, .testimonial-card
+component__element  → .hero__title, .feature-card__icon
+component--modifier → .btn--primary, .btn--lg, .card--glow-border
+```
+Rules:
+- Class names are lowercase, hyphenated
+- No deep nesting in CSS (max 2 levels: `.hero .hero__content`)
+- No `id` for styling — only for anchor links and `aria-labelledby`
+- Utility classes for single-purpose overrides: `.sr-only`, `.reveal`, `.gradient-text`
+---
+## 6. Responsive Strategy
+**Do NOT just reflow columns on mobile. Also:**
+- Hide secondary navigation links → show only logo + CTA + burger
+- Reduce heading sizes with `clamp()` instead of media queries for font-size
+- Stack `.hero__actions` buttons vertically below 480px
+- Remove decorative orbs/blobs on mobile (performance + layout stability)
+- Simplify card grids: 3 → 2 → 1 columns
+- Show testimonials as carousel or stacked, not 3-column grid
+```css
+/* Prefer clamp() for fluid typography over breakpoint-heavy font-size */
+.hero__title { font-size: clamp(2rem, 6vw, 4.5rem); }
+.section-title { font-size: clamp(1.875rem, 4vw, 3rem); }
+/* Hide decorative elements on mobile */
+@media (max-width: 768px) {
+  .hero__decor { display: none; }
+  .header__nav { display: none; }
+  .header__nav.open { display: flex; flex-direction: column; }
+  .hero__actions { flex-direction: column; align-items: center; }
+}
+```
+---
+## 7. Accessibility Checklist (non-negotiable)
+- [ ] All `<img>` have `alt` — decorative images use `alt=""` + `role="presentation"`
+- [ ] All interactive elements reachable by `Tab` and operable by `Enter`/`Space`
+- [ ] `:focus-visible` styles visible and clear (2px outline, offset, accent color)
+- [ ] All `<button>` have `type="button"` or `type="submit"`
+- [ ] Icon-only buttons have `aria-label`
+- [ ] Sections have `aria-labelledby` pointing to their heading `id`
+- [ ] Color contrast ≥ 4.5:1 for body text, ≥ 3:1 for large text and UI controls
+- [ ] `prefers-reduced-motion: reduce` disables all animations
+- [ ] Mobile menu uses `aria-expanded` toggling
+- [ ] Footer `<nav>` has `aria-label="Footer navigation"` distinct from header nav
+---
+## 8. Curated Unsplash Images by Domain
+Format: `https://images.unsplash.com/photo-{ID}?w=1920&q=80&fit=crop`
+| Domain | Hero | Feature/Section |
+|---|---|---|
+| Tech/AI/SaaS | `1518770660439-4636190af475` | `1551288049-bebda4e38f71` |
+| Business/Corp | `1497366216548-37526070297c` | `1522071820081-009f0129c71c` |
+| Creative/Agency | `1558618666-fcd25c85cd64` | `1504607798333-52a30db54a5d` |
+| Wellness/Health | `1506905925346-21bda4d32df4` | `1571019613454-1cb2f99b2d8b` |
+| Food/Restaurant | `1414235077428-338989a2e8c0` | `1555939594-58d7cb561ad1` |
+| Architecture | `1486325212027-8081e485255e` | `1460317442991-0ec209397118` |
+| Nature/Travel | `1441974231531-c6227db76b6e` | `1506197603052-3cc9c3a201bd` |
+| People/Teams | `1522202176988-66273c2fd55f` | `1582213782179-e0d53f98f2ca` |
+| Avatars (face) | `1535713875002-d1d0cf377fde` | `1494790108377-be9c29b29330` |
+Face crops (for testimonials): append `&w=48&h=48&fit=crop&crop=face`
+---
+## 11. SCSS Architecture (for larger projects)
+```
+assets/scss/
+  base/
+    _reset.scss        ← minimal reset + box-model
+    _typography.scss   ← font imports, type scale, body
+    _helpers.scss      ← .sr-only, .reveal, .gradient-text, .container
+  tokens/
+    _colors.scss       ← CSS custom properties :root block
+    _spacing.scss      ← --space-* tokens
+    _typography.scss   ← --font-*, --text-* tokens
+    _motion.scss       ← --ease-*, --duration-* tokens
+  layout/
+    _header.scss
+    _footer.scss
+    _grid.scss
+  components/
+    _buttons.scss
+    _cards.scss
+    _forms.scss
+    _modal.scss
+    _accordion.scss
+    _slider.scss
+  sections/
+    _hero.scss
+    _features.scss
+    _how-it-works.scss
+    _testimonials.scss
+    _pricing.scss
+    _faq.scss
+    _cta-final.scss
+  main.scss            ← @forward all partials in order
+```
+**Compile:** `sass assets/scss/main.scss assets/css/main.min.css --style=compressed --watch`