Back to .md Directory

FrankX.ai V3 - Complete Site Audit & Optimization Roadmap

Audits 54 routes, flags duplicates and missing pages, and prescribes a 4-phase optimization roadmap with rubrics and templates.

May 2, 2026
0 downloads
0 views
ai agent prompt
View source

What this file does

Audits 54 routes, flags duplicates and missing pages, and prescribes a 4-phase optimization roadmap with rubrics and templates.

When to use it

  • Planning a site-wide content and technical audit before expansion
  • Consolidating duplicate or overlapping pages in a Next.js project
  • Defining design, copy, and conversion standards for a team
  • Building a phased action plan for SEO and lead generation

Assumes this stack

Next.jsTypeScript

FrankX.ai V3 - Complete Site Audit & Optimization Roadmap

Current Version: V3HomePage (Active) Total Pages: 54 routes Audit Date: 2025-10-03 Goal: Establish specs, rubrics, and best practices before expansion


šŸ“Š CURRENT SITE INVENTORY

Core Pages (7)

  • āœ… / - Homepage (V3)
  • āœ… /about - About/Story
  • āœ… /contact - Contact
  • āœ… /start - Start Here/Onboarding
  • āœ… /thank-you - Thank you page
  • āœ… /search - Search functionality
  • āœ… /team - AI Team (NEW - just built)

Product Pages (7)

  • āœ… /products - Product hub
  • āœ… /products/vibe-os - Music OS
  • āœ… /products/creative-ai-toolkit - Toolkit
  • āœ… /products/agentic-creator-os - Creator OS
  • āœ… /products/generative-creator-os - Generative OS
  • āœ… /products/creation-chronicles - Chronicles
  • āœ… /products/[slug] - Dynamic product pages

Resources & Content (10)

  • āœ… /blog - Blog hub
  • āœ… /blog/[slug] - Dynamic blog posts
  • āš ļø /blog/intelligence-revolution-2025 - Static post
  • āš ļø /blog/soul-frequency-framework - Static post
  • āœ… /guides - Guides hub
  • āœ… /guides/[slug] - Dynamic guides
  • āœ… /resources - Resources hub
  • āœ… /resources/templates - Templates
  • āœ… /templates - Templates (duplicate?)
  • āœ… /prompt-library - Prompt library with categories

Community & Engagement (8)

  • āœ… /realm - Community
  • āœ… /community - Community (duplicate?)
  • āœ… /agents - Agents
  • āœ… /agent-team - Agent team services
  • āœ… /agentic-ai-center - AI center
  • āœ… /coaching - Coaching
  • āœ… /affiliates - Affiliate program
  • āœ… /testimonials - Social proof

Tools & Interactive (8)

  • āœ… /tools - Tools hub
  • āœ… /tools/builder - Builder tool
  • āœ… /tools/roi-calculator - ROI calculator
  • āœ… /tools/strategy-canvas - Strategy canvas
  • āœ… /assessment - Main assessment
  • āœ… /assessment/creative - Creative assessment
  • āœ… /assessment/advanced - Advanced assessment
  • āœ… /ai-assessment - AI assessment (duplicate?)

User Journey (9)

  • āœ… /soul-frequency-assessment - Main assessment
  • āœ… /soul-frequency-quiz - Quiz version
  • āœ… /onboarding - Onboarding flow
  • āœ… /dashboard - User dashboard
  • āœ… /goals - Goal setting
  • āœ… /achievements - Achievements
  • āœ… /roadmap - Roadmap
  • āœ… /founder-playbook - Founder resources
  • āœ… /intelligence-atlas - Intelligence mapping

Learning & Growth (5)

  • āœ… /courses - Courses hub
  • āœ… /courses/conscious-ai-foundations - Course page
  • āœ… /insights - Insights
  • āœ… /music-lab - Music creation
  • āœ… /content-studio - Content creation
  • āœ… /creation-chronicles - Creator journey

🚨 ISSUES IDENTIFIED

Duplicates & Confusion

  • āš ļø /community vs /realm - Same purpose?
  • āš ļø /templates vs /resources/templates - Consolidate?
  • āš ļø /assessment vs /ai-assessment vs /soul-frequency-assessment - 3 different assessments?
  • āš ļø /agents vs /agent-team - Related but separate?

