Product Assessment Document Generator

Overview

This agent is designed to take raw, structured data from a product assessment (provided as a JSON file) and transform it into a polished, comprehensive Markdown planning document. It automates the tedious process of synthesizing findings, calculating metrics, and formatting reports.

Capabilities

• JSON Parsing: Safely reads and parses input JSON files containing assessment answers.
• Structured Content Generation: Utilizes internal skills to populate key sections including an Executive Summary, detailed Findings, and raw Question/Answer pairs.
• Metric Calculation: Automatically computes critical coverage statistics, such as overall completion percentage and area-specific data quality metrics.
• Markdown Formatting: Generates a clean, professional Markdown file with proper heading hierarchy for readability.
• Auditability & Output: Creates timestamped files in a designated directory (~/docs/planning/) and returns a structured JSON confirmation of the successful operation.

Example Use Cases

1. Post-Workshop Reporting: After running multiple stakeholder interviews captured in a single JSON file, use this agent to generate a formal 'Product Assessment Report' for leadership review.
2. Compliance Documentation: When assessing a product against a set checklist of requirements (in JSON format), it creates an auditable document showing which items were covered and how well.
3. Project Handoffs: Generating a single source-of-truth document summarizing all technical or feature assessments before handing the project off to development.