agentleFS
Sign inSign up

CLAUDE.md examples from real projects

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

Most stars first · from page 5Worked for most · soon
alirezarezvaniCLAUDE.md

claude-skills / agents

alirezarezvani/claude-skills/agents/CLAUDE.md

This guide provides comprehensive instructions for creating *cs- prefixed agents** that seamlessly integrate with the 346 production skills in this repository (count derived via scripts/derive_counters.py). *cs- agents** are specialized Claude Code agents that orchestrate the repository's 346 skills. Each agent: - References skills via relative paths (../marketing-skill/) - Executes Python automation tools from skill packages - Follows established workflows and templates - Maintains skill portability and independence Key Principle: Agents ORCHESTRATE skills, they don't replace them. Skills remain self-contained and…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / business-growth

alirezarezvani/claude-skills/business-growth/CLAUDE.md

This guide covers the 5 production-ready business and growth skills and their Python automation tools. Available Skills: 1. customer-success-manager/ - Customer health scoring, churn risk analysis, expansion opportunities (3 Python tools) 2. sales-engineer/ - Technical discovery, RFP analysis, competitive positioning, POC planning (3 Python tools) 3. revenue-operations/ - Pipeline analysis, forecast accuracy, GTM efficiency metrics (3 Python tools) Total Tools: 9 Python automation tools, 9 knowledge bases, 19+ templates Purpose: Multi-dimensional customer health scoring with trend analysis Features: - Weighted…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / business-operations

alirezarezvani/claude-skills/business-operations/CLAUDE.md

This file provides domain-specific guidance for skills in business-operations/. The Business Operations domain ships skills that help internal operators (BizOps lead, COO direct reports, vendor management office, IT ops) run the company day-to-day. This is not strategy (that's c-level-advisor/) and not external sales (that's business-growth/). Path-B 11-file contract per skill (Matt Pocock-derived discipline preserved):

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / c-level-advisor

alirezarezvani/claude-skills/c-level-advisor/CLAUDE.md

A complete virtual board of directors: 28 skills covering 10 executive roles, orchestration, cross-cutting capabilities, and culture & collaboration frameworks — plus the new c-level-agents plugin layer that surfaces 8 cs-* persona agents and 17 /cs:* slash commands on top of the skills.

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / commercial

alirezarezvani/claude-skills/commercial/CLAUDE.md

This file provides domain-specific guidance for skills in commercial/. The Commercial domain ships skills that help deal-desk operators, pricing teams, partner managers, RFP responders, and commercial forecasters make per-deal and packaging decisions. This is not strategy (c-level-advisor/cro-advisor), not sales execution (business-growth/sales-engineer), and not financial close (finance/financial-analysis). Path-B 11-file contract per skill. SKILL.md includes a "Forcing-question library" section that grills the user with cited canon (Skok, Tunguz, Bessemer, Ramanujam, ProfitWell, Winning by Design, Shipley, APMP).

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / engineering-team

alirezarezvani/claude-skills/engineering-team/CLAUDE.md

This guide covers the 32 production-ready engineering skills and their Python automation tools. Core Engineering (16 skills): - senior-architect, senior-frontend, senior-backend, senior-fullstack - senior-qa, senior-devops, senior-secops - code-reviewer, senior-security - aws-solution-architect, ms365-tenant-manager, google-workspace-cli, tdd-guide, tech-stack-evaluator, epic-design - a11y-audit — WCAG 2.2 accessibility audit and fix (a11yscanner.py, contrastchecker.py) - azure-cloud-architect — Azure infrastructure design, ARM/Bicep templates, landing zones - gcp-cloud-architect — GCP infrastructure design, Terraform modules, cloud-native patterns - security-pen-testing — Penetration testing methodology, vulnerability assessment, exploit analysis - snowflake-development —…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / finance

alirezarezvani/claude-skills/finance/CLAUDE.md

