@jaimevalasek/aioson 1.4.0 → 1.5.1

package/template/.aioson/skills/premium-visual-design/tokens/status-extended.md

@@ -0,0 +1,142 @@
+# Status Extended Tokens
+
+Extended state and status tokens for Squad Dashboard v3 inter-squad UI.
+
+## Agent & Task State Tokens
+
+```css
+:root {
+  /* --- Blocked --- */
+  --state-blocked:        #f87171;
+  --state-blocked-bg:     rgba(248, 113, 113, 0.12);
+  --state-blocked-border: rgba(248, 113, 113, 0.30);
+
+  /* --- Ready --- */
+  --state-ready:          #4ade80;
+  --state-ready-bg:       rgba(74, 222, 128, 0.12);
+  --state-ready-border:   rgba(74, 222, 128, 0.30);
+
+  /* --- Solo (no squad context) --- */
+  --state-solo:           #8b8fa3;
+  --state-solo-bg:        rgba(139, 143, 163, 0.12);
+  --state-solo-border:    rgba(139, 143, 163, 0.25);
+
+  /* --- Auto (fully autonomous agent) --- */
+  --state-auto:           #22d3ee;
+  --state-auto-bg:        rgba(34, 211, 238, 0.12);
+  --state-auto-border:    rgba(34, 211, 238, 0.30);
+
+  /* --- Human (human-in-the-loop) --- */
+  --state-human:          #fbbf24;
+  --state-human-bg:       rgba(251, 191, 36, 0.12);
+  --state-human-border:   rgba(251, 191, 36, 0.30);
+
+  /* --- Review (awaiting review) --- */
+  --state-review:         #c084fc;
+  --state-review-bg:      rgba(192, 132, 252, 0.12);
+  --state-review-border:  rgba(192, 132, 252, 0.30);
+
+  /* --- Running (animated pulse) --- */
+  --state-running:        #6c8aff;
+  --state-running-bg:     rgba(108, 138, 255, 0.12);
+
+  /* --- Idle --- */
+  --state-idle:           #8b8fa3;
+  --state-idle-bg:        rgba(139, 143, 163, 0.10);
+
+  /* --- Error --- */
+  --state-error:          #f87171;
+  --state-error-bg:       rgba(248, 113, 113, 0.12);
+
+  /* --- Done --- */
+  --state-done:           #4ade80;
+  --state-done-bg:        rgba(74, 222, 128, 0.10);
+}
+```
+
+## Running Pulse Animation
+
+Apply to indicators when `state = running`:
+
+```css
+@keyframes state-pulse {
+  0%, 100% { opacity: 1; }
+  50%       { opacity: 0.45; }
+}
+
+.state-dot-running {
+  background: var(--state-running);
+  animation: state-pulse 1.6s ease-in-out infinite;
+}
+```
+
+## Agent Type Tokens
+
+Used by `agent-badge` component.
+
+| Type | Token | Color |
+|------|-------|-------|
+| `auto` | `--state-auto` | Cyan `#22d3ee` |
+| `human` | `--state-human` | Amber `#fbbf24` |
+| `solo` | `--state-solo` | Muted `#8b8fa3` |
+
+## Priority Tokens
+
+```css
+:root {
+  --priority-critical: #f87171;   /* red */
+  --priority-high:     #fb923c;   /* orange */
+  --priority-medium:   #fbbf24;   /* amber */
+  --priority-low:      #8b8fa3;   /* muted */
+}
+```
+
+## Notification Type Tokens
+
+Map event types to colors for notification icons:
+
+| Event type | Token | Notes |
+|-----------|-------|-------|
+| `info` | `--accent` `#6c8aff` | General info |
+| `warning` | `--warning` `#fbbf24` | Soft warning |
+| `error` | `--danger` `#f87171` | Errors |
+| `success` | `--success` `#4ade80` | Completions |
+| `merge_conflict` | `--purple` `#c084fc` | Git conflicts |
+| `context_warning` | `--warning` | Context at 85% |
+| `context_critical` | `--danger` | Context at 95% |
+| `task_completed` | `--success` | Task done |
+| `task_needs_revision` | `--state-review` | Hunk rejected |
+| `handoff` | `--accent` | Agent handoff |
+| `decision` | `--cyan` `#22d3ee` | Decision recorded |
+
+## Usage
+
+Reference tokens in component CSS. Always fall back gracefully:
+
+```css
+.task-status-badge[data-status="blocked"] {
+  background: var(--state-blocked-bg);
+  color:      var(--state-blocked);
+  border:     1px solid var(--state-blocked-border);
+}
+```
+
+Map exhaustive status values:
+
+```javascript
+const STATE_TOKEN = {
+  blocked:  'blocked',
+  ready:    'ready',
+  solo:     'solo',
+  auto:     'auto',
+  human:    'human',
+  review:   'review',
+  running:  'running',
+  idle:     'idle',
+  error:    'error',
+  done:     'done',
+  pending:  'idle',    // alias
+  active:   'running', // alias
+  completed:'done'     // alias
+};
+```

