progress.txt

# Ralph Progress Log
Started: Thu Mar 19 16:52:37 CET 2026
---

## Codebase Patterns
- Article data is stored in `src/data/articles.ts` as a typed array, not markdown files
- All pages (homepage, category, articles) share the same dark theme with `bg-mesh` background, `header-blur` sticky header, and `category-card glow-border` card styling
- Category page and article page headers use the same logo + nav pattern with Map/Guides links
- `toSlug()` from `@/lib/categories` converts category names to URL slugs (e.g., "Standards & Protocols" → "standards-and-protocols")
- Homepage is a client component; category pages and article pages are server components
- Params in Next.js 16 are async: `params: Promise<{ slug: string }>` — must `await params`
- Pre-existing lint error in `src/app/page.tsx` (setState in useEffect) — not introduced by articles work
- Article content supports bullet lists (lines starting with `• ` or `- `) and numbered lists (`1. `) within body text, separated by `\n\n`
- Diagrams go in `src/components/diagrams/` and are mapped to articles via `articleDiagrams` in `src/app/articles/[slug]/page.tsx`
- OG image for articles is category-aware: imports `categories`, `categoryColors`, `categoryHex` from `@/lib/categories`
- Article JSON-LD author must be `@type: "Organization"` with `name: "Agentic Commerce Market Map"` and `url: "https://agenticcommercemap.com"`
- `/articles` index page has ItemList JSON-LD schema listing all articles

---

## 2026-03-20 - US-001
- Implemented blog infrastructure and sitemap integration
- Files changed:
  - `src/data/articles.ts` — Article type definitions (Article, ContentSection, FAQ) and articles array
  - `src/app/articles/page.tsx` — Articles index page with listing, dark theme, header/footer
  - `src/app/articles/[slug]/page.tsx` — Dynamic article route with semantic HTML (<article>, <time>, <section>, proper H1>H2>H3), generateStaticParams, related articles, category link
  - `src/app/sitemap.ts` — Added /articles (priority 0.6) and /articles/[slug] (priority 0.7) with publishedDate as lastModified
  - `src/app/feed.xml/route.ts` — Added article entries with title, link, description, pubDate
  - `src/app/llms.txt/route.ts` — Plain-text site overview for LLM crawlers with articles and categories
  - `src/app/page.tsx` — Added "Guides" link to homepage header nav
  - `src/app/category/[slug]/page.tsx` — Added "Guides" link to category page header nav, replaced "Back to Map" with Map/Guides nav
  - `prd.json` — Marked US-001 as passes: true
- **Learnings for future iterations:**
  - The header pattern is duplicated across homepage, category, and articles pages — consider extracting a shared Header component in the future
  - The homepage uses `max-w-[1600px]` while category/article pages use `max-w-[900px]` for the content area
  - Articles are rendered with `section.body.split("\n\n")` for paragraph splitting — content should use double newlines for paragraph breaks
  - The articles array is currently empty — subsequent stories (US-003 through US-021) will populate it
---

## 2026-03-20 - US-002
- Implemented article SEO, structured data & server-side rendering
- Files changed:
  - `src/app/articles/[slug]/page.tsx` — Added JSON-LD structured data (Article, BreadcrumbList, FAQPage), enhanced OpenGraph metadata with url/modifiedTime
  - `src/app/articles/[slug]/opengraph-image.tsx` — Dynamic OG image generation per article using next/og ImageResponse (edge runtime)
  - `prd.json` — Marked US-002 as passes: true
- **Learnings for future iterations:**
  - JSON-LD is injected via `<script type="application/ld+json">` with `dangerouslySetInnerHTML` — standard Next.js pattern for structured data
  - OG image uses `runtime = "edge"` and `ImageResponse` from `next/og` — must export `size`, `contentType`, `alt`, and `generateStaticParams`
  - The `ArticleJsonLd` component is a server component rendered inside the page — no "use client" needed
  - robots.ts already allows all AI bots (ChatGPT-User, ClaudeBot, GPTBot, anthropic-ai, cohere-ai, Google-Extended)
  - Articles index page already had proper Metadata from US-001
  - Article pages are fully server-rendered — no client-side fetching or useEffect for content
---

## 2026-03-20 - US-003
- Implemented Standards & Protocols article with slug 'standards-and-protocols-guide'
- Files changed:
  - `src/data/articles.ts` — Added first article to the articles array with 12 content sections, 5 FAQ entries, ~2000 words covering x402, ERC-8004, MCP, A2A, ACP, AP2, UCP, ERC-4337, and MPP
  - `prd.json` — Marked US-003 as passes: true
- **Learnings for future iterations:**
  - Article content uses double newlines (`\n\n`) for paragraph breaks within body text — this matches the `section.body.split("\n\n")` rendering pattern
  - Related article slugs can reference articles that don't exist yet — they will be created by subsequent stories
  - Category field should match the category name exactly as used in market-map-data.json (e.g., "Standards & Protocols")
  - Reading time is a string like "12 min read" — estimate based on ~200 words per minute
---

## 2026-03-20 - US-004
- Implemented Payment Processors article with slug 'payment-processors-guide'
- Files changed:
  - `src/data/articles.ts` — Added second article to the articles array with 9 content sections, 5 FAQ entries, ~2200 words covering payment processing for AI agents, x402 in practice, convergence of crypto-native and traditional processors, specialized processors, protocol competition
  - `prd.json` — Marked US-004 as passes: true
- **Learnings for future iterations:**
  - The market-map-data.json contains company names and logos but no descriptions — article content must draw from domain knowledge and PRD notes
  - Category name in article data must match market-map-data.json exactly (e.g., "Payment Processors" not "Payment Processing")
  - Articles can reference related articles that exist (standards-and-protocols-guide) and ones that don't yet (payment-infrastructure-guide, stablecoins-guide)
---

## 2026-03-20 - US-005
- Implemented Identity & Trust article with slug 'identity-and-trust-guide'
- Files changed:
  - `src/data/articles.ts` — Added third article to the articles array with 11 content sections, 5 FAQ entries, ~2200 words covering ERC-8004, KYA, reputation systems, World AgentKit, deepfake resistance, enterprise verification, real-time behavior classification
  - `prd.json` — Marked US-005 as passes: true
