creating-iteration-report

What problem does it solve?

Produces a formal, quantitative iteration completion report by automating the collection and synthesis of iteration plans, release plans, git history, and test results so teams no longer assemble metrics and narratives by hand.

Core Features & Use Cases

• Data aggregation: Collects iteration_plan-{N}.md, release_plan.md, prior iteration reports, git logs, and test outputs to form the factual basis of the report.
• Metrics & charts: Computes planned vs actual story points, achievement rate, velocity tables, burn-down and velocity charts, and test result summaries for transparency and planning improvement.
• Repository updates: Writes docs/development/iteration_report-{N}.md, updates release_plan.md progress entries, and refreshes documentation indexes and mkdocs navigation as needed.
• Use case: At the end of an iteration, run this workflow to generate a reproducible report that supports release planning, retrospectives, and stakeholder updates.

Quick Start

Create an iteration completion report for iteration 4 by aggregating docs/development/iteration_plan-4.md, release_plan.md, git history, and test outputs into docs/development/iteration_report-4.md.