package/template/.aioson/skills/squad/formats/catalog.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0.0",
+  "formats": [
+    { "slug": "instagram-feed", "title": "Instagram Feed Post", "category": "social", "platform": "Instagram", "file": "social/instagram-feed.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "youtube-long", "title": "YouTube Long-form Video", "category": "social", "platform": "YouTube", "file": "social/youtube-long.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "youtube-shorts", "title": "YouTube Shorts", "category": "social", "platform": "YouTube", "file": "social/youtube-shorts.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "linkedin-post", "title": "LinkedIn Post", "category": "social", "platform": "LinkedIn", "file": "social/linkedin-post.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "tiktok", "title": "TikTok Video", "category": "social", "platform": "TikTok", "file": "social/tiktok.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "twitter-thread", "title": "Twitter/X Thread", "category": "social", "platform": "Twitter/X", "file": "social/twitter-thread.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "blog-post", "title": "Blog Post", "category": "content", "platform": "Web", "file": "content/blog-post.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "newsletter", "title": "Email Newsletter", "category": "content", "platform": "Email", "file": "content/newsletter.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "podcast-script", "title": "Podcast Script", "category": "creative", "platform": "Audio", "file": "creative/podcast-script.md", "version": "1.0.0", "updated": "2026-03-24" },
+    { "slug": "video-script", "title": "Video Script", "category": "creative", "platform": "Video", "file": "creative/video-script.md", "version": "1.0.0", "updated": "2026-03-24" }
+  ]
+}

package/template/.aioson/skills/squad/formats/content/blog-post.md

@@ -0,0 +1,47 @@
+# Format: Blog Post
+
+> Platform: Web
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: content
+
+## Specs
+- **Ideal length:** 1,500-2,500 words (SEO sweet spot)
+- **Reading time:** 7-12 minutes
+- **Meta description:** 150-160 characters
+- **Title:** 55-60 characters for SERP display
+
+## Structure
+
+### Title
+Include primary keyword. Use numbers, "how to", or power words for CTR.
+
+### Introduction (100-150 words)
+Hook → context → promise. The reader should know what they'll learn and why it matters.
+
+### Body (H2/H3 sections)
+- H2 for main sections, H3 for subsections
+- Short paragraphs (2-3 sentences max)
+- Lists and bullet points for scanability
+- Internal links to related content
+
+### Conclusion
+Summarize key points. Clear next action for the reader.
+
+## Best Practices
+1. Front-load value — don't save the best for last
+2. Use images/diagrams every 300-500 words
+3. Include a table of contents for posts > 2,000 words
+4. Answer the search intent in the first 200 words (featured snippet)
+
+## Anti-patterns
+1. Keyword stuffing or unnatural phrasing for SEO
+2. Generic introductions that could be on any article
+3. Missing meta description (search engines will auto-generate a bad one)
+
+## Quality Checklist
+- [ ] Title includes primary keyword and is < 60 chars
+- [ ] Meta description is 150-160 chars and compelling
+- [ ] H2/H3 hierarchy is logical
+- [ ] At least one image per 500 words
+- [ ] Internal and external links present

package/template/.aioson/skills/squad/formats/content/newsletter.md

