Skip to content

borghei/Claude-Skills / project-management/execution/summarize-meeting

summarize-meeting

Verified

Turns meeting notes or transcripts into a summary of decisions, owned and dated action items, and open questions. Use when writing up a meeting, a recap email or a decision log; for patterns across a series use meeting-analyzer.

scripts/decision_log_builder.py

View on GitHub
#!/usr/bin/env python3
"""Decision Log Builder - Build and query a decision log from meeting data.

Aggregates decisions across meetings and provides search, timeline,
and decision audit capabilities.

Usage:
    python decision_log_builder.py --meetings meetings.json
    python decision_log_builder.py --meetings meetings.json --search "launch"
    python decision_log_builder.py --meetings meetings.json --json
    python decision_log_builder.py --example
"""

import argparse
import json
import re
import sys
from datetime import datetime


def load_data(path: str) -> dict:
    try:
        with open(path, "r") as f:
            data = json.load(f)
    except (OSError, json.JSONDecodeError) as e:
        fail(f"cannot read {path}: {e}")
    if not isinstance(data, dict):
        fail(f"{path}: top level must be a JSON object (see --example)")
    return data


def fail(msg: str) -> None:
    """Bad input: one line on stderr, exit 2."""
    print(f"Error: {msg}", file=sys.stderr)
    sys.exit(2)


def build_log(data: dict, search: str = None) -> dict:
    meetings = data.get("meetings", [])

    decisions = []
    for meeting in meetings:
        date = meeting.get("date", "Unknown")
        topic = meeting.get("topic", "Unknown")
        participants = meeting.get("participants", [])

        for dec in meeting.get("decisions", []):
            decision = {
                "id": f"DEC-{date.replace('-', '')}-{len(decisions)+1:03d}",
                "date": date,
                "meeting_topic": topic,
                "decision": dec.get("decision", ""),
                "rationale": dec.get("rationale", ""),
                "decided_by": dec.get("decided_by", "Unknown"),
                "participants": participants,
                "category": dec.get("category", "General"),
                "impact": dec.get("impact", "Medium"),
                "reversible": dec.get("reversible", True),
            }
            decisions.append(decision)

    # Sort by date (most recent first)
    decisions.sort(key=lambda x: x["date"], reverse=True)

    # Apply search filter
    if search:
        pattern = re.compile(search, re.IGNORECASE)
        decisions = [d for d in decisions if pattern.search(d["decision"]) or pattern.search(d.get("rationale", ""))]

    # Category distribution
    categories = {}
    for d in decisions:
        cat = d["category"]
        categories[cat] = categories.get(cat, 0) + 1

    # Impact distribution
    impact_counts = {"High": 0, "Medium": 0, "Low": 0}
    for d in decisions:
        impact_counts[d["impact"]] = impact_counts.get(d["impact"], 0) + 1

    # Quality checks
    missing_rationale = [d for d in decisions if not d.get("rationale")]
    high_impact_reversible = [d for d in decisions if d["impact"] == "High" and d.get("reversible", True)]

    recs = []
    if missing_rationale:
        recs.append(f"{len(missing_rationale)} decision(s) without documented rationale. Future teams need to understand 'why'.")
    if high_impact_reversible:
        recs.append(f"{len(high_impact_reversible)} high-impact decision(s) marked as reversible. Verify this is correct and document rollback plans.")

    return {
        "total_decisions": len(decisions),
        "search_query": search,
        "categories": categories,
        "impact_distribution": impact_counts,
        "decisions": decisions,
        "quality": {
            "missing_rationale": len(missing_rationale),
            "decisions_with_rationale_pct": round((len(decisions) - len(missing_rationale)) / len(decisions) * 100, 1) if decisions else 0,
        },
        "recommendations": recs,
    }


def print_report(result: dict) -> None:
    print(f"\nDecision Log")
    if result["search_query"]:
        print(f"Search: '{result['search_query']}'")
    print(f"Total Decisions: {result['total_decisions']}")
    print("=" * 65)

    imp = result["impact_distribution"]
    print(f"Impact: High={imp.get('High',0)} | Medium={imp.get('Medium',0)} | Low={imp.get('Low',0)}")
    print(f"Rationale Coverage: {result['quality']['decisions_with_rationale_pct']:.0f}%")

    print(f"\nDecisions:")
    for d in result["decisions"]:
        rev = " [reversible]" if d.get("reversible") else " [irreversible]"
        print(f"\n  {d['id']} ({d['date']})")
        print(f"    Decision: {d['decision']}")
        if d["rationale"]:
            print(f"    Rationale: {d['rationale'][:80]}")
        print(f"    Decided by: {d['decided_by']}  |  Impact: {d['impact']}{rev}")

    if result["recommendations"]:
        print(f"\nRecommendations:")
        for i, r in enumerate(result["recommendations"], 1):
            print(f"  {i}. {r}")
    print()


def print_example() -> None:
    example = {
        "meetings": [
            {
                "date": "2026-03-14",
                "topic": "Architecture Review",
                "participants": ["Alice", "Bob", "Carol"],
                "decisions": [
                    {"decision": "Use PostgreSQL for analytics service", "rationale": "80% relational queries based on pattern analysis", "decided_by": "Engineering leads", "category": "Technical", "impact": "High", "reversible": False},
                    {"decision": "Adopt trunk-based development", "rationale": "Reduce merge conflicts and improve CI speed", "decided_by": "Alice", "category": "Process", "impact": "Medium", "reversible": True},
                ],
            },
            {
                "date": "2026-03-07",
                "topic": "Sprint Planning",
                "participants": ["Alice", "Dave"],
                "decisions": [
                    {"decision": "Launch date set for April 15", "rationale": "Allows 2 full sprints for QA after feature freeze", "decided_by": "Steering committee", "category": "Schedule", "impact": "High", "reversible": True},
                ],
            },
        ],
    }
    print(json.dumps(example, indent=2))


def main():
    parser = argparse.ArgumentParser(description="Build and query a decision log.")
    parser.add_argument("--meetings", type=str, help="Path to meetings JSON file")
    parser.add_argument("--search", type=str, help="Search decisions by keyword")
    parser.add_argument("--json", action="store_true", help="Output as JSON")
    parser.add_argument("--format", choices=["text", "json"], default="text", help="Output format (--json is the same as --format json)")
    parser.add_argument("--example", action="store_true", help="Print example and exit")
    args = parser.parse_args()

    if args.example:
        print_example()
        return
    if not args.meetings:
        parser.error("--meetings is required")

    data = load_data(args.meetings)
    try:
        result = build_log(data, args.search)
    except (AttributeError, TypeError, KeyError, ValueError) as e:
        fail(f"unexpected input shape ({type(e).__name__}: {e}); run --example for the format")
    if args.json or args.format == "json":
        print(json.dumps(result, indent=2))
    else:
        print_report(result)


if __name__ == "__main__":
    main()
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall