$ recombobulate _
home / tips / use-planmd-files-for-writing-tasks-not-just-code
0

Use plan.md Files for Writing Tasks, Not Just Code

bagwaa @bagwaa · Mar 26, 2026 · Workflows
use-planmd-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.

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Scan Pending Changes for Security Issues with /security-review

The /security-review command scans your uncommitted changes for injection vectors, auth gaps, hardcoded secrets, and other common vulnerabilities.

bagwaa @bagwaa · 1 hour ago
0
Run Setup Scripts on Every Session with the SessionStart Hook

The SessionStart hook fires when any session begins or resumes, making it ideal for loading environment variables and running one-time setup scripts.

bagwaa @bagwaa · 1 hour ago
0
Write Property-Based Tests with fast-check and Claude

Ask Claude to write property-based tests for your functions using fast-check — it identifies the mathematical invariants in your code and generates tests that cover inputs you'd never enumerate by hand.

bagwaa @bagwaa · 2 hours ago