@@ -0,0 +1,47 @@
+# Format: Email Newsletter
+
+> Platform: Email
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: content
+
+## Specs
+- **Subject line:** 30-50 characters (mobile preview)
+- **Preview text:** 40-90 characters
+- **Body length:** 200-500 words (brief) or 800-1500 (deep dive)
+- **Width:** Max 600px for email clients
+
+## Structure
+
+### Subject Line
+Specific, curiosity-driven, personal. Avoid spam triggers (ALL CAPS, excessive punctuation).
+
+### Preview Text
+Extends the subject line — not a repeat. Provides additional reason to open.
+
+### Body
+- Lead with the most valuable insight
+- One primary CTA (not three competing ones)
+- Scannable: short paragraphs, bold key phrases, links
+- Personal tone (write to one person, not an audience)
+
+### Footer
+Unsubscribe link (required). Social links. Brief about section.
+
+## Best Practices
+1. Subject line determines open rate — test 2-3 variations
+2. Send on Tuesday-Thursday, 9-11am local time (test your audience)
+3. One CTA per email maximizes click-through rate
+4. Plain text sections outperform heavy HTML in many audiences
+
+## Anti-patterns
+1. Subject lines that don't match body content (destroys trust)
+2. Multiple competing CTAs diluting each other
+3. Image-heavy emails (many clients block images by default)
+
+## Quality Checklist
+- [ ] Subject line is < 50 chars and specific
+- [ ] Preview text complements (not repeats) the subject
+- [ ] Single clear CTA
+- [ ] Mobile-friendly layout
+- [ ] Unsubscribe link present

package/template/.aioson/skills/squad/formats/creative/podcast-script.md

@@ -0,0 +1,43 @@
+# Format: Podcast Script
+
+> Platform: Audio
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: creative
+
+## Specs
+- **Duration:** 20-45 minutes (standard), 45-90 (deep dive)
+- **Segments:** 3-5 per episode
+- **Intro:** Max 60 seconds
+- **Outro:** Max 30 seconds
+
+## Structure
+
+### Cold Open (0-30s)
+Teaser clip or provocative question from the episode. No intro music yet.
+
+### Intro (30-60s)
+Show name, host, topic preview. Brief sponsor read if applicable.
+
+### Segments
+Each segment: topic introduction → discussion → key takeaway. Transitions between segments should feel natural.
+
+### Outro
+Episode summary, preview of next episode, CTA (subscribe, review, share).
+
+## Best Practices
+1. Script the intro and transitions; improvise the discussions
+2. Each segment should work as a standalone clip for social media
+3. Name-drop the episode topic in the first 60 seconds (for podcast directories)
+4. Include timestamps in show notes
+
+## Anti-patterns
+1. Unscripted intros that ramble for 5+ minutes
+2. Inside jokes without context (alienates new listeners)
+3. Audio quality inconsistencies between host and guests
+
+## Quality Checklist
+- [ ] Cold open hooks the listener immediately
+- [ ] Each segment has a clear takeaway
+- [ ] Transitions between segments are scripted
+- [ ] Show notes with timestamps prepared

package/template/.aioson/skills/squad/formats/creative/video-script.md

@@ -0,0 +1,41 @@
+# Format: Video Script
+
+> Platform: Video (generic)
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: creative
+
+## Specs
+- **Duration:** Varies by purpose (30s ad, 3-5min explainer, 10-20min educational)
+- **Script format:** Scene descriptions, dialogue/narration, visual notes
+
+## Structure
+
+### Scene Header
+`INT/EXT — LOCATION — TIME` or simplified: `SCENE {N}: {description}`
+
+### Action Lines
+Visual descriptions. What the viewer SEES. Present tense, active voice.
+
+### Dialogue/Narration
+Character name or "NARRATOR" centered. Dialogue below. Parenthetical for tone.
+
+### Visual Notes
+`[B-ROLL: description]`, `[GRAPHIC: description]`, `[CUT TO: next scene]`
+
+## Best Practices
+1. Write for the ear, not the eye — read it aloud
+2. One idea per scene. If a scene has two ideas, split it.
+3. Include visual cues — the script should paint a picture
+4. Time it: ~150 words = 1 minute of speaking
+
+## Anti-patterns
+1. Wall-of-text narration without visual variety
+2. Scripts that read well but sound unnatural when spoken
+3. Missing visual direction (leaves too much to interpretation)
+
+## Quality Checklist
+- [ ] Script reads naturally when spoken aloud
+- [ ] Visual cues accompany every dialogue section
+- [ ] Timing is estimated and realistic
+- [ ] Hook is in the first 5 seconds

package/template/.aioson/skills/squad/formats/social/instagram-feed.md