This guide covers the 3 production-ready finance skills and their Python automation tools. Available Skills: 1. financial-analyst/ - Financial statement analysis, ratio analysis, DCF valuation, budgeting, forecasting (4 Python tools) 2. saas-metrics-coach/ - SaaS financial health: ARR, MRR, churn, CAC, LTV, NRR, Quick Ratio, 12-month projections (3 Python tools) 3. business-investment-advisor/ - Investment thesis evaluation, ROI modeling, capital allocation guidance Total Tools: 7 Python automation tools, 5 knowledge bases, 6 templates Commands: 2 (/financial-health, /saas-health) Purpose: Calculate and interpret financial…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / markdown-html

alirezarezvani/claude-skills/markdown-html/CLAUDE.md

This file provides domain-specific guidance for skills in markdown-html/. The markdown-html domain converts long markdown files (the actual artifacts produced inside a Claude project — specs, reports, RFCs, PR writeups, slide outlines) into world-class, single-file, lightly-interactive HTML. Inspired by Thariq Shihipar's argument (Medium, 2026): markdown collapses past ~100 lines because it lacks visual machinery for density and lateral navigation; HTML restores both. It is not an interactive prompt-tuning playground (/playground plugin owns that lane), not a landing-page generator (marketing/landing/), not…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / marketing-skill

alirezarezvani/claude-skills/marketing-skill/CLAUDE.md

This directory contains 44 marketing skills organized into 8 specialist pods (Content, SEO + AEO, CRO, Channels, Growth, Intelligence, Sales enablement, Marketing ops). 59 scripts, all stdlib-only. Run directly: No pip install needed. Scripts include embedded samples for demo mode (run with no args). ❌ Don't read all 44 SKILL.md files ❌ Don't skip .claude/product-marketing-context.md if it exists ❌ Don't use content-creator (deprecated → use content-production) ❌ Don't install pip packages for Python tools

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / product-team

alirezarezvani/claude-skills/product-team/CLAUDE.md

This guide covers the 17 production-ready product management skills (13 bundled incl. the orchestrator + 4 standalone plugins) and their Python automation tools. skills/product-skills/ is the domain's context: fork orchestrator and agent harness adapter: Commands: /cs:product (router) · /cs:grill-product (canon-cited grilling) · /cs:product-loop (the discovery loop). Agent: cs-product-orchestrator. Build-scale goals compile through engineering/agent-harness with the product-team.json manifest. Hard rules: no roadmap cites a tree that fails the linter; single-participant claims are anecdotes; AI features ship with eval specs (see skills/product-skills/references/aiproductevals.md).

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / project-management

alirezarezvani/claude-skills/project-management/CLAUDE.md

This guide covers the 9 production-ready project management skills, 15 Python automation tools, and bundled Atlassian Remote MCP integration (.mcp.json ships with the plugin — OAuth handled by Claude Code, no env vars required). Available Skills: 1. pm-skills/ - Domain orchestrator (context: fork) + agentic delivery loop (3 scripts: goal router, Jira snapshot bridge, delivery loop gate) 2. senior-pm/ - Portfolio health, risk analysis, resource planning (3 scripts) 3. scrum-master/ - Sprint health, velocity forecasting, retrospectives (3 scripts) 4. jira-expert/…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / ra-qm-team

alirezarezvani/claude-skills/ra-qm-team/CLAUDE.md

This guide covers the 14 production-ready RA/QM compliance skills for HealthTech/MedTech companies. Strategic Leadership (2 skills): - regulatory-affairs-head - RA strategy, regulatory intelligence, authority relations - quality-manager-qmr - QMS oversight, management review, quality culture Quality Systems (3 skills): - quality-manager-qms-iso13485 - ISO 13485 compliance, process management - capa-officer - CAPA system management, root cause analysis - quality-documentation-manager - DHF, DMR, DHR management Risk & Security (2 skills): - risk-management-specialist - ISO 14971 compliance, risk analysis - information-security-manager-iso27001 - ISO 27001,…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / research-ops

