PROTOFLOW/Docs

Collaboration

Comments & Reviews

ProtoFlow includes a full commenting and review system for team collaboration. Add comments directly on your schematic, create threaded discussions, and use AI-powered reviews to catch design issues automatically.

# Adding Comments

Place comments directly on your schematic to annotate specific components, connections, or areas of your design.

How to Add a Comment

  1. Right-click on the canvas or a component to open the context menu
  2. Select Add Comment
  3. Type your comment in the text field
  4. Press Enter or click Submit to post the comment
  5. A comment marker icon appears at the location on the canvas

Comment Markers

Comments are shown as small markers on the canvas. Hover over a marker to preview the comment, or click it to open the full thread. The comment sidebar provides a list view of all comments.

[ Screenshot ]

Comment markers on a schematic with one expanded showing the comment text

# Comment Threads

Comments support threaded replies for discussions. Team members can respond to comments, creating a conversation history for each annotation.

Thread Features

  • Threaded replies — Reply to any comment to create a discussion thread
  • Timestamps — Each comment and reply shows when it was posted
  • Author identification — Comments show the name of the person who posted them
  • Persistent storage — Comments are saved with the schematic file and preserved across sessions
[ Screenshot ]

Comment sidebar showing a threaded discussion with timestamps and author names

# AI-Powered Design Reviews

Use the AI Copilot to automatically review your schematic and generate comments highlighting potential issues, improvements, and best practice violations.

How AI Reviews Work

  1. Open the AI Copilot panel and select Agent Mode
  2. Ask the AI to review your schematic (e.g., "Review this schematic and add comments for any issues")
  3. The AI analyzes the schematic structure, connectivity, component values, and best practices
  4. Comments are automatically placed on the schematic at relevant locations
  5. Review the AI's comments and resolve them as you address each issue

What the AI Checks

  • Missing bypass capacitors — Checks if ICs have proper decoupling caps
  • Pull-up/pull-down resistors — Verifies that inputs have proper biasing
  • Component value recommendations — Suggests optimal values based on the circuit topology
  • Pin conflicts — Detects multiple outputs driving the same net
  • Power integrity — Checks for proper power distribution and grounding
  • Design pattern recognition — Identifies common circuit patterns and suggests improvements

Pro Tip

Use AI reviews at key checkpoints in your design process — after placing all components, after wiring, and before exporting to KiCad. This catches issues early when they're easiest to fix.

[ Screenshot ]

AI-generated review comments placed on a schematic highlighting missing bypass capacitors

# Resolving Comments

Track the status of comments and mark them as resolved once the issue has been addressed.

Resolution Workflow

  • Mark as resolved — Click the resolve button on a comment to mark it as addressed
  • Filter by status — Toggle between showing all comments, only unresolved, or only resolved
  • Resolution tracking — The comment sidebar shows a count of resolved vs. unresolved comments
  • Re-open — Resolved comments can be re-opened if the issue reappears

Comment Sidebar

The comment sidebar provides a centralized view of all comments on the schematic. It supports filtering, searching, and navigating to specific comments by clicking on them.

[ Screenshot ]

Comment sidebar with resolved/unresolved filter and navigation

Next Steps