Skip to main content

One post tagged with "Collaboration"

Posts about working effectively with others

View All Tags

The Simple Question That Fixed My Prompts

I was getting bored writing the CLAUDE.md file for my Ruby project. The usual drill: "Use RSpec for testing. Use Rubocop for linting." You know the type: bullet points that technically cover the basics but somehow miss the mark.

So I handed it off to Claude with a simple request: "Can you document conventions and commonly agreed-on best practices for this Rails project?"

What came back surprised me. Claude didn't just reformat my scattered notes; it completely restructured them. My lazy bullet points became a comprehensive guide with clear sections, context, and actionable details. The output felt more... intentional. Like it was designed to actually help someone succeed, not just check a documentation box.

But then, I realized Claude had essentially shown me how to write for its own "neurons."

That moment got me thinking. If Claude could improve my documentation, could it improve my prompts?