Writing Best Practices

Create structured, maintainable best practices documentation that scales from quick reference to detailed guides.

Core Principle

Separate quick reference from comprehensive documentation.

When to Use

• Creating technical best practices guides
• Organizing reference documentation for teams or agents
• Building structured knowledge bases
• Documenting proven patterns and approaches

Don't use for:

• One-time documentation (use simple README)
• Project-specific notes (use CLAUDE.md)
• Narrative blog posts or tutorials