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 (agents)
• 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.

Agent vs Profile

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

Agent

Un agent est un rôle spécialisé que l'IA adopte pour exécuter une tâche. Il combine l'identité (qui), les contraintes (ce qu'il ne fait pas) et le mécanisme d'exécution (comment).

• Défini dans framework/agents/{name}.md
• Contient une identité : qui est cet agent, comment il pense, quel est son objectif
• Contient des contraintes : ce qu'il ne fait pas (ex. : l'architecte ne touche pas au code)
• Peut opérer en conversation principale (rôle actif) ou en sous-processus isolé (worker autonome)
• A un menu d'actions : codes courts pour invoquer des actions spécifiques
• A un modèle assigné (haiku, sonnet, opus) configuré dans framework/models.md

Exemples : analyst, architect, executor, code-reviewer, security-reviewer, quality-reviewer, test-engineer, debugger, explore

Analogie

Un agent est comme un collaborateur spécialisé : l'architect conçoit et ne code pas, l'executor implémente selon le plan, le code-reviewer cherche les problèmes.

Profile

Un profile est un contexte technologique qui enrichit les agents avec des conventions, patterns et anti-patterns spécifiques à une stack. Il ne change pas qui est l'agent — il change 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 architect (agent) 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

Step (/kensho step-04-execute)       <- "quand et comment orchestrer"
    |
    v dispatch agents
Agent (executor, sonnet)           <- "qui je suis + mécanisme d'exécution"
    |
    v enrichi par
Profile (rust, tauri)              <- "ce que je sais"
    |
    v reçoit
Prompt + Artifacts                 <- "ce que je fais"

Tableau comparatif

Aspect	Agent	Profile
Nature	Rôle / identité + mécanisme	Contexte / savoir
Où il vit	framework/agents/{name}.md	framework/profiles/{name}.md
Quand il agit	Quand un step l'active	Chargé au démarrage de Kensho
Interaction	Dialogue ou retourne un résultat	Aucune (passif)
Durée	Le temps du step ou de la tâche	Toute la session
Modifiable par l'utilisateur	Parfois	Souvent (par projet)
Exemple	L'architect conçoit le plan	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 agents

Exemples : /kensho, /bugfix, /brainstorm

/feature fusionné dans /kensho

Le skill /feature a été fusionné dans /kensho. Utilisez /kensho pour obtenir l'analyse codebase et la conception architecture avant l'implémentation. Pour une review approfondie, ajoutez -x.

Workflow

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

• Décrit le flux entre agents
• 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 d'agents

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.

Agentic Workflow

Un agentic workflow est un pipeline où plusieurs agents collaborent de manière orchestrée pour accomplir une tâche complexe.

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 agents en pipeline.

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

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.

MCP Server

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

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

Vue d'ensemble

Framework (structure globale)
├── Profiles (contexte technologique par stack)
│   └── Injectés dans les Agents
├── Agents (rôles + mécanismes d'exécution)
├── Skills (commandes /slash invocables)
│   ├── Orchestrent des Agents
│   └── Suivent des Workflows
├── Workflows (pipelines visuels)
├── Plugins (extensions modulaires)
│   ├── Skills
│   ├── Hooks
│   └── Agents
└── MCP Servers (services externes via MCP)