bmad-plus 0.1.3 → 0.3.0

package/oveanet-pack/seo-audit-360/ref/quality-gates.md

@@ -0,0 +1,133 @@
+# Quality Gates — Content Thresholds (March 2026)
+
+> Author: Laurent Rochetta | BMAD+ SEO Engine v2.0
+
+## Word Count Minimums by Page Type
+
+| Page Type | Minimum | Notes |
+|-----------|---------|-------|
+| Homepage | 500 | Brand clarity + key offerings |
+| Service page | 800 | Comprehensive service description |
+| Blog / article | 1,500 | Deep topical coverage |
+| Product page | 300+ (400+ complex) | Depends on product complexity |
+| Category page | 200 | Plus product listings |
+| Location page | 500–600 | Must be 60%+ unique per location |
+| Comparison page | 1,200 | Feature matrix + analysis |
+| Landing page | 400 | Conversion-focused |
+| About page | 500 | Company story + credentials |
+| FAQ page | 1,000 | Comprehensive Q&A coverage |
+
+> **Word count is NOT a ranking factor.** These are topical coverage floors. A thorough 500-word page beats a padded 2,000-word one.
+
+---
+
+## Location Page Quality Gates
+
+| Threshold | Action |
+|-----------|--------|
+| 1–29 location pages | ✅ Normal — ensure 60%+ unique content per page |
+| 30+ location pages | ⚠️ WARNING — enforce 60%+ unique content, audit for thin/duplicate |
+| 50+ location pages | 🛑 HARD STOP — require user justification before proceeding |
+
+### Unique Content Requirements per Location
+- Unique local testimonials or case studies
+- Location-specific service details
+- Local area information and context
+- Original photos (not stock)
+- Unique meta title and description
+
+---
+
+## Programmatic Page Quality Gates
+
+| Threshold | Action |
+|-----------|--------|
+| 1–99 programmatic pages | ✅ Normal — verify template quality |
+| 100+ pages | ⚠️ WARNING — audit for thin content and cannibalization |
+| 500+ pages | 🛑 HARD STOP — full audit required before generating more |
+
+### Programmatic Content Requirements
+- Each page must provide unique value (not just data swap)
+- Internal linking automation between related pages
+- Canonical strategy to prevent index bloat
+- Minimum 200 words of unique contextual content per page
+- Quality varies by template — audit samples before scale
+
+---
+
+## Title Tag Guidelines
+
+| Criterion | Requirement |
+|-----------|-------------|
+| Length | 50–60 characters (display limit ~600px) |
+| Primary keyword | Include near the beginning |
+| Brand name | Append with " | Brand" or " — Brand" |
+| Uniqueness | Every page must have a unique title |
+| Accuracy | Must reflect actual page content |
+
+---
+
+## Meta Description Guidelines
+
+| Criterion | Requirement |
+|-----------|-------------|
+| Length | 150–160 characters |
+| Call to action | Include when appropriate |
+| Primary keyword | Include naturally |
+| Uniqueness | Every page must have a unique description |
+| Accuracy | Must match page content (Google may rewrite if not) |
+
+---
+
+## Heading Hierarchy Rules
+
+| Rule | Requirement |
+|------|-------------|
+| H1 count | Exactly 1 per page |
+| H1 content | Should contain primary keyword, be descriptive |
+| Hierarchy | H1 → H2 → H3 (no skipping levels) |
+| Heading frequency | One heading every 200–300 words |
+| Heading style | Descriptive, not generic ("Our Services" → "Professional SEO Audit Services") |
+
+---
+
+## Image Optimization Standards
+
+| Criterion | Standard | Priority |
+|-----------|----------|----------|
+| Alt text | Descriptive, meaningful, includes keywords naturally | High |
+| Dimensions | Width and height attributes specified | High (CLS) |
+| Format | WebP or AVIF preferred, JPEG/PNG acceptable | Medium |
+| File size | <200KB for standard, <500KB for hero images | Medium |
+| Lazy loading | `loading="lazy"` for below-fold images | Medium |
+| Preload | `<link rel="preload">` for hero/LCP images | High |
+| Srcset | Responsive sizes for different viewports | Medium |
+
+---
+
+## Internal Linking Standards
+
+| Metric | Target |
+|--------|--------|
+| Links per 1,000 words | 3–5 relevant internal links |
+| Anchor text | Descriptive (not "click here") |
+| Orphan pages | 0 (every page linked from at least one other) |
+| Click depth | Important pages within 3 clicks of homepage |
+| Broken links | 0 internal 404s |
+
+---
+
+## Thin Content Detection
+
+A page is flagged as "thin content" when:
+1. Word count is below the minimum for its page type
+2. Content is predominantly duplicate or near-duplicate of another page
+3. Content is auto-generated without unique value-add
+4. Page provides no actionable information
+
+### Doorway Page Prevention
+Never recommend creating pages that:
+- Exist solely to funnel users to another page
+- Have nearly identical content with only location/keyword swaps
+- Provide no standalone value
+- Target many similar keyword variations with minimal differences

package/oveanet-pack/seo-audit-360/ref/schema-catalog.md

@@ -0,0 +1,91 @@
+# Schema.org — Type Catalog & Deprecation Status (March 2026)
+
+> Author: Laurent Rochetta | BMAD+ SEO Engine v2.0 | Schema.org v29.4
+
+## Format: Always JSON-LD
+`<script type="application/ld+json">` — Google's explicit recommendation.
+Content with schema has ~2.5× higher AI citation probability (Google/Microsoft, March 2025).
+
+## Active — Recommend Freely
+
+| Type | Use Case | Key Properties |
+|------|----------|----------------|
+| Organization | Company/brand | name, url, logo, contactPoint, sameAs |
+| LocalBusiness | Physical location | name, address, telephone, openingHours, geo, priceRange |
+| SoftwareApplication | Apps | name, operatingSystem, applicationCategory, offers |
+| WebApplication | SaaS | name, applicationCategory, offers, featureList |
+| Product | Products | name, image, description, sku, brand, offers, review |
+| ProductGroup | Variants | name, productGroupID, variesBy, hasVariant |
+| Offer | Pricing | price, priceCurrency, availability, url |
+| Service | Services | name, provider, areaServed, description, offers |
+| Article | Articles | headline, author, datePublished, dateModified, image, publisher |
+| BlogPosting | Blog content | Same as Article + blog context |
+| NewsArticle | News | Same as Article + news context |
+| Review | Reviews | reviewRating, author, itemReviewed, reviewBody |
+| AggregateRating | Ratings | ratingValue, reviewCount, bestRating |
+| BreadcrumbList | Navigation | itemListElement with position, name, item |
+| WebSite | Site-level | name, url, potentialAction (SearchAction) |
+| WebPage | Page-level | name, description, datePublished, dateModified |
+| Person | Authors/team | name, jobTitle, url, sameAs, image, worksFor |
+| ProfilePage | Profiles | mainEntity (Person), name, sameAs |
+| ContactPage | Contact | name, url |
+| VideoObject | Video | name, description, thumbnailUrl, uploadDate, duration |
+| ImageObject | Images | contentUrl, caption, creator |
+| Event | Events | name, startDate, endDate, location, organizer |
+| JobPosting | Jobs | title, description, datePosted, hiringOrganization |
+| Course | Education | name, description, provider, hasCourseInstance |
+| DiscussionForumPosting | Forums | headline, author, datePublished, text |
+| Certification | Certifications | certificationIdentification, issuedBy (April 2025) |
+| BroadcastEvent | Live streams | isLiveBroadcast, startDate, endDate |
+| Clip | Video chapters | name, startOffset, endOffset, url |
+| SeekToAction | Video seek | target with timestamp parameter |
+| SoftwareSourceCode | Repos | codeRepository, programmingLanguage, license |
+
+## Restricted — Specific Sites Only
+
+| Type | Restriction | Since |
+|------|------------|-------|
+| FAQPage | Government & healthcare ONLY | Aug 2023 |
+
+> FAQPage still benefits AI/LLM citation (ChatGPT, Perplexity) even without Google rich results. Existing FAQPage on commercial sites: Info priority, not Critical.
+
+## Deprecated — NEVER Recommend
+
+| Type | Since | Notes |
+|------|-------|-------|
+| HowTo | Sept 2023 | Rich results fully removed |
+| SpecialAnnouncement | July 2025 | COVID-era, no longer processed |
+| CourseInfo | June 2025 | Merged into Course |
+| EstimatedSalary | June 2025 | No longer displayed |
+| LearningVideo | June 2025 | Use VideoObject instead |
+| ClaimReview | June 2025 | Fact-check markup discontinued |
+| VehicleListing | June 2025 | Vehicle listings discontinued |
+| Practice Problem | Late 2025 | Educational problems discontinued |
+| Dataset | Late 2025 | Dataset Search discontinued |
+
+## Recent Additions (2024–2026)
+
+| Feature | When | Notes |
+|---------|------|-------|
+| Product Certification | April 2025 | Replaces EnergyConsumptionDetails |
+| ProductGroup | 2025 | E-commerce variants |
+| ProfilePage | 2025 | E-E-A-T author pages |
+| DiscussionForumPosting | 2024 | Forum content |
+| LoyaltyProgram | June 2025 | Member pricing |
+| ConferenceEvent | Dec 2025 | Schema.org v29.4 |
+| PerformingArtsEvent | Dec 2025 | Schema.org v29.4 |
+
+## Validation Checklist
+1. ✅ `@context` = `"https://schema.org"` (not http)
+2. ✅ `@type` valid + non-deprecated
+3. ✅ Required properties present
+4. ✅ Correct data types
+5. ✅ No placeholder text
+6. ✅ Absolute URLs only
+7. ✅ ISO 8601 dates
+8. ✅ Valid image URLs
+
+## E-Commerce Notes
+- `returnPolicyCountry` required in MerchantReturnPolicy (March 2025)
+- Content API for Shopping sunsets August 18, 2026 → migrate to Merchant API
+- JS-injected Product schema may face delayed processing → include in server HTML

