blog AGENTS.md

AGENTS.md — axelfreeman/blog

Instructions for AI agents (Claude Code, Codex, Hermes, etc.) working with this repository.

---

What This Repo Is

This is the blog articles repository for axelfreeman.com — Axel Freeman's personal site about AI agents, AEO, automation, and marketing. Every article is real experience, not recycled content. No fluff.

• Default branch: master
• License: MIT (see LICENSE)
• Owner: @axelfreeman

---

Article Structure

Articles are plain Markdown (.md). Each follows this structure:

# Article Title<br><span style="...">Optional Subtitle</span>

Category  ·  Subcategory

    Article Title Repeated
(Optional Subtitle)

    Axel Freeman  ·  DATE  ·  X min read

        **Bold summary paragraph.** The key takeaway, 2-4 sentences.

    ## Section Heading

    Content paragraphs...

        ### Callout Box Title
        Callout content with key insight or actionable advice.

Key Conventions

1. Title line — uses <br> for line breaks, for styled subtitles
2. Category line — Category · Subcategory (e.g., AI Marketing · Opinion, AI Marketing · Content)
3. Author line — Axel Freeman · DATE · X min read (indented with 4 spaces)
4. Summary paragraph — bold, 2-4 sentences, indented with 8 spaces, captures the article's core argument
5. Section headings — ## Heading (H2), no H1 after the title
6. Callout boxes — ### Emoji Callout Title followed by content, indented
7. Paragraphs — indented with 4 spaces
8. Emphasis — bold for key phrases, sparing inline code for terms

---

Bilingual Convention

• English articles: <slug>-en.md (e.g., claude-vs-hermes-marketing-en.md)
• Russian articles: <slug>.md (e.g., claude-vs-hermes-marketing.md)

When creating a new article, always produce both versions. English is the primary public-facing version; Russian serves the RU-speaking audience on axelfreeman.ru.

---

Article Naming