claude-best-practices

A living knowledge base of best practices for working with Claude, Claude Code, skills, MCP tools, and agentic workflows that I PERSONALLY collected from practitioners, researchers and the community.

---

This repo is a personal knowledge base I've been building while learning Claude Code and agentic workflows. Everything here comes from real practitioners sharing what actually works.... Twitter threads, blog posts, Anthropic's official guides and my own experience.

It's not a tutorial. It's a decision guide organized so you can find the right practice for the situation you're in right now.

I'm keeping this updated as I learn more. If you've found something that works, contributions are welcome.

---

Start with [`00-index.md`](./00-index.md) it maps every common situation to the right file and section. Don't read everything at once. Find your situation, go to the relevant file.

With Claude Code: point Claude at this repo before starting work: > "Read my knowledge base at github.com/[your-username]/claude-best-practices and use it to inform how we work together."

With claude.ai Projects: upload the .md files to your Project Knowledge so Claude can reference them in chat.

---

| File | What's Inside | |------|--------------| | `00-index.md` | Decision guide. Start here | | `claude-md-best-practices.md` | CLAUDE.md line limits, lazy loading, rewrite cadence | | `agentic-workflow-best-practices.md` | Planning, parallel agents, bug handling, multi-agent structure | | `skills-best-practices.md` | Skill authoring, skill-creator, self-improving skills | | `anthropic-skills-guide.md` | Anthropic's official 33-page guide distilled | | `project-docs-structure.md` | /documents/ folder, onb