Subchapter 2.3

README

README.mdMarkdown17 KBView on GitHub

AISEO - Answer Engine Optimization Content Generator

Generate machine-readable content that earns citations from ChatGPT, Claude, Gemini, and Google AI Overviews.

Not a tool or app - this is a guided workflow with templates for use with Claude Code.

README · Bencium Aeo · bencium/bencium-marketplace · Skills Docs

File	Purpose	Audience
`prd.md`	Complete AEO content generation guide with templates	Claude Code
`CLAUDE.md`	Project context and development guidelines	Claude Code
`README.md`	Usage instructions and workflow	You (human)

"I need AEO-optimized content for [product name].

Product: [brief description]
Target page: [URL]
Top questions: [list 5-10 customer questions]
Data available: [any benchmarks, research, or stats]

Generate:
- Product overview (50 words)
- 15 FAQs with schema
- Evidence blocks for key claims
- All necessary JSON-LD markup"

"Generate AEO content for my SaaS analytics product.

Product: Real-time analytics dashboard for e-commerce stores
URL: analytics.example.com
Top questions:
- What is real-time analytics?
- How is this different from Google Analytics?
- What metrics can I track?
- How long does setup take?
- What integrations are supported?

We have benchmark data: 127ms median query latency from Q3 2025 study"

<article id="product-overview">
  <h1>What is [Product Name]?</h1>
  <div class="overview-answer">
    <p>[Product Name] is a real-time analytics dashboard for
    e-commerce stores that tracks customer behavior and sales metrics.
    As of October 2025, it processes over 10M events daily with
    sub-second latency. This matters because real-time insights enable
    immediate optimization of marketing campaigns and inventory.</p>
    <p class="meta">Last updated: 2025-10-31</p>
  </div>
  <!-- Product schema -->
  <script type="application/ld+json">
  { ... complete schema ... }
  </script>
</article>

<section id="faq">
  <h2>Frequently Asked Questions</h2>

  <div class="faq-item" id="faq-what-is-realtime-analytics">
    <h3>What is real-time analytics?</h3>
    <p>Real-time analytics processes and displays customer behavior
    data within seconds of events occurring, enabling immediate
    business decisions. Unlike batch processing (hourly/daily),
    real-time systems update dashboards continuously as customers
    interact with your store.</p>
    <p class="meta">Last updated: 2025-10-31</p>
  </div>

  <!-- 14 more FAQs -->

  <!-- FAQPage Schema -->
  <script type="application/ld+json">
  { ... complete FAQPage schema with all 15 FAQs ... }
  </script>
</section>

<aside class="evidence-panel" id="evidence-query-latency">
  <h4>Evidence: Query Performance Benchmark</h4>
  <dl>
    <dt>Claim:</dt>
    <dd>127ms median query latency for dashboard analytics</dd>

    <dt>Methodology:</dt>
    <dd>Measured 10,000 dashboard queries across 50 e-commerce stores
    over 30-day period</dd>

    <dt>Data Source:</dt>
    <dd><a href="https://example.com/benchmarks/2025-q3">Q3 2025
    Performance Report</a></dd>

    <dt>Date:</dt>
    <dd>September 15, 2025</dd>

    <dt>Limitations:</dt>
    <dd>Performance measured on standard tier; enterprise tier may
    vary ±15ms based on custom configurations</dd>
  </dl>
</aside>

Intent	Engine	Mentioned?	Linked?	Accurate?	Evidence Quoted?	Notes
What is X	ChatGPT	✅ Yes	✅ Yes	✅ Yes	❌ No	Generic description
Compare X vs Y	Claude	❌ No	❌ No	N/A	N/A	Doesn’t know us yet
Best [category]	Gemini	✅ Yes	❌ No	✅ Yes	✅ Yes	Cited our benchmark

Content Type	Check	Update
Homepage & FAQ	Monthly review	Quarterly update
Product pages	When features change	Immediately
Evidence blocks	Every 6 months	When data refreshes
Blog posts	Quarterly	Add “Last reviewed” even if unchanged
How-to guides	When process changes	Immediately

Mistake	Fix
❌ FAQ answers too long	✅ Keep to 30-50 words
❌ Missing dates	✅ Add “Last updated” everywhere
❌ Vague claims	✅ Include specific data, methods, dates
❌ No schema markup	✅ FAQPage schema is essential
❌ Marketing speak	✅ Use factual, specific language
❌ Buried answers	✅ Front-load the answer, details second
❌ Pronoun ambiguity	✅ Say “the product” not “it”
❌ Missing evidence	✅ Add methodology for all claims
❌ Stale content	✅ Update within 10 months or lose visibility

1. PREPARE
   ├─ Gather product info
   ├─ List top 15 customer questions
   ├─ Collect evidence/data
   └─ Note competitors

2. GENERATE (Claude Code session)
   ├─ "Generate AEO content for [URL/product]"
   ├─ Claude analyzes requirements
   ├─ Claude uses prd.md templates
   └─ Receive complete HTML + schema

3. IMPLEMENT
   ├─ Copy HTML to your website
   ├─ Add schema to <head>
   └─ Verify anchor links work

4. VALIDATE
   ├─ Google Rich Results Test
   ├─ Check FAQ word counts
   ├─ Verify all dates present
   └─ Test anchor links

5. TEST
   ├─ Manual prompts (ChatGPT, Claude, Gemini)
   ├─ Track in scorecard
   └─ Monitor over 4-8 weeks

6. MAINTAIN
   ├─ Monthly review
   ├─ Quarterly updates
   └─ Refresh data every 6 months