bmad-plus 0.8.0 → 0.9.1

package/src/bmad-plus/agents/pack-seo/ref/schema-catalog.md

@@ -1,91 +0,0 @@
-# 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/src/bmad-plus/agents/pack-seo/ref/schema-templates.json

@@ -1,356 +0,0 @@
-{
-  "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]"
-          }
-        }
-      }
-    }
-  ]
-}