@mmerterden/multi-agent-pipeline 20.35.0 → 20.37.0

package/pipeline/skills/shared/external/css-modern/references/code-examples.md

@@ -0,0 +1,142 @@
+# Modern CSS Code Examples
+
+Full code samples for the SKILL.md sections that link here. The rules and the decision guidance stay in SKILL.md; each heading below matches the SKILL.md section the code belongs to.
+
+## CSS Custom Properties (Variables)
+
+```css
+:root {
+  /* Color system */
+  --color-brand: oklch(55% 0.25 265);
+  --color-brand-light: oklch(70% 0.2 265);
+  --color-brand-dark: oklch(40% 0.25 265);
+
+  --color-surface: #ffffff;
+  --color-surface-elevated: #f9fafb;
+  --color-text: #111827;
+  --color-text-muted: #6b7280;
+  --color-border: #e5e7eb;
+
+  /* Spacing scale */
+  --space-xs: 0.25rem;
+  --space-sm: 0.5rem;
+  --space-md: 1rem;
+  --space-lg: 1.5rem;
+  --space-xl: 2rem;
+  --space-2xl: 3rem;
+
+  /* Typography */
+  --font-sans: 'Inter', system-ui, sans-serif;
+  --font-mono: 'JetBrains Mono', monospace;
+
+  /* Transitions */
+  --transition-fast: 150ms ease;
+  --transition-normal: 250ms ease;
+  --transition-slow: 400ms ease;
+
+  /* Shadows */
+  --shadow-sm: 0 1px 2px rgb(0 0 0 / 0.05);
+  --shadow-md: 0 4px 6px rgb(0 0 0 / 0.1);
+  --shadow-lg: 0 10px 15px rgb(0 0 0 / 0.1);
+}
+
+/* Dark theme override */
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-surface: #111827;
+    --color-surface-elevated: #1f2937;
+    --color-text: #f9fafb;
+    --color-text-muted: #9ca3af;
+    --color-border: #374151;
+  }
+}
+
+/* Component using tokens */
+.card {
+  background: var(--color-surface-elevated);
+  color: var(--color-text);
+  border: 1px solid var(--color-border);
+  border-radius: 0.75rem;
+  padding: var(--space-lg);
+  box-shadow: var(--shadow-sm);
+  transition: box-shadow var(--transition-normal);
+
+  &:hover {
+    box-shadow: var(--shadow-md);
+  }
+}
+```
+
+## Animations and Transitions
+
+```css
+/* View Transitions API */
+@view-transition {
+  navigation: auto;
+}
+
+.hero-image {
+  view-transition-name: hero;
+}
+
+::view-transition-old(hero) {
+  animation: fade-out 300ms ease;
+}
+
+::view-transition-new(hero) {
+  animation: fade-in 300ms ease;
+}
+
+/* Scroll-driven animations */
+@keyframes slide-in {
+  from { opacity: 0; transform: translateY(50px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+.scroll-reveal {
+  animation: slide-in linear both;
+  animation-timeline: view();
+  animation-range: entry 0% entry 100%;
+}
+
+/* Transition with discrete properties */
+.dialog {
+  transition: opacity 300ms ease, display 300ms ease allow-discrete;
+  opacity: 0;
+  display: none;
+
+  &[open] {
+    opacity: 1;
+    display: block;
+
+    @starting-style {
+      opacity: 0;
+    }
+  }
+}
+
+/* Keyframe animation */
+@keyframes shimmer {
+  0% { background-position: -200% 0; }
+  100% { background-position: 200% 0; }
+}
+
+.skeleton {
+  background: linear-gradient(
+    90deg,
+    #f0f0f0 25%,
+    #e0e0e0 50%,
+    #f0f0f0 75%
+  );
+  background-size: 200% 100%;
+  animation: shimmer 1.5s infinite ease-in-out;
+}
+
+/* Respect motion preferences */
+@media (prefers-reduced-motion: reduce) {
+  .scroll-reveal {
+    animation: none;
+    opacity: 1;
+  }
+}
+```

