@jaimevalasek/aioson 1.6.0 → 1.7.0

package/template/.aioson/schemas/squad-manifest.schema.json

@@ -98,9 +98,9 @@
           "title": { "type": "string" },
           "type": {
             "type": "string",
-            "enum": ["worker", "agent", "clone", "assistant", "human-gate"],
+            "enum": ["worker", "agent", "clone", "assistant", "human-gate", "research", "reviewer", "skill"],
             "default": "agent",
-            "description": "Executor type: worker (deterministic script, no LLM), agent (LLM with defined role), clone (cognitive replica of real person), assistant (domain specialist with behavioral profile), human-gate (human approval checkpoint)"
+            "description": "Executor type: worker (deterministic script, no LLM), agent (LLM with defined role), clone (cognitive replica of real person), assistant (domain specialist with behavioral profile), human-gate (human approval checkpoint), research (web research with cache, no LLM), reviewer (cross-AI review synthesis), skill (external Agent Skills Standard skill)"
           },
           "role": { "type": "string" },
           "file": { "type": "string" },
@@ -121,6 +121,14 @@
             "type": "string",
             "description": "Script path for worker executors"
           },
+          "skill": {
+            "type": "string",
+            "description": "Agent Skills Standard skill identifier (for type: 'skill'). E.g. '@anthropic/code-review'"
+          },
+          "source": {
+            "type": "string",
+            "description": "Skill source path or package. E.g. 'npm:@org/skill', './skills/my-skill/'"
+          },
           "domain": {
             "type": "string",
             "description": "Specialized domain for assistant executors"
@@ -198,11 +206,85 @@
                 "order": { "type": "integer", "minimum": 1 },
                 "file": { "type": "string", "description": "Path to the task .md file" },
                 "input": { "type": "string", "description": "What this task receives" },
-                "output": { "type": "string", "description": "What this task produces" }
+                "output": { "type": "string", "description": "What this task produces" },
+                "review_loop": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Enable evaluator-optimizer loop: dev implements, qa evaluates, repeat up to max_review_iterations"
+                },
+                "review_criteria": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "description": "Criteria the evaluator uses to PASS/FAIL the output (used with review_loop: true)"
+                },
+                "max_review_iterations": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5,
+                  "default": 3,
+                  "description": "Maximum dev→qa iterations before escalating to human (used with review_loop: true)"
+                },
+                "voting": {
+                  "type": "object",
+                  "description": "Sampling-and-Voting: run N parallel instances and reach consensus. Best for critical decisions.",
+                  "properties": {
+                    "instances": {
+                      "type": "integer",
+                      "minimum": 2,
+                      "maximum": 10,
+                      "default": 3,
+                      "description": "Number of parallel instances to spawn"
+                    },
+                    "threshold": {
+                      "type": "number",
+                      "minimum": 0.5,
+                      "maximum": 1,
+                      "default": 0.66,
+                      "description": "Minimum consensus fraction to accept result (0.66 = 66%)"
+                    },
+                    "on_no_consensus": {
+                      "type": "string",
+                      "enum": ["escalate", "use_majority", "fail"],
+                      "default": "escalate",
+                      "description": "What to do when consensus < threshold"
+                    }
+                  }
+                }
               }
             },
             "description": "Granular tasks within this executor, executed in order"
           },
+          "research": {
+            "type": "object",
+            "description": "Configuration for research executor type (type: 'research')",
+            "properties": {
+              "topic": { "type": "string", "description": "Cache key / topic slug (e.g. 'youtube-shorts-2026')" },
+              "urls": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "URLs to scrape for this research topic"
+              },
+              "cache_hours": { "type": "integer", "default": 168, "description": "Cache TTL in hours (default 168 = 7 days)" },
+              "cache_dir": { "type": "string", "default": "researchs/", "description": "Base directory for research cache" },
+              "max_sources": { "type": "integer", "default": 5, "description": "Maximum number of URLs to scrape" }
+            }
+          },
+          "cross_ai": {
+            "type": "boolean",
+            "description": "If true (for reviewer type), send to multiple AI CLIs and synthesize responses"
+          },
+          "review": {
+            "type": "object",
+            "description": "Configuration for reviewer executor type",
+            "properties": {
+              "detect_clis": {
+                "type": "array",
+                "items": { "type": "string", "enum": ["claude", "gemini", "codex"] }
+              },
+              "exclude_current": { "type": "boolean", "default": true },
+              "synthesize_to": { "type": "string", "description": "Output path for REVIEWS.md" }
+            }
+          },
           "formats": {
             "type": "array",
             "items": { "type": "string" },
@@ -705,5 +787,44 @@
       }
     }
   },
