@su-record/vibe 3.2.62 → 4.0.0

package/skills/vibe.scaffold/SKILL.md

@@ -1,193 +0,0 @@
----
-name: vibe.scaffold
-description: 새 프로젝트 구조를 만들거나 기존 폴더 구조가 AI-assisted development에 적합한지 감사할 때 사용한다.
-argument-hint: --check (audit existing) or project-type
-user-invocable: true
----
-
-# /vibe.scaffold
-
-## 완료 기준
-
-- [ ] 요청된 디렉터리와 필수 설정 파일이 존재한다.
-- [ ] 생성한 package 또는 module의 build 명령이 통과한다.
-- [ ] import·module 해석 검사가 통과한다.
-- [ ] audit mode에서는 발견 항목마다 실제 경로 근거가 있다.
-
-Design and generate a project structure where AI works effectively on its own.
-
-> "A well-designed project structure trains AI to follow it naturally."
-
-## Usage
-
-```
-/vibe.scaffold                 # Generate structure (auto-detect stack)
-/vibe.scaffold --check         # Audit existing structure + suggest improvements
-/vibe.scaffold webapp          # Generate webapp-type structure
-/vibe.scaffold api             # Generate api-type structure
-```
-
----
-
-## Process
-
-### 1. Assess Current State
-
-1. Read `CLAUDE.md`, `package.json`, `pyproject.toml`, `pubspec.yaml`
-2. Scan existing folder structure via `Glob`
-3. Read `.vibe/config.json` for detected stacks
-
-### 2. Determine Project Type
-
-| Type | Structure |
-|------|-----------|
-| `webapp` | src/ + pages/ + components/ + hooks/ + styles/ |
-| `api` | src/ + routes/ + services/ + models/ + middleware/ |
-| `fullstack` | src/client/ + src/server/ or apps/ monorepo |
-| `library` | src/ + examples/ + benchmarks/ |
-| `mobile` | lib/ (Flutter) or src/ (React Native) |
-
-### 3. Generate Base Structure
-
-Common directories for all projects:
-
-```
-my-project/
-├── src/              # Business logic
-├── docs/             # Human-maintained business documents (AI reference)
-│   ├── README.md     # Explains purpose: business rules, domain defs, ADR
-│   └── adr/          # Architecture Decision Records
-├── tests/            # Test infrastructure
-├── .dev/             # AI-generated work logs
-│   ├── README.md     # Explains purpose: learnings, debug logs, scratch
-│   ├── learnings/    # Troubleshooting records
-│   └── scratch/      # Experiments, scratchpad (gitignored)
-├── .claude/          # AI configuration (managed by vibe init)
-├── out/              # Build artifacts (gitignored)
-└── CLAUDE.md         # Project map
-```
-
-### 4. Stack-Specific src/ Layout
-
-**React/Next.js (webapp):**
-```
-src/
-├── components/       # Reusable UI components
-│   ├── ui/           # Primitives (Button, Input, Modal)
-│   └── features/     # Feature-specific components
-├── pages/ or app/    # Routes (varies by Next.js version)
-├── hooks/            # Custom hooks
-├── lib/              # Utilities, helpers
-├── services/         # API calls, external services
-├── stores/           # State management (zustand, jotai, etc.)
-├── types/            # Type definitions
-└── styles/           # Global styles
-```
-
-**Express/NestJS/FastAPI (api):**
-```
-src/
-├── routes/           # API routes (or controllers/)
-├── services/         # Business logic
-├── models/           # Data models, schemas
-├── middleware/       # Auth, logging, error handling
-├── lib/              # Utilities
-├── types/            # Type definitions
-└── config/           # Configuration management
-```
-
-**Flutter (mobile):**
-```
-lib/
-├── screens/          # Screen widgets
-├── widgets/          # Reusable widgets
-├── services/         # API, local storage
-├── providers/        # State management
-├── models/           # Data models
-├── utils/            # Utilities
-└── config/           # Configuration, constants
-```
-
-### 5. Clean Architecture Layers (Optional)
-
-When clean architecture is explicitly selected, read `references/clean-architecture.md`. Default stack layouts and `--check` audits do not load it.
-
-### 6. Generate Supporting Files
-
-| File | Content |
-|------|---------|
-| `docs/README.md` | Purpose of docs/ directory |
-| `.dev/README.md` | Purpose of .dev/ directory |
-| `.gitignore` additions | `out/`, `.dev/scratch/` entries |
-
-### 7. Update CLAUDE.md
-
-Add generated structure as pointers in CLAUDE.md:
-
-```markdown
-## Project Structure
-- `src/` — Business logic
-- `docs/` — Human-maintained business docs (AI reads before work)
-- `tests/` — Test infrastructure
-- `.dev/` — AI-generated work logs
-- `.claude/` — AI configuration
-```
-
----
-
-## --check Mode: Audit Existing Structure
-
-### Checklist
-
-| Item | Criteria | Points |
-|------|----------|--------|
-| `docs/` exists | Business documents separated | /15 |
-| `.dev/` exists | AI work logs separated | /10 |
-| src/ sub-structure | Role-based folder organization | /20 |
-| tests/ separated | Not co-located with source | /15 |
-| CLAUDE.md describes structure | Folder purposes documented | /10 |
-| .gitignore complete | Includes out/, .dev/scratch/ | /5 |
-| Layer separation | Domain/service/infra distinction | /15 |
-| Dependency direction consistency | No reverse imports | /10 |
-
-### Output
-
-```markdown
-## Scaffold Audit Result (N/100)
-
-### Current Structure
-[tree output]
-
-### Findings
-| Item | Status | Recommendation |
-|------|--------|----------------|
-| docs/ | Missing | `mkdir docs && echo "..." > docs/README.md` |
-| ... | ... | ... |
-
-### Auto-Fixable Items
-1. [ ] Create docs/
-2. [ ] Create .dev/
-3. [ ] Update .gitignore
-
-Proceed with auto-fix? (y/n)
-```
-
-### Self-Repair
-
-If audit score < 60, automatically suggest:
-1. Run `/vibe.scaffold` to generate missing directories
-2. Run `vibe update` to regenerate CLAUDE.md with structure info
-3. Run `/vibe.harness` for full maturity assessment
-
----
-
-## Principles
-
-1. **Never delete or move existing files** — only add new directories
-2. **Empty directories get a README.md** — purpose description helps AI understand context
-3. **No structure < bad structure < good structure** — any scaffolding improves AI output
-4. **Separate by ownership** — human docs (docs/) vs AI logs (.dev/) in different directories
-
----
-
-ARGUMENTS: $ARGUMENTS

