Use plan.md Files for Writing Tasks, Not Just Code
Most people use plan.md files to outline code tasks. But Claude Code has access to your full project context, which makes it genuinely useful for any writing that benefits from knowing how your system actually works.
The next time you have a meeting transcript, a rough idea, or a set of notes, try dropping them into Claude Code and asking it to turn them into a structured document.
# Paste a meeting transcript into a file and ask Claude:
# "Based on this transcript and our current codebase, write a product
# proposal with goals, user stories, and a technical approach that
# references the real files it will touch"
# Or for a competitive analysis:
# "Write a competitive analysis for adding offline support. Reference our
# current sync architecture in src/sync and explain the trade-offs."
Because Claude has read your code, the docs it produces are grounded in reality. It references actual file paths, real data models, and the conventions you have established — not generic placeholder content.
This works especially well for:
- Turning rough meeting notes into a structured proposal
- Writing architecture decision records that reference real code
- Creating onboarding docs that accurately describe your actual codebase
- Drafting specs where the technical approach needs to reflect existing patterns
Claude Code already knows your project better than most new hires. Put that knowledge to use outside the code editor too.
A plan.md written with full codebase context is worth ten generic templates.
Log in to leave a comment.
Set up Claude Code as an automated reviewer in your CI pipeline — on every pull request, it reads the diff, checks for bugs, security issues, missing tests, and convention violations, then posts its findings as a PR comment. Your human reviewers get a head start because the obvious issues are already flagged before they look.
Before deploying, tell Claude to read your project — migrations, environment variables, queue workers, scheduled tasks, caching, third-party integrations — and generate a deployment checklist that's specific to your app. Not a generic "did you run migrations?" list, but one that knows YOUR infrastructure and catches the things YOUR deploy can break.
Instead of writing a README from memory or copying a template, tell Claude to read your project and generate one that's actually accurate — real setup instructions from your config, real architecture from your directory structure, real API examples from your routes, and real prerequisites from your dependency files.