What is weekly-reports?

This Claude skill automates the creation and management of comprehensive weekly project reports integrated with Cumulative Flow Diagrams (CFD). It enables teams to visualize workflow stability, track task progression, and monitor key performance indicators such as throughput, lead time, and work-in-progress (WIP) directly through automated data collection and markdown generation.

When should I use weekly-reports?

weekly-reports is useful in the following scenarios: • Automated Weekly Status Updates: Quickly generate professional markdown reports summarizing all completed and newly created tasks to keep stakeholders informed without manual data entry. • Workflow Bottleneck Identification: Use the Cumulative Flow Diagram (CFD) to visualize task distribution and identify stages where work is piling up, allowing for immediate process optimization. • Agile Metrics Tracking: Monitor essential productivity metrics like average lead time and team throughput to improve sprint planning and delivery predictability. • Project Data Archiving: Maintain a structured history of project progress with version-controlled JSON data and visual reports for long-term trend analysis and auditing.

name	weekly-reports
description	Génération et mise à jour de rapports hebdomadaires avec CFD (Cumulative Flow Diagram). Activer ce skill quand l'utilisateur parle de récapitulatif, bilan hebdomadaire, rapport de la semaine, ou CFD.
version	1.0.0

Weekly Reports Skill

Système de génération de rapports hebdomadaires pour le suivi des tâches du projet CV.

Available Commands

report-create

Crée un nouveau rapport hebdomadaire complet avec CFD.

report-create [--week YYYY-WNN]

Fonctionnalités:

Collecte automatique des tâches terminées/créées de la semaine
Génération du CFD (Cumulative Flow Diagram)
Création du rapport markdown
Statistiques par catégorie

Voir workflows/report-create.md pour les détails.

report-update

Met à jour un rapport existant (données, CFD, notes).

report-update [--week YYYY-WNN]

Fonctionnalités:

Mise à jour des données JSON
Régénération du CFD
Ajout de notes et observations

Voir workflows/report-update.md pour les détails.

Architecture

.claude/skills/weekly-reports/
├── SKILL.md                    # Ce fichier (Level 1)
└── workflows/                  # Instructions détaillées (Level 2)
    ├── report-create.md
    └── report-update.md

scripts/reports/                # Module Python (Level 3)
├── __init__.py
├── cfd.py                      # Génération CFD
├── weekly_report.py            # Génération rapport markdown
├── generate_cfd.py             # CLI
└── tests/                      # 34 tests

.tasks/reports/                 # Rapports générés
├── YYYY-WNN-recap.md           # Rapport markdown
├── YYYY-WNN-cfd.png            # Image CFD
└── YYYY-WNN-data.json          # Données brutes

Métriques du CFD

Le Cumulative Flow Diagram permet de visualiser:

Métrique	Lecture	Signification
Throughput	Pente de la zone verte	Vitesse de livraison (tâches/jour)
WIP	Épaisseur de la zone orange	Travail en cours
Lead Time	Distance horizontale	Temps moyen de traitement
Backlog	Hauteur de la zone bleue	Tâches restantes

Commandes CLI

# Générer un CFD depuis données JSON
uv run --with matplotlib --with numpy scripts/reports/generate_cfd.py \
  --data .tasks/reports/2025-W48-data.json \
  --output .tasks/reports/

# Afficher les métriques
uv run --with matplotlib --with numpy scripts/reports/generate_cfd.py \
  --data .tasks/reports/2025-W48-data.json \
  --metrics

# Mode interactif (afficher le graphique)
uv run --with matplotlib --with numpy scripts/reports/generate_cfd.py \
  --data .tasks/reports/2025-W48-data.json \
  --show

Format des données JSON

{
  "week": "2025-W48",
  "title": "Cumulative Flow Diagram - Semaine 48",
  "data": [
    {"date": "2025-11-24", "backlog": 29, "in_progress": 0, "done": 12, "comment": "État initial"},
    {"date": "2025-11-25", "backlog": 22, "in_progress": 0, "done": 32, "comment": "20 terminées"}
  ],
  "summary": {
    "tasks_completed": 28,
    "tasks_created": 19,
    "avg_wip": 0.5
  }
}

weekly-reports

When & Why to Use This Skill

Use Cases