package/pipeline/skills/shared/external/database-patterns/SKILL.md

@@ -197,112 +197,11 @@ ALTER TABLE "user" DROP COLUMN IF EXISTS preferences;
 
 ## Prisma ORM (TypeScript)
 
-```typescript
-// prisma/schema.prisma
-generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider = "postgresql"
-  url      = env("DATABASE_URL")
-}
-
-model User {
-  id        String   @id @default(uuid())
-  email     String   @unique
-  name      String
-  role      Role     @default(USER)
-  posts     Post[]
-  createdAt DateTime @default(now()) @map("created_at")
-  updatedAt DateTime @updatedAt @map("updated_at")
-
-  @@map("user")
-}
-
-model Post {
-  id          String    @id @default(uuid())
-  title       String
-  slug        String    @unique
-  content     String    @default("")
-  status      PostStatus @default(DRAFT)
-  publishedAt DateTime? @map("published_at")
-  author      User      @relation(fields: [authorId], references: [id], onDelete: Cascade)
-  authorId    String    @map("author_id")
-  tags        Tag[]
-  createdAt   DateTime  @default(now()) @map("created_at")
-  updatedAt   DateTime  @updatedAt @map("updated_at")
-
-  @@index([authorId, status])
-  @@map("post")
-}
-
-enum Role { ADMIN USER VIEWER }
-enum PostStatus { DRAFT PUBLISHED ARCHIVED }
-```
-
-```typescript
-// queries
-const posts = await prisma.post.findMany({
-  where: { status: 'PUBLISHED', author: { role: 'ADMIN' } },
-  include: { author: { select: { name: true, email: true } }, tags: true },
-  orderBy: { publishedAt: 'desc' },
-  take: 20,
-  skip: 0,
-});
-
-// Transaction
-const [post, notification] = await prisma.$transaction([
-  prisma.post.update({ where: { id }, data: { status: 'PUBLISHED', publishedAt: new Date() } }),
-  prisma.notification.create({ data: { userId: authorId, type: 'POST_PUBLISHED' } }),
-]);
-```
+Code for this section: [ORM examples](references/orm-examples.md).
 
 ## Drizzle ORM (TypeScript)
 
-```typescript
-// schema.ts
-import { pgTable, uuid, text, timestamp, boolean, pgEnum } from 'drizzle-orm/pg-core';
-
-export const roleEnum = pgEnum('role', ['admin', 'user', 'viewer']);
-
-export const users = pgTable('user', {
-  id: uuid('id').primaryKey().defaultRandom(),
-  email: text('email').notNull().unique(),
-  name: text('name').notNull(),
-  role: roleEnum('role').notNull().default('user'),
-  isActive: boolean('is_active').notNull().default(true),
-  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
-  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
-});
-
-export const posts = pgTable('post', {
-  id: uuid('id').primaryKey().defaultRandom(),
-  authorId: uuid('author_id').notNull().references(() => users.id, { onDelete: 'cascade' }),
-  title: text('title').notNull(),
-  slug: text('slug').notNull().unique(),
-  content: text('content').notNull().default(''),
-  status: text('status', { enum: ['draft', 'published', 'archived'] }).notNull().default('draft'),
-  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
-});
-
-// queries
-import { eq, and, desc } from 'drizzle-orm';
-
-const publishedPosts = await db
-  .select()
-  .from(posts)
-  .where(and(eq(posts.status, 'published'), eq(posts.authorId, userId)))
-  .orderBy(desc(posts.createdAt))
-  .limit(20);
-
-// Join query
-const postsWithAuthors = await db
-  .select({ post: posts, authorName: users.name })
-  .from(posts)
-  .innerJoin(users, eq(posts.authorId, users.id))
-  .where(eq(posts.status, 'published'));
-```
+Code for this section: [ORM examples](references/orm-examples.md).
 
 ## Do's
 
