Mathias STRASSER
b7dc27f2a5
Les enseignants ont besoin de moyennes à jour immédiatement après la publication ou modification des notes, sans attendre un batch nocturne. Le système recalcule via Domain Events synchrones : statistiques d'évaluation (min/max/moyenne/médiane), moyennes matières pondérées (normalisation /20), et moyenne générale par élève. Les résultats sont stockés dans des tables dénormalisées avec cache Redis (TTL 5 min). Trois endpoints API exposent les données avec contrôle d'accès par rôle. Une commande console permet le backfill des données historiques au déploiement.
3.3 KiB
Standard Agent Fields
Frontmatter Fields
Only these fields go in the YAML frontmatter block:
| Field | Description | Example |
|---|---|---|
name |
Full skill name (kebab-case, same as folder name) | bmad-agent-tech-writer, bmad-cis-agent-lila |
description |
[What it does]. [Use when user says 'X' or 'Y'.] | See Description Format below |
Content Fields
These are used within the SKILL.md body — never in frontmatter:
| Field | Description | Example |
|---|---|---|
displayName |
Friendly name (title heading, greetings) | Paige, Lila, Floyd |
title |
Role title | Tech Writer, Holodeck Operator |
icon |
Single emoji | 🔥, 🌟 |
role |
Functional role | Technical Documentation Specialist |
sidecar |
Memory folder (optional) | {skillName}-sidecar/ |
Overview Section Format
The Overview is the first section after the title — it primes the AI for everything that follows.
3-part formula:
- What — What this agent does
- How — How it works (role, approach, modes)
- Why/Outcome — Value delivered, quality standard
Templates by agent type:
Companion agents:
This skill provides a {role} who helps users {primary outcome}. Act as {displayName} — {key quality}. With {key features}, {displayName} {primary value proposition}.
Workflow agents:
This skill helps you {outcome} through {approach}. Act as {role}, guiding users through {key stages/phases}. Your output is {deliverable}.
Utility agents:
This skill {what it does}. Use when {when to use}. Returns {output format} with {key feature}.
SKILL.md Description Format
{description of what the agent does}. Use when the user asks to talk to {displayName}, requests the {title}, or {when to use}.
Path Rules
Skill-Internal Files
All references to files within the skill use ./ relative paths:
./references/memory-system.md./references/some-guide.md./scripts/calculate-metrics.py
This distinguishes skill-internal files from {project-root} paths — without the ./ prefix the LLM may confuse them.
Memory Files (sidecar)
Always use {project-root} prefix: {project-root}/_bmad/memory/{skillName}-sidecar/
The sidecar index.md is the single entry point to the agent's memory system — it tells the agent what else to load (boundaries, logs, references, etc.). Load it once on activation; don't duplicate load instructions for individual memory files.
Config Variables
Use directly — they already contain {project-root} in their resolved values:
{output_folder}/file.md- Correct:
{bmad_builder_output_folder}/agent.md - Wrong:
{project-root}/{bmad_builder_output_folder}/agent.md(double-prefix)