package/skills/vibe.scaffold/references/clean-architecture.md

@@ -1,17 +0,0 @@
-# Optional Clean Architecture Layout
-
-Load only when clean architecture is explicitly selected.
-
-```
-src/
-├── domain/           # Business rules (pure logic, no external deps)
-├── application/      # Use cases (domain composition)
-├── infrastructure/   # External integrations (DB, API, files)
-└── presentation/     # UI or API endpoints
-```
-
-Layer rules:
-
-- Dependency direction: presentation → application → domain (reverse forbidden)
-- domain must not import external packages
-- infrastructure implements domain interfaces

package/skills/vibe.seo-checklist/SKILL.md

@@ -1,59 +0,0 @@
----
-name: vibe.seo-checklist
-invocation: [auto]
-tier: core
-description: "SEO gotchas for web development — easy-to-miss items that hurt search ranking. Covers meta tags, Open Graph, structured data (JSON-LD), sitemap, robots.txt, canonical URLs, and Naver/Google-specific requirements. Use when building or reviewing any public-facing web page, landing page, or marketing site. Must use this skill when user mentions SEO, search ranking, meta tags, or when deploying a web app that needs to be discoverable."
-triggers: [seo, meta tags, sitemap, structured data, opengraph, search ranking, robots.txt, naver]
-priority: 60
----
-
-# SEO Checklist
-
-## Pre-check (K1)
-
-> Is this a public-facing web page that needs search visibility? Internal tools, admin panels, and authenticated-only pages don't need SEO optimization.
-
-## Easy-to-Miss Gotchas
-
-### Meta & Social
-
-| Gotcha | Why It Hurts | Fix |
-|--------|-------------|-----|
-| Missing `<link rel="canonical">` | Duplicate content penalty from URL variants | Set canonical on every page, including paginated |
-| OG image wrong size | Cropped/pixelated on social share | Must be exactly **1200x630px** |
-| Same title/description on all pages | Google treats as duplicate content | Unique title (50-60 chars) + description (150-160 chars) per page |
-| Missing `og:type` | Defaults to "website" for articles | Set `article` for posts, `product` for products |
-
-### Technical
-
-| Gotcha | Why It Hurts | Fix |
-|--------|-------------|-----|
-| `robots.txt` blocks important pages | Pages not indexed | `Allow: /` for public, only block `/api/`, `/admin/` |
-| No sitemap or stale sitemap | Crawler misses new pages | Auto-generate, include `<lastmod>` with real dates |
-| `noindex` left in production | Entire site invisible | Verify `<meta name="robots">` in production build |
-| Images without `width`/`height` | CLS layout shift penalty | Always set dimensions + `loading="lazy"` for below-fold |
-
-### Core Web Vitals
-
-| Metric | Target | Common Miss |
-|--------|--------|-------------|
-| LCP | ≤2.5s | Hero image not preloaded — add `<link rel="preload">` |
-| INP | ≤200ms | Heavy JS on interaction — defer non-critical scripts |
-| CLS | ≤0.1 | Dynamic content without reserved space — set `min-height` |
-
-### Structured Data
-
-| Gotcha | Fix |
-|--------|-----|
-| JSON-LD not validated | Test with Google Rich Results Test before deploy |
-| Wrong `@type` | `Product` for products, `Article` for posts, `FAQPage` for FAQs |
-| Missing `BreadcrumbList` | Add breadcrumb schema for all non-root pages |
-
-## Done Criteria (K4)
-
-- [ ] Every page has unique title, description, canonical URL
-- [ ] OG images are 1200x630px on all shareable pages
-- [ ] `robots.txt` and `sitemap.xml` present and correct
-- [ ] Structured data validates in Rich Results Test
-- [ ] Core Web Vitals green (LCP ≤2.5s, INP ≤200ms, CLS ≤0.1)
-- [ ] No `noindex` tags in production