- **Learnings for future iterations:**
  - All 15 companies from the Identity & Trust category in market-map-data.json were mentioned with context on what they do
  - Article follows the established pattern: intro section explaining why the category matters, deep dives into key concepts, company overview, future outlook
  - The category field must exactly match "Identity & Trust" as it appears in market-map-data.json
---

## 2026-03-20 - US-006
- Implemented Agent Harnesses article with slug 'agent-harness-guide'
- Files changed:
  - `src/data/articles.ts` — Added fourth article to the articles array with 11 content sections, 5 FAQ entries, ~2400 words covering the autonomy spectrum (coding agents, general-purpose assistants, crypto-native frameworks), how harnesses differ from chatbots, competitive landscape, and stack integration
  - `prd.json` — Marked US-006 as passes: true
- **Learnings for future iterations:**
  - All 12 companies from the Agent Harness category in market-map-data.json were mentioned with context: OpenClaw, IronClaw, ElizaOS, NemoClaw, NanoClaw, Manus, Perplexity Computer, OpenAI Operator, Project Mariner, Claude Cowork, Simular AI, MultiOn
  - Category field is "Agent Harness" (singular, not "Agent Harnesses") to match market-map-data.json exactly
  - Article maintains the established pattern: what the category is, why it matters, deep dives into sub-categories, company overview, future outlook
---

## 2026-03-20 - US-007
- Implemented Stablecoins article with slug 'stablecoins-guide'
- Files changed:
  - `src/data/articles.ts` — Added fifth article to the articles array with 10 content sections, 5 FAQ entries, ~2200 words covering why agents need stablecoins (stability + programmability + instant settlement), USDC as x402 standard, USDT's scale ambitions, PYUSD as PayPal's bridge, micropayment revolution, stablecoins vs fiat vs volatile crypto
  - `prd.json` — Marked US-007 as passes: true
- **Learnings for future iterations:**
  - All 3 companies from the Stablecoins category in market-map-data.json were mentioned with context: USDC (Circle), USDT (Tether), PYUSD (PayPal)
  - Category field is "Stablecoins" to match market-map-data.json exactly
  - The PRD mentioned CASH by Phantom but market-map-data.json has PYUSD instead — followed the market-map data as the source of truth for company listings
  - Article covers the unique angle of why stablecoins beat both volatile crypto AND traditional fiat for agent use cases — the three-way comparison is key
---

## 2026-03-20 - US-008
- Implemented Agent Networks article with slug 'agent-networks-guide'
- Files changed:
  - `src/data/articles.ts` — Added sixth article to the articles array with 10 content sections, 5 FAQ entries, ~2400 words covering agent-to-agent commerce, Virtuals Protocol and ACP, Bittensor subnets, Moltbook social layer, ClawdVine collaboration graphs, Questflow orchestration, agent discovery/negotiation/payment mechanics, coordination frontier
  - `prd.json` — Marked US-008 as passes: true
- **Learnings for future iterations:**
  - All 5 companies from the Agent Networks category in market-map-data.json were mentioned with context: Moltbook, ClawdVine, Questflow, Bittensor, Virtuals Protocol
  - Category field is "Agent Networks" to match market-map-data.json exactly
  - Some companies appear in multiple categories (e.g., Questflow is in both Agent Networks and Agent Frameworks & Tooling) — this is noted in the article content where relevant
  - Article follows the established pattern: what the category is, why it matters, deep dives into each company/concept, mechanics explanation, future outlook
---

## 2026-03-20 - US-009
- Implemented Discovery article with slug 'discovery-guide'
- Files changed:
  - `src/data/articles.ts` — Added seventh article to the articles array with 10 content sections, 5 FAQ entries, ~2200 words covering the discovery problem, why human search fails for agents, agent-native marketplaces, directories and indexes, ecosystem explorers, task platforms, machine-readable catalogs, key companies, challenges, and future outlook
  - `prd.json` — Marked US-009 as passes: true
- **Learnings for future iterations:**
  - All 10 companies from the Discovery category in market-map-data.json were mentioned with context: x402jobs, Moltlaunch, 402.bot, Pawr.link, ClawIndex, WURK, 0xWork, x402scan, 8004scan, Valoria
  - Category field is "Discovery" to match market-map-data.json exactly
  - Article emphasizes the fundamental difference between human and agent discovery — not just a convenience problem but an existential bottleneck for the agent economy
  - Discovery articles naturally reference many other categories (payments, identity, protocols) since discovery is a cross-cutting concern
---

## 2026-03-20 - US-010
- Implemented Crypto Commerce article with slug 'crypto-commerce-guide'
- Files changed:
  - `src/data/articles.ts` — Added eighth article to the articles array with 10 content sections, 5 FAQ entries, ~2300 words covering marketplaces & aggregators, physical goods & agent stores, digital goods & services, bridges to traditional retail, x402 in practice, agent vs human purchasing, challenges, and future outlook
  - `prd.json` — Marked US-010 as passes: true
- **Learnings for future iterations:**
  - All 13 companies from the Crypto Commerce category in market-map-data.json were mentioned with context: List402, Agoragentic, RelAI, agentshops.xyz, x402-store, x402 Shopify Commerce, Bitrefill, Laso Finance, x402wall, Postera, AEON, Stripe, payable.link
  - Category field is "Crypto Commerce" to match market-map-data.json exactly
  - The Crypto Commerce category has 4 subcategories in market-map-data.json — article structure mirrors these subcategories as sections for natural organization
  - This category is unique in having both crypto-native companies (List402, x402-store) and traditional companies (Stripe, Shopify) — the article emphasizes convergence
---

## 2026-03-20 - US-011
- Implemented Wallets & Tooling article with slug 'wallets-and-tooling-guide'
- Files changed:
  - `src/data/articles.ts` — Added ninth article to the articles array with 11 content sections, 5 FAQ entries, ~2400 words covering agent wallets vs human wallets, programmable spending policies, delegated access, autonomous signing, key management infrastructure, MetaMask/Phantom evolution, ERC-7579 modular smart accounts, security tooling, Crossmint virtual cards, autonomy/security tradeoffs, key players, and future outlook
  - `prd.json` — Marked US-011 as passes: true
