Add ai-agents/claude.md for intro standardization

[kbatuigas]

Description

Create specific Claude Code guidance/memory for ADP doc intros: adds module-specific guidance for writing outcome-focused, executive-friendly introductions across all ai-agents pages. Covers 9 topic types (concepts, how-to, overview, tutorial, etc.) with length targets, examples, and anti-patterns.

Example of first rewrite for observability/transcripts section: 4708a4e

Why claude.md in this directory vs alternatives:

• Context-specific: ai-agents requires outcome-focused intros that don't apply to other modules (operations,
  deployment)
• Just-in-time: Auto-loads when working here—no commands to remember
• Discoverable: Team can read, edit, and PR improvements. Non-Claude-Code users benefit too
• Simple: Plain markdown, version-controlled with content, references actual files in this module

Relationship to docs-team-standards plugin:

• Plugin provides org-wide standards (templates, Antora conventions, general writing style)
• claude.md provides ai-agents-specific requirement (outcome-focused intros)
• Complementary layers, explicitly scoped to prevent duplication

For more info on CLAUDE.md, see official docs https://code.claude.com/docs/en/memory

Resolves https://github.com/redpanda-data/documentation-private/issues/
Review deadline:

Page previews

Checks

• New feature
• Content gap
• Support Follow-up
• Small fix (typos, links, copyedits, etc)

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch ai-agents-claude-md

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[netlify]

✅ Deploy Preview for rp-cloud ready!

Name	Link
🔨 Latest commit	40f8b3b
🔍 Latest deploy log	https://app.netlify.com/projects/rp-cloud/deploys/6993cf50fd68b900089f51e3
😎 Deploy Preview	https://deploy-preview-503--rp-cloud.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[micheleRP]

@kbatuigas let's talk about this. Some of this claude.md could be incorporated into the docs-team-standards plugin because it could apply to other module/repos too; e.g., word count targets, intro structure. I'm not sure what is specific to the AI Agents module.

[Feediver1]

What is the status of this PR @kbatuigas? Please provide and update. Thx

[kbatuigas]

Status: after earlier discussions with team, we've decided that the intro patterns should be applicable and usable across RP docs, not just ADP. I updated the proposed skill and resource in https://github.com/redpanda-data/docs-team-standards/pull/2844 and we may not need this PR when 2844 is merged.

[kbatuigas]

With https://github.com/redpanda-data/docs-team-standards/pull/2844 merged we can close this.