Définitions

Ce glossaire clarifie les termes clés du framework et de l'écosystème AI coding. Ces concepts sont souvent confondus — voici ce qui les distingue.

Framework

Un framework est une structure organisationnelle qui fournit des conventions, des patterns et des outils pour résoudre une catégorie de problèmes.

Dans notre contexte, le Prompt Engineering Framework fournit :

• Des rôles (personas)
• Des workflows (skills)
• Des templates (PRD, ADR)
• Des conventions (commits, état, progressive disclosure)

Analogie

Un framework est comme le plan d'une maison : il définit la structure, les pièces, les circulations — mais ne construit pas la maison lui-même.

Persona vs Agent vs Profile

Ces trois concepts sont souvent confondus. Voici ce qui les distingue clairement.

Persona

Un persona est un rôle conceptuel que l'IA adopte temporairement. Il définit une identité, des responsabilités, des contraintes et un ensemble d'outils autorisés.

• Opère dans la conversation principale (pas de sous-processus)
• L'IA devient le persona — elle change de comportement
• Activé par un skill qui dit "adopte le persona Architect"
• Peut avoir un menu d'actions (codes courts : D, R, T...)
• Défini dans framework/personas/{name}.md

Exemples : Analyst, Architect, Developer, Reviewer

Analogie

Un persona est comme un chapeau que l'IA met : quand elle porte le chapeau "Architect", elle pense en architecte, ne code pas, et dessine des plans.

Agent

Un agent est un worker autonome lancé en sous-processus pour exécuter une tâche ciblée. Il travaille seul, dans un contexte séparé, et retourne un résultat.

• Opère dans un contexte isolé (subagent)
• Ne dialogue pas avec l'utilisateur — il reçoit une mission et rend un rapport
• A des outils spécifiques autorisés
• Sélection du modèle selon la complexité (haiku, sonnet, opus)
• Défini dans framework/agents/{name}.md ou .claude/agents/{name}.md

Exemples : Code Reviewer Agent, Explore Codebase Agent, Web Search Agent

Analogie

Un agent est comme un employé spécialisé à qui on envoie un dossier : il le traite dans son bureau et retourne le résultat — il ne participe pas à la réunion.

Profile

Un profile est un contexte technologique qui enrichit les personas avec des conventions, patterns et anti-patterns spécifiques à une stack. Il ne change pas qui est le persona, mais ce qu'il sait.

• N'a pas de comportement propre — il injecte du contexte
• Chargé automatiquement par APEX au Step 00
• Peut hériter d'un autre profil (extends:)
• Configuré dans CLAUDE.md via la ligne profile:
• Défini dans framework/profiles/{name}.md

Exemples : rust, tauri, vue-typescript, xterm

Analogie

Un profile est comme une spécialisation : un architecte (persona) qui a le profile "Rust" sait concevoir des systèmes avec Tauri et tokio. Sans le profile, il propose des solutions génériques.

Comment ils interagissent

Profile (rust, tauri)          ← "ce que je sais"
    ↓ injecte le contexte
Persona (architect)            ← "qui je suis"
    ↓ guidé par
Skill (/apex step 02)          ← "ce que je fais"
    ↓ peut lancer
Agent (explore-codebase)       ← "tâche déléguée"

Tableau comparatif

Aspect	Persona	Agent	Profile
Nature	Rôle / identité	Worker / processus	Contexte / savoir
Où il vit	Conversation principale	Sous-processus isolé	Injecté dans les personas
Quand il agit	Quand un skill l'active	Quand on le lance sur une tâche	Chargé au démarrage d'APEX
Interaction	Dialogue avec l'utilisateur	Retourne un résultat	Aucune (passif)
Durée	Le temps du step	Le temps de la tâche	Toute la session
Modifiable par l'utilisateur	Rarement	Parfois	Souvent (par projet)
Fichier	personas/{name}.md	agents/{name}.md	profiles/{name}.md
Exemple	L'Architect conçoit le plan	L'Explore Agent mappe le code	Le profile Rust ajoute les conventions Rust

Skill vs Workflow

Skill

Un skill est une commande invocable (/nom) qui encapsule un workflow complet avec des étapes, des flags et des gates. C'est l'unité d'interaction principale du framework.