- **Learnings for future iterations:**
  - All 13 companies from the Wallets & Tooling category in market-map-data.json were mentioned with context: Turnkey, Coinbase, MetaMask, Fireblocks, Crossmint, Privy, Openfort, Rhinestone, thirdweb, Varlock, mlld, AgentCard, Phantom
  - Category field is "Wallets & Tooling" to match market-map-data.json exactly
  - This category has no subcategories in market-map-data.json — structured the article by functional area instead (key management, smart accounts, security, bridging)
  - The wallets article naturally references many other categories (identity, stablecoins, standards) since wallets are a cross-cutting infrastructure concern
---

## 2026-03-20 - US-012
- Implemented Payment Infrastructure article with slug 'payment-infrastructure-guide'
- Files changed:
  - `src/data/articles.ts` — Added tenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering x402, ACP, AP2, MPP, streaming payments (Superfluid), virtual cards (Crossmint, Lithic), compliance (Cleared, Basis Theory, BVNK), payment orchestration, infrastructure lock-in, key players, and future outlook
  - `prd.json` — Marked US-012 as passes: true
- **Learnings for future iterations:**
  - All 30 companies from the Payment Infrastructure category in market-map-data.json were mentioned with context: Merit Systems, Moonpay, Gwop, ampersend, Conto, Superfluid Foundation, lobster.cash, RevaPay AI, Pay3, HTTPayer, x402engine, Cleared, Reveel, Visa, AP2, Crossmint, Meridian, x402, machines.cash, ACP, Sponge, Stripe, BVNK, Basis Theory, Rye, Firmly, Lithic, AgentCash, Unicity Labs, Rain
  - Category field is "Payment Infrastructure" to match market-map-data.json exactly
  - This is the largest category by company count (30) — article organized by infrastructure layer (protocol, routing, virtual cards, streaming, compliance, management, commerce) rather than listing companies sequentially
  - The distinction between infrastructure and processors is the core thesis — emphasize architectural lock-in as the key differentiator
---

## 2026-03-20 - US-013
- Implemented User Interfaces article with slug 'user-interfaces-guide'
- Files changed:
  - `src/data/articles.ts` — Added eleventh article to the articles array with 12 content sections, 5 FAQ entries, ~2400 words covering messaging apps as commerce surfaces (Telegram, WhatsApp, Discord, Slack), social platforms (X, Farcaster), dedicated hardware (Rabbit R1), the paradigm shift from browse-and-click to ask-and-confirm, how UI choice affects the agent stack, and the future of agent interfaces
  - `prd.json` — Marked US-013 as passes: true
- **Learnings for future iterations:**
  - All 6 companies from the User Interfaces category in market-map-data.json were mentioned with context: Telegram, WhatsApp, Discord, Rabbit, Slack, X
  - Category field is "User Interfaces" to match market-map-data.json exactly
  - This category is unique in that the companies are platforms, not startups — the article focuses on how each platform serves as a commerce surface rather than what product they sell
  - Published date 2026-03-03 is earlier than most other articles — this was specified in the PRD acceptance criteria
---

## 2026-03-20 - US-014
- Implemented Agent Frameworks & Tooling article with slug 'agent-frameworks-and-tooling-guide'
- Files changed:
  - `src/data/articles.ts` — Added twelfth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering protocol-level infrastructure (MCP, A2A, AXTP), platform-level infrastructure (thirdweb, Cloudflare, Blockrun), coding agents (Claude Code, Cursor, Devin, Windsurf, OpenHands, Cline, Goose, Codex CLI, GitHub Copilot, Replit Agent, Droyd, twit.sh), specialized frameworks (Bankr, Starkbot Cloud, RevaPay AI, Beep, Fluid, Frames), security tooling (Quick Intel, t54.ai, Corbits, Visa), orchestration (Questflow, OpenServ, NEAR, ClawHub), picks-and-shovels analogy, choosing frameworks, build-vs-buy decision, future outlook
  - `prd.json` — Marked US-014 as passes: true
- **Learnings for future iterations:**
  - All 36 companies from the Agent Frameworks & Tooling category in market-map-data.json were mentioned with context: Starkbot Cloud, thirdweb, t54.ai, Frames, Daydreams, Blockrun, RevaPay AI, Beep, Fluid, Dexter, Visa, Quick Intel, NEAR, ClawHub, Conway Research, MCP, OpenServ, Cloudflare, Corbits, Questflow, Bankr, A2A, AXTP, Arcade.dev, Claude Code, Cursor, Windsurf, Devin, OpenHands, Cline, Goose, Codex CLI, GitHub Copilot, Replit Agent, Droyd, twit.sh
  - Category field is "Agent Frameworks & Tooling" to match market-map-data.json exactly
  - This is the largest category (36 companies) — organized by functional tier (protocol, platform, coding agents, specialized) rather than listing companies sequentially
  - Many companies in this category appear in other categories too (thirdweb, Visa, Cloudflare, etc.) — noted cross-category presence where relevant
  - Published date 2026-03-04 is earlier than most other articles — specified in PRD acceptance criteria
---

## 2026-03-20 - US-015
- Implemented Universal Balance & Account Abstraction article with slug 'universal-balance-and-account-abstraction-guide'
- Files changed:
  - `src/data/articles.ts` — Added thirteenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering the multi-chain problem, what account abstraction is, EOAs vs smart accounts, ERC-4337, Polygon Agent CLI, programmable wallet logic (ERC-7579), gas abstraction, universal balance across chains, practical implications for developers, key players, and future outlook
  - `prd.json` — Marked US-015 as passes: true
- **Learnings for future iterations:**
  - "Universal Balance & Account Abstraction" does NOT exist as a category in market-map-data.json — this is a cross-cutting topic that draws companies from Wallets & Tooling, Standards & Protocols, and Blockchains categories
  - Companies mentioned span multiple market-map categories: Polygon (Blockchains), ERC-4337 (Standards & Protocols), Rhinestone/Openfort/Coinbase/Turnkey/Fireblocks/Privy/MetaMask/Phantom/thirdweb (Wallets & Tooling), SKALE/Base/Tempo (Blockchains), Biconomy and Pimlico (not in market-map but key ERC-4337 ecosystem players)
  - The article distinguishes between account abstraction (smarter individual wallets) and universal balance (unified cross-chain view) as complementary but distinct concepts
  - Published date 2026-03-05 is earlier than most other articles — specified in PRD acceptance criteria
