agentleFS

CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Worked for most · soon
matteotittaCLAUDE.md

claude-code-marketing-quickstart

matteotitta/claude-code-marketing-quickstart/CLAUDE.md

This is a marketing workspace for one company. Read this file first.

7022d agoReviewMountCreate a free account to mount
matteotittaCLAUDE.md

claude-code-marketing-quickstart / context

matteotitta/claude-code-marketing-quickstart/context/CLAUDE.md

Every skill reads these folders before it writes anything. Fill them in this order: ICP, competitors, voice, positioning, messaging. Win-loss, founder POV, brand kit, funnel and goals are in the paid context plugin ($19.99, link in the README), when you want them. Keep one current file per topic (for example positioning.md) and date the research behind it (1026-competitor-acme.md). See ../example/pulse-analytics/context for a filled-in version.

7022d agoReviewMountCreate a free account to mount
matteotittaCLAUDE.md

repo-structure-agency

matteotitta/repo-structure-agency/CLAUDE.md

This is an agency or consultant workspace: your own business in my-agency/, each client in clients/. Read this file first. Every task belongs to one folder. If the user hasn't said which client, ask before you read or write anything. Never mix one client's context into another's work. For your own marketing, use my-agency/ the same way. Copy clients/_template/ to clients/active/<client-name>/, then run /company-context on their website.

129d agoReviewMountCreate a free account to mount
matteotittaCLAUDE.md

repo-structure-agency / my-agency

matteotitta/repo-structure-agency/my-agency/CLAUDE.md

Your own business: your positioning, offers, voice and the content you publish. Rename the folder to your agency's name.

129d agoReviewMountCreate a free account to mount
matteotittaCLAUDE.md

repo-structure-agency / workflows

matteotitta/repo-structure-agency/workflows/CLAUDE.md

Recipes that chain several skills, one file each. Example: new-competitor.md runs /competitor-research, then refreshes positioning and the battlecard.

129d agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About CLAUDE.md

What is CLAUDE.md?

A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.

Where does it go?

At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.

What should it contain?

Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.

CLAUDE.md or AGENTS.md?

Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.