Claude Md Writer

CLAUDE.md Writer

Creates and refactors CLAUDE.md files following official Anthropic best practices (2025).

Golden Rules

| Rule | Why | |------|-----| | **CLAUDE.md 300, must split

1. Find task-specific content — SQL, debugging, deploy → extract
2. Create .claude/rules/:

• database.md - queries, schema, connection
• deploy.md - deployment process
• messaging.md - integrations (Telegram, etc.)

1. Use @file references — don't duplicate
2. Keep in CLAUDE.md — only what applies to EVERY task

What Goes Where

| Content | Location | |---------|----------| | Project description | CLAUDE.md | | Critical constraints | CLAUDE.md (top!) | | Quick start (3 commands) | CLAUDE.md | | Architecture overview | CLAUDE.md | | Key patterns (1-liners) | CLAUDE.md | | SQL queries/schema | .claude/rules/database.md | | Deployment steps | .claude/rules/deploy.md | | API documentation | .claude/rules/api.md | | Git workflow | .claude/rules/git.md | | Personal preferences | CLAUDE.local.md (gitignored) | | Code style rules | .eslintrc / biome.json (NOT docs) |

Import Syntax

Reference files instead of duplicating:

@README.md
@docs/architecture.md
@~/.claude/snippets/common.md

• Relative: @docs/file.md
• Absolute: @~/path/file.md
• Max depth: 5 hops

CLAUDE.local.md

Personal project settings (auto-gitignored):

# My Local Settings

- Prefer verbose output
- Run tests after every change
- My worktree location: .trees/

Common Mistakes

| Mistake | Fix | |---------|-----| | 500+ lines | Split into .claude/rules/ | | SQL examples inline | → rules/database.md | | "Run prettier" rules | Use tool config files | | Full API docs | → rules/api.md | | Deployment instructions | → rules/deploy.md | | Code in CLAUDE.md | Use @file:line references | | Negative rules only | Add alternatives: "Don't X; use Y instead" |

Quality Checklist

Before finishing:

• [ ] CLAUDE.md < 200 lines?
• [ ] Each rules file < 500 lines?
• [ ] Critical rules at top?
• [ ] No task-specific content in main file?
• [ ] No code style rules (use ESLint/Prettier)?
• [ ] .claude/rules/ for domain-specific docs?
• [ ] Subdirectories for components (frontend/, backend/)?
• [ ] paths: frontmatter for conditional loading?
• [ ] @ references instead of duplication?
• [ ] CLAUDE.local.md for personal prefs?

Useful Commands

| Command | Purpose | |---------|---------| | /init | Generate initial CLAUDE.md | | /memory | View loaded memory files |

Sources

Official:

• code.claude.com/docs/en/memory (Memory management, paths, globs)
• anthropic.com/engineering/claude-code-best-practices
• claude.com/blog/using-claude-md-files

Community:

• thedocumentation.org/claude-code-development-kit (3-Tier System)
• claudefa.st/blog/guide/mechanics/rules-directory
• humanlayer.dev/blog/writing-a-good-claude-md

Updated: Jan 2026

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: serejaris
• Source: serejaris/personal-corp-skills
• License: MIT
• Homepage: https://github.com/serejaris/personal-corp-skills

Install and usage instructions live in the source repository linked above.