@@ -336,3 +235,7 @@ const postsWithAuthors = await db
 | Data inconsistency | Missing constraints or transaction | Add foreign keys, use transactions for multi-step ops |
 | Migration fails | Incompatible schema change | Use additive migrations: add column, backfill, then drop old |
 | ORM generates bad SQL | Complex query expressed in ORM | Use raw SQL for complex analytical queries |
+
+## References
+
+- [ORM examples](references/orm-examples.md): open when defining schemas or writing queries with Prisma or Drizzle.

package/pipeline/skills/shared/external/database-patterns/references/orm-examples.md

@@ -0,0 +1,112 @@
+# ORM examples
+
+Schema and query code for Prisma and Drizzle. SKILL.md keeps schema design, indexing, query optimization and migration rules.
+
+## Prisma ORM (TypeScript)
+
+```typescript
+// prisma/schema.prisma
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        String   @id @default(uuid())
+  email     String   @unique
+  name      String
+  role      Role     @default(USER)
+  posts     Post[]
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  @@map("user")
+}
+
+model Post {
+  id          String    @id @default(uuid())
+  title       String
+  slug        String    @unique
+  content     String    @default("")
+  status      PostStatus @default(DRAFT)
+  publishedAt DateTime? @map("published_at")
+  author      User      @relation(fields: [authorId], references: [id], onDelete: Cascade)
+  authorId    String    @map("author_id")
+  tags        Tag[]
+  createdAt   DateTime  @default(now()) @map("created_at")
+  updatedAt   DateTime  @updatedAt @map("updated_at")
+
+  @@index([authorId, status])
+  @@map("post")
+}
+
+enum Role { ADMIN USER VIEWER }
+enum PostStatus { DRAFT PUBLISHED ARCHIVED }
+```
+
+```typescript
+// queries
+const posts = await prisma.post.findMany({
+  where: { status: 'PUBLISHED', author: { role: 'ADMIN' } },
+  include: { author: { select: { name: true, email: true } }, tags: true },
+  orderBy: { publishedAt: 'desc' },
+  take: 20,
+  skip: 0,
+});
+
+// Transaction
+const [post, notification] = await prisma.$transaction([
+  prisma.post.update({ where: { id }, data: { status: 'PUBLISHED', publishedAt: new Date() } }),
+  prisma.notification.create({ data: { userId: authorId, type: 'POST_PUBLISHED' } }),
+]);
+```
+
+## Drizzle ORM (TypeScript)
+
+```typescript
+// schema.ts
+import { pgTable, uuid, text, timestamp, boolean, pgEnum } from 'drizzle-orm/pg-core';
+
+export const roleEnum = pgEnum('role', ['admin', 'user', 'viewer']);
+
+export const users = pgTable('user', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  email: text('email').notNull().unique(),
+  name: text('name').notNull(),
+  role: roleEnum('role').notNull().default('user'),
+  isActive: boolean('is_active').notNull().default(true),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+});
+
+export const posts = pgTable('post', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  authorId: uuid('author_id').notNull().references(() => users.id, { onDelete: 'cascade' }),
+  title: text('title').notNull(),
+  slug: text('slug').notNull().unique(),
+  content: text('content').notNull().default(''),
+  status: text('status', { enum: ['draft', 'published', 'archived'] }).notNull().default('draft'),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+});
+
+// queries
+import { eq, and, desc } from 'drizzle-orm';
+
+const publishedPosts = await db
+  .select()
+  .from(posts)
+  .where(and(eq(posts.status, 'published'), eq(posts.authorId, userId)))
+  .orderBy(desc(posts.createdAt))
+  .limit(20);
+
+// Join query
+const postsWithAuthors = await db
+  .select({ post: posts, authorName: users.name })
+  .from(posts)
+  .innerJoin(users, eq(posts.authorId, users.id))
+  .where(eq(posts.status, 'published'));
+```