alirezarezvani/claude-skills/research-ops/CLAUDE.md

This file provides domain-specific guidance for skills in research-ops/. The Research Operations domain ships skills that help R&D leads, clinical study teams, R&D finance/controllers, market-research analysts, and product-research / ResearchOps teams plan, fund, scope, and synthesize research across enterprise workstreams. This is the enterprise / cross-functional counterpart to the academic research/ domain (litreview, grants, patent, syllabus, pulse, dossier, notebooklm). It is not regulatory submission (ra-qm-team), not corporate financial close/valuation (finance/financial-analysis), not funding discovery (research/grants), not persona/journey/live-experiment design (product-team), and not…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / standards

alirezarezvani/claude-skills/standards/CLAUDE.md

This guide explains how to use the standards library for consistent quality across all skills and agents. Location: standards/ Available Standards: 1. communication/ - Communication principles and response protocols 2. quality/ - Code quality, testing, and validation standards 3. git/ - Git workflow, conventional commits, branching strategy 4. documentation/ - Markdown quality, structure consistency, living docs 5. security/ - Secret detection, dependency security, input validation Reference when: - Writing agent documentation - Creating SKILL.md files - Drafting user-facing content -…

25k5mo agoDiscuss
alirezarezvaniCLAUDE.md

claude-skills / templates

alirezarezvani/claude-skills/templates/CLAUDE.md

This guide explains the template system for agents, commands, and standardized workflows. Location: templates/ Purpose: Reusable templates for consistent agent development, slash command creation, and workflow automation across all domains. Location: templates/agent-template.md Usage: Starting point for creating new cs-* agents Contains: - YAML frontmatter structure - Required markdown sections - Workflow documentation format - Integration examples pattern When to Use: Creating any new agent in agents/ directory Not yet created. There is no command template or workflow template file in…

25k5mo agoDiscuss
VoltAgentCLAUDE.md

awesome-claude-code-subagents

VoltAgent/awesome-claude-code-subagents/CLAUDE.md

This is a curated collection of Claude Code subagent definitions - specialized AI assistants for specific development tasks. Subagents are markdown files with YAML frontmatter that Claude Code can load and use. Each subagent follows this template: When adding a new agent, update these files: Format for main README: - agent-name - Brief description Project subagents take precedence over global ones with the same name.

25k7mo agoDiscuss
nocobaseCLAUDE.md

nocobase

nocobase/nocobase/CLAUDE.md

This file is a bridge — treat AGENTS.md as the source of truth. When asked to read, update, or add rules to CLAUDE.md, read from and write to AGENTS.md instead.

24k2y agoDiscuss
mksgluCLAUDE.md

context-mode

mksglu/context-mode/CLAUDE.md

context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context. Analyze/count/filter/compare/search/parse/transform data: write code via ctxexecute(language, code), console.log() only the answer. Do…

24k4mo agoDiscuss
SuperClaude-OrgCLAUDE.md

SuperClaude_Framework

SuperClaude-Org/SuperClaude_Framework/CLAUDE.md

CRITICAL: This project uses UV for all Python operations. Never use python -m, pip install, or python script.py directly. Current v4.3.0 Architecture: Python package with 30 commands, 20 agents, 7 modes SuperClaude integrates with Claude Code through these mechanisms: - Slash Commands: 30 commands installed to ~/.claude/commands/sc/ (e.g., /sc:pm, /sc:research) - Agents: 20 agents installed to ~/.claude/agents/ (e.g., @pm-agent, @system-architect) - Skills: Installed to ~/.claude/skills/ (e.g., confidence-check) - Hooks: Session lifecycle hooks in src/superclaude/hooks/ - Settings: Project settings in .claude/settings.json…

24k11mo agoDiscuss
coleam00CLAUDE.md

Archon

coleam00/Archon/CLAUDE.md

Agent rules: read @AGENTS.md

24k2mo agoDiscuss
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.