@@ -0,0 +1,42 @@
+# Format: Instagram Feed Post
+
+> Platform: Instagram
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: social
+
+## Specs
+- **Max length:** 2,200 characters (caption)
+- **Ideal length:** 150-300 characters for engagement, 800-1500 for educational
+- **Aspect ratio:** 1:1 (feed), 4:5 (preferred for visibility), 1.91:1 (landscape)
+- **Carousel:** Up to 10 slides
+
+## Structure
+
+### Hook
+First line visible without "more" — must stop the scroll. Use pattern interrupts, bold claims, or relatable statements.
+
+### Body
+- Educational: numbered tips or step-by-step
+- Storytelling: conflict → lesson → transformation
+- Carousel: 1 idea per slide, progressive reveal
+
+### Close
+CTA aligned with goal: save (educational), share (relatable), comment (engagement), link in bio (conversion).
+
+## Best Practices
+1. First line is everything — it determines if caption is read
+2. Line breaks create visual breathing room (use them)
+3. Hashtags: 5-15 relevant ones, mix of sizes (avoid only mega-hashtags)
+4. Carousel posts get 1.4x more reach than single images
+
+## Anti-patterns
+1. Starting with "Hey guys!" or generic greetings (invisible in feed)
+2. Wall of text without line breaks
+3. Irrelevant or banned hashtags
+
+## Quality Checklist
+- [ ] Hook stops the scroll (first line is compelling)
+- [ ] CTA is clear and specific
+- [ ] Hashtags are relevant and varied
+- [ ] Image/carousel matches the caption narrative

package/template/.aioson/skills/squad/formats/social/linkedin-post.md