package/skills/vibe.seo-checklist/frameworks/structured-data.md

@@ -1,153 +0,0 @@
----
-name: structured-data
-type: framework
-applies-to: [seo-checklist]
-format: JSON-LD
----
-
-# Structured Data — JSON-LD Schema Templates
-
-Embed in `<script type="application/ld+json">` in `<head>` or before `</body>`.
-
-## Article
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "Article",
-  "headline": "Article Title (max 110 chars)",
-  "description": "Article summary (max 160 chars)",
-  "image": "https://example.com/article-image.jpg",
-  "author": {
-    "@type": "Person",
-    "name": "Author Name",
-    "url": "https://example.com/authors/name"
-  },
-  "publisher": {
-    "@type": "Organization",
-    "name": "Publisher Name",
-    "logo": {
-      "@type": "ImageObject",
-      "url": "https://example.com/logo.png"
-    }
-  },
-  "datePublished": "2024-01-15T08:00:00+00:00",
-  "dateModified": "2024-01-20T10:00:00+00:00",
-  "mainEntityOfPage": {
-    "@type": "WebPage",
-    "@id": "https://example.com/article-slug"
-  }
-}
-```
-
-**Required by Google**: `headline`, `image`, `datePublished`, `author`
-
-## Product
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "Product",
-  "name": "Product Name",
-  "description": "Product description",
-  "image": ["https://example.com/product-1.jpg", "https://example.com/product-2.jpg"],
-  "sku": "PROD-123",
-  "brand": {
-    "@type": "Brand",
-    "name": "Brand Name"
-  },
-  "offers": {
-    "@type": "Offer",
-    "url": "https://example.com/product",
-    "priceCurrency": "USD",
-    "price": "29.99",
-    "availability": "https://schema.org/InStock",
-    "itemCondition": "https://schema.org/NewCondition"
-  },
-  "aggregateRating": {
-    "@type": "AggregateRating",
-    "ratingValue": "4.5",
-    "reviewCount": "127"
-  }
-}
-```
-
-**Required by Google**: `name` + one of `review`, `aggregateRating`, or `offers`
-
-## FAQ
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "FAQPage",
-  "mainEntity": [
-    {
-      "@type": "Question",
-      "name": "What is the return policy?",
-      "acceptedAnswer": {
-        "@type": "Answer",
-        "text": "We accept returns within 30 days of purchase. Items must be unused and in original packaging."
-      }
-    },
-    {
-      "@type": "Question",
-      "name": "How long does shipping take?",
-      "acceptedAnswer": {
-        "@type": "Answer",
-        "text": "Standard shipping takes 3-5 business days. Express shipping is available for 1-2 day delivery."
-      }
-    }
-  ]
-}
-```
-
-**Note**: Each Q&A must appear as visible content on the page. Do not use for ad content.
-
-## BreadcrumbList
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "BreadcrumbList",
-  "itemListElement": [
-    {
-      "@type": "ListItem",
-      "position": 1,
-      "name": "Home",
-      "item": "https://example.com"
-    },
-    {
-      "@type": "ListItem",
-      "position": 2,
-      "name": "Category",
-      "item": "https://example.com/category"
-    },
-    {
-      "@type": "ListItem",
-      "position": 3,
-      "name": "Product Name",
-      "item": "https://example.com/category/product"
-    }
-  ]
-}
-```
-
-**Note**: `position` must be sequential starting at 1. Last item does not require `item` URL.
-
-## Validation
-
-| Tool | URL |
-|------|-----|
-| Google Rich Results Test | https://search.google.com/test/rich-results |
-| Schema.org Validator | https://validator.schema.org |
-| Chrome DevTools → Network | Filter for `application/ld+json` |
-
-## Common Mistakes
-
-| Mistake | Fix |
-|---------|-----|
-| Price without currency | Always include `priceCurrency` with `price` |
-| Missing `datePublished` on Article | Required for Google News eligibility |
-| FAQ content not visible on page | Google penalizes hidden Q&A markup |
-| Breadcrumb positions not sequential | Use 1, 2, 3 — no skipping |
-| Image URL not absolute | Always use full `https://` URLs |

