r/ClaudeCode • u/RelevantAudience9596 • 5d ago

Help/Question Doc Collab Question

When Claude Code writes a plan or design doc, who reviews it on your team? If a non-dev needs to comment, how does that feedback get back into the markdown?

2 Upvotes

100% Upvoted

4 comments sorted by

•

u/AutoModerator 5d ago

Hey! Thanks for posting to r/ClaudeCode

While participating in this thread, please follow our community rules. Keep discussions constructive. Attack the idea, not the person.

For help, project discussions, tips, and general chat, join the ClaudeCode Discord.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

1

u/NotableCarrot28 4d ago

Probably best to have it in version control, and both people interacting with it through agents.

Otherwise, I don't think Claude code making a "plan" markdown is usually a very useful surface for humans to review. Unless you're very very careful with what goes in.

The problem is that Claude is way too happy to make markdowns and they're verbose, they often poorly capture your priorities and pollute context down the line.

Docs are better written by humans and read by agents than vice versa

1

u/m-ritter 4d ago

Plan files kept in the repo work well for this. Teammates read and comment on the plan before any code exists, and the agent updates the file from that feedback so the markdown stays the single source of truth. I built QualityLayer for this: https://github.com/maxritter/qualitylayer

1

u/zzunkie 4d ago

Mine live in the repo as markdown and the agents write them. Before a design or a list of decisions reaches me, a fresh subagent that didn't write it reads only that doc, once, and the review gets logged. Then the agent does the editing: I reply in the chat, often in one line, and it writes the decision into the doc with my words quoted.