Missing Critical Elements

  • āŒ No /privacy-policy page
  • āŒ No /terms-of-service page
  • āŒ No /sitemap.xml (maybe generated?)
  • āŒ No /404 custom error page?
  • āŒ No email capture modals/popups
  • āŒ No exit-intent capture

Content Gaps

  • āš ļø Blog only has 2 static posts (need volume)
  • āš ļø Guides appear empty (need content)
  • āš ļø Courses only has 1 course
  • āš ļø Products have landing pages but unclear what's actually delivered

Technical Concerns

  • āš ļø Multiple HomePage versions (V1, V2, V3, Optimized) - cleanup needed?
  • āš ļø TypeScript errors in type-check (not critical but should fix)
  • āš ļø No obvious analytics integration
  • āš ļø No obvious email service integration

šŸ“‹ WHAT WE NEED TO BUILD

Phase 1: Foundation & Standards (CURRENT PRIORITY)

1.1 Design System Documentation

Create: docs/DESIGN_SYSTEM.md

  • Color palette with HSL values
  • Typography scale and usage
  • Spacing system (margins, padding)
  • Component patterns library
  • Animation standards
  • Responsive breakpoints
  • Accessibility guidelines
  • Dark mode standards

1.2 Copywriting Standards

Create: docs/COPYWRITING_GUIDE.md

  • Brand voice definition
  • Tone variations by context
  • Power words list
  • Avoid words list
  • Headline formulas
  • CTA best practices
  • SEO title templates
  • Meta description templates

1.3 Page Quality Rubric

Create: docs/PAGE_QUALITY_RUBRIC.md

  • SEO checklist (meta, headings, keywords)
  • Performance targets (Core Web Vitals)
  • Accessibility score (WCAG 2.1 AA)
  • Conversion elements checklist
  • Mobile responsiveness checklist
  • Content quality standards
  • Legal compliance (GDPR, etc.)

1.4 Content Templates

Create: docs/CONTENT_TEMPLATES.md

  • Landing page structure
  • Product page structure
  • Blog post structure
  • Resource page structure
  • Tool page structure

Phase 2: Optimize Current Pages

2.1 Homepage (V3)

  • Audit against rubric
  • A/B test headline variations
  • Optimize hero CTA
  • Add trust signals
  • Add exit-intent capture
  • Performance optimization
  • Schema markup validation

2.2 Product Pages (7 pages)

  • Consistent structure across all
  • Before/After transformation clarity
  • Pricing clarity
  • What's included lists
  • Testimonials integration
  • FAQ sections
  • Urgency/scarcity elements
  • Clear next steps

2.3 Resource Pages

  • Consolidate duplicates
  • Consistent navigation
  • Clear categorization
  • Search functionality
  • Filter/sort options
  • Email gates for premium content

2.4 Tools & Assessments

  • Make them actually work (not just mockups)
  • Email capture before results
  • Personalized results pages
  • Product recommendations based on results
  • Social sharing functionality
  • Save/bookmark features

Phase 3: SEO Blog Infrastructure

3.1 Blog System

  • Category taxonomy
  • Tag system
  • Author system (you + AI team members)
  • Related posts
  • Reading time
  • Table of contents
  • Social sharing
  • Comments/engagement
  • Newsletter signup in posts

3.2 Content Calendar

  • 90-day content plan
  • Keyword research per post
  • Internal linking strategy
  • Topic clustering
  • Pillar content identification

3.3 SEO Optimization

  • Schema markup for articles
  • XML sitemap generation
  • Robots.txt optimization
  • Canonical URLs
  • Image optimization
  • Loading speed optimization

Phase 4: Lead Magnets & Interactive Tools

4.1 Lead Magnets

  • Soul Frequency Assessment (working version)
  • AI Readiness Calculator
  • Creator Type Quiz
  • Music Production Workflow Generator
  • Prompt Library (gated premium section)
  • Template Packages

4.2 Interactive Tools

  • Content Calendar Generator
  • Suno Prompt Builder
  • Workflow Visualizer
  • ROI Calculator (enhance current)
  • Strategy Canvas (enhance current)

šŸŽÆ BEST PRACTICES FRAMEWORK

Design Best Practices

  1. Visual Hierarchy: Clear F-pattern or Z-pattern
  2. White Space: Generous breathing room
  3. Contrast: WCAG AA minimum (4.5:1)
  4. Consistency: Same patterns everywhere
  5. Mobile-First: Design for smallest screen first
  6. Performance: <3s load time, >90 Lighthouse
  7. Animations: Purposeful, <300ms, can be disabled

