The Startup Ideas Podcast

The best businesses are built at the intersection of emerging technology, community, and real human needs.

Back to Playbooks

Build and maintain an effective team knowledge base using CloudMD

Development teams using Claude Code

Ongoing daily practice

What Success Looks Like

Claude consistently avoids known mistakes and follows team conventions without repeated instruction

Steps to Execute

Create CloudMD file in your repository root

Add initial team conventions and common mistakes to avoid

Check CloudMD into version control for team sharing

Install Claude GitHub action for automated updates

During code reviews, tag @claude to update CloudMD when issues repeat

Make updating CloudMD part of standard code review process

Checklist

CloudMD file exists and is checked into git

All team members can edit and contribute

GitHub action installed and configured

Process established for adding new learnings

File is actively maintained and growing

Inputs Needed

Git repository with team access
Claude Code GitHub action
Team agreement on maintenance process

Outputs

Continuously improving AI code quality
Reduced repetitive code review comments
Institutional knowledge preservation

Example

“A team notices Claude repeatedly making the same API error handling mistake. They tag @claude in the PR to add this pattern to CloudMD, ensuring future code generation follows their preferred error handling approach”