• Invoqué par l'utilisateur via /commande
• Contient des steps numérotés avec des gates
• Accepte des flags pour adapter le comportement
• Peut orchestrer plusieurs personas et agents

Exemples : /apex, /feature, /bugfix, /brainstorm

Workflow

Un workflow est un pipeline visuel qui décrit comment les personas s'enchaînent pour accomplir un objectif. C'est la vue "big picture" d'un processus.

• Décrit le flux entre personas
• Définit les gates de validation
• Peut être adapté selon la complexité
• Sert de référence pour comprendre le pipeline

Exemples : Feature Pipeline, Bugfix Pipeline

En résumé

Aspect	Skill	Workflow
Nature	Commande exécutable	Diagramme de flux
Granularité	Steps détaillés + flags	Vue d'ensemble
Invocation	/commande par l'utilisateur	Référence documentaire
Contenu	Instructions précises	Flux de personas

Agentic vs Agentic Workflow

Agentic

Agentic décrit un comportement où l'IA agit de manière autonome — elle prend des décisions, exécute des actions, et itère sans intervention humaine à chaque étape.

Un système est "agentic" quand il :

• Planifie ses propres actions
• Utilise des outils de manière autonome
• Itère jusqu'à atteindre un objectif
• Gère les erreurs et s'adapte

Agentic Workflow

Un agentic workflow est un pipeline où plusieurs agents collaborent de manière orchestrée pour accomplir une tâche complexe. Chaque agent a un rôle spécialisé.

Agent A (analyser) → Agent B (planifier) → Agent C (exécuter) → Agent D (vérifier)

Le framework implémente ce concept via les skills qui orchestrent des personas et agents en pipeline.

En résumé

Aspect	Agentic	Agentic Workflow
Scope	Comportement d'un seul agent	Collaboration entre agents
Focus	Autonomie	Orchestration
Exemple	Un agent qui debug seul	Le feature pipeline complet

Plugin

Un plugin est une extension modulaire qui ajoute des capacités à un outil existant sans modifier son code source.

Dans l'écosystème Claude Code :

• Les skills sont des plugins pour le framework
• Les hooks sont des plugins événementiels pour Claude Code
• Les agents sont des plugins de traitement autonome

Différence avec un skill

Un plugin est un concept technique (extension logicielle). Un skill est un concept fonctionnel (workflow invocable). Un skill est un type de plugin, mais tous les plugins ne sont pas des skills.

MCP et MCP Server

MCP (Model Context Protocol)

MCP est un protocole standardisé (créé par Anthropic) qui permet aux AI coding agents de communiquer avec des services externes de manière uniforme.

C'est un standard de communication — comme HTTP pour le web, MCP définit comment l'IA parle aux outils externes.

MCP Server

Un MCP Server est un service qui implémente le protocole MCP pour exposer des capacités spécifiques à l'IA.

Exemples :

• Un MCP Server filesystem → permet à l'IA de lire/écrire des fichiers
• Un MCP Server database → permet à l'IA de requêter une base de données
• Un MCP Server GitHub → permet à l'IA d'interagir avec les repos
• Un MCP Server Slack → permet à l'IA d'envoyer des messages

En résumé

Aspect	MCP	MCP Server
Nature	Protocole (spécification)	Service (implémentation)
Rôle	Définir le format d'échange	Exposer des capacités
Analogie	HTTP (le protocole)	Un serveur web (l'implémentation)

AI Agent ←→ [MCP Protocol] ←→ MCP Server ←→ Service externe
                                              (GitHub, DB, Slack...)

Vue d'ensemble

Comment tous ces concepts s'articulent dans le framework :

Framework (structure globale)
├── Profiles (contexte technologique par stack)
│   └── Injectés dans les Personas
├── Personas (rôles dans la conversation)
├── Skills (commandes /slash invocables)
│   ├── Orchestrent des Personas
│   ├── Lancent des Agents
│   └── Suivent des Workflows
├── Agents (workers autonomes)
│   └── Peuvent utiliser des MCP Servers
├── Workflows (pipelines visuels)
├── Plugins (extensions modulaires)
│   ├── Skills
│   ├── Hooks
│   └── Agents
└── MCP Servers (services externes via MCP)