# leadtech-bmad-mcp — Métadonnées `knowledge/`

Ce document définit le **front matter minimal** attendu pour rendre la base `knowledge/` mieux exploitable par le MCP.

## Objectif

- améliorer le ranking de recherche
- permettre des filtres structurés
- préparer un futur index compilé

## Format retenu

Chaque document `knowledge/*/*.md` peut commencer par :

```md
---
title: Backend — Patterns : NestJS
domain: backend
bucket: patterns
tags: [nestjs, guards, auth, redis]
applies_to: [analysis, implementation, review, debug]
severity: medium
validated_on: 2026-03-07
source_projects: [app-alexandrie]
---
```

Le front matter est **optionnel** dans la phase 1.

Le loader doit :

- fonctionner avec ou sans front matter
- ignorer proprement les champs inconnus
- continuer à servir le markdown brut si demandé en resource

## Champs v1

### `title`

- titre logique du document
- type : `string`

### `domain`

- domaine principal
- type : `backend | frontend | ux | n8n | product | workflow`

### `bucket`

- type de document
- type : `patterns | risques`

### `tags`

- mots-clés de recherche
- type : `string[]`

### `applies_to`

- moments du workflow où le document est pertinent
- type : `analysis | implementation | review | debug | architecture`
- type de stockage : `string[]`

### `severity`

- niveau de criticité métier ou technique du document
- type : `low | medium | high`

### `validated_on`

- date de validation terrain
- type : `YYYY-MM-DD`

### `source_projects`

- projets ayant validé le pattern ou révélé le risque
- type : `string[]`

## Règles de gouvernance

- les README d'index n'ont pas besoin de front matter dans la phase 1
- priorité aux documents les plus consultés ou les plus critiques
- ne pas bloquer une capitalisation parce que le front matter n'existe pas encore

## Politique de migration

Phase 1 :
- ajouter le front matter à un petit noyau de documents pilotes

Noyau pilote actuellement couvert :

- `knowledge/backend/patterns/auth.md`
- `knowledge/backend/patterns/contracts.md`
- `knowledge/backend/patterns/nestjs.md`
- `knowledge/backend/patterns/prisma.md`
- `knowledge/backend/risques/auth.md`
- `knowledge/backend/risques/contracts.md`
- `knowledge/backend/risques/nestjs.md`
- `knowledge/backend/risques/prisma.md`
- `knowledge/frontend/patterns/navigation.md`
- `knowledge/frontend/patterns/tests.md`
- `knowledge/frontend/risques/navigation.md`
- `knowledge/frontend/risques/tests.md`
- `knowledge/workflow/risques/story-tracking.md`

Phase 2 :
- généraliser aux documents backend, frontend et workflow les plus actifs

Phase 3 :
- exiger ces métadonnées pour l'index compilé