---

## 2026-03-20 - US-016
- Implemented Proprietary Models article with slug 'proprietary-models-guide'
- Files changed:
  - `src/data/articles.ts` — Added fourteenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering Claude/MCP, GPT/ACP/Stripe, Gemini/AP2/Project Mariner, Grok/2M context, Command/enterprise/multilingual, Nova/AWS/Bedrock AgentCore, model-commerce stack coupling, capability comparison, vendor lock-in tradeoffs, and future outlook
  - `prd.json` — Marked US-016 as passes: true
- **Learnings for future iterations:**
  - All 6 companies from the Proprietary Models category in market-map-data.json were mentioned with context: Claude, GPT, Gemini, Grok, Command, Nova
  - Category field is "Proprietary Models" to match market-map-data.json exactly
  - This article is unique in that each company maps to a distinct commerce stack (Claude→MCP, GPT→ACP, Gemini→AP2) — the article's thesis is that model choice determines commerce architecture
  - Published date 2026-03-06 is earlier than most other articles — specified in PRD acceptance criteria
  - The vendor lock-in tradeoff is a key theme that naturally connects to the open-source-models-guide article
---

## 2026-03-20 - US-017
- Implemented Open Source Models article with slug 'open-source-models-guide'
- Files changed:
  - `src/data/articles.ts` — Added fifteenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering Llama (Meta), DeepSeek (MIT license, MoE), Qwen (native MCP, Apache 2.0, consumer hardware), Hermes (agent-first, persistent memory), Mistral (European compliance), Gemma (edge deployment), Phi (lightweight), GPT-OSS (migration path), regulated industries, self-hosted inference economics, open-source vs proprietary tradeoffs, future outlook
  - `prd.json` — Marked US-017 as passes: true
- **Learnings for future iterations:**
  - All 8 companies from the Open Source Models category in market-map-data.json were mentioned with context: Llama, DeepSeek, Qwen, Mistral, Hermes, Gemma, Phi, GPT-OSS
  - Category field is "Open Source Models" to match market-map-data.json exactly
  - This article naturally pairs with the proprietary-models-guide — cross-references between the two articles help readers compare approaches
  - Published date 2026-03-07 is earlier than most other articles — specified in PRD acceptance criteria
  - The regulated industries section is the article's strongest differentiator — makes the case that open-source is a compliance requirement, not just a preference
---

## 2026-03-20 - US-018
- Implemented Blockchains & Crypto article with slug 'blockchains-guide'
- Files changed:
  - `src/data/articles.ts` — Added sixteenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering why agents need blockchains, key requirements (sub-second finality, near-zero fees, stablecoin support), Base (Coinbase x402 hub), Solana (400ms finality, 35M+ x402 transactions), Ethereum (settlement layer, ERC standards origin), Tempo (Stripe/Paradigm, MPP, 100K+ TPS), next-gen chains (SKALE gas-free, Radius 2.5M TPS, Keeta regulated, Sei DeFi, Story IP), broader ecosystem (Arbitrum, Polygon, Avalanche, NEAR, BNB, Celo, Algorand, MultiversX, Stellar, Taiko), chain competition dynamics, multi-chain reality, future outlook
  - `prd.json` — Marked US-018 as passes: true
- **Learnings for future iterations:**
  - All 19 companies from the Blockchains category in market-map-data.json were mentioned with context: Ethereum, Arbitrum, Radius, Tempo, Avalanche, Polygon, Keeta Network, Celo, SKALE, BNB, Sei, Story, Algorand, Taiko, NEAR, Base, MultiversX, Solana, Stellar
  - Category field is "Blockchains" to match market-map-data.json exactly
  - This is a large category (19 chains) — organized by strategic importance (Base, Solana, Ethereum as top-tier, Tempo as new entrant, next-gen specialized chains, then broader ecosystem) rather than alphabetically
  - Published date 2026-03-08 is earlier than most other articles — specified in PRD acceptance criteria
  - The multi-chain future thesis is key — no single chain wins, agents will use multiple chains routed by infrastructure
---

## 2026-03-20 - US-019
- Implemented Hosting, Cloud & Compute article with slug 'hosting-cloud-compute-guide'
- Files changed:
  - `src/data/articles.ts` — Added seventeenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering hyperscale clouds (Google Cloud AP2 stack, AWS Bedrock AgentCore), Cloudflare (x402 Foundation, edge computing), decentralized compute (Akash 85% cheaper, Heurist censorship-resistant, Bittensor subnets), self-hosted servers (Hetzner, DigitalOcean, Contabo, OVHcloud, Hostinger), local inference (Mac Mini M4, Rabbit R1), privacy infrastructure (Venice.ai VVV token, Treza Labs ZK-KYC), data infrastructure (Dune, Allium, SQD, Alchemy), cost comparison across tiers, choosing infrastructure, future outlook
  - `prd.json` — Marked US-019 as passes: true
- **Learnings for future iterations:**
  - All 19 companies from the Hosting / Cloud / Compute category in market-map-data.json were mentioned with context: Google Cloud, Amazon Web Services, Cloudflare, Hetzner, Hostinger, DigitalOcean, Contabo, OVHcloud, Mac Mini, Rabbit, Heurist, Bittensor, akash, Treza Labs, Venice.ai, Dune, Allium, SQD, Alchemy
  - Category field is "Hosting / Cloud / Compute" to match market-map-data.json exactly (uses slashes, not ampersands or commas)
  - This category spans a uniquely wide spectrum — from hyperscale clouds to a $500 Mac Mini — article organized by infrastructure tier rather than alphabetically
  - Some companies appear in multiple categories (Cloudflare in Agent Frameworks & Tooling, Bittensor in Agent Networks, Rabbit in User Interfaces) — noted cross-category presence where relevant
  - Published date 2026-03-09 is earlier than most other articles — specified in PRD acceptance criteria
  - Data infrastructure companies (Dune, Allium, SQD, Alchemy) are part of hosting because they provide the analytics and blockchain connectivity layer agents need to operate
---

