meeting-report（会议报告）

Meeting Report

Generate a structured French meeting report from a Microsoft Teams .vtt transcript, optionally enriched with a Teams .csv attendance report.

The skill works on any project. It auto-detects the hexagone-monorepo project and, when detected, applies project-specific rules (sub-domain classification, sub-folder routing, foundation date-only naming). On any other project, it falls back to a generic single-folder output.

When to Use This Skill

Activate when the user:

• Dépose un chemin vers un fichier .vtt Teams dans le prompt
• Dit « crée un compte-rendu de cette transcription Teams »
• Dit « génère le compte-rendu de cette réunion »
• Dit « transforme cette transcription en rapport »
• Dépose en plus un fichier .csv de présence Teams (optionnel)

Inputs

The skill expects one or two file paths dropped in the user prompt:

• Required: .vtt file — Teams meeting transcript in WebVTT format
• Optional: .csv file — Teams attendance report

Detection: inspect file extensions in the user prompt. If both are present, .vtt is the transcript and .csv is the attendance report. If only one file is dropped, it must be the .vtt.

Project Mode Detection

Before processing, decide whether the current working directory is the hexagone-monorepo project. This sets the routing behavior for the rest of the workflow.

Run these checks (any one of them is sufficient to enter hexagone-monorepo mode):

1. Folder layout — docs/reports/foundation/ AND docs/reports/interoperability/ both exist
2. Git remote — git remote -v mentions hexagone-monorepo
3. Package name — root package.json has a name containing hexagone-monorepo

If none match → generic mode.

The user may also explicitly override:

• « mode générique » / « generic mode » → force generic
• « mode hexagone » → force hexagone-monorepo (only valid if the layout exists)

State the detected mode in one short sentence to the user before producing the report (e.g. « Mode détecté: hexagone-monorepo. » or « Mode détecté: générique. »).

Workflow

Step 1: Locate and Read the Files

1. Parse the user prompt for file paths (look for .vtt and .csv extensions)
2. Verify each file exists using Read
3. If no .vtt is found → stop and ask the user to provide one
4. Read the .vtt content entirely
5. Read the .csv content if provided

Step 2: Parse the Transcript

Teams .vtt file structure:

WEBVTT

NOTE
Meeting metadata may appear here (date, title, organizer)

00:00:01.000 --> 00:00:04.000
<v Speaker Name>Speech content</v>

00:00:05.000 --> 00:00:08.000
Anonymous speech without voice tag

Extract:

1. Meeting date — try in this order:

- (a) NOTE header content containing a date pattern (ISO YYYY-MM-DD or French DD/MM/YYYY) - (b) Filename date pattern (e.g. 20260410_...vtt → 2026-04-10) - (c) Today's date as fallback

1. Speakers — parse <v Speaker Name>...</v> voice tags (may be absent)
2. Content blocks — each timestamped segment is a speaker turn

Step 3: Resolve Participants

Priority order:

1. If .csv attendance report provided → parse it and extract the Name column. Teams attendance CSVs typically contain columns like Name, First Join, Last Leave, Duration, Role, Email. Use names only for the ## Participants section.
2. Else if <v> voice tags are present in the .vtt → extract unique speaker names
3. Else → stop and ask the user to provide the participants list before continuing: « La transcription est anonyme et aucun fichier de présence n'est fourni. Peux-tu me donner la liste des participants? »

Step 4: Classify the Sub-Domain (hexagone-monorepo mode only)

Skip this step in generic mode. In generic mode, there is no domain classification — the report goes to a single output folder (see Step 11).

In hexagone-monorepo mode, analyze transcript content for domain signals using the table below (case-insensitive keyword matching):

Classification rule:

Classification is by project/domain, not by team org. The Hexaflux team is organizationally part of the Foundation team but works exclusively on the Hexaflux project (domain = interoperability), so their recurring meetings land in interoperability/, not foundation/. Always check project-specific signals before the generic Foundation standup rule.

1. If the meeting is the Hexaflux team recurring meeting (mentions « Hexaflux », or a weekly/standup/rétro involving the HL7/interop scope) → interoperability/
2. Else if the meeting is a Foundation team recurring meeting working on the horizontal/transverse platform (sprint, rétro, daily, point équipe, stand-up — without project-specific scope) → foundation/
3. Interoperability vs. GAP disambiguation. HL7 messages carry patient data (PID, PV1, NK1, etc.) so GAP keywords (patient, admission, séjour, venue) will naturally appear. When HL7/interop signals are present alongside GAP signals, the meeting is about integration, not patient business workflows → classify as interoperability/. Only classify as gap/ when the discussion is about the functional/business side (UI, portail patient, facturation, workflows métier admission) without a technical HL7/message layer.
4. Otherwise, count keyword matches per domain folder and pick the folder with the highest count (dominant domain)
5. On a tie, prefer the folder whose signals appear earliest in the transcript
6. If no signals match at all → ask the user to confirm the target folder

