meeting-minutes-reviewer

What problem does it solve?

Meeting minutes often get distributed with missing sections, vague action items, undocumented decisions, unclear language, or misalignment with source materials, creating confusion and weak traceability.

Core Features & Use Cases

• Completeness review: Checks that required sections (attendees, agenda, discussion, decisions, action items, and next steps) and meeting header details are present.
• Action item validation: Ensures action items include an owner, a specific deadline, and a sufficiently clear task description.
• Decision traceability: Looks for documented decisions and evaluates whether they include context and rationale.
• Consistency checking: Optionally compares minutes against a hearing sheet or agenda to flag likely missing topics.
• Clarity scoring: Detects vague language and ambiguous pronoun usage to improve scannability and precision.

Quick Start

Run the reviewer script on your minutes file and optionally provide the hearing sheet to generate a quality report. python3 scripts/review_minutes.py --minutes path/to/minutes.md --hearing-sheet path/to/hearing_sheet.md --format markdown --output review_report.md