product-report

Compiles the product-level PRD reconciling epics and shipped status against final code.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/subvisual/the-a-team --skill product-report-subvisual
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-report
Source: https://github.com/subvisual/the-a-team/tree/main/.claude/skills/product-report
Command: npx skills add https://github.com/subvisual/the-a-team --skill product-report-subvisual

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Product documentation drifts from reality when reports are written from plans instead of code. This Skill produces a durable, product-level PRD (docs/product/ateam-product-report.md) whose shipped-status verdicts are grounded in the final integrated code, not in intentions or completed tickets. ## Core Features & Use Cases - Code-grounded scope table: Indexes every epic with its MoSCoW class, jobs served, and an implemented/partial/not-implemented verdict backed by concrete code evidence. - Acceptance and milestone reporting: Reports requirement acceptance from the obligations ledger and all six independent feature milestones (implementation, verification, human acceptance, integration, release, product validation) without ever certifying them. - Durable update-only refresh: Runs at the end of an A-Team run's pr phase or standalone, preserving prior content, growing the decision log, and keeping every citation and artifact link resolvable. - Use Case: After a feature run integrates and before the PR opens, invoke this Skill to refresh the product report so reviewers see what the product actually is and how much of it is real. ## Quick Start Ask the agent to refresh the product report for the current run so docs/product/ateam-product-report.md reflects what actually shipped.

Frequently Asked Questions about product-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a product-level PRD after a feature run?▼

Invoke the product-report skill after the run's dev phase has integrated and plans are refreshed, before the PR opens. It reads the durable docs layer, the run's feature artifacts, and the final code, then writes or refreshes docs/product/ateam-product-report.md.

What is the difference between prd.md and the product report?▼

prd.md is the feature-level PRD covering one run's requirement-granular scope, written by prd-writer. The product report is the durable product-level PRD at epic granularity, refreshed at the end of every run and grounded in shipped code.

Can the product report mark an epic as shipped from completed tickets?▼

No. Shipped verdicts require evidence in the built code itself. An issue marked complete or a passing test suite is not shipped-evidence; epics the code does not evidence are reported as partial with the gap named.

When should I not use the product-report skill?▼

Do not use it mid-run before dev has integrated, for the feature-level prd.md (use prd-writer), or to define or restructure epics (use the epics skill). A report written from plans instead of code is treated as fiction.

Does the product report certify feature milestones or acceptance?▼

No. It observes and reports all six milestones and the acceptance obligations ledger, distinguishing pending, recorded, stale, and unknown states. It never writes manifest fields, changes ledger status, or self-certifies human studies.