package/oveanet-pack/seo-audit-360/ref/schema-templates.json

@@ -0,0 +1,356 @@
+{
+  "meta": {
+    "author": "Laurent Rochetta",
+    "engine": "BMAD+ SEO Engine v2.0",
+    "schema_org_version": "29.4",
+    "last_updated": "2026-03-19"
+  },
+  "templates": [
+    {
+      "type": "Organization",
+      "use_case": "Company/brand homepage",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Organization",
+        "name": "[Company Name]",
+        "url": "[Website URL]",
+        "logo": "[Logo URL]",
+        "description": "[Company description]",
+        "foundingDate": "[YYYY]",
+        "contactPoint": {
+          "@type": "ContactPoint",
+          "telephone": "[Phone]",
+          "contactType": "customer service",
+          "availableLanguage": ["English", "French"]
+        },
+        "sameAs": [
+          "[Facebook URL]",
+          "[LinkedIn URL]",
+          "[Twitter URL]",
+          "[YouTube URL]"
+        ]
+      }
+    },
+    {
+      "type": "LocalBusiness",
+      "use_case": "Physical business location",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "LocalBusiness",
+        "name": "[Business Name]",
+        "url": "[Website URL]",
+        "image": "[Photo URL]",
+        "telephone": "[Phone]",
+        "priceRange": "[$$]",
+        "address": {
+          "@type": "PostalAddress",
+          "streetAddress": "[Street]",
+          "addressLocality": "[City]",
+          "addressRegion": "[State/Region]",
+          "postalCode": "[ZIP]",
+          "addressCountry": "[Country Code]"
+        },
+        "geo": {
+          "@type": "GeoCoordinates",
+          "latitude": "[Lat]",
+          "longitude": "[Long]"
+        },
+        "openingHoursSpecification": [
+          {
+            "@type": "OpeningHoursSpecification",
+            "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
+            "opens": "09:00",
+            "closes": "18:00"
+          }
+        ]
+      }
+    },
+    {
+      "type": "Article",
+      "use_case": "Blog posts, articles",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Article",
+        "headline": "[Title - max 110 chars]",
+        "description": "[Summary]",
+        "author": {
+          "@type": "Person",
+          "name": "[Author Name]",
+          "url": "[Author Profile URL]"
+        },
+        "datePublished": "[YYYY-MM-DD]",
+        "dateModified": "[YYYY-MM-DD]",
+        "image": "[Featured Image URL]",
+        "publisher": {
+          "@type": "Organization",
+          "name": "[Publisher Name]",
+          "logo": {
+            "@type": "ImageObject",
+            "url": "[Logo URL]"
+          }
+        },
+        "mainEntityOfPage": {
+          "@type": "WebPage",
+          "@id": "[Page URL]"
+        }
+      }
+    },
+    {
+      "type": "Product",
+      "use_case": "E-commerce product pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Product",
+        "name": "[Product Name]",
+        "image": "[Product Image URL]",
+        "description": "[Product Description]",
+        "sku": "[SKU]",
+        "brand": {
+          "@type": "Brand",
+          "name": "[Brand Name]"
+        },
+        "offers": {
+          "@type": "Offer",
+          "url": "[Product URL]",
+          "price": "[Price]",
+          "priceCurrency": "[Currency Code]",
+          "availability": "https://schema.org/InStock",
+          "seller": {
+            "@type": "Organization",
+            "name": "[Seller Name]"
+          }
+        },
+        "aggregateRating": {
+          "@type": "AggregateRating",
+          "ratingValue": "[4.5]",
+          "reviewCount": "[120]"
+        }
+      }
+    },
+    {
+      "type": "WebSite",
+      "use_case": "Site-level with sitelinks search box",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "WebSite",
+        "name": "[Site Name]",
+        "url": "[Homepage URL]",
+        "potentialAction": {
+          "@type": "SearchAction",
+          "target": {
+            "@type": "EntryPoint",
+            "urlTemplate": "[Search URL]?q={search_term_string}"
+          },
+          "query-input": "required name=search_term_string"
+        }
+      }
+    },
+    {
+      "type": "BreadcrumbList",
+      "use_case": "Navigation breadcrumbs",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        "itemListElement": [
+          {
+            "@type": "ListItem",
+            "position": 1,
+            "name": "Home",
+            "item": "[Homepage URL]"
+          },
+          {
+            "@type": "ListItem",
+            "position": 2,
+            "name": "[Category]",
+            "item": "[Category URL]"
+          },
+          {
+            "@type": "ListItem",
+            "position": 3,
+            "name": "[Current Page]"
+          }
+        ]
+      }
+    },
+    {
+      "type": "Person",
+      "use_case": "Author/team member profiles (E-E-A-T)",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Person",
+        "name": "[Full Name]",
+        "jobTitle": "[Job Title]",
+        "url": "[Profile URL]",
+        "image": "[Photo URL]",
+        "description": "[Professional bio]",
+        "worksFor": {
+          "@type": "Organization",
+          "name": "[Company Name]"
+        },
+        "sameAs": [
+          "[LinkedIn URL]",
+          "[Twitter URL]",
+          "[GitHub URL]"
+        ]
+      }
+    },
+    {
+      "type": "Service",
+      "use_case": "Service business pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Service",
+        "name": "[Service Name]",
+        "description": "[Service Description]",
+        "provider": {
+          "@type": "Organization",
+          "name": "[Provider Name]",
+          "url": "[Provider URL]"
+        },
+        "areaServed": {
+          "@type": "City",
+          "name": "[Service Area]"
+        },
+        "offers": {
+          "@type": "Offer",
+          "price": "[Starting Price]",
+          "priceCurrency": "[Currency]"
+        }
+      }
+    },
+    {
+      "type": "VideoObject",
+      "use_case": "Video content pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "VideoObject",
+        "name": "[Video Title]",
+        "description": "[Video Description]",
+        "thumbnailUrl": "[Thumbnail URL]",
+        "uploadDate": "[YYYY-MM-DD]",
+        "duration": "[PT1H30M]",
+        "contentUrl": "[Video File URL]",
+        "embedUrl": "[Embed URL]",
+        "publisher": {
+          "@type": "Organization",
+          "name": "[Publisher]"
+        }
+      }
+    },
+    {
+      "type": "Event",
+      "use_case": "Events and conferences",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Event",
+        "name": "[Event Name]",
+        "description": "[Event Description]",
+        "startDate": "[YYYY-MM-DDTHH:MM]",
+        "endDate": "[YYYY-MM-DDTHH:MM]",
+        "location": {
+          "@type": "Place",
+          "name": "[Venue Name]",
+          "address": {
+            "@type": "PostalAddress",
+            "streetAddress": "[Street]",
+            "addressLocality": "[City]",
+            "addressCountry": "[Country]"
+          }
+        },
+        "organizer": {
+          "@type": "Organization",
+          "name": "[Organizer Name]",
+          "url": "[Organizer URL]"
+        },
+        "offers": {
+          "@type": "Offer",
+          "price": "[Price]",
+          "priceCurrency": "[Currency]",
+          "url": "[Ticket URL]",
+          "availability": "https://schema.org/InStock"
+        }
+      }
+    },
+    {
+      "type": "SoftwareApplication",
+      "use_case": "SaaS and app pages",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "SoftwareApplication",
+        "name": "[App Name]",
+        "description": "[App Description]",
+        "applicationCategory": "[Category]",
+        "operatingSystem": "[OS]",
+        "offers": {
+          "@type": "Offer",
+          "price": "[Price or 0]",
+          "priceCurrency": "[Currency]"
+        },
+        "aggregateRating": {
+          "@type": "AggregateRating",
+          "ratingValue": "[Rating]",
+          "ratingCount": "[Count]"
+        }
+      }
+    },
+    {
+      "type": "ProfilePage",
+      "use_case": "Author/creator profile pages (E-E-A-T)",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "ProfilePage",
+        "mainEntity": {
+          "@type": "Person",
+          "name": "[Author Name]",
+          "url": "[Profile URL]",
+          "description": "[Bio and expertise]",
+          "sameAs": ["[LinkedIn]", "[Twitter]"]
+        }
+      }
+    },
+    {
+      "type": "ProductGroup",
+      "use_case": "E-commerce product variants",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "ProductGroup",
+        "name": "[Product Name]",
+        "description": "[Group description]",
+        "productGroupID": "[Group ID]",
+        "variesBy": ["https://schema.org/size", "https://schema.org/color"],
+        "hasVariant": [
+          {
+            "@type": "Product",
+            "name": "[Variant Name]",
+            "sku": "[SKU]",
+            "color": "[Color]",
+            "size": "[Size]",
+            "offers": {
+              "@type": "Offer",
+              "price": "[Price]",
+              "priceCurrency": "[Currency]",
+              "availability": "https://schema.org/InStock"
+            }
+          }
+        ]
+      }
+    },
+    {
+      "type": "Certification",
+      "use_case": "Product certifications (April 2025)",
+      "template": {
+        "@context": "https://schema.org",
+        "@type": "Product",
+        "name": "[Product Name]",
+        "hasCertification": {
+          "@type": "Certification",
+          "certificationIdentification": "[Certification Name]",
+          "issuedBy": {
+            "@type": "Organization",
+            "name": "[Issuing Organization]"
+          }
+        }
+      }
+    }
+  ]
+}