Untitled Session
2026-05-25 20:38 UTC · 18 messages · cli
You2026-05-25 20:40 UTC
Rewrite the SEO Project Brief at /root/.hermes/plans/pb-m9-seo.md
The architecture is now: **Google Site Kit (free plugin) + custom-built everything else.**
**Google Site Kit scope:**
- Install Google Site Kit plugin (free from WP repo)
- Connect Google Search Console — submit sitemaps, monitor crawl errors, get search analytics
- Connect Google Analytics — traffic data
- Optionally PageSpeed Insights — Core Web Vitals data
- That's it. Site Kit is ONLY for Google integration, nothing more.
**Custom build scope (everything else):**
1. **XML Sitemap Generator** — custom module generates sitemap.xml with proper hierarchy, lastmod, priority, changefreq. Support sub-sitemaps for different content types (basic pages, marketing, catalog, library, community, lit reviews). Exclude confirmation pages, member dashboards.
2. **Schema Injection** — custom JSON-LD schema injection (ScholarlyArticle, CreativeWorkSeries, CreativeWorkSeason, CreativeWorkEpisode, VideoObject, AudioObject, CollectionPage, QAPage, BreadcrumbList). Handle both WP post types AND non-WP catalog/library pages via renderSchema() returning raw JSON-LD string.
3. **llms.txt** — generate llms.txt for AI crawlers
4. **SEO Meta** — title, description, OG tags, Twitter cards, canonical URLs, robots meta, pagination meta
5. **Breadcrumbs** — breadcrumb schema + visual breadcrumbs for catalog hierarchy, 90%+ coverage
6. **Canonical URLs** — per-content-type rules
7. **Redirect Manager** — basic 301/302 redirect CRUD
8. **Tone Taxonomy** — uncle-voice vs dr-saunders-voice
**Update the PB:**
- §0: New executive summary (Site Kit + custom build)
- §2: Remove all Rank Math evaluation. Add brief Site Kit rationale. Add build-vs-plugin decision log.
- §3: Architecture for custom-only approach
- §4: seo_bridge module expands to cover sitemaps + schema + meta + breadcrumbs + redirects + tone taxonomy
- §5: Content strategy (remove Rank Math references)
- §7: Update 20 card descriptions on Deck Board 13 to match new approach
- §8: Update risks (remove Rank Math conflicts, add custom-build risks like sitemap correctness)
- §9: New build order — Phase 1: Site Kit install, Phase 2: Sitemap module, Phase 3: Schema + Meta, Phase 4: Breadcrumbs + Redirects, Phase 5: Tone + Docs
- §10: Updated file manifest
Save in-place at /root/.hermes/plans/pb-m9-seo.md
Donna2026-05-25 20:40 UTC
Tool2026-05-25 20:40 UTC
{"content": " 1|# Project Brief: Module 9 — SEO\n 2|\n 3|**Document ID:** PB-M9-SEO-001\n 4|**Author:** SA\n 5|**Date:** 2026-05-25\n 6|**Status:** DRAFT — Pending Profe greenlight\n 7|**Build Plan Source:** pb-complete.md (lines 890-957), features-brief.md\n 8|**Deck...
Tool2026-05-25 20:40 UTC
{"content": " 1|# SGS Re-Review: Module 9 — SEO (PB-M9-SEO-001)\n 2|\n 3|**Reviewer:** SGS (subagent)\n 4|**Date:** 2026-05-25\n 5|**Document:** `/root/.hermes/plans/pb-m9-seo.md` (759 lines)\n 6|**Previous review:** `/root/.hermes/plans/pb-m9-seo-sgs-review.md`\n 7|**Sta...
Donna2026-05-25 20:40 UTC
Tool2026-05-25 20:40 UTC
{"content": " 501|namespace Profe\\SeoBridge;\n 502|\n 503|interface SeoBridgeInterface\n 504|{\n 505| /**\n 506| * Get or create SEO metadata for a custom content entity.\n 507| */\n 508| public function getMetadata(string $entityType, int $entityId): ?array;\n 509| ...
Donna2026-05-25 20:40 UTC
Now I have the full picture. Let me write the completely rewritten PB.
Tool2026-05-25 20:40 UTC
{"bytes_written": 67131, "dirs_created": true, "lint": {"status": "skipped", "message": "No linter for .md files"}, "_warning": "/root/.hermes/plans/pb-m9-seo.md was last read with offset/limit pagination (partial view). Re-read the whole file before overwriting it."}
Donna2026-05-25 20:40 UTC
Let me verify the rewrite is complete and well-structured.
Tool2026-05-25 20:40 UTC
{"content": " 1|# Project Brief: Module 9 — SEO\n 2|\n 3|**Document ID:** PB-M9-SEO-002\n 4|**Author:** SA\n 5|**Date:** 2026-05-25\n 6|**Status:** DRAFT — Pending Profe greenlight\n 7|**Build Plan Source:** pb-complete.md (lines 890-957), features-brief.md, **Profe decis...
Tool2026-05-25 20:40 UTC
{"content": " 580|\n 581|10. **Pagination Meta Tags** — Inject `rel=\"next\"`, `rel=\"prev\"`, `noindex,follow` on pagination pages beyond page 1.\n 582|\n 583|**What seo_bridge does NOT do:**\n 584|- Does NOT replace Google Site Kit — Site Kit still handles Search Console + Analytics inte...
Donna2026-05-25 20:40 UTC
Tool2026-05-25 20:40 UTC
{"content": " 1055|| `src/SeoBridge/SeoBridgeModule.php` | NEW | ModuleInstanceInterface, route registration, migration, event listeners, tone taxonomy registration |\n 1056|| `src/SeoBridge/SeoBridgeSchemaTemplates.php` | NEW | Schema template configuration + placeholder replacement engine |\n 1...
Donna2026-05-25 20:40 UTC
Let me verify there are no residual Rank Math references in the wrong places.
Tool2026-05-25 20:40 UTC
{"total_count": 26, "matches": [{"path": "/root/.hermes/plans/pb-m9-seo.md", "line": 6, "content": "**Status:** DRAFT — Pending Profe greenlight"}, {"path": "/root/.hermes/plans/pb-m9-seo.md", "line": 7, "content": "**Build Plan Source:** pb-complete.md (lines 890-957), features-brief.md, **Profe de...
Donna2026-05-25 20:40 UTC
Good — all 26 "Rank Math" references are in proper context (decision rationale, decision log, or "not using" statements). No residual usage instructions remain.
Let me verify the sections specifically called out in the task are all present.
Tool2026-05-25 20:40 UTC
{"total_count": 29, "matches": [{"path": "/root/.hermes/plans/pb-m9-seo.md", "line": 12, "content": "## §0 Executive Summary"}, {"path": "/root/.hermes/plans/pb-m9-seo.md", "line": 67, "content": "## §1 Locked from Past Modules"}, {"path": "/root/.hermes/plans/pb-m9-seo.md", "line": 71, "content": "...
Donna2026-05-25 20:40 UTC
The file is complete and well-structured. Here is a summary of the rewrite:
---
## Summary
**What I did:** Completely rewrote `/root/.hermes/plans/pb-m9-seo.md` from the Rank Math approach to the Google Site Kit + full custom build approach.
**File modified:** `/root/.hermes/plans/pb-m9-seo.md` — 1104 lines, saved in-place.
**Document ID** bumped to PB-M9-SEO-002.
### What changed per section:
| Section | What Was | What Is Now |
|---------|----------|------------|
| **§0 Executive Summary** | Rank Math + custom bridge | Site Kit (Google only) + full custom seo_bridge. Includes architecture diagram showing the two-layer stack. |
| **§2 Tool Evaluation** | Full Rank Math vs Yoast vs TSF comparison table | Brief Site Kit rationale, "Why NOT a plugin approach" reasoning, build-vs-plugin decision log with Profe's explicit override. |
| **§3 Architecture** | Rank Math-driven implementation plan | Full custom architecture. 12 sub-requirements (was 10) — expanded to cover sitemap generation, llms.txt, schema, meta, breadcrumbs, pagination, community, catalog, library, lit reviews, content silos, tone. |
| **§4 Module Breakdown** | seo_bridge as small Rank Math bridge (8 responsibilities) | seo_bridge as the complete SEO engine (10 responsibilities). Interface expanded from 5 methods to 16 methods. Added `profe_redirects` table. Added 6 service classes to file manifest. |
| **§5 Content Strategy** | Rank Math references present | All Rank Math references removed. Strategy unchanged otherwise. |
| **§7 Deck Board Cards** | 20 cards for Rank Math install + bridge build | 20 completely rewritten cards: 09-01 is now Site Kit install, 09-02→09-20 are custom build tasks (sitemaps, schema, meta, breadcrumbs, redirects, tone, templates, etc.) |
| **§8 Risk Assessment** | Rank Math conflicts listed | Rank Math conflict risk removed. Added: custom sitemap formatting errors, breadcrumb resolution failures, redirect loops, wrong sitemap exclusions. |
| **§9 Build Order** | 4 phases (9A-D) centered on Rank Math | 5 phases: Phase 1 Site Kit + cleanup, Phase 2 Sitemaps + llms.txt, Phase 3 Schema + Meta + Templates, Phase 4 Breadcrumbs + Redirects, Phase 5 Polish + Docs |
| **§10 File Manifest** | 18 files (Rank Math bridge) | 24 files (full custom module with 6 service classes, 2 repositories, 2 migration classes + redirect migration) |
| **§11 Forward Signals** | Rank Math-centric items | Rewritten for custom approach — added CDN and structured data automation items. |