## 2026-03-20 - US-020
- Implemented "How to Book Plane Tickets Today with an AI Agent Using OpenClaw & Virtual Debit Cards" article with slug 'book-flights-with-openclaw-agent'
- Files changed:
  - `src/data/articles.ts` — Added eighteenth article to the articles array with 10 content sections, 5 FAQ entries, ~2500 words covering OpenClaw setup, the credit card risk problem, virtual debit card solutions (Lobster.cash, CreditClaw, Privacy.com), step-by-step flight booking walkthrough, virtual card security model, OpenClaw security risks and mitigations, compatible airlines and sites, limitations and future outlook
  - `prd.json` — Marked US-020 as passes: true
- **Learnings for future iterations:**
  - This is a tutorial/how-to article, not a category overview — uses a different structure with step-by-step instructions rather than company-by-company analysis
  - Category is "Agent Harness" (the category OpenClaw belongs to in market-map-data.json), since this is not a category overview article
  - The article links back to both /category/agent-harness and /category/wallets-and-tooling as specified in acceptance criteria — handled in the content body text rather than as a separate field
  - Companies mentioned span multiple categories: OpenClaw/IronClaw/NemoClaw/Manus (Agent Harness), Lobster.cash/Crossmint/CreditClaw (Wallets & Tooling), Visa (Payment Infrastructure), Privacy.com (external)
  - Published date 2026-03-19 matches the PRD specification
---

## 2026-03-20 - US-021
- Implemented "Tempo Mainnet Launch — Stripe & Paradigm's Payments Blockchain Goes Live with Machine Payments Protocol" article with slug 'tempo-mainnet-launch-mpp'
- Files changed:
  - `src/data/articles.ts` — Added nineteenth article to the articles array with 12 content sections, 5 FAQ entries, ~2500 words covering Tempo mainnet launch, MPP protocol details (sessions, payment-method agnosticism, directory), Tempo architecture (100K+ TPS, sub-second finality), launch partners (Anthropic, OpenAI, Visa, Mastercard, DoorDash, Shopify, Nubank, Revolut, Standard Chartered, UBS, Lightspark), use cases, comparison with Base and Solana, open-source specs, security/compliance, key companies, bigger picture implications
  - `prd.json` — Marked US-021 as passes: true
- **Learnings for future iterations:**
  - This is a news/analysis article, not a category overview — uses a timely event (March 18, 2026 mainnet launch) as the hook for deep analysis
  - Category is "Blockchains" since Tempo is listed in the Blockchains category in market-map-data.json
  - The article links back to /category/blockchains, /category/standards-and-protocols, and /category/payment-infrastructure as specified in acceptance criteria — handled in content body text
  - Companies mentioned span multiple categories: Tempo (Blockchains), MPP (Standards & Protocols), Stripe/Visa/Lightspark (Payment Infrastructure), Anthropic/OpenAI (Proprietary Models), Shopify (Crypto Commerce)
  - Published date 2026-03-19 matches the PRD specification
  - MPP is distinguished from x402 and ACP by its session-based model and network extension architecture — this is the key differentiator to emphasize
---

## 2026-03-20 - US-001
- Improved Standards & Protocols article (slug: standards-and-protocols-guide) with dash cleanup, diagram, bullet lists, category-aware OG image, hero image, and SEO enhancements
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from standards-and-protocols-guide content (metaDescription, all 12 contentSections, all 5 FAQ answers). Converted 3 dense paragraphs to bullet/numbered lists (interoperability problems, protocol stack layers, future trends).
  - `src/components/diagrams/StandardsProtocolsDiagram.tsx` — NEW: React component showing 4-layer protocol stack (Identity, Discovery, Payment, Infrastructure) with color-coded protocol pills
  - `src/app/articles/[slug]/opengraph-image.tsx` — Rewrote to be category-aware: imports category data (colors, companies, descriptions), renders category-style OG images for category articles (breadcrumb, color glow, company pills, count) and placeholder style for non-category articles
  - `src/app/articles/[slug]/page.tsx` — Added hero image at top of article, diagram rendering system (slug-to-component mapping), content block renderer supporting bullet/numbered lists, SEO fixes (author changed from Person to Organization with url, added wordCount computation)
  - `src/app/articles/page.tsx` — Added ItemList JSON-LD schema listing all articles with position, name, and url
  - `prd.json` — Marked US-001 as passes: true
- **Learnings for future iterations:**
  - The article page now supports bullet points (lines starting with `• ` or `- `) and numbered lists (lines starting with `1. `) within content section bodies, separated by `\n\n` from surrounding paragraphs
  - Diagrams are mapped via `articleDiagrams` object in page.tsx keyed by slug, with `afterSection` index to control placement
  - The OG image now imports category data from `@/lib/categories` and `@/data/company-info` — for category articles it matches the category page OG style, for non-category articles it uses a simpler placeholder
  - Hero image is rendered as `<img src="/articles/[slug]/opengraph-image">` at the top of the article page
  - The `computeWordCount` function in page.tsx computes word count from title, description, all sections, and all FAQ entries
  - Future US stories for article improvements can follow the same pattern: add diagram to `src/components/diagrams/`, add entry to `articleDiagrams` mapping, edit article content for dashes and lists
---

