Module 10 — Playbooks et seuils de production — Context Engineering — le pack Praktik

Objectif

À la fin de ce module, tu auras 5 playbooks copier-coller pour les situations les plus courantes.

Playbook 1 : Démarrage de session

Quand : Tu ouvres une nouvelle session avec un agent.

# Session Setup

## Context Window Budget
- Total: [200K|256K|1M]
- Effective: [120K|150K|600K]
- Compaction trigger: [65%|70%|75%]

## Session Goal
[Une phrase claire sur ce que tu veux accomplir]

## Constraints (début ET fin)
- [Règle critique 1]
- [Règle critique 2]
- [Format de sortie requis]

## Project Context
- Stack: [technos]
- Entry points: [fichiers clés]
- Conventions: [style, patterns]

Playbook 2 : Compaction rapide

Quand : Tu atteins 70% d’utilisation.

# Compaction Request

## Action
Compacter l'historique en résumé structuré.

## Format requis
```markdown
## Session Intent
[Rappel de l'objectif]

## Files Modified
- [fichier] : [modification]

## Decisions Made
- [décision] : [justification]

## Current State
- [status des tests]
- [erreurs en cours]

## Next Steps
1. [étape]
2. [étape]

Règles

Ne pas perdre les chemins de fichiers complets
Ne pas perdre les messages d’erreur
Garder les décisions avec leur justification


---

## Playbook 3 : Subagent de recherche

**Quand** : Tu dois explorer un codebase inconnu.

```markdown
# Research Subagent

## Task
Explorer le codebase pour [objectif].

## Deliverable
Document structuré avec :
1. Fichiers pertinents (chemins complets + lignes)
2. Flow d'information (entrée → traitement → sortie)
3. Hypothèses (3 max, avec probabilité)
4. Recommandation (par où commencer)

## Constraints
- Ne pas modifier de fichiers
- Ne pas faire de suppositions non vérifiées
- Citer les lignes exactes quand pertinent

Playbook 4 : Plan d’implémentation

Quand : Tu as le research et tu veux structurer le travail.

# Implementation Plan

## Based on Research
[Insérer le research]

## Phases
### Phase 1 : [Nom]
- Files: [liste]
- Changes: [description]
- Tests: [comment vérifier]
- Estimation: [durée]

### Phase 2 : [Nom]
- Files: [liste]
- Changes: [description]
- Tests: [comment vérifier]
- Estimation: [durée]

## Verification Globale
[Comment valider que tout fonctionne ensemble]

## Rollback Plan
[Comment annuler si ça va mal]

Playbook 5 : Diagnostic de dégradation

Quand : L’agent commence à produire des résultats de mauvaise qualité.

# Degradation Diagnostic

## Step 1 : Check context usage
/claude context
→ Si >70% : compacter immédiatement

## Step 2 : Check for poisoning
- L'agent cite-t-il une info fausse malgré correction ?
- Y a-t-il un document obsolète dans le contexte ?
→ Si oui : tronquer avant le point de poison

## Step 3 : Check for distraction
- Des documents non pertinents ont-ils été ajoutés ?
→ Si oui : les retirer

## Step 4 : Check for confusion
- L'agent mélange-t-il plusieurs tâches ?
→ Si oui : reset de contexte, une tâche à la fois

## Step 5 : Check for clash
- Des sources contradictoires sont-elles présentes ?
→ Si oui : établir priorité, marquer conflits

## Step 6 : If all else fails
- Redémarrer session avec contexte minimal
- Recharger uniquement les sources vérifiées

Seuils de production

Métrique	Seuil d’alerte	Seuil critique	Action
Context utilization	60%	75%	Compacter
Re-fetching frequency	1x par phase	3x par phase	Audit compression
Cache hit rate	60%	40%	Fix prompt stability
Token cost / task	Baseline +20%	Baseline +50%	Review workflow
Quality score	Baseline -5%	Baseline -15%	Diagnostiquer pattern

Tableau de choix rapide

Situation	Playbook	Trigger
Nouvelle session	Setup	Démarrage
Contexte plein	Compaction	70% usage
Codebase inconnu	Research	Avant planification
Feature complexe	Plan	Après research
Qualité baisse	Diagnostic	Symptômes visibles

Checklist de validation

J’ai copié au moins 2 playbooks
Je connais les seuils d’alerte et critique
Je peux diagnostiquer une dégradation en 5 étapes
Je sais quand compacter, masquer, ou partitionner

Fin du pack

Tu as maintenant :

La différence taille nominale / effective (Module 1)
L’anatomie des 5 composants (Module 2)
La courbe d’attention en U (Module 3)
Les 5 patterns de dégradation (Module 4)
La compaction intentionnelle (Module 5)
Le masking et le KV-cache (Module 6)
Les subagents et partitionnement (Module 7)
Le workflow Research → Plan → Implement (Module 8)
L’adaptation par modèle (Module 9)
5 playbooks copier-coller (Module 10)

Prochaine étape : choisir un projet réel et appliquer le Playbook 1.