Step 5: Extract Meeting Title and Slug

1. Read the first minutes of the transcript for explicit subject references (greetings usually mention the meeting title)
2. Infer a clean French meeting title (e.g. Atelier UX/UI Recherche Patient)
3. Generate a kebab-case slug from the title:

- Lowercase, ASCII only (strip accents) - Replace spaces and punctuation with - - Max ~60 characters - Example: atelier-ux-ui-recherche-patient

Step 6: Rewrite Content by Topic

Style: Heavy rewrite, grouped by topic, not chronological, not verbatim.

1. Identify the main topics discussed — cluster speaker turns into thematic groups (topic detection, not speaker order)
2. For each topic, extract:

- Décisions — concrete decisions made (always present as a ### Décisions subsection) - Point d'attention — ambiguities, unresolved items (optional ### Point d'attention subsection) - Problèmes identifiés — blockers, technical issues, missing dependencies (optional ### Problèmes identifiés subsection)

1. Write in professional French:

- Use "nous" or impersonal tone - Fix all missing accents aggressively — Teams French transcripts are notoriously bad with accents and punctuation - Remove filler words — « euh », « du coup », « en fait », repetitions, stammering - Use **bold** emphasis on key terms inside decision bullets

1. Target length: 800–1500 words for the full report
2. Number the sections: ## 1. <Topic>, ## 2. <Topic>, etc.
3. Do not quote speakers verbatim. The output is a synthesized report, not minutes.

Step 7: Extract Actions

Comb the transcript for action items — things to do, follow-ups, commitments, decisions requiring later implementation. Identify for each:

• Action — the thing to do
• Responsable — who was assigned (or « À préciser » if unclear)
• Statut — typical values: À planifier, En cours, En attente, Terminé

Format as a Markdown table. The ## Actions section is always present at the end of the report. If no actions were identified, write a single row:

| Action | Responsable | Statut |
|--------|-------------|--------|
| Aucune action identifiée | — | — |

Step 8: Decide Whether to Add a Mermaid Diagram

Add a mermaid diagram only when the content genuinely benefits from visualization. Good triggers:

• Multi-step workflows (e.g. a facturation 6/8/7-step process)
• Decision trees with clear branches
• Sequence of events between multiple actors (e.g. admission → séjour → facturation)
• Data flow between systems

Prefer these diagram types:

• flowchart LR or flowchart TD for processes and decisions
• sequenceDiagram for inter-actor interactions
• timeline for project phases

Place the diagram inside the relevant topic section, not at the top of the report.

Default: no diagram. When in doubt, skip it. A report without a diagram is the norm, not the exception.

Step 9: Assemble the Report

Use this exact template:

# Compte-rendu — <Type de réunion> <Sujet>

**Date :** DD/MM/YYYY
**Organisateur :** <Nom> (<Rôle>)

## Participants

<Nom1>, <Nom2>, <Nom3>, ...

---

## 1. <Topic 1>

### Décisions

- **<Key term>** : <decision>
- ...

### Point d'attention

<Optional paragraph — only when there is an ambiguity or unresolved item>

### Problèmes identifiés

- <Optional bullet list — only when problems were raised>

---

## 2. <Topic 2>

### Décisions

- ...

---

<...as many topics as needed...>

## Actions

| Action | Responsable | Statut |
|--------|-------------|--------|
| ... | ... | ... |

Rules:

• No YAML front-matter
• Date in French format DD/MM/YYYY in the body (ISO only in the filename)
• Participants is a single comma-separated line, not a table, no roles
• Organisateur: if identifiable from transcript/csv, write **Organisateur:** Nom (Rôle). If not identifiable, write **Organisateur:** À préciser
• --- horizontal rule separator between topics
• ## Actions always at the very end

Step 10: Determine the Filename

hexagone-monorepo mode:

• Foundation team meetings (foundation/ folder) → YYYY-MM-DD.md (date only, no slug — one standing team meeting per day maximum)
• All other folders → YYYY-MM-DD-<slug>.md

Generic mode:

• Always YYYY-MM-DD-<slug>.md

The filename always uses the ISO date format YYYY-MM-DD, different from the French DD/MM/YYYY used in the report body.

Step 11: Resolve the Output Folder and Write the File

hexagone-monorepo mode:

1. Target path: docs/reports/<sub-domain>/<filename>.md
2. Verify the sub-domain folder exists (ls docs/reports/<sub-domain>/). If missing, create it.

Generic mode:

1. Pick the first existing folder among:

- docs/reports/ - docs/meetings/ - meetings/ - reports/

1. If none exists, create docs/reports/ and use it.
2. Target path: <chosen-folder>/<filename>.md

Common to both modes:

1. Check if a file with the same name already exists — if yes, append -2, -3, etc. before writing (do NOT overwrite)
2. Write the file with the Write tool

Step 12: Report to the User

Show a concise summary:

1. ✓ Mode: hexagone-monorepo or generic
2. ✓ Target path
3. One-line summary: (sub-domain in hexagone mode), number of topics, number of actions, number of participants
4. Note any fallback that was triggered (no attendance CSV, no voice tags, today's date used because no date found, default folder created, etc.)
5. Stop. Do not run git add, git commit, or git push. The user commits the file manually after review.

Important Notes

• Project-agnostic by default. Sub-domain classification and docs/reports/<sub-domain>/ routing only apply when the hexagone-monorepo project is detected.
• No redaction or pseudonymization. Team meetings are considered internal and trusted. Names and content may appear verbatim in reports.
• No git actions. The skill writes the file and stops. Commit and push are manual.
• Rewrite heavily — do not transcribe. The output is a thematic synthesis, not chronological minutes.
• Fix French accents aggressively. Teams .vtt French transcripts routinely miss accents and punctuation.
• Foundation date-only naming applies only in hexagone-monorepo mode. Generic mode always uses YYYY-MM-DD-<slug>.md.
• Mermaid is optional, rare, and only when useful. Default is no diagram.
• Participants fallback order: .csv first, then <v> voice tags, then ask the user. Never invent names.
• Never overwrite an existing report. Append a numeric suffix if a file with the same name already exists.

Examples

Example 1: Generic project, simple meeting

User: crée un compte-rendu de cette transcription Teams /tmp/kickoff.vtt

→ Detection: no docs/reports/foundation/ found → generic mode
→ Skill reads the .vtt
→ Parses <v> voice tags → 5 speakers
→ Extracts date 2026-04-22
→ Picks docs/reports/ (exists) as output folder
→ Writes docs/reports/2026-04-22-kickoff-projet.md
→ Reports: « Mode détecté : générique. »

Example 2: Generic project, no docs/reports folder yet

User: génère le compte-rendu /tmp/atelier.vtt /tmp/attendees.csv

→ Detection: generic mode
→ No docs/reports/, no docs/meetings/, no meetings/, no reports/ → creates docs/reports/
→ Writes docs/reports/2026-04-15-atelier-architecture.md
→ Reports: « Mode détecté : générique. Dossier docs/reports/ créé. »

Example 3 (hexagone-monorepo): UX/UI atelier with attendance CSV

User: crée un compte-rendu de cette transcription Teams /tmp/atelier_recherche_patient.vtt /tmp/attendees.csv

→ Detection: docs/reports/foundation/ + interoperability/ exist → hexagone-monorepo mode
→ Skill reads both files
→ Extracts date from .vtt NOTE header: 2026-03-18
→ Participants from .csv: Chloé Julenon, Richard Gill, Adrien Marcos, Myriam Fatoux, Damien Battistella
→ Detects ui-ux signals (atelier, écran, maquette, recherche patient)
→ Classifies as ui-ux/
→ Writes docs/reports/ui-ux/2026-03-18-atelier-recherche-patient.md

Example 4 (hexagone-monorepo): Foundation team sprint review, no CSV

User: génère le compte-rendu de cette réunion /tmp/sprint_review.vtt

→ Detection: hexagone-monorepo mode
→ Parses <v Speaker> voice tags → extracts 4 speakers
→ Extracts date from NOTE header: 2026-04-10
→ Detects foundation signals (sprint, rétro, point équipe)
→ Classifies as foundation/
→ Uses date-only naming
→ Writes docs/reports/foundation/2026-04-10.md

Example 5: Anonymous transcript with no CSV (any mode)

User: transforme cette transcription en rapport /tmp/meeting.vtt

→ No <v> tags found
→ No .csv provided
→ Stops and asks: « La transcription est anonyme et aucun fichier de présence n'est fourni. Peux-tu me donner la liste des participants ? »
→ Waits for the user, then continues with the provided names

Example 6 (hexagone-monorepo): Hexaflux weekly — HL7 discussion, not GAP

User: crée un compte-rendu /tmp/hexaflux_weekly.vtt

→ Detection: hexagone-monorepo mode
→ Detects HL7 / ADT / PID / PV1 / NK1 / OBX / segment / mapping signals
→ Patient and admission keywords are present BUT tied to HL7 message segments, not business workflows
→ Applies the interop-vs-gap disambiguation rule → picks interoperability/
→ Writes docs/reports/interoperability/2026-04-17-hexaflux-weekly.md