@@ -0,0 +1,42 @@
+# Format: LinkedIn Post
+
+> Platform: LinkedIn
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: social
+
+## Specs
+- **Max length:** 3,000 characters
+- **Ideal length:** 800-1,500 characters
+- **Visible without expand:** First ~210 characters
+
+## Structure
+
+### Hook (first 2 lines)
+Bold statement, counterintuitive insight, or personal story opener. Must earn the "...see more" click.
+
+### Body
+- Professional insight with personal angle
+- Short paragraphs (1-2 sentences each)
+- Use line breaks aggressively
+- Data points or specific examples add credibility
+
+### Close
+Question to drive comments, or clear takeaway. Avoid "agree?" — too generic.
+
+## Best Practices
+1. Write like a human, not a brand — personal voice wins
+2. One idea per post (not a listicle unless it's the format)
+3. Native content outperforms links (algorithm penalizes external links)
+4. Post images or documents (carousels) for 2-3x reach
+
+## Anti-patterns
+1. Corporate jargon without substance
+2. Humble-bragging disguised as advice
+3. External links in the main post (put in comments)
+
+## Quality Checklist
+- [ ] First 2 lines are compelling enough to click "see more"
+- [ ] Professional but human tone
+- [ ] No external links in main body
+- [ ] Ends with engagement trigger (question or takeaway)

package/template/.aioson/skills/squad/formats/social/tiktok.md

@@ -0,0 +1,39 @@
+# Format: TikTok Video
+
+> Platform: TikTok
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: social
+
+## Specs
+- **Duration:** 15-60 seconds (ideal), up to 10 minutes
+- **Aspect ratio:** 9:16 (vertical)
+- **Caption:** Max 4,000 characters, first 50 visible
+
+## Structure
+
+### Hook (0-1s)
+Immediate visual hook. Text overlay with the promise. "Here's why..." or "POV:" format.
+
+### Core (1-45s)
+Fast pacing, jump cuts, movement. One transformation or one revelation per video.
+
+### Payoff
+Deliver on the hook's promise. Surprise endings boost shares and re-watches.
+
+## Best Practices
+1. Trending sounds dramatically boost reach
+2. Text overlays are mandatory (80%+ watch without sound)
+3. Reply to comments with videos (boosts engagement)
+4. Post 1-3 times daily for algorithm favor
+
+## Anti-patterns
+1. Over-produced content (authentic > polished on TikTok)
+2. Slow builds without early payoff signal
+3. Ignoring trends in favor of evergreen-only content
+
+## Quality Checklist
+- [ ] Hook in first second
+- [ ] Text overlays present
+- [ ] Vertical format (9:16)
+- [ ] Trending sound considered

package/template/.aioson/skills/squad/formats/social/twitter-thread.md

@@ -0,0 +1,39 @@
+# Format: Twitter/X Thread
+
+> Platform: Twitter/X
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: social
+
+## Specs
+- **Tweet length:** 280 characters per tweet
+- **Thread length:** 5-15 tweets ideal
+- **Media:** Images/GIFs boost engagement 2-3x
+
+## Structure
+
+### Tweet 1 (Hook)
+Bold claim or curiosity gap. End with "A thread:" or equivalent to signal more value coming.
+
+### Body tweets (2 to N-1)
+One idea per tweet. Use numbering (1/, 2/) for scanability. Mix text-only with visual tweets.
+
+### Final tweet
+Summary + CTA (follow, retweet, bookmark). Link to relevant resource.
+
+## Best Practices
+1. Tweet 1 determines 80% of the thread's reach — optimize ruthlessly
+2. Each tweet should stand alone (people land mid-thread)
+3. Include images or examples every 3-4 tweets to break monotony
+4. Self-retweet the thread after 8-12 hours
+
+## Anti-patterns
+1. Threads that could be one tweet (don't stretch thin content)
+2. Every tweet starting with the same structure
+3. Burying the value in tweet 8+ without enough hooks
+
+## Quality Checklist
+- [ ] Tweet 1 is a standalone hook
+- [ ] Each tweet delivers one clear idea
+- [ ] Thread has visual variety (images, examples)
+- [ ] Final tweet has CTA and summary

package/template/.aioson/skills/squad/formats/social/youtube-long.md

@@ -0,0 +1,47 @@
+# Format: YouTube Long-form Video
+
+> Platform: YouTube
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: social
+
+## Specs
+- **Duration:** 8-20 minutes (sweet spot for monetization + retention)
+- **Title:** Max 100 chars, ideal 50-70
+- **Description:** First 150 chars visible, max 5,000
+- **Thumbnail:** 1280x720px, max 2MB
+
+## Structure
+
+### Hook (0-3s)
+Pattern interrupt, curiosity gap, or bold claim. The viewer decides to stay or leave in 3 seconds.
+
+### Context Bridge (3-15s)
+Why the viewer should stay. Establish credibility and promise of value.
+
+### Value Delivery (main body)
+Chapters with mini-hooks at transitions to prevent drop-off. Each chapter delivers on a specific promise.
+
+### CTA
+Subscribe, like, comment prompt integrated naturally (not forced). Best placed after a value moment.
+
+### End Screen (last 20s)
+Teaser for the next video. Visual end screen elements.
+
+## Best Practices
+1. Script the first 30 seconds word-for-word
+2. Use chapters (timestamps) for SEO and navigation
+3. Thumbnail: one focal point, max 3-4 words, readable at 120px width
+4. Title creates curiosity without misleading (clickbait kills trust)
+
+## Anti-patterns
+1. "Hey guys, welcome back to my channel..." (instant drop-off)
+2. Intros longer than 15 seconds
+3. Thumbnails with cluttered text or low contrast
+
+## Quality Checklist
+- [ ] Hook is scripted and compelling (first 3 seconds)
+- [ ] Title creates genuine curiosity
+- [ ] Thumbnail is readable at mobile size
+- [ ] Chapters/timestamps are defined
+- [ ] Description includes keywords and links

package/template/.aioson/skills/squad/formats/social/youtube-shorts.md

@@ -0,0 +1,39 @@
+# Format: YouTube Shorts
+
+> Platform: YouTube
+> Version: 1.0.0
+> Updated: 2026-03-24
+> Category: social
+
+## Specs
+- **Duration:** Max 60 seconds, ideal 15-45s
+- **Aspect ratio:** 9:16 (vertical)
+- **Title:** Short, hashtag-friendly
+
+## Structure
+
+### Hook (0-1s)
+Immediate visual or verbal hook. No intro, no greeting — start with the payoff or the tension.
+
+### Core (1-45s)
+One idea, one message. Fast pacing, cuts every 2-3 seconds. Text overlays for silent viewers.
+
+### Loop Point
+End connects visually or thematically to the beginning to encourage re-watches.
+
+## Best Practices
+1. Start mid-action or mid-sentence
+2. Text on screen for accessibility and silent viewing
+3. Trending sounds boost discoverability
+4. #Shorts in title or description
+
+## Anti-patterns
+1. Slow starts or countdowns
+2. Horizontal content cropped to vertical
+3. Asking to subscribe before delivering value
+
+## Quality Checklist
+- [ ] Opens with immediate hook (no greeting)
+- [ ] Single clear message
+- [ ] Viewable without audio (text overlays)
+- [ ] Under 60 seconds