package/skills/vibe.seo-checklist/rubrics/content-seo.md

@@ -1,42 +0,0 @@
-# Content SEO Checklist
-
-## Heading Structure
-
-- [ ] Single `<h1>` per page — matches primary keyword intent
-- [ ] Logical hierarchy: `h1 → h2 → h3` (no skipping levels)
-- [ ] `<h2>` tags cover major subtopics (crawlers use for content outline)
-- [ ] No headings used purely for styling — use CSS classes instead
-
-## Keyword Placement
-
-- [ ] Primary keyword in `<title>`, `<h1>`, first 100 words of body
-- [ ] Secondary keywords in `<h2>` tags and body naturally
-- [ ] Keyword in image `alt` text where relevant (descriptive, not stuffed)
-- [ ] URL slug contains primary keyword (lowercase, hyphens, no stop words)
-
-## Internal Linking
-
-- [ ] Every important page reachable within 3 clicks from homepage
-- [ ] Anchor text is descriptive ("authentication guide") not generic ("click here")
-- [ ] New content links back to related existing content
-- [ ] Orphan pages (no inbound internal links) have at least one link added
-
-## Content Quality Signals
-
-- [ ] Word count appropriate for topic depth (informational: 1000+, landing: 300-600)
-- [ ] No duplicate content across pages — each URL has unique value
-- [ ] Pagination uses `rel="next"` / `rel="prev"` or canonical to main page
-- [ ] Thin content pages (< 300 words) either expanded or `noindex` applied
-
-## Images & Media
-
-- [ ] Every `<img>` has descriptive `alt` text (empty `alt=""` for decorative images)
-- [ ] File names descriptive: `product-dashboard-screenshot.webp` not `IMG_4821.jpg`
-- [ ] Use WebP or AVIF format where possible
-- [ ] Videos have transcript or caption for accessibility and crawlability
-
-## Localization (if applicable)
-
-- [ ] `hreflang` tags on all translated pages
-- [ ] Each locale version has its own canonical URL
-- [ ] `hreflang` includes `x-default` for language selector page

package/skills/vibe.seo-checklist/rubrics/technical-seo.md

@@ -1,48 +0,0 @@
-# Technical SEO Checklist
-
-## Meta Tags
-
-- [ ] `<title>` unique per page, 50-60 characters
-- [ ] `<meta name="description">` unique per page, 150-160 characters
-- [ ] `<link rel="canonical">` on every page (including paginated, filtered)
-- [ ] `<meta name="robots" content="index,follow">` — verify `noindex` is NOT in production
-- [ ] `<html lang="{{LOCALE}}">` set correctly
-
-## Open Graph / Social
-
-- [ ] `og:title` — matches page title or optimized variant
-- [ ] `og:description` — matches meta description or optimized variant
-- [ ] `og:image` — exactly **1200x630px**, under 8MB
-- [ ] `og:type` — `website` for homepage, `article` for posts, `product` for products
-- [ ] `og:url` — canonical URL
-- [ ] `twitter:card` — `summary_large_image` for image-rich pages
-- [ ] `twitter:image` — same as og:image (some crawlers check separately)
-
-## Structured Data (JSON-LD)
-
-- [ ] Correct `@type` for content: `Article`, `Product`, `FAQPage`, `LocalBusiness`, `BreadcrumbList`
-- [ ] `BreadcrumbList` on all non-root pages
-- [ ] Validated with [Google Rich Results Test](https://search.google.com/test/rich-results)
-- [ ] No structured data describing content not visible on the page
-
-## Crawlability
-
-- [ ] `robots.txt` present at domain root
-  - `Allow: /` for public pages
-  - `Disallow: /api/`, `/admin/`, `/_next/` (static assets excepted)
-  - `Sitemap: https://{{DOMAIN}}/sitemap.xml`
-- [ ] `sitemap.xml` auto-generated, includes `<lastmod>` with real dates
-- [ ] Sitemap submitted to Google Search Console
-
-## Performance (Core Web Vitals)
-
-| Metric | Target | Common Fix |
-|--------|--------|------------|
-| LCP | ≤ 2.5s | `<link rel="preload">` on hero image |
-| INP | ≤ 200ms | Defer non-critical JS |
-| CLS | ≤ 0.1 | Set `width`/`height` on all images; `min-height` on dynamic containers |
-
-- [ ] Images have explicit `width` and `height` attributes
-- [ ] Below-fold images use `loading="lazy"`
-- [ ] Hero/LCP image uses `fetchpriority="high"` (not lazy)
-- [ ] No render-blocking scripts without `defer` or `async`