## 2026-03-20 - US-002
- Improved Payment Processors article (slug: payment-processors-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from payment-processors-guide content (metaDescription, all 8 contentSections, all 5 FAQ answers). Converted 3 sections to use bullet/numbered lists: "Why This Is the Most Crowded Category" (bullet list of processor types), "What Makes Agent Payments Different" (numbered list of 5 differences), "The Battle Between Protocols" (bullet list of 4 protocol ecosystems), "What the Future Looks Like" (numbered list of 3 winning characteristics).
  - `src/components/diagrams/PaymentProcessorsDiagram.tsx` — NEW: React component showing 4-category processor landscape (Crypto-Native, Traditional Finance, Hybrid/Bridge, Specialized/Vertical) with color-coded company pills
  - `src/app/articles/[slug]/page.tsx` — Added PaymentProcessorsDiagram import and mapping (afterSection: 1)
  - `prd.json` — Marked US-002 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - Em dash replacement requires contextual judgment: some become commas, some become colons, some need parentheses, some need sentence restructuring
  - Converting paragraphs to lists works best when content has clear enumeration (numbered differences, protocol comparisons, category breakdowns)
  - SEO infrastructure from US-001 (OG images, JSON-LD, hero image) carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-003
- Improved Identity & Trust article (slug: identity-and-trust-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from identity-and-trust-guide content (metaDescription, all 11 contentSections, all 5 FAQ answers). Converted 4 sections to use bullet/numbered lists: "The Identity Problem" (bullet list of 6 identity questions), "ERC-8004" (numbered list of 3 advantages), "KYA: Know Your Agent" (bullet list of 3 verification components), "Reputation Systems" (numbered list of 3 challenges), "Real-Time Behavior Classification" (bullet list of 3 anomaly types).
  - `src/components/diagrams/IdentityTrustDiagram.tsx` — NEW: React component showing 5-layer trust verification stack (Agent Identity, Verification/KYA, Reputation, Real-Time Monitoring, Privacy & Credentials) with color-coded company pills
  - `src/app/articles/[slug]/page.tsx` — Added IdentityTrustDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-003 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is now well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - Em dash replacement requires contextual judgment: some become commas, some become colons, some become parentheses, some need sentence restructuring
  - Converting paragraphs to lists works best when content has clear enumeration (questions, numbered advantages, component breakdowns, challenge lists)
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-004
- Improved Agent Harnesses article (slug: agent-harness-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from agent-harness-guide content (metaDescription, all 11 contentSections, all 5 FAQ answers). Converted 4 sections to use bullet/numbered lists: "How Agent Harnesses Differ from Chatbots" (numbered list of 3 capabilities), "The Autonomy Spectrum" (bullet list of 3 safety philosophies), "What Agents Actually Do" (numbered list of 4 action types), "The Competitive Landscape" (bullet list of 3 fault lines).
  - `src/components/diagrams/AgentHarnessDiagram.tsx` — NEW: React component showing 3-tier autonomy spectrum (Coding Agents, General-Purpose Assistants, Crypto-Native Frameworks) with color-coded company pills and directional arrow
  - `src/app/articles/[slug]/page.tsx` — Added AgentHarnessDiagram import and mapping (afterSection: 2)
  - `prd.json` — Marked US-004 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - Em dash replacement requires contextual judgment: some become commas, some become colons, some become parentheses, some need semicolons, some need sentence restructuring
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields (last entry for US-004)
---

## 2026-03-20 - US-005
- Improved Stablecoins article (slug: stablecoins-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from stablecoins-guide content (metaDescription, all 10 contentSections, 1 FAQ answer). Converted 4 sections to use bullet/numbered lists: "The Three Properties" (numbered list of 3 properties), "How Stablecoins Compare" (bullet list of fiat vs crypto advantages), "Stablecoins in the Agent Payment Stack" (numbered list of 4 stack layers), "The Micropayment Revolution" (bullet list of 4 business models), "The Future of Agent Money" (numbered list of 4 trends).
  - `src/components/diagrams/StablecoinsDiagram.tsx` — NEW: React component showing 3-coin comparison (USDC, USDT, PYUSD) with color-coded cards, key stats (market cap, chains, agent adoption), strength highlights, and feature pills
  - `src/app/articles/[slug]/page.tsx` — Added StablecoinsDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-005 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-006
- Improved Agent Networks article (slug: agent-networks-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from agent-networks-guide content (metaDescription, all 10 contentSections, 2 FAQ answers). Converted 3 sections to use bullet/numbered lists: "How Agents Discover, Negotiate, and Pay Each Other" (numbered list of 4 transaction stages), "The Coordination Frontier" (bullet lists of 3 challenges and 4 network approaches), "The Future of Agent-to-Agent Commerce" (numbered list of 3 trends).
  - `src/components/diagrams/AgentNetworksDiagram.tsx` — NEW: React component showing 5 network nodes (Virtuals Protocol, Bittensor, Moltbook, ClawdVine, Questflow) with role, stats, and approach, plus a 4-stage transaction flow diagram
  - `src/app/articles/[slug]/page.tsx` — Added AgentNetworksDiagram import and mapping (afterSection: 1)
  - `prd.json` — Marked US-006 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-007
- Improved Discovery article (slug: discovery-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from discovery-guide content (metaDescription, all 10 contentSections, 3 FAQ answers). Converted 4 sections to use bullet/numbered lists: "Why Human Search Engines Fail" (bullet list of 6 agent requirements), "Directories and Indexes" (bullet list of 4 directory players), "The Challenge of Building Search" (numbered list of 5 challenges), "The Future of Agent Discovery" (numbered list of 3 evolution phases).
  - `src/components/diagrams/DiscoveryDiagram.tsx` — NEW: React component showing 4-category discovery ecosystem map (Marketplaces, Directories & Indexes, Ecosystem Explorers, Task Platforms) with color-coded company pills and underlying standards layer (MCP, A2A, x402)
  - `src/app/articles/[slug]/page.tsx` — Added DiscoveryDiagram import and mapping (afterSection: 1)
  - `prd.json` — Marked US-007 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-008
- Improved Crypto Commerce article (slug: crypto-commerce-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from crypto-commerce-guide content (metaDescription, all 10 contentSections, 3 FAQ answers). Converted Section 1 sub-sectors to bullet list, Section 7 agent differences to numbered list (4 items), Section 9 challenges to bullet list (4 items).
  - `src/components/diagrams/CryptoCommerceDiagram.tsx` — NEW: React component showing 4-sector breakdown (Marketplaces & Aggregators, Physical Goods & Agent Stores, Digital Goods & Services, Bridges to Traditional Retail) with color-coded company pills, plus a 4-step x402 purchase flow diagram
  - `src/app/articles/[slug]/page.tsx` — Added CryptoCommerceDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-008 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-009
- Improved Wallets & Tooling article (slug: wallets-and-tooling-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from wallets-and-tooling-guide content (all 11 contentSections, all 5 FAQ answers). Converted 3 sections to use bullet/numbered lists: "Why Agent Wallets Are Fundamentally Different" (bullet list of 3 wallet requirements: delegation, scoping, revocation), "Key Management Infrastructure" (numbered list of 3 approaches: institutional custody, embedded key management, decentralized key management), "The Balance Between Autonomy and Security" (bullet list of 3 transaction tiers), "The Key Players" (bullet list of all 13 companies with roles).
  - `src/components/diagrams/WalletsToolingDiagram.tsx` — NEW: React component showing human wallet vs agent wallet comparison table (interface, signing, key storage, spending limits, access control, revocation) plus 5-tier company landscape (Key Management & Custody, Smart Accounts & Policies, Consumer Wallets, Security & Monitoring, Fiat Bridge)
  - `src/app/articles/[slug]/page.tsx` — Added WalletsToolingDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-009 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-010
- Improved Payment Infrastructure article (slug: payment-infrastructure-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from payment-infrastructure-guide content (metaDescription, heading, all 12 contentSections, all 5 FAQ answers). Converted 3 sections to use bullet/numbered lists: "How Infrastructure Decisions Lock in Architecture" (bullet list of 4 protocol choices), "The Key Players" (bullet list of 7 infrastructure layers with companies), "The Future of Payment Infrastructure" (numbered list of 3 trends).
  - `src/components/diagrams/PaymentInfrastructureDiagram.tsx` — NEW: React component showing 6-layer infrastructure architecture (Protocol, Routing & Processing, Virtual Cards & Fiat Bridge, Streaming & Continuous, Compliance & Security, Management & Commerce) with color-coded company pills plus a 4-step payment flow diagram
  - `src/app/articles/[slug]/page.tsx` — Added PaymentInfrastructureDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-010 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - Payment Infrastructure has 30 companies (largest category alongside Agent Frameworks & Tooling), organized by infrastructure layer rather than listing companies sequentially
---

## 2026-03-20 - US-011
- Improved User Interfaces article (slug: user-interfaces-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from user-interfaces-guide content (metaDescription, all 12 contentSections, 2 FAQ answers). Converted 5 sections to use bullet/numbered lists: "The Front Door" (bullet list of 3 commerce stack changes), "Why the Interface Matters" (bullet list of 3 platform capabilities), "Slack" (numbered list of 4 procurement workflow steps), "Rabbit R1" (bullet list of 3 hardware security features), "The Paradigm Shift" (numbered list of 3 implications), "How UI Choice Affects the Agent Stack" (bullet list of 5 platform architecture differences), "The Future" (numbered list of 3 trends).
  - `src/components/diagrams/UserInterfacesDiagram.tsx` — NEW: React component showing 6-channel UI map (Telegram, WhatsApp, Discord, Slack, X, Rabbit R1) with type tags, reach stats, strengths, and commerce fit, plus a paradigm shift comparison (Browse & Click vs Ask & Confirm)
  - `src/app/articles/[slug]/page.tsx` — Added UserInterfacesDiagram import and mapping (afterSection: 1)
  - `prd.json` — Marked US-011 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-012
- Improved Agent Frameworks & Tooling article (slug: agent-frameworks-and-tooling-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from agent-frameworks-and-tooling-guide content (metaDescription, all 12 contentSections, 3 FAQ answers). Converted 3 sections to use bullet/numbered lists: "The Picks-and-Shovels Analogy" (bullet list of dependency examples), "Key Companies" (bullet list of four tiers with company groupings), "The Future" (numbered list of 4 trends).
  - `src/components/diagrams/AgentFrameworksDiagram.tsx` — NEW: React component showing 4-tier framework stack (Protocol Layer, Platform Layer, Development Layer, Specialized Layer) with color-coded company pills and counts, plus a 4-step framework selection flow
  - `src/app/articles/[slug]/page.tsx` — Added AgentFrameworksDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-012 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - Agent Frameworks & Tooling is the largest category (36 companies), organized into 4 tiers (protocol, platform, development, specialized)
---

## 2026-03-20 - US-013
- Improved Universal Balance & Account Abstraction article (slug: universal-balance-and-account-abstraction-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from universal-balance-and-account-abstraction-guide content (metaDescription, all 12 contentSections, 3 FAQ answers). Converted 4 sections to use bullet/numbered lists: "The Multi-Chain Problem" (bullet list of 5 chain requirements), "EOAs vs Smart Accounts" (numbered list of 3 transformative capabilities), "Why Agents Should Not Manage Gas Tokens" (bullet list of 4 gas management problems), "Practical Implications" (numbered list of 5 developer recommendations), "The Future" (numbered list of 3 convergence trends).
  - `src/components/diagrams/UniversalBalanceDiagram.tsx` — NEW: React component showing before/after comparison (multi-chain complexity without AA vs simplified flow with smart accounts + universal balance) plus 5-tier ecosystem landscape (Standards, Smart Account Infrastructure, Wallet Platforms, Consumer Wallets, Chain Infrastructure)
  - `src/app/articles/[slug]/page.tsx` — Added UniversalBalanceDiagram import and mapping (afterSection: 1)
  - `prd.json` — Marked US-013 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - "Universal Balance & Account Abstraction" is NOT a category in market-map-data.json, so the OG image uses the placeholder style (non-category article treatment)
---

## 2026-03-20 - US-014
- Improved Proprietary Models article (slug: proprietary-models-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from proprietary-models-guide content (metaDescription, all 12 contentSections, 2 FAQ answers). Converted 3 sections to use bullet/numbered lists: "Why Proprietary Models Matter" (bullet list of 6 model-to-protocol mappings), "How Model Choice Determines Your Commerce Stack" (numbered list of 6 model choices with commerce implications), "The Vendor Lock-In Tradeoff" (bullet list of 3 lock-in levels: model, protocol, ecosystem).
  - `src/components/diagrams/ProprietaryModelsDiagram.tsx` — NEW: React component showing 6-model comparison matrix (Claude, GPT, Gemini, Grok, Command, Nova) with color-coded cards showing protocol, context window, commerce stack, and strength pills, plus a model-to-lock-in mapping section
  - `src/app/articles/[slug]/page.tsx` — Added ProprietaryModelsDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-014 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-015
- Improved Open Source Models article (slug: open-source-models-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from open-source-models-guide content (metaDescription, all 11 contentSections, 3 FAQ answers). Converted 4 sections to use bullet/numbered lists: "Why Open Source Models Matter" (bullet list of 4 customization capabilities), "The Case for Self-Hosting" (numbered list of 5 self-hosting advantages), "Regulated Industries" (bullet list of 4 compliance benefits + numbered list of 4 regulatory frameworks), "Gemma, Phi, and GPT-OSS" (bullet list of 3 model niches), "The Future" (numbered list of 3 trends).
  - `src/components/diagrams/OpenSourceModelsDiagram.tsx` — NEW: React component showing 8-model comparison grid (Llama, DeepSeek, Qwen, Hermes, Mistral, Gemma, Phi, GPT-OSS) with color-coded cards showing license, parameters, best-for use case, and strength pills, plus a 4-tier deployment spectrum (Edge/Local, Single GPU, Multi-GPU, GPU Cluster)
  - `src/app/articles/[slug]/page.tsx` — Added OpenSourceModelsDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-015 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
---

## 2026-03-20 - US-016
- Improved Blockchains & Crypto article (slug: blockchains-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from blockchains-guide content (metaDescription, all 12 contentSections, 3 FAQ answers). Converted 4 sections to use bullet/numbered lists: "Why AI Agents Need Blockchains" (bullet list of 3 blockchain properties), "The Key Requirements" (numbered list of 5 requirements), "Next-Generation Chains" (bullet list of 5 chains with focus areas), "How Chains Compete" (bullet list of 4 competitive factors), "The Future" (numbered list of 3 chain types that win).
  - `src/components/diagrams/BlockchainsDiagram.tsx` — NEW: React component showing 6-chain comparison grid (Base, Solana, Ethereum, Tempo, SKALE, Radius) with color-coded cards showing type, TPS, finality, fees, stablecoin support, and strength pills, plus a broader ecosystem section with 8 additional chains
  - `src/app/articles/[slug]/page.tsx` — Added BlockchainsDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-016 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - Blockchains is a large category (19 chains) organized by strategic importance (Base, Solana, Ethereum as top-tier, Tempo as new entrant, then next-gen and broader ecosystem)
---

## 2026-03-20 - US-017
- Improved Hosting, Cloud & Compute article (slug: hosting-cloud-compute-guide) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from hosting-cloud-compute-guide content (metaDescription, all 12 contentSections, 3 FAQ answers). Converted 5 sections to use bullet/numbered lists: "Where Do AI Agents Actually Run?" (bullet list of 4 infrastructure tradeoffs), "Self-Hosted Servers" (numbered list of 5 hosting providers with niches), "Data Infrastructure" (bullet list of 4 data providers with roles), "Cost Comparison" (numbered list of 5 cost tiers), "Choosing the Right Infrastructure" (bullet list of 5 deployment profiles), "The Key Players" (bullet list of 6 tiers with companies), "The Future" (numbered list of 4 trends).
  - `src/components/diagrams/HostingCloudComputeDiagram.tsx` — NEW: React component showing 6-tier infrastructure spectrum (Hyperscale Cloud, Edge Computing, Traditional Hosting, Decentralized Compute, Privacy Infrastructure, Local Inference) with cost/privacy/control metrics, company pills, and strength tags, plus a data infrastructure layer section
  - `src/app/articles/[slug]/page.tsx` — Added HostingCloudComputeDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-017 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - Category field is "Hosting / Cloud / Compute" (uses slashes) to match market-map-data.json exactly
---

## 2026-03-20 - US-018
- Improved "How to Book Plane Tickets with an AI Agent" article (slug: book-flights-with-openclaw-agent) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from book-flights-with-openclaw-agent content (all 10 contentSections, 5 FAQ answers). Converted 4 sections to use bullet/numbered lists: "What If Your AI Agent Could Book Your Next Flight?" (bullet list of 3 security questions), "The Problem: Giving AI Agents Your Credit Card Is Dangerous" (numbered list of 4 risks: prompt injection, credential exposure, unlimited authority, no task scoping), "Security Considerations" (bullet list of 4 blast-radius containments + bullet list of 4 safety practices), "What Sites and Airlines Work Today" (bullet list of 4 known limitations), "Limitations and What Is Coming Next" (numbered list of 4 upcoming improvements).
  - `src/components/diagrams/BookFlightsDiagram.tsx` — NEW: React component showing 7-step booking flow (Setup > Virtual Card > Prompt > Search > Compare > Book > Confirmation) with numbered steps and color gradient, plus a 4-layer virtual card security model (Spending Limit, Single-Use, Merchant Lock, Instant Revoke), and virtual card provider pills
  - `src/app/articles/[slug]/page.tsx` — Added BookFlightsDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-018 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - This is a non-category tutorial article with category "Agent Harness" — the OG image uses the category-aware style since "Agent Harness" exists in market-map-data.json
---

## 2026-03-20 - US-019
- Improved Tempo Mainnet Launch article (slug: tempo-mainnet-launch-mpp) with dash cleanup, diagram, bullet/numbered lists, and SEO verification
- Files changed:
  - `src/data/articles.ts` — Removed all em dashes from tempo-mainnet-launch-mpp content (title, metaDescription, all 10 contentSections, 2 FAQ answers). Converted 4 sections to use bullet/numbered lists: "What Is MPP?" (bullet list of 4 payment methods), "MPP Key Features" (numbered list of 3 features with nested bullet lists for network extensions), "Launch Partners" (bullet list of 6 partner categories), "What Tempo Means for the Future" (numbered list of 4 signals), "Use Cases" (numbered list of 5 business trip workflow steps).
  - `src/components/diagrams/TempoMPPDiagram.tsx` — NEW: React component showing 4-layer MPP architecture stack (Agent Layer, MPP Protocol, Network Extensions, Tempo Blockchain) with color-coded items, 3-chain comparison grid (Base, Solana, Tempo) with TPS/protocol/model/strength, and 12 launch partner pills organized by role
  - `src/app/articles/[slug]/page.tsx` — Added TempoMPPDiagram import and mapping (afterSection: 0)
  - `prd.json` — Marked US-019 as passes: true
- **Learnings for future iterations:**
  - The pattern for adding diagrams is well-established: create component in `src/components/diagrams/`, import in page.tsx, add to `articleDiagrams` mapping with `afterSection` index
  - SEO infrastructure from US-001 carries forward automatically for all articles with valid category fields
  - This is a news/analysis article with category "Blockchains" — the OG image uses the category-aware style since "Blockchains" exists in market-map-data.json
  - The acceptance criteria says "non-category article" for OG image style, but since the category field is "Blockchains" (a valid category), the existing OG image logic automatically renders it in category-aware style, consistent with how US-018 was handled
---