package/pipeline/skills/shared/external/html-semantic/SKILL.md

@@ -205,54 +205,9 @@ improves accessibility, SEO, and maintainability. Style with CSS, not with HTML
 
 ## SEO Best Practices
 
-```html
-<head>
-  <!-- Essential meta -->
-  <title>Primary Keyword  -  Brand Name</title>
-  <meta name="description" content="Compelling description with primary keywords (150-160 chars)" />
-  <meta name="robots" content="index, follow" />
-  <link rel="canonical" href="https://example.com/current-page" />
-
-  <!-- Open Graph (Facebook, LinkedIn) -->
-  <meta property="og:type" content="article" />
-  <meta property="og:title" content="Article Title" />
-  <meta property="og:description" content="Compelling description for social sharing" />
-  <meta property="og:image" content="https://example.com/og-image.jpg" />
-  <meta property="og:image:width" content="1200" />
-  <meta property="og:image:height" content="630" />
-  <meta property="og:url" content="https://example.com/article" />
-  <meta property="og:site_name" content="Site Name" />
-
-  <!-- Twitter Cards -->
-  <meta name="twitter:card" content="summary_large_image" />
-  <meta name="twitter:site" content="@sitehandle" />
-  <meta name="twitter:title" content="Article Title" />
-  <meta name="twitter:description" content="Description for Twitter" />
-  <meta name="twitter:image" content="https://example.com/twitter-card.jpg" />
-
-  <!-- Structured Data (JSON-LD) -->
-  <script type="application/ld+json">
-  {
-    "@context": "https://schema.org",
-    "@type": "Article",
-    "headline": "Article Title",
-    "author": {
-      "@type": "Person",
-      "name": "Jane Doe",
-      "url": "https://example.com/authors/jane"
-    },
-    "datePublished": "2025-01-15",
-    "dateModified": "2025-01-20",
-    "image": "https://example.com/article-image.jpg",
-    "publisher": {
-      "@type": "Organization",
-      "name": "Site Name",
-      "logo": { "@type": "ImageObject", "url": "https://example.com/logo.png" }
-    }
-  }
-  </script>
-</head>
-```
+Every page head carries a title, a meta description, robots and a canonical link, then Open Graph tags (absolute `og:image` URL, 1200x630), Twitter Card tags and JSON-LD structured data.
+
+Code: [SEO Best Practices](references/code-examples.md#seo-best-practices).
 
 ### Heading Hierarchy
 
@@ -302,3 +257,7 @@ improves accessibility, SEO, and maintainability. Style with CSS, not with HTML
 | Form not submitting | Missing `name` attribute on inputs | Add `name` to every form input |
 | Accessibility audit fails | Divs used as buttons, missing labels | Replace with semantic elements, add labels |
 | Heading outline broken | Skipped heading levels | Fix hierarchy: h1 > h2 > h3 sequentially |
+
+## References
+
+- [Code examples](references/code-examples.md): open for the full code behind SEO Best Practices.

package/pipeline/skills/shared/external/html-semantic/references/code-examples.md

@@ -0,0 +1,54 @@
+# Semantic HTML Code Examples
+
+Full code samples for the SKILL.md sections that link here. The rules and the decision guidance stay in SKILL.md; each heading below matches the SKILL.md section the code belongs to.
+
+## SEO Best Practices
+
+```html
+<head>
+  <!-- Essential meta -->
+  <title>Primary Keyword  -  Brand Name</title>
+  <meta name="description" content="Compelling description with primary keywords (150-160 chars)" />
+  <meta name="robots" content="index, follow" />
+  <link rel="canonical" href="https://example.com/current-page" />
+
+  <!-- Open Graph (Facebook, LinkedIn) -->
+  <meta property="og:type" content="article" />
+  <meta property="og:title" content="Article Title" />
+  <meta property="og:description" content="Compelling description for social sharing" />
+  <meta property="og:image" content="https://example.com/og-image.jpg" />
+  <meta property="og:image:width" content="1200" />
+  <meta property="og:image:height" content="630" />
+  <meta property="og:url" content="https://example.com/article" />
+  <meta property="og:site_name" content="Site Name" />
+
+  <!-- Twitter Cards -->
+  <meta name="twitter:card" content="summary_large_image" />
+  <meta name="twitter:site" content="@sitehandle" />
+  <meta name="twitter:title" content="Article Title" />
+  <meta name="twitter:description" content="Description for Twitter" />
+  <meta name="twitter:image" content="https://example.com/twitter-card.jpg" />
+
+  <!-- Structured Data (JSON-LD) -->
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    "headline": "Article Title",
+    "author": {
+      "@type": "Person",
+      "name": "Jane Doe",
+      "url": "https://example.com/authors/jane"
+    },
+    "datePublished": "2025-01-15",
+    "dateModified": "2025-01-20",
+    "image": "https://example.com/article-image.jpg",
+    "publisher": {
+      "@type": "Organization",
+      "name": "Site Name",
+      "logo": { "@type": "ImageObject", "url": "https://example.com/logo.png" }
+    }
+  }
+  </script>
+</head>
+```

package/pipeline/skills/shared/external/humanizer/SKILL.md

@@ -110,26 +110,9 @@ vibrant, leverage, streamline, seamless, robust, comprehensive, innovative
 | Over-hyphenation | "cross-functional, data-driven, client-facing" everywhere | Humans are inconsistent with hyphens  -  drop some |
 | Authority tropes | "At its core", "The real question is" | State the point directly |
 
-## Voice Guidelines
+## Voice
 
-Removing AI patterns is half the job. The result should have a voice.
-
-- **Have opinions.** "I'm not sure this is the right approach" beats neutral reporting.
-- **Vary rhythm.** Short sentences. Then longer ones that take their time. Mix it up.
-- **Be specific.** Not "this is concerning" but "this breaks on iOS 17 when the user rotates."
-- **Use "I" when it fits.** First person is not unprofessional.
-- **Leave room for imperfection.** Perfect structure feels algorithmic.
-
-## Voice Calibration
-
-If the user provides a writing sample, match their style:
-- Sentence length patterns
-- Word choice level (casual vs. academic)
-- Paragraph openings
-- Punctuation habits
-- Transition style
-
-When no sample is provided, default to clear, direct, slightly opinionated.
+Removing AI patterns is half the job; the result should have a voice. Match the user's writing sample when one is given; otherwise default to clear, direct, slightly opinionated. The voice guidelines and the calibration checklist are in [references/voice.md](references/voice.md).
 
 ## Output language
 
@@ -177,3 +160,7 @@ that exist and ask which was meant.
 
 1. Rewrite the text
 2. Brief list of what you changed and why
+
+## References
+
+- [Voice](references/voice.md): open when shaping the voice of a rewrite or matching a user-supplied writing sample.

package/pipeline/skills/shared/external/humanizer/references/voice.md

@@ -0,0 +1,24 @@
+# Voice
+
+What the rewrite should sound like once the AI patterns are gone, and how to match a writing sample the user supplies.
+
+## Voice Guidelines
+
+Removing AI patterns is half the job. The result should have a voice.
+
+- **Have opinions.** "I'm not sure this is the right approach" beats neutral reporting.
+- **Vary rhythm.** Short sentences. Then longer ones that take their time. Mix it up.
+- **Be specific.** Not "this is concerning" but "this breaks on iOS 17 when the user rotates."
+- **Use "I" when it fits.** First person is not unprofessional.
+- **Leave room for imperfection.** Perfect structure feels algorithmic.
+
+## Voice Calibration
+
+If the user provides a writing sample, match their style:
+- Sentence length patterns
+- Word choice level (casual vs. academic)
+- Paragraph openings
+- Punctuation habits
+- Transition style
+
+When no sample is provided, default to clear, direct, slightly opinionated.