+  "depends_on": {
+    "type": "array",
+    "description": "Inter-squad dependencies: this squad will consume published events from these squads before starting a run",
+    "items": {
+      "type": "object",
+      "required": ["squad", "event"],
+      "properties": {
+        "squad": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$",
+          "description": "Slug of the squad whose events this squad depends on"
+        },
+        "event": {
+          "type": "string",
+          "description": "Event pattern to subscribe to (e.g. 'episode.created', 'review.*', '*')"
+        },
+        "input_mapping": {
+          "type": "object",
+          "description": "Maps event payload fields to task context fields",
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    }
+  },
+  "hooks": {
+    "type": "object",
+    "description": "Hook scripts that gate squad execution (exit 0=allow, exit 2=deny)",
+    "properties": {
+      "pre_run": {
+        "type": "string",
+        "description": "Shell command to run before squad:autorun starts. Exit code 2 aborts the run."
+      }
+    }
+  },
+  "subscriptions": {
+    "type": "array",
+    "description": "Event patterns this squad subscribes to (consumed at the start of each autorun). Short form of depends_on[*].event.",
+    "items": { "type": "string" }
+  },
   "additionalProperties": true
 }

package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json

@@ -0,0 +1,31 @@
+{
+  "id": "pt.squarespace.com",
+  "name": "Squarespace Design System",
+  "source": "https://pt.squarespace.com/",
+  "extractedAt": "2026-03-31",
+  "theme": "light-dark",
+  "baseUnit": "4px",
+  "referenceSkill": null,
+  "type": "extracted",
+  "designPillars": [
+    "Sharp minimalism — zero border-radius",
+    "Bold typographic hierarchy — Clarkson font family",
+    "High contrast — black/white with teal accents"
+  ],
+  "colors": {
+    "primary": "#000000",
+    "accent": "#1E4C41",
+    "background": "#FFFFFF",
+    "surface": "#F5F5F4"
+  },
+  "fonts": {
+    "display": "Clarkson, Helvetica, sans-serif",
+    "body": "Helvetica Neue, Helvetica, Arial, sans-serif",
+    "serif": "Clarkson Serif, Georgia, serif"
+  },
+  "breakpoints": {
+    "desktop": 1440,
+    "tablet": 768,
+    "mobile": 390
+  }
+}

package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md

@@ -0,0 +1,66 @@
+# Squarespace (pt.squarespace.com) Design System
+
+> Extracted from https://pt.squarespace.com/ on 2026-03-31.
+> Deep analysis completed 2026-04-01 via static file extraction (CSS/JS/fonts/media from saved site).
+> Visual clone skill — do not use in unrelated projects without adapting the tokens.
+
+## Identity
+
+**Theme:** light (with dark hero/footer sections)
+**Personality:** Clean, professional SaaS aesthetic with strong typographic hierarchy, minimal decoration, and bold black-white contrast punctuated by occasional teal accents.
+
+## Design pillars
+
+1. **Sharp minimalism** — Zero border-radius throughout; geometric precision dominates
+2. **Bold typographic hierarchy** — Large headlines (Clarkson 300), clear size differentiation
+3. **High contrast** — Black and white with teal accent; no gradients, no shadows
+
+## Animation philosophy
+
+**CSS-first, zero third-party libraries.** No GSAP, no Framer Motion, no AOS, no Lottie.
+All animations are pure `@keyframes` + class toggling + `IntersectionObserver`.
+
+Signature effects:
+- CTA hover: `mix-blend-mode: difference` pseudo-element (not a color transition)
+- Mobile menu: `clip-path: polygon()` swipe animation (not `translateX`)
+- Link underline: `background-position` animated on two linear-gradients
+- Scroll reveals: `IntersectionObserver` adds `.in-view`, CSS handles transition
+
+## Local assets available
+
+These files were extracted from the saved site and are ready to use directly:
+
+**Fonts** (`public/fonts/`):
+- `clarkson-300.woff2` — Clarkson Light (hero headlines)
+- `clarkson-400.woff2` — Clarkson Regular (body, nav)
+- `clarkson-500.woff2` — Clarkson Medium (CTAs, labels)
+- `clarkson-serif-300.woff2` — Clarkson Serif Light
+- `clarkson-serif-400.woff2` — Clarkson Serif Regular
+
+**Videos** (`public/videos/pt.squarespace.com/`):
+- `video-desktop.webm` + `.mp4` — Hero background video (1280×720)
+- `video-mobile.webm` + `.mp4` — Hero background video, portrait-optimized
+- `templates.webm` + `.mp4` — Template showcase animation
+- `blueprint-ai.webm` + `.mp4` — AI blueprint feature demo
+- `design-intelligence-3.mp4` — Design intelligence card video
+- `conversion-centered.mp4` — Final CTA section video
+
+> Reference files — replace with your own assets before publishing.
+
+## When to use
+
+Activate when building projects that need a professional, clean SaaS website aesthetic inspired by Squarespace's homepage — minimal, typography-forward, with dark hero sections and teal accents.
+
+## Activation
+
+Load `references/design-tokens.md` before writing any component.
+Load `references/motion.md` before implementing any animation or interaction.
+Load `references/components.md` to get the real class naming conventions and hover mechanics.
+
+## Skill files
+
+- `references/design-tokens.md` — CSS custom properties (colors, typography, spacing, real easing curves)
+- `references/components.md` — Component patterns, real class names, CTA hover mechanics
+- `references/patterns.md` — Page layout patterns with real section IDs
+- `references/motion.md` — All 12 extracted @keyframes, exact timings, animation usage map
+- `references/websites.md` — Complete page topology including all 11 sections

package/template/.aioson/skills/design/pt.squarespace.com/references/components.md

@@ -0,0 +1,368 @@
+# Components — pt.squarespace.com
+
+## Button
+
+### Variants
+
+| Variant | Description | Token Usage |
+|---------|-------------|-------------|
+| `primary` | Solid white bg, dark text | `bg: white`, `color: black` |
+| `secondary` | Ghost/outline style | `border: 1px solid var(--border)` |
+| `inline` | Text with arrow suffix | `color: var(--text-primary)` |
+| `cta--light` | For dark backgrounds | `bg: white`, `color: black` |
+| `cta--dark` | For light backgrounds | `bg: black`, `color: white` |
+
+### States
+
+- **default:** Base colors per variant
+- **hover (primary/secondary):** `mix-blend-mode: difference` pseudo-element scales in — NOT a color transition. The white pseudo-element with blend mode creates a color inversion effect.
+- **active:** Slight scale (0.98) if any
+- **disabled:** `opacity: 0.5`, `pointer-events: none`
+- **loading:** Spinner or text change
+
+### CTA Hover Mechanic — mix-blend-mode: difference
+
+**This is Squarespace's real CTA effect.** Do NOT implement as a simple `background-color` transition:
+
+```css
+.cta--primary,
+.cta--secondary {
+  position: relative;
+  overflow: hidden;
+}
+
+.cta--primary::after,
+.cta--secondary::after {
+  content: '';
+  mix-blend-mode: difference;
+  background-color: white;
+  transform-origin: 0;
+  width: 100%;
+  height: 100%;
+  position: absolute;
+  top: 0;
+  left: 0;
+  transform: scaleX(0);
+  transition: transform 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
+}
+
+.cta--primary:hover::after,
+.cta--secondary:hover::after {
+  transform: scaleX(1);
+}
+```
+
+**Effect:** The white fill + `difference` blend mode inverts the button colors — a black button with white text becomes white with black text without any `color:` change.
+
+### DOM Structure
+```html
+<a class="cta cta--primary cta--light">Button Text</a>
+<!-- or -->
+<button class="cta cta--primary">Button Text</button>
+```
+
+### Tokens Applied
+- `font-family: var(--font-display)`
+- `font-size: var(--text-sm)`
+- `font-weight: var(--font-medium)`
+- `padding: var(--space-3) var(--space-4)`
+- `border-radius: var(--radius-none)` (0px)
+- `transition: var(--transition-all)`
+- `cursor: pointer`
+
+### Tertiary CTA — Sliding Underline (.cta--tertiary)
+
+Text links with an animated dual-gradient underline. The underline slides in from left on hover and out to right on mouse-leave:
+
+```css
+.cta--tertiary {
+  background-image:
+    linear-gradient(currentColor, currentColor),
+    linear-gradient(currentColor, currentColor);
+  background-size: 100% 1px, 0% 1px;
+  background-repeat: no-repeat;
+  background-position: -200% 100%, -100% 100%;
+  animation: 0.5s cubic-bezier(0.645, 0.045, 0.355, 1) forwards ctaUnderlineSlideOut;
+}
+
+.cta--tertiary:hover {
+  animation: 0.5s cubic-bezier(0.645, 0.045, 0.355, 1) forwards ctaUnderlineSlideIn;
+}
+```
+
+Requires `@keyframes ctaUnderlineSlideIn / ctaUnderlineSlideOut` from `motion.md`.
+
+---
+
+## Navigation
+
+### Variants
+
+| Variant | Description |
+|---------|-------------|
+| `desktop` | Horizontal links, logo left, CTAs right |
+| `mobile` | Hamburger + slide-out drawer |
+
+### States
+
+- **default:** Transparent background initially
+- **scrolled:** Solid background (e.g. `bg: white`) kicks in after ~50px scroll
+- **mobile-open:** Hamburger becomes X, drawer wipes in from right via `clip-path` animation (NOT `translateX`)
+
+### Mobile Menu — clip-path Swipe
+
+The mobile drawer does NOT use `transform: translateX`. It uses `clip-path: polygon()` animation:
+
+```css
+/* Open */
+.global-navigation__mobile-menu--open {
+  animation: 0.6s cubic-bezier(0.165, 0.84, 0.44, 1) forwards swipeIn;
+}
+
+/* Close */
+.global-navigation__mobile-menu--close {
+  animation: 0.6s cubic-bezier(0.165, 0.84, 0.44, 1) forwards swipeOut;
+}
+```
+
+Requires `@keyframes swipeIn / swipeOut` from `motion.md`. The menu covers full viewport, background `rgb(0, 0, 0)` with white links.
+
+### Accordion (Mobile Nav)
+
+Sub-menus use CSS grid transition — no JS height calculation:
+
+```css
+.global-navigation__accordion-content {
+  display: grid;
+  grid-template-rows: 0fr;
+  transition: grid-template-rows 0.7s cubic-bezier(0.165, 0.84, 0.44, 1),
+              padding 0.7s cubic-bezier(0.165, 0.84, 0.44, 1);
+}
+.global-navigation__accordion-content--open {
+  grid-template-rows: 1fr;
+}
+```
+
+### DOM Structure
+```html
+<header class="global-navigation">
+  <a class="global-navigation__logo-link">Logo</a>
+  <nav class="global-navigation__links">
+    <a class="cta cta--inline">Products</a>
+    <a class="cta cta--inline">Solutions</a>
+    <button class="cta cta--inline">Resources</button>
+  </nav>
+  <div class="global-navigation__cta">
+    <a class="cta cta--inline">Login</a>
+    <a class="cta cta--primary cta--light">Get Started</a>
+  </div>
+  <button class="global-navigation__hamb">☰</button>
+</header>
+```
+
+### Tokens Applied
+- `font-family: var(--font-body)`
+- `font-size: var(--text-base)`
+- `font-weight: var(--font-normal)`
+- `padding: var(--space-4) var(--space-4)`
+- `gap: var(--space-4)`
+- `transition: top var(--transition-medium) var(--ease-sqsp-cta)`
+
+---
+
+## Link
+
+### Variants
+
+| Variant | Description | Context |
+|---------|-------------|---------|
+| `nav-link` | Navigation links | Header |
+| `footer-link` | Footer links | Footer |
+| `cta--inline` | Inline CTA with arrow | Various |
+
+### States
+
+- **default:** `color: var(--text-primary)` or `var(--text-inverse)`
+- **hover:** `color: var(--text-muted)`, optional underline
+
+### Tokens Applied
+- `font-family: var(--font-body)`
+- `font-size: var(--text-base)`
+- `font-weight: var(--font-normal)`
+- `transition: var(--transition-colors)`
+
+---
+
+## Input
+
+### Variants
+
+| Variant | Description |
+|---------|-------------|
+| `text` | Standard text input |
+| `domain` | Domain search input with search button |
+
+### States
+
+- **default:** `border: 1px solid var(--border)`
+- **focus:** Border color changes to accent
+- **error:** Border color `var(--error)`
+- **disabled:** `opacity: 0.5`
+
+### DOM Structure
+```html
+<div class="input-wrapper">
+  <input type="text" class="input input--domain" placeholder="Digite seu domínio">
+</div>
+```
+
+### Tokens Applied
+- `background: var(--bg-base)`
+- `border: 1px solid var(--border)`
+- `border-radius: var(--radius-none)`
+- `padding: var(--space-3)`
+- `font-family: var(--font-body)`
+- `font-size: var(--text-base)`
+
+---
+
+## Card
+
+### Variants
+
+| Variant | Description |
+|---------|-------------|
+| `feature-card` | Icon + title + description |
+| `stat-card` | Large number + label |
+| `pricing-card` | Price + features + CTA |
+
+### States
+
+- **default:** No shadow, flat design
+- **hover:** May have subtle color shift
+
+### Tokens Applied
+- `background: var(--bg-surface)` or transparent
+- `border-radius: var(--radius-none)`
+- `box-shadow: var(--shadow-sm)` (none typically)
+- `padding: var(--space-5)`
+
+---
+
+## Card Carousel (Platform / One Platform section)
+
+A horizontally scrollable row of cards that loop. Each card holds a `<video>` or `<img>` with an absolute text label.
+
+### DOM Structure
+```html
+<div class="card-carousel">
+  <div class="card-carousel__track">
+    <div class="card-carousel__card">
+      <video autoplay muted loop playsinline preload="none">
+        <source src="/videos/website-editing.webm" type="video/webm">
+      </video>
+      <span class="card-carousel__label">Edição de website</span>
+    </div>
+    <!-- repeat cards -->
+  </div>
+</div>
+```
+
+### Key CSS
+```css
+.card-carousel__card {
+  position: relative;
+  flex-shrink: 0;
+  border-radius: var(--radius-none);
+  overflow: hidden;
+}
+
+.card-carousel__label {
+  position: absolute;
+  bottom: var(--space-4);
+  left: var(--space-4);
+  font-family: var(--font-display);
+  font-size: var(--text-sm);
+  color: var(--text-inverse);
+  background: rgba(0, 0, 0, 0.55);
+  padding: var(--space-2) var(--space-3);
+}
+```
+
+Cards use `preload="none"` — only hero video is eager-loaded.
+
+---
+
+## Section
+
+### Hero Section
+- Full viewport dark background (`background: var(--bg-inverse)`)
+- Video background: `<video autoPlay muted loop playsInline preload="auto">` with WebM + MP4 sources
+- Dark overlay: `rgba(0, 0, 0, 0.52)` absolute layer over video
+- Centered content
+- Large headline: `font-family: var(--font-display)`, `font-size: var(--text-3xl)`, `font-weight: var(--font-light)`
+- Single CTA button (`.cta--primary.cta--light`)
+
+### Content Section
+- Max-width container
+- Light background
+- H2 headline
+- Grid or flex content layout
+
+### CTA Section
+- Colored background (teal or dark)
+- Centered headline + CTA
+- White text
+
+### Footer
+- Dark background (`bg: var(--bg-inverse)`)
+- 4-column grid of links
+- Bottom row with legal text
+- `padding: var(--space-16) var(--space-8)`
+
+---
+
+## Typography Components
+
+### Display Heading (H1)
+```css
+font-family: var(--font-display);
+font-size: var(--text-3xl);
+font-weight: var(--font-light);
+color: var(--text-inverse);
+line-height: var(--leading-tight);
+```
+
+### Section Heading (H2)
+```css
+font-family: var(--font-display);
+font-size: var(--text-xl);
+font-weight: var(--font-normal);
+color: var(--text-primary);
+line-height: var(--leading-normal);
+```
+
+### Serif Heading (H3)
+```css
+font-family: var(--font-serif);
+font-size: var(--text-lg);
+font-weight: var(--font-normal);
+color: var(--text-inverse);
+```
+
+### Body Text
+```css
+font-family: var(--font-body);
+font-size: var(--text-base);
+font-weight: var(--font-normal);
+color: var(--text-primary);
+line-height: var(--leading-relaxed);
+```
+
+### Caption/Muted
+```css
+font-family: var(--font-body);
+font-size: var(--text-sm);
+font-weight: var(--font-normal);
+color: var(--text-muted);
+```