Copywriting Best Practices

  1. Headlines: Problem → Solution → Outcome
  2. CTAs: Action verb + benefit + urgency
  3. Body: Short paragraphs, scannable, bullet points
  4. Tone: Conversational + authoritative
  5. SEO: Natural keyword integration, not stuffing
  6. Clarity: 8th-grade reading level
  7. Proof: Data, testimonials, case studies

Conversion Best Practices

  1. Above Fold: Clear value prop + CTA
  2. Trust Signals: Social proof, credentials, logos
  3. Urgency: Scarcity, deadlines, FOMO
  4. Risk Reversal: Guarantees, free trials
  5. Path Clarity: One clear next step
  6. Friction Reduction: Minimal form fields
  7. Exit Intent: Capture before they leave

šŸ“Š SUCCESS METRICS (To Define)

Current State (Baseline Needed)

  • Traffic (organic, direct, referral)
  • Bounce rate per page type
  • Time on page per page type
  • Conversion rate (email capture)
  • Conversion rate (product purchase)
  • Core Web Vitals scores
  • SEO rankings for target keywords

Goal State (To Define)

  • 10K monthly organic visitors?
  • 5% email capture rate?
  • <40% bounce rate?
  • >2min time on page?
  • 90+ Lighthouse scores?
  • Top 10 for target keywords?

šŸš€ RECOMMENDED IMMEDIATE ACTIONS

Week 1: Foundation

  1. āœ… Create Design System doc
  2. āœ… Create Copywriting Guide
  3. āœ… Create Page Quality Rubric
  4. āœ… Audit Homepage against rubric
  5. āœ… Identify quick wins (low-hanging fruit)

Week 2: Cleanup

  1. Resolve duplicate pages
  2. Add missing legal pages
  3. Fix TypeScript errors
  4. Remove unused components (old HomePage versions)
  5. Create 404 page

Week 3: Optimization

  1. Optimize top 5 pages (homepage + 4 products)
  2. Add email capture points
  3. Integrate analytics (if not done)
  4. Add basic schema markup

Week 4: Content Prep

  1. Set up blog infrastructure
  2. Create content calendar
  3. Write first 10 blog posts
  4. Set up email service

ā“ QUESTIONS TO ANSWER

  1. Which pages should we keep vs consolidate?

    • Community vs Realm?
    • Multiple assessment pages?
    • Templates duplication?
  2. What's the primary conversion goal?

    • Email capture?
    • Product purchase?
    • Community join?
    • Course enrollment?
  3. What actually gets delivered in products?

    • Notion templates?
    • PDF downloads?
    • Video courses?
    • Community access?
  4. Who is the absolute primary audience?

    • AI Architects (Oracle professionals)?
    • Music Creators (Suno users)?
    • Generative Creators (content creators)?
  5. What's the business model?

    • Digital products ($)?
    • Coaching/consulting ($$$)?
    • Community membership ($)?
    • Affiliate commissions?

šŸŽÆ MY RECOMMENDATION

Let's start with these 5 documents in this order:

  1. PAGE_QUALITY_RUBRIC.md - Our measuring stick
  2. DESIGN_SYSTEM.md - Visual consistency
  3. COPYWRITING_GUIDE.md - Voice consistency
  4. CONTENT_STRATEGY.md - What to build
  5. HOMEPAGE_OPTIMIZATION.md - Execute on #1 page

Then audit and optimize homepage as the model for all other pages.

Should I start building these documents now?

What's inside

8 sections: inventory of 54 routes, 4 issue categories, 4 phases with checklists, best practices framework, success metrics, and a 4-week action plan

Change this for your project

  • Replace FrankX.ai with your own brand name throughout
  • Replace V3HomePage with your active homepage version identifier
  • Replace frankxai/frankx.ai-vercel-website with your repository path
  • Replace all route paths like /soul-frequency-assessment with your own routes

Where it goes

Keep it in your repository where the agent or team that needs it will read it.

Worth borrowing

  • Separating issues into duplicates, missing elements, content gaps, and technical concerns for clarity
  • Phasing work into foundation, optimization, infrastructure, and lead magnets to avoid overwhelm
  • Including a 'Questions to Answer' section